ExperimentalInterface schemas

Type-specific details of experimental interfaces: the point where hardware meets the animal or tissue, such as an implanted probe, a cranial window or an optic fiber.

Table of contents

  1. How to use this family
  2. Quick type map
  3. Electrophysiology
    1. ECG
    2. ECoG
    3. EEG
    4. EMG
    5. Ground electrode
    6. Multi-electrode array (MEA)
    7. Nerve cuff
    8. Patch pipette
    9. Reference electrode
    10. Silicon probe
    11. Single wire electrode
    12. Tetrode
    13. Tungsten microelectrode
  4. Physiological monitoring
    1. Blood-pressure sensor
    2. Respiratory sensor
  5. Optical
    1. Cranial window
    2. GRIN lens
    3. Microscope objective
    4. Miniscope
    5. Optic fiber
    6. Prism
    7. Widefield macroscope
  6. Assemblies
    1. Headcap
    2. Headpost
  7. Behavioral and Environmental
    1. Camera
    2. Microphone
    3. Tracking system
  8. Delivery
    1. Bath perfusion
    2. Catheter
    3. Drug delivery line
    4. Injection cannula
    5. Microperfusion line
    6. Osmotic pump
  9. Stimulation
    1. Auditory stimulator
    2. LED array
    3. Olfactometer
    4. Stimulating electrode
    5. TMS coil
    6. Tactile stimulator
    7. Thermal probe
    8. Ultrasound transducer
    9. Visual stimulator
  10. Generic
    1. Generic interface
  11. Target specimens

How to use this family

  • experimentalinterface: set type to a type code below and send its properties in details.
  • experimentalinterfacetemplate: set type to a type code below and send its properties in details.
  • Every version is published at https://www.brainstem.org/schemas/ExperimentalInterface/<Type>/<version>.json and never changes; https://www.brainstem.org/schemas/ExperimentalInterface/<Type>.json is the current version and https://www.brainstem.org/schemas/ExperimentalInterface/<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
AuditoryStimulatorAuditory stimulatorStimulation1.0.3none1.0.3.json
BathPerfusionBath perfusionDelivery2.0.1none2.0.1.json
BloodPressureSensorBlood-pressure sensorPhysiological monitoring1.0.0none1.0.0.json
CameraCameraBehavioral and Environmental2.0.1none2.0.1.json
CatheterCatheterDelivery2.0.1none2.0.1.json
CranialWindowCranial windowOptical2.0.1none2.0.1.json
DrugDeliveryLineDrug delivery lineDelivery2.0.1none2.0.1.json
ECGECGElectrophysiology1.0.2none1.0.2.json
ECoGECoGElectrophysiology1.0.0none1.0.0.json
EEGEEGElectrophysiology1.0.2none1.0.2.json
EMGEMGElectrophysiology1.0.2none1.0.2.json
GRINLensGRIN lensOptical1.0.0none1.0.0.json
GenericGeneric interfaceGeneric1.0.2none1.0.2.json
GroundElectrodeGround electrodeElectrophysiology2.0.1none2.0.1.json
HeadcapHeadcapAssemblies2.0.1none2.0.1.json
HeadpostHeadpostAssemblies1.0.0none1.0.0.json
InjectionCannulaInjection cannulaDelivery2.0.1none2.0.1.json
LEDArrayLED arrayStimulation2.0.1none2.0.1.json
MicroperfusionLineMicroperfusion lineDelivery2.0.1none2.0.1.json
MicrophoneMicrophoneBehavioral and Environmental2.0.1none2.0.1.json
MicroscopeObjectiveMicroscope objectiveOptical2.0.1none2.0.1.json
MiniscopeMiniscopeOptical2.0.1none2.0.1.json
MultiElectrodeArrayMulti-electrode array (MEA)Electrophysiology2.0.1none2.0.1.json
NerveCuffNerve cuffElectrophysiology1.0.2none1.0.2.json
OlfactometerOlfactometerStimulation1.0.2none1.0.2.json
OpticFiberOptic fiberOptical1.0.0none1.0.0.json
OsmoticPumpOsmotic pumpDelivery2.0.1none2.0.1.json
PatchPipettePatch pipetteElectrophysiology2.0.1none2.0.1.json
PrismPrismOptical1.0.0none1.0.0.json
ReferenceElectrodeReference electrodeElectrophysiology2.0.1none2.0.1.json
RespiratorySensorRespiratory sensorPhysiological monitoring1.0.0none1.0.0.json
SiliconProbeSilicon probeElectrophysiology2.0.1none2.0.1.json
SingleWireElectrodeSingle wire electrodeElectrophysiology2.0.1none2.0.1.json
StimulatingElectrodeStimulating electrodeStimulation2.0.1none2.0.1.json
TMSCoilTMS coilStimulation2.0.1none2.0.1.json
TactileStimulatorTactile stimulatorStimulation1.0.3none1.0.3.json
TargetSpecimensTarget specimens (form only) 1.0.2none1.0.2.json
TetrodeTetrodeElectrophysiology2.0.1none2.0.1.json
ThermalProbeThermal probeStimulation2.0.1none2.0.1.json
TrackingSystemTracking systemBehavioral and Environmental2.0.1none2.0.1.json
TungstenMicroelectrodeTungsten microelectrodeElectrophysiology2.0.1none2.0.1.json
UltrasoundTransducerUltrasound transducerStimulation2.0.1none2.0.1.json
VisualStimulatorVisual stimulatorStimulation1.0.3none1.0.3.json
WidefieldMacroscopeWidefield macroscopeOptical2.0.1none2.0.1.json

