SpecimenProcedure schemas

Type-specific details of ex-vivo processing steps performed on a specimen set.

This family is experimental: its schemas may change shape between releases without a version bump. Treat writes to these types as experimental.

Table of contents

  1. How to use this family
  2. Quick type map
  3. Preparation
    1. Dissection
  4. Sectioning
    1. Cryosectioning
    2. Sectioning
  5. Fixation and Preservation
    1. Cryopreservation
    2. Embedding
    3. Fixation (immersion)
  6. Clearing and Mounting
    1. Mounting
    2. Tissue clearing
  7. Labeling and Staining
    1. Antigen retrieval
    2. Blocking
    3. Dye loading
    4. Immunolabeling
    5. In situ hybridization
    6. Staining
    7. Wash step
  8. Tissue Processing
    1. Dehydration
  9. Generic
    1. Generic intervention

How to use this family

  • specimenprocedure: set type to a type code below and send its properties in details.
  • specimenproceduretemplate: set type to a type code below and send its properties in details.
  • Every version is published at https://www.brainstem.org/schemas/SpecimenProcedure/<Type>/<version>.json and never changes; https://www.brainstem.org/schemas/SpecimenProcedure/<Type>.json is the current version and https://www.brainstem.org/schemas/SpecimenProcedure/<Type>/ lists the versions. See Public schemas.
  • Quantities are objects {"value": <number>, "unit": "<code>"}. Property paths with [] are inside a repeatable list of rows. The server sets the schema version field itself.

Quick type map

Type codeTitleGroupVersionRequired propertiesSchema
AntigenRetrievalAntigen retrievalLabeling and Staining1.0.1none1.0.1.json
BlockingBlockingLabeling and Staining1.0.1none1.0.1.json
CryopreservationCryopreservationFixation and Preservation1.0.0none1.0.0.json
CryosectioningCryosectioningSectioning1.0.0none1.0.0.json
DehydrationDehydrationTissue Processing1.1.0none1.1.0.json
DissectionDissectionPreparation1.0.1none1.0.1.json
DyeLoadingDye loadingLabeling and Staining1.0.0none1.0.0.json
EmbeddingEmbeddingFixation and Preservation1.0.0none1.0.0.json
FixationFixation (immersion)Fixation and Preservation1.0.0none1.0.0.json
GenericInterventionGeneric interventionGeneric1.0.0none1.0.0.json
ImmunolabelingImmunolabelingLabeling and Staining1.0.0none1.0.0.json
InSituHybridizationIn situ hybridizationLabeling and Staining1.0.0none1.0.0.json
MountingMountingClearing and Mounting1.0.0none1.0.0.json
SectioningSectioningSectioning1.0.0none1.0.0.json
StainingStainingLabeling and Staining1.0.0none1.0.0.json
TissueClearingTissue clearingClearing and Mounting1.0.0none1.0.0.json
WashStepWash stepLabeling and Staining1.0.0none1.0.0.json

Preparation

Dissection

  • type code Dissection · version 1.0.1 · schema

Separating tissue from the body or dividing it into regions of interest.

PropertyTitleShapeRequiredAllowed valuesMeaning
instrumentInstrumenttext  Dissection instrument used.
dissectionTemperatureTemperaturequantity with unit units °C, K; default {"unit": "°C"}Temperature during dissection (e.g., 4 °C for ice-cold, 22 °C for room temperature).
durationDurationquantity with unit units s, min, h; default {"unit": "min"}Time taken to complete the dissection.

Illustrative payload:

{
    "instrument": "text",
    "dissectionTemperature": {
        "value": 1,
        "unit": "°C"
    }
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Medium (Processing medium)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
StorageMedium (Storage medium)  PhysiologicalSolution, HistologyReagentPhysiologicalSolution, HistologyReagentyes 
CollectionContainer (Collection container)  SurgicalDisposable, ConsumableDeviceSurgicalDisposable, ConsumableDeviceyes 
ProcessingSupply (Processing supply)  SurgicalDisposableSurgicalDisposableyes 
Other (Other material)    yes 

Stages:

  • dissection_step (Dissection), no detail schema; repeatable

Sectioning

Cryosectioning

  • type code Cryosectioning · version 1.0.0 · schema

Cutting frozen tissue on a cryostat. Use this rather than Sectioning whenever the tissue was frozen for cutting.

PropertyTitleShapeRequiredAllowed valuesMeaning
thicknessSection thicknessquantity with unit units µm, mm, nm, m; default {"unit": "µm"}Nominal section thickness as set on the cryostat for this event; actual sections may deviate from the setting.
orientationOrientationtext  Anatomical plane in which the tissue was cut; for an oblique cut, state the plane it deviates from and how.
nSectionsNumber of sectionsinteger ≥ 0Total number of sections produced by this cutting event.
serialSectioningSerial sectioningyes/no  Check if every cut section was retained (a complete collection), whether kept as one series or distributed across parallel series; leave unchecked if sections were discarded during collection.
sectionIntervalSection intervalinteger ≥ 1Sampling interval of one collected series: each series contains every nth section (e.g., 6 means every 6th section). Enter 1 when a single complete series contains every section.
collectionMethodCollection methodchoice one of direct_mount, free_floating, tape_transfer, otherTechnique by which the sections were collected off the knife: mounted directly onto slides, collected free-floating into wells or dishes, or transferred with a tape system. Choose Other for a technique not listed.
bladeAngleBlade anglequantity with unit units °; default {"unit": "°"}Blade clearance angle set on the cutting instrument for this event.
cuttingSpeedCutting speedquantity with unit units µm/s, mm/s; default {"unit": "mm/s"}Blade advance speed set for this event.

Illustrative payload:

{
    "thickness": {
        "value": 1,
        "unit": "µm"
    },
    "orientation": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
EmbeddingMedium (Embedding medium)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Cryoprotectant (Cryoprotectant)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
StorageMedium (Storage medium)  PhysiologicalSolution, HistologyReagentPhysiologicalSolution, HistologyReagentyes 
CollectionContainer (Collection container)  SurgicalDisposable, ConsumableDeviceSurgicalDisposable, ConsumableDeviceyes 
ProcessingSupply (Processing supply)  SurgicalDisposableSurgicalDisposableyes 
Other (Other material)    yes 

Stages:

  • cryostat_run (Cryostat run), no detail schema; repeatable
  • collection_step (Collection), no detail schema; repeatable
  • storage_step (Storage), no detail schema; repeatable

Sectioning

  • type code Sectioning · version 1.0.0 · schema

Cutting tissue into sections at room or bath temperature, as with a vibratome. Thickness and orientation are required because nothing downstream can be interpreted without them.

PropertyTitleShapeRequiredAllowed valuesMeaning
thicknessSection thicknessquantity with unit units µm, mm, nm, m; default {"unit": "µm"}Nominal section thickness as set on the cutting instrument for this event; actual sections may deviate from the setting.
orientationOrientationtext  Anatomical plane in which the tissue was cut; for an oblique cut, state the plane it deviates from and how.
nSectionsNumber of sectionsinteger ≥ 0Total number of sections produced by this event.
bladeAngleBlade anglequantity with unit units °; default {"unit": "°"}Blade clearance angle set on the cutting instrument for this event.
cuttingSpeedCutting speedquantity with unit units µm/s, mm/s; default {"unit": "mm/s"}Blade advance speed set for this event.
vibrationAmplitudeVibration amplitudequantity with unit units µm, mm, nm, m; default {"unit": "mm"}Lateral blade vibration amplitude set for this event; leave empty for instruments without a vibrating blade.
vibrationFrequencyVibration frequencyquantity with unit units Hz; default {"unit": "Hz"}Blade vibration frequency set for this event; leave empty for instruments without a vibrating blade.

Illustrative payload:

{
    "thickness": {
        "value": 1,
        "unit": "µm"
    },
    "orientation": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
EmbeddingMedium (Embedding medium)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
StorageMedium (Storage medium)  PhysiologicalSolution, HistologyReagentPhysiologicalSolution, HistologyReagentyes 
CollectionContainer (Collection container)  SurgicalDisposable, ConsumableDeviceSurgicalDisposable, ConsumableDeviceyes 
ProcessingSupply (Processing supply)  SurgicalDisposableSurgicalDisposableyes 
Other (Other material)    yes 

Stages:

  • sectioning_run (Sectioning run), no detail schema; repeatable
  • collection_step (Collection), no detail schema; repeatable
  • storage_step (Storage), no detail schema; repeatable

Fixation and Preservation

Cryopreservation

  • type code Cryopreservation · version 1.0.0 · schema

Preparing and holding tissue frozen for later use.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

  • Fields hidden by the web form for this type (leave empty): target_regions, target_regions_atlas.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Cryoprotectant (Cryoprotectant)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
StorageMedium (Storage medium)  PhysiologicalSolution, HistologyReagentPhysiologicalSolution, HistologyReagentyes 
CollectionContainer (Collection container)  SurgicalDisposable, ConsumableDeviceSurgicalDisposable, ConsumableDeviceyes 
Other (Other material)    yes 

Stages:

  • equilibration_step (Equilibration), no detail schema; repeatable
  • freezing_step (Freezing), no detail schema; repeatable

Embedding

  • type code Embedding · version 1.0.0 · schema

Setting tissue in a supporting medium such as paraffin, agarose, or OCT before cutting. The medium is recorded as a material.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
EmbeddingMedium (Embedding medium)yes HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
ProcessingReagent (Processing reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
CollectionContainer (Collection container)  SurgicalDisposable, ConsumableDeviceSurgicalDisposable, ConsumableDeviceyes 
ProcessingSupply (Processing supply)  SurgicalDisposableSurgicalDisposableyes 
Other (Other material)    yes 

Stages:

  • infiltration_step (Infiltration), no detail schema; repeatable
  • embedding_step (Embedding), no detail schema; repeatable

Fixation (immersion)

  • type code Fixation · version 1.0.0 · schema

Preserving tissue by immersing it in fixative. Perfusion fixation through the circulation is a Procedure on the subject, not a Specimen procedure. Record the fixative itself as a material.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Fixative (Fixative)yes HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
StorageMedium (Storage medium)  PhysiologicalSolution, HistologyReagentPhysiologicalSolution, HistologyReagentyes 
Other (Other material)    yes 

Stages:

  • fixation_step (Fixation), no detail schema; repeatable
  • wash_step (Wash), no detail schema; repeatable

Clearing and Mounting

Mounting

  • type code Mounting · version 1.0.0 · schema

Placing sections on slides under coverslips for imaging. The mounting medium is recorded as a material.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
MountingMedium (Mounting medium)  HistologyReagentHistologyReagentyes 
IndexMatchingMedium (Index-matching medium)  HistologyReagentHistologyReagentyes 
MountingComponent (Slide, coverslip, or mounting support)  SurgicalDisposableSurgicalDisposableyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 

Stages:

  • mounting_step (Mounting), no detail schema; repeatable
  • curing_step (Curing), no detail schema; repeatable

Tissue clearing

  • type code TissueClearing · version 1.0.0 · schema

Making tissue optically transparent for volumetric imaging. The clearing method is required, since duration and temperature are only interpretable against it.

PropertyTitleShapeRequiredAllowed valuesMeaning
methodClearing methodchoice one of clarity, pact, shield, cubic, scales, idisco, 3disco, udisco, pegasos, otherClearing method family used to render the tissue transparent. Solvent-based families (iDISCO+, 3DISCO, uDISCO, PEGASOS) shrink tissue and require solvent-tolerant optics and immersion media; hydrogel and aqueous families do not. Choose Other for a method family not listed.

Illustrative payload:

{
    "method": "clarity"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ClearingReagent (Clearing reagent)yes HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
PermeabilizationReagent (Permeabilization reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
IndexMatchingMedium (Index-matching medium)  HistologyReagentHistologyReagentyes 
Other (Other material)    yes 

Stages:

  • permeabilization (Permeabilization), no detail schema; repeatable
  • decolorization (Decolorization), no detail schema; repeatable
  • delipidation (Delipidation), no detail schema; repeatable
  • wash (Wash), no detail schema; repeatable
  • clearing (Clearing), no detail schema; repeatable
  • index_matching (Index matching), no detail schema; repeatable
  • other (Other), no detail schema; repeatable

Labeling and Staining

Antigen retrieval

  • type code AntigenRetrieval · version 1.0.1 · schema

Unmasking epitopes before immunolabeling, normally by heat or enzyme.

PropertyTitleShapeRequiredAllowed valuesMeaning
methodRetrieval methodchoice one of heat_induced_hier, enzymatic, otherAntigen retrieval strategy used.
temperatureTemperaturequantity with unit units °C, K, °F; default {"unit": "°C"}Temperature during antigen retrieval.
durationDurationquantity with unit units µs, ms, s, min, h; default {"unit": "min"}Duration of the antigen retrieval step.

Illustrative payload:

{
    "method": "heat_induced_hier",
    "temperature": {
        "value": 1,
        "unit": "°C"
    }
}
  • Fields hidden by the web form for this type (leave empty): target_regions, target_regions_atlas.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
RetrievalReagent (Retrieval reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • retrieval_step (Retrieval), no detail schema; repeatable
  • wash_step (Wash), no detail schema; repeatable

Blocking

  • type code Blocking · version 1.0.1 · schema

Blocking non-specific binding before labeling. Record the blocking solution as a material.

PropertyTitleShapeRequiredAllowed valuesMeaning
durationBlocking durationquantity with unit units µs, ms, s, min, h; default {"unit": "h"}Duration of the blocking step.
temperatureTemperaturequantity with unit units °C, K, °F; default {"unit": "°C"}Temperature during blocking.

Illustrative payload:

{
    "duration": {
        "value": 1,
        "unit": "h"
    },
    "temperature": {
        "value": 1,
        "unit": "°C"
    }
}
  • Fields hidden by the web form for this type (leave empty): target_regions, target_regions_atlas.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
BlockingReagent (Blocking reagent)yes HistologyReagent, ImmunoReagent, ChemicalReagentHistologyReagent, ImmunoReagent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • blocking_step (Blocking), no detail schema; repeatable
  • wash_step (Wash), no detail schema; repeatable

Dye loading

  • type code DyeLoading · version 1.0.0 · schema

Loading a dye or indicator into tissue or cells. Record the dye as a material.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
StainDye (Stain or dye)yes TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 
ProcessingReagent (Processing reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • loading_step (Loading), no detail schema; repeatable
  • washout_step (Washout), no detail schema; repeatable

Immunolabeling

  • type code Immunolabeling · version 1.0.0 · schema

Antibody-based labeling. Record the primary and secondary antibodies as materials, each with its dilution, and use stages for the incubation and wash sequence.

PropertyTitleShapeRequiredAllowed valuesMeaning
labelingConfigurationLabeling configurationchoice one of free_floating, on_slide, whole_mountPhysical configuration of the specimen during labeling: free-floating, slide-mounted, or whole-mount.

Illustrative payload:

{
    "labelingConfiguration": "free_floating"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
BlockingReagent (Blocking reagent)  HistologyReagent, ImmunoReagent, ChemicalReagentHistologyReagent, ImmunoReagent, ChemicalReagentyes 
PermeabilizationReagent (Permeabilization reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
PrimaryLabel (Primary immunolabeling reagent)yes ImmunoReagentImmunoReagentyes 
SecondaryLabel (Secondary immunolabeling reagent)  ImmunoReagentImmunoReagentyes 
DetectionReagent (Detection reagent)  ImmunoReagent, HistologyReagentImmunoReagent, HistologyReagentyes 
StainDye (Stain or dye)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • permeabilization_step (Permeabilization), no detail schema; repeatable
  • blocking_step (Blocking), no detail schema; repeatable
  • primary_incubation (Primary incubation), no detail schema; repeatable
  • wash_step (Wash), no detail schema; repeatable
  • secondary_incubation (Secondary incubation), no detail schema; repeatable
  • detection_step (Detection), no detail schema; repeatable
  • counterstain_step (Counterstain), no detail schema; repeatable

In situ hybridization

  • type code InSituHybridization · version 1.0.0 · schema

Probe-based labeling of nucleic acid targets. Record the probes as materials and the hybridization and wash steps as stages.

PropertyTitleShapeRequiredAllowed valuesMeaning
methodHybridization methodchoice one of rnascope, hcr, chromogenic_ish, fish, otherHybridization chemistry used to detect the target transcripts.

Illustrative payload:

{
    "method": "rnascope"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
HybridizationProbe (Hybridization probe)yes ImmunoReagent, ChemicalReagentImmunoReagent, ChemicalReagentyes 
DetectionReagent (Detection reagent)  ImmunoReagent, HistologyReagentImmunoReagent, HistologyReagentyes 
BlockingReagent (Blocking reagent)  HistologyReagent, ImmunoReagent, ChemicalReagentHistologyReagent, ImmunoReagent, ChemicalReagentyes 
StainDye (Stain or dye)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • pretreatment_step (Pretreatment), no detail schema; repeatable
  • prehybridization_step (Prehybridization), no detail schema; repeatable
  • hybridization_step (Hybridization), no detail schema; repeatable
  • stringency_wash (Stringency wash), no detail schema; repeatable
  • amplification_step (Amplification), no detail schema; repeatable
  • detection_step (Detection), no detail schema; repeatable
  • counterstain_step (Counterstain), no detail schema; repeatable

Staining

  • type code Staining · version 1.0.0 · schema

Applying a general stain, such as Nissl or a histochemical stain. It defines no fields of its own: record the stain in Material usage and the timing in stages.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
StainDye (Stain or dye)yes TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 
ProcessingReagent (Processing reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • staining_step (Staining), no detail schema; repeatable
  • differentiation_step (Differentiation), no detail schema; repeatable
  • rinse_step (Rinse), no detail schema; repeatable
  • bluing_step (Bluing), no detail schema; repeatable
  • counterstain_step (Counterstain), no detail schema; repeatable
  • dehydration_step (Dehydration), no detail schema; repeatable

Wash step

  • type code WashStep · version 1.0.0 · schema

A standalone wash. Record it separately only when the wash is worth its own entry; a wash inside a labeling run belongs in that run’s stages instead.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

  • Fields hidden by the web form for this type (leave empty): target_regions, target_regions_atlas.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
WashSolution (Wash solution)yes PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • wash_step (Wash), no detail schema; repeatable

Tissue Processing

Dehydration

  • type code Dehydration · version 1.1.0 · schema

Removing water through a graded solvent series, usually before embedding or clearing. The series itself is recorded as ordered stages with the solutions as materials.

This type has no type-specific properties: send an empty object. Everything meaningful is recorded on the record itself or on its material usage rows.

  • Fields hidden by the web form for this type (leave empty): target_regions, target_regions_atlas.

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
DehydrationReagent (Dehydration reagent)yes HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
WashSolution (Wash solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
ProcessingReagent (Processing reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
Other (Other material)    yes 

Stages:

  • dehydration_step (Dehydration), no detail schema; repeatable

Generic

Generic intervention

  • type code GenericIntervention · version 1.0.0 · schema

Use this only when no specific type applies. The intervention method is required, and the description should say plainly what was done, because the type name tells another user nothing.

PropertyTitleShapeRequiredAllowed valuesMeaning
interventionMethodIntervention methodtext  What was done to the specimen, in the lab’s own words.

Illustrative payload:

{
    "interventionMethod": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ProcessingReagent (Processing reagent)  HistologyReagent, ChemicalReagentHistologyReagent, ChemicalReagentyes 
ActiveAgent (Active agent)  PharmacologicalAgent, ChemicalReagentPharmacologicalAgent, ChemicalReagentyes 
Buffer (Buffer)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
Medium (Processing medium)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
StorageMedium (Storage medium)  PhysiologicalSolution, HistologyReagentPhysiologicalSolution, HistologyReagentyes 
CollectionContainer (Collection container)  SurgicalDisposable, ConsumableDeviceSurgicalDisposable, ConsumableDeviceyes 
ProcessingSupply (Processing supply)  SurgicalDisposableSurgicalDisposableyes 
Other (Other material)    yes 

Stages:

  • processing_step (Processing), no detail schema; repeatable