Electrophysiology

ECG

  • type code ECG · version 1.0.2 · schema

Electrodes recording cardiac electrical activity.

PropertyTitleShapeRequiredAllowed valuesMeaning
leadConfigurationLead configurationtext  The arrangement and roles of the installed ECG leads.
electrodeLayoutElectrode layouttext (multi-line)  The spatial arrangement of electrodes in the installed interface.

Illustrative payload:

{
    "leadConfiguration": "text",
    "electrodeLayout": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ElectrodeAssembly (Electrode assembly)yes ElectrodeComponent, SingleWireElectrode, ConsumableDeviceElectrodeComponent, SingleWireElectrode, ConsumableDeviceyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

ECoG

  • type code ECoG · version 1.0.0 · schema

A grid or strip array of contacts installed on the dura, on the brain surface, or on thinned skull. Created by an ECoG implant procedure; the array’s design (contact count, pitch, substrate) lives on the ECoG array material row and its catalog entry.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
placementLayerPlacement layerchoice one of epidural, subdural, epicranialWhich tissue layer the installed array rests on: the dura, the brain surface under an opened dura, or the bone.
referenceConfigurationReference configurationtext  How the array’s reference input is wired as installed: a skull screw, an on-array contact or a recording contact.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "placementLayer": "epidural"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
EcogArray (ECoG array)yes EcogArrayEcogArrayDesignyes 
ReferenceElectrode (Reference electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
ShieldingMaterial (Shielding material)  ImplantMaterial, ConsumableDeviceImplantMaterial, ConsumableDeviceyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

EEG

  • type code EEG · version 1.0.2 · schema

Electrodes recording large-scale activity on or beneath the skull.

PropertyTitleShapeRequiredAllowed valuesMeaning
electrodeLayoutElectrode layouttext (multi-line)  The spatial arrangement of electrodes in the installed interface.
channelCountChannel countinteger ≥ 0The number of channels configured and available on this installed interface.

Illustrative payload:

{
    "electrodeLayout": "text",
    "channelCount": 1
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ElectrodeAssembly (Electrode assembly)yes ElectrodeComponent, SingleWireElectrode, ConsumableDeviceElectrodeComponent, SingleWireElectrode, ConsumableDeviceyes 
ReferenceElectrode (Reference electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
ShieldingMaterial (Shielding material)  ImplantMaterial, ConsumableDeviceImplantMaterial, ConsumableDeviceyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

EMG

  • type code EMG · version 1.0.2 · schema

Electrodes in or on muscle.

PropertyTitleShapeRequiredAllowed valuesMeaning
muscleMuscletext  The muscle targeted by the installed EMG interface.
electrodeLayoutElectrode layouttext (multi-line)  The spatial arrangement of electrodes in the installed interface.

Illustrative payload:

{
    "muscle": "text",
    "electrodeLayout": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ElectrodeAssembly (Electrode assembly)yes ElectrodeComponent, SingleWireElectrode, ConsumableDeviceElectrodeComponent, SingleWireElectrode, ConsumableDeviceyes 
ReferenceElectrode (Reference electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Ground electrode

  • type code GroundElectrode · version 2.0.1 · schema

Ties the preparation to circuit ground. Keep it separate from the reference electrode even when one screw serves both, and say so in Notes.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
groundSiteGround sitetext  The anatomical or apparatus site used for the ground electrode.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "groundSite": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
GroundElectrode (Ground electrode)yes ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Multi-electrode array (MEA)

  • type code MultiElectrodeArray · version 2.0.1 · schema

A planar or grid array of electrodes, common for ex-vivo and surface recording.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
electrodeCountElectrode countinteger ≥ 0The number of electrodes present on the configured array.
electrodePitchUmElectrode pitch (µm)number ≥ 0Centre-to-centre distance between adjacent electrodes.
electrodeDiameterUmElectrode diameter (µm)number ≥ 0The electrode diameter in micrometres.
substrateTypeSubstrate typetext  The material or construction type of the electrode-array substrate.
referenceConfigurationReference configurationtext  The reference-channel or reference-electrode arrangement used by the interface.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "electrodeCount": 1
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
MultiElectrodeArray (Multi-electrode array)yes ConsumableDevice, ElectrodeComponent, SingleWireElectrodeConsumableDevice, ElectrodeComponent, SingleWireElectrodeyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Nerve cuff

  • type code NerveCuff · version 1.0.2 · schema

A cuff placed around a peripheral nerve to record or stimulate.

PropertyTitleShapeRequiredAllowed valuesMeaning
nerveNervetext  The nerve enclosed or contacted by the installed cuff.
contactCountContact countinteger ≥ 0The number of electrical contacts configured on the installed interface.
cuffSizeCuff sizetext  The cuff size fitted to the target nerve, including the sizing convention or units.

Illustrative payload:

{
    "nerve": "text",
    "contactCount": 1
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
NerveCuff (Nerve cuff)yes ConsumableDevice, ImplantMaterial, ElectrodeComponentConsumableDevice, ImplantMaterial, ElectrodeComponentyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
ReferenceElectrode (Reference electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Patch pipette

  • type code PatchPipette · version 2.0.1 · schema

A glass pipette sealed to a cell for intracellular recording.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
patchTypePatch configurationchoice one of whole_cell, cell_attached, perforated_patch, outside_out, inside_out, otherPatch-clamp recording configuration used.
resistancePipette resistancequantity with unit units kΩ, MΩ, GΩ; default {"unit": "MΩ"}Pipette resistance in the bath before seal formation.
sealResistanceSeal resistancequantity with unit units kΩ, MΩ, GΩ; default {"unit": "GΩ"}Gigaseal resistance achieved before break-in (whole-cell) or during recording (cell-attached).

Illustrative payload:

{
    "deviceIdentifier": "text",
    "patchType": "whole_cell"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
PatchPipette (Patch pipette)yes ConsumableDeviceConsumableDeviceyes 
Buffer (Internal solution)  PhysiologicalSolution, ChemicalReagentPhysiologicalSolution, ChemicalReagentyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Other (Other material)    yes 

Reference electrode

  • type code ReferenceElectrode · version 2.0.1 · schema

Supplies the reference potential the recording channels are measured against.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
referenceSiteReference sitetext  The anatomical or apparatus site used for the reference electrode.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "referenceSite": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ElectrodeAssembly (Electrode assembly)  ElectrodeComponent, SingleWireElectrode, ConsumableDeviceElectrodeComponent, SingleWireElectrode, ConsumableDeviceyes 
ReferenceElectrode (Reference electrode)yes ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Silicon probe

  • type code SiliconProbe · version 2.0.1 · schema

A silicon-based probe carrying many recording sites, often on several shanks.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
channelCountActive channel countinteger ≥ 0The number of channels configured and available on this installed interface.
shankCountConfigured shank countinteger ≥ 0The number of probe shanks configured for this installed interface.
referenceConfigurationReference configurationtext  The reference-channel or reference-electrode arrangement used by the interface.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "channelCount": 1
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
SiliconProbe (Silicon probe)yes SiliconProbeSiliconProbeDesignyes 
FixedPositioningAssembly (Fixed probe carrier or shuttle)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ManualMicrodrive (Manual probe microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
MotorizedMicrodrive (Motorized probe microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, SingleWireElectrodeConsumableDevice, ImplantMaterial, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
Other (Other material)    yes 

Single wire electrode

  • type code SingleWireElectrode · version 2.0.1 · schema

One insulated wire electrode used for recording or stimulation.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
wireMaterialWire materialtext  The conductor material of the installed electrode wire.
impedanceImpedancetext  The nominal or measured impedance of the installed electrode, including frequency context when known.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "wireMaterial": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
SingleWireElectrode (Single-wire electrode)yes SingleWireElectrode, ConsumableDeviceSingleWireElectrode, ConsumableDeviceyes 
FixedPositioningAssembly (Fixed electrode carrier or shuttle)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ManualMicrodrive (Manual electrode microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
MotorizedMicrodrive (Motorized electrode microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Tetrode

  • type code Tetrode · version 2.0.1 · schema

A four-wire bundle used to separate nearby single units.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
tetrodeCountTetrode countinteger ≥ 0The number of tetrodes configured in the installed interface.
wireMaterialWire materialtext  The conductor material of the installed electrode wire.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "tetrodeCount": 1
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
ElectrodeAssembly (Electrode assembly)yes SingleWireElectrode, ElectrodeComponent, ConsumableDeviceSingleWireElectrode, ElectrodeComponent, ConsumableDeviceyes 
FixedPositioningAssembly (Fixed electrode carrier or shuttle)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ManualMicrodrive (Manual electrode microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
MotorizedMicrodrive (Motorized electrode microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ReferenceElectrode (Reference electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Tungsten microelectrode

  • type code TungstenMicroelectrode · version 2.0.1 · schema

A sharpened metal microelectrode, typically for acute single-unit recording.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
impedanceMohmImpedance (MΩ)number ≥ 0Electrode impedance measured at 1 kHz.
tipDiameterUmTip diameter (µm)number ≥ 0The electrode-tip diameter in micrometres.
shaftDiameterUmShaft diameter (µm)number ≥ 0The electrode-shaft diameter in micrometres.
referenceConfigurationReference configurationtext  The reference-channel or reference-electrode arrangement used by the interface.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "impedanceMohm": 1.0
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
SingleWireElectrode (Single-wire electrode)yes ConsumableDevice, SingleWireElectrodeConsumableDevice, SingleWireElectrodeyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Physiological monitoring

Blood-pressure sensor

  • type code BloodPressureSensor · version 1.0.0 · schema

Represents a sensor that monitors the subject’s blood pressure, such as an implanted telemetry catheter or an arterial pressure transducer.

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
BloodPressureSensor (Blood-pressure sensor)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Respiratory sensor

  • type code RespiratorySensor · version 1.0.0 · schema

Represents a sensor that monitors the subject’s breathing, such as a nasal thermistor, thermocouple, pressure sensor or plethysmograph.

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
RespiratorySensor (Respiratory sensor)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Optical

Cranial window

  • type code CranialWindow · version 2.0.1 · schema

A transparent window giving optical access to the brain surface.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
windowMaterialWindow materialtext  The material forming the transparent portion of the cranial window.
diameterMmDiameter (mm)number ≥ 0The installed cranial-window diameter in millimetres.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "windowMaterial": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
CranialWindow (Cranial window)yes ConsumableDevice, ImplantMaterial, OpticalComponentConsumableDevice, ImplantMaterial, OpticalComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Other (Other material)    yes 

GRIN lens

  • type code GRINLens · version 1.0.0 · schema

A gradient-index lens giving optical access to deep tissue.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
protrusionAboveSkullProtrusion above skullquantity with unit units µm, mm; default {"unit": "mm"}Distance from the skull surface at the implant site to the top face of the lens; not the lens’s own length.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "protrusionAboveSkull": {
        "value": 1,
        "unit": "mm"
    }
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
GrinLens (GRIN lens)yes OpticalComponent, ConsumableDeviceOpticalComponent, ConsumableDeviceyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Microscope objective

  • type code MicroscopeObjective · version 2.0.1 · schema

The objective through which the preparation is imaged, when it is worth recording as a target-facing interface.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
magnificationMagnificationtext  The nominal magnification of the configured microscope objective.
numericalApertureNumerical aperturenumber ≥ 0The numerical aperture of the configured microscope objective.
workingDistanceMmWorking distance (mm)number ≥ 0The objective working distance in millimetres.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "magnification": "text"
}
  • Fields hidden by the web form for this type (leave empty): consumablestock, consumablestock_inventory.

Miniscope

  • type code Miniscope · version 2.0.1 · schema

A head-mounted miniature microscope, usually imaging above a GRIN lens.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
fieldOfViewField of viewtext  The field of view provided by the configured miniscope.
frameRateHzFrame rate (Hz)number ≥ 0The configured image frame rate in frames per second.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "fieldOfView": "text"
}
  • Fields hidden by the web form for this type (leave empty): consumablestock, consumablestock_inventory.

Optic fiber

  • type code OpticFiber · version 1.0.0 · schema

A fiber delivering or collecting light, typically for optogenetics.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
measuredOutputPowerMeasured output powerquantity with unit units µW, mW, W; default {"unit": "mW"}Optical power measured from the finished assembly on the bench, before implantation.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "measuredOutputPower": {
        "value": 1,
        "unit": "mW"
    }
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
OpticFiber (Optic fiber)yes OpticFiberOpticFiberDesignyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Prism

  • type code Prism · version 1.0.0 · schema

Redirects the optical path to reach a plane a straight lens cannot.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.

Illustrative payload:

{
    "deviceIdentifier": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Prism (Prism)yes OpticalComponent, ConsumableDeviceOpticalComponent, ConsumableDeviceyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Widefield macroscope

  • type code WidefieldMacroscope · version 2.0.1 · schema

A large field-of-view imaging path for cortex-wide imaging.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
objectiveMagnificationObjective magnificationtext  The objective magnification used by the configured macroscope.
fieldOfViewMmField of view (mm)text  Imaged area width × height in mm.
excitationWavelengthNmExcitation wavelength (nm)number ≥ 0The configured fluorescence excitation wavelength in nanometres.
emissionWavelengthNmEmission wavelength (nm)number ≥ 0The configured fluorescence emission wavelength in nanometres.
frameRateHzFrame rate (Hz)number ≥ 0The configured image frame rate in frames per second.
indicatorFluorescent indicatortext  The fluorescent indicator observed with the configured macroscope.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "objectiveMagnification": "text"
}
  • Fields hidden by the web form for this type (leave empty): consumablestock, consumablestock_inventory.

Assemblies

Headcap

  • type code Headcap · version 2.0.1 · schema

The assembled cap protecting cranial implants and carrying their connectors. It is the assembly rather than any single device, so its components are recorded as its materials.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
shapeFinal shape or designtext  The final installed headcap shape or design.
shieldingConfigurationShielding configurationtext (multi-line)  The shielding arrangement incorporated into the installed headcap.
connectorConfigurationConnector and port configurationtext (multi-line)  The connector types and port arrangement incorporated into the installed headcap.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "shape": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
HeadcapAssembly (Headcap assembly)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
ShieldingMaterial (Shielding material)  ImplantMaterial, ConsumableDeviceImplantMaterial, ConsumableDeviceyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Other (Other material)    yes 

Headpost

  • type code Headpost · version 1.0.0 · schema

Represents a headpost or head plate fixed to the skull for head fixation.

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
Headpost (Headpost)yes ImplantMaterial, ConsumableDeviceImplantMaterial, ConsumableDeviceyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
Other (Other material)    yes 

Behavioral and Environmental

Camera

  • type code Camera · version 2.0.1 · schema

A camera trained on the subject or preparation as a fixed observation point.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
viewViewtext  The field of view or viewing direction provided by the installed camera.
frameRateHzFrame rate (Hz)number ≥ 0The configured image frame rate in frames per second.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "view": "text"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

Microphone

  • type code Microphone · version 2.0.1 · schema

A microphone positioned to capture sound from the preparation.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
placementPlacementtext  The installed position and orientation of the interface relative to its target.
sampleRateHzSample rate (Hz)number ≥ 0The configured microphone sampling rate in samples per second.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "placement": "text"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

Tracking system

  • type code TrackingSystem · version 2.0.1 · schema

A configured tracking arrangement observing the subject.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
trackingMethodTracking methodtext  The sensing method used by the configured tracking system.
trackedMarkersTracked markerstext (multi-line)  The markers or features tracked by the configured system.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "trackingMethod": "text"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

Delivery

Bath perfusion

  • type code BathPerfusion · version 2.0.1 · schema

The bath that superfuses a preparation, normally on a specimen set.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
flowRateFlow ratequantity with unit units mL/min, µL/min, mL/h, µL/h; default {"unit": "mL/min"}Perfusion flow rate.
solutionSolutiontext (multi-line)  Composition or name of the perfusion solution (e.g., aCSF, ACSF with TTX 1 µM).
temperatureTemperaturequantity with unit units °C, K, °F; default {"unit": "°C"}Temperature of the perfusion solution at the recording chamber.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "flowRate": {
        "value": 1,
        "unit": "mL/min"
    }
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
FluidDeliveryLine (Perfusion flow path)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
ActiveAgent (Delivered agent)  PharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionPharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionyes 
Other (Other material)    yes 

Catheter

  • type code Catheter · version 2.0.1 · schema

A tube in a vessel or cavity for delivery, sampling, or monitoring.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
routeRoutetext  The anatomical or configured route followed by the installed line or catheter.
gaugeGaugetext  The gauge designation of the installed catheter or cannula.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "route": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Catheter (Catheter)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
ActiveAgent (Delivered agent)  PharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionPharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Drug delivery line

  • type code DrugDeliveryLine · version 2.0.1 · schema

A line delivering an agent from an external source.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
routeRoutetext  The anatomical or configured route followed by the installed line or catheter.
deadVolumeDead volumetext  The internal volume retained by the configured delivery line.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "route": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
FluidDeliveryLine (Fluid-delivery line)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
ActiveAgent (Delivered agent)  PharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionPharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionyes 
Other (Other material)    yes 

Injection cannula

  • type code InjectionCannula · version 2.0.1 · schema

A cannula for delivering a substance to a defined site.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
gaugeGaugetext  The gauge designation of the installed catheter or cannula.
deliveryTargetDelivery targettext  The anatomical or experimental target reached by the installed cannula.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "gauge": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
Cannula (Cannula)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Obturator (Obturator)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
ActiveAgent (Delivered agent)  PharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionPharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Microperfusion line

  • type code MicroperfusionLine · version 2.0.1 · schema

A fine line exchanging solution locally at the target.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
flowRateFlow ratetext  The configured flow rate for the installed microperfusion line, including units.
solutionSolutiontext (multi-line)  The solution intended to pass through the installed microperfusion line.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "flowRate": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
FluidDeliveryLine (Microperfusion line)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
Cannula (Delivery cannula)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
MicrodialysisProbe (Microdialysis probe)  ConsumableDeviceConsumableDeviceyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
ActiveAgent (Delivered agent)  PharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionPharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionyes 
Other (Other material)    yes 

Osmotic pump

  • type code OsmoticPump · version 2.0.1 · schema

An implanted pump delivering an agent continuously without external control.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
nominalFlowRateNominal flow ratequantity with unit units µL/h, µL/day, mL/h, mL/day; default {"unit": "µL/h"}Manufacturer-specified nominal flow rate.
reservoirVolumeReservoir volumequantity with unit units µL, mL, L; default {"unit": "µL"}Total volume capacity of the osmotic pump reservoir.
durationDelivery durationquantity with unit units h, days, weeks; default {"unit": "days"}Expected delivery duration based on reservoir volume and flow rate.
deliveryAgentDelivery agent / drugtext  Agent being delivered.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "nominalFlowRate": {
        "value": 1,
        "unit": "µL/h"
    }
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
OsmoticPump (Osmotic pump)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
FluidDeliveryLine (Delivery line)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
Catheter (Delivery catheter)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
Other (Other material)    yes 

Stimulation

Auditory stimulator

  • type code AuditoryStimulator · version 1.0.3 · schema

The configured arrangement presenting sound to the subject.

PropertyTitleShapeRequiredAllowed valuesMeaning
stimulusTypesStimulus typesmulti-select one of tone, click, white_noise, pink_noise, frequency_sweep, amplitude_modulated, pulse_train, chirp, other; format select2Types of auditory stimuli delivered through this interface. Select one or more.
deliveryMethodDelivery methodchoice one of free_field_speaker, in_ear_speaker, bone_conduction, headphone, otherHow the sound was delivered to the subject. Free-field speakers are most common in head-fixed setups.
stimulationContextStimulation contextchoice one of passive, behavioral_task, closed_loop, anesthetized, free_behaviorExperimental context in which auditory stimulation was delivered.
paradigmDescriptionParadigm descriptiontext (multi-line)  Free-text description of the auditory stimulation paradigm: include stimulus timing, repetitions, device setup, etc.

Illustrative payload:

{
    "stimulusTypes": [
        "tone"
    ],
    "deliveryMethod": "free_field_speaker"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

LED array

  • type code LEDArray · version 2.0.1 · schema

An array of LEDs for patterned optical stimulation.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
wavelengthNmWavelength (nm)number ≥ 0Peak emission wavelength of the LEDs.
ledCountLED countinteger ≥ 0The number of LEDs present in the configured array.
pitchMmLED pitch (mm)number ≥ 0Centre-to-centre distance between adjacent LEDs.
maxPowerMwMax power per LED (mW)number ≥ 0The maximum optical power per LED in milliwatts.
opsinTarget opsintext  Opsin targeted by this LED array.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "wavelengthNm": 1.0
}
  • Fields hidden by the web form for this type (leave empty): consumablestock, consumablestock_inventory.

Olfactometer

  • type code Olfactometer · version 1.0.2 · schema

The configured arrangement presenting odors.

PropertyTitleShapeRequiredAllowed valuesMeaning
deliveryMethodDelivery methodchoice one of olfactometer, manually_pipetted, syringe_injection, headspace_exposure, cotton_swab, otherHow the odor was delivered to the subject. Use ‘Olfactometer’ for computer-controlled systems.
stimulationContextStimulation contextchoice one of passive, behavioral_task, closed_loop, anesthetized, free_behaviorExperimental context in which odor stimulation occurred.
paradigmDescriptionParadigm descriptiontext (multi-line)  Free-text description of the odor stimulation paradigm, including stimulus timing, delivery parameters, and experimental goals.

Illustrative payload:

{
    "deliveryMethod": "olfactometer",
    "stimulationContext": "passive"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

Stimulating electrode

  • type code StimulatingElectrode · version 2.0.1 · schema

An electrode used to deliver current rather than to record.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
contactCountActive contact countinteger ≥ 0The number of electrical contacts configured on the installed interface.
stimulationModeStimulation modetext  The electrical stimulation mode supported by the configured electrode.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "contactCount": 1
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
StimulatingElectrode (Stimulating electrode)yes ConsumableDevice, SingleWireElectrodeConsumableDevice, SingleWireElectrodeyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

TMS coil

  • type code TMSCoil · version 2.0.1 · schema

A coil inducing currents in tissue without contact.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
coilTypeCoil typetext  The geometry or construction type of the configured TMS coil.
placementPlacementtext  The installed position and orientation of the interface relative to its target.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "coilType": "text"
}
  • Fields hidden by the web form for this type (leave empty): consumablestock, consumablestock_inventory.

Tactile stimulator

  • type code TactileStimulator · version 1.0.3 · schema

The configured arrangement applying mechanical stimuli.

PropertyTitleShapeRequiredAllowed valuesMeaning
stimulusTypesStimulation typesmulti-select one of whisker_poke, whisker_deflection, air_puff, brush, vibration, pressure_pad, cotton_swab, other; format select2Select the types of tactile stimuli delivered through this interface. Multiple types can be listed if applicable.
stimulationSiteStimulation sitetext  The anatomical region where tactile stimuli were applied (e.g., ‘whisker pad’, ‘hindpaw’, ‘tail’).
deliveryMethodDelivery methodchoice one of manual, piezo_actuator, solenoid_piston, air_puff, brush_probe, otherThe method or device used to deliver the tactile stimulus to the subject.
stimulationContextStimulation contextchoice one of passive, behavioral_task, closed_loop, anesthetized, free_behaviorExperimental context in which tactile stimulation occurred.
paradigmDescriptionParadigm descriptiontext (multi-line)  Free-text description of the tactile stimulation paradigm, including stimulus timing, frequency, devices used, and behavioral conditions.

Illustrative payload:

{
    "stimulusTypes": [
        "whisker_poke"
    ],
    "stimulationSite": "text"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

Thermal probe

  • type code ThermalProbe · version 2.0.1 · schema

A probe heating or cooling the target.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
temperatureRangeTemperature rangetext  The operating or measurement temperature range of the configured thermal probe.
contactSiteContact sitetext  The anatomical or specimen site contacted by the thermal probe.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "temperatureRange": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
TemperatureSensor (Temperature probe or sensor)yes ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeConsumableDevice, ImplantMaterial, OpticalComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Ultrasound transducer

  • type code UltrasoundTransducer · version 2.0.1 · schema

A transducer delivering focused ultrasound to the target.

PropertyTitleShapeRequiredAllowed valuesMeaning
deviceIdentifierDevice identifiertext  The device’s own identifier: the manufacturer’s serial number, or the code the lab marks on the hardware and writes on the cage card and the surgery sheet. This is not the name given to this record.
centerFrequencyMhzCenter frequency (MHz)number ≥ 0The transducer centre frequency in megahertz.
focusFocustext  The focal geometry or focal distance of the configured transducer.

Illustrative payload:

{
    "deviceIdentifier": "text",
    "centerFrequencyMhz": 1.0
}
  • Fields hidden by the web form for this type (leave empty): consumablestock, consumablestock_inventory.

Visual stimulator

  • type code VisualStimulator · version 1.0.3 · schema

The configured arrangement presenting visual stimuli.

PropertyTitleShapeRequiredAllowed valuesMeaning
stimulusTypesStimulus typesmulti-select one of gratings, natural_images, led_flashes, checkerboard, full_field_flashes, moving_bars, flicker, other; format select2Select the visual stimulus types delivered through this interface. Multiple types may be selected.
presentationDevicePresentation devicechoice one of monitor, led_panel, projector, head_mounted_display, fiber_coupled_light, otherDevice or method used to present the visual stimuli to the subject.
stimulationPositionStimulus positionchoice one of contralateral, ipsilateral, bilateral, centered, surround, other, unknownRelative visual field position where the stimulus was presented with respect to the subject.
stimulationContextStimulation contextchoice one of passive, behavioral_task, closed_loop, anesthetized, free_behaviorExperimental condition in which visual stimulation occurred.
paradigmDescriptionParadigm descriptiontext (multi-line)  Free-text description of the visual stimulation paradigm, including stimulus sequence, timing, and behavioral relevance.

Illustrative payload:

{
    "stimulusTypes": [
        "gratings"
    ],
    "presentationDevice": "monitor"
}
  • Fields hidden by the web form for this type (leave empty): coordinates, coordinates_json, target_regions, target_regions_atlas, consumablestock, consumablestock_inventory.

Generic

Generic interface

  • type code Generic · version 1.0.2 · schema

Use this only when no specific type above applies. Describe what the interface is and how it contacts the target in the configuration notes, because the type name will tell another user nothing.

PropertyTitleShapeRequiredAllowed valuesMeaning
interfaceIdInterface IDtext  The identifier assigned to this interface configuration.
configurationNotesConfiguration notestext (multi-line)  A concise description of configuration details not represented by structured fields.

Illustrative payload:

{
    "interfaceId": "text",
    "configurationNotes": "text"
}

Materials (material usage rows) allowed on this type:

Role (type)RequiredMaxFrom stock typesFrom catalog typesManualComplete when
GenericDevice (Other interface device)yes ConsumableDevice, EcogArray, ElectrodeComponent, ImplantMaterial, OpticFiber, OpticalComponent, SiliconProbe, SingleWireElectrodeConsumableDevice, EcogArrayDesign, ElectrodeComponent, ImplantMaterial, OpticFiberDesign, OpticalComponent, SiliconProbeDesign, SingleWireElectrodeyes 
FixedPositioningAssembly (Fixed implant carrier or shuttle)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ManualMicrodrive (Manual microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
MotorizedMicrodrive (Motorized microdrive)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
OtherComponent (Other installed component)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ReferenceElectrode (Reference electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
GroundElectrode (Ground electrode)  ElectrodeComponent, SingleWireElectrodeElectrodeComponent, SingleWireElectrodeyes 
ConnectorComponent (Connector component)  ConnectorComponentConnectorComponentyes 
Obturator (Obturator)  ConsumableDevice, ImplantMaterialConsumableDevice, ImplantMaterialyes 
ShieldingMaterial (Shielding material)  ImplantMaterial, ConsumableDeviceImplantMaterial, ConsumableDeviceyes 
AdhesiveSealant (Adhesive, cement, or sealant)  AdhesiveCementAdhesiveCementyes 
Fastener (Anchor screw, pin, or fastener)  FastenerAnchorFastenerAnchoryes 
ActiveAgent (Delivered agent)  PharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionPharmacologicalAgent, ChemicalReagent, PhysiologicalSolutionyes 
Other (Other material)    yes 
Coating (Coating)  TracerDye, ChemicalReagentTracerDye, ChemicalReagentyes 

Target specimens

  • type code TargetSpecimens · version 1.0.2 · schema
PropertyTitleShapeRequiredAllowed valuesMeaning
specimenIdSpecimen IDtext  The identifier of the specimen targeted by this interface entry.
roleRoletext  The role of the specimen in relation to the interface.
notesNotestext (multi-line)  A concise clarification specific to this target-specimen association.

Illustrative payload:

[
    {
        "specimenId": "text",
        "role": "text"
    }
]