Subject log types

Entry schemas for subject logs: measurements and observations followed over time for one subject.

Table of contents

Consumption Logs

Logs of food and water intake.

Food consumption log

Logs the amount of food a subject consumed, for tracking intake over time, for example during food restriction.

FieldDescription
Food amountRequired. Quantity with unit. Food amount consumed. Units: kg, g, mg, µg.

Water consumption log

Logs the amount of water a subject consumed, for tracking intake over time, for example during water restriction.

FieldDescription
Water amountRequired. Quantity with unit. Water amount consumed. Units: L, mL, µL, nL, pL.

Deprivation Logs

Logs of food or water restriction periods and the protocol governing them.

Food deprivation log

Logs periods of food restriction or deprivation, with the responsible person’s name and phone number and the protocol governing the deprivation.

FieldDescription
Responsible person (name and phone number)Required. Text. The name and contact number of the person responsible during the deprivation period.
ProtocolText. The approved or laboratory protocol governing this deprivation record.

Water deprivation log

Logs periods of water restriction or deprivation, with the responsible person’s name and phone number and the protocol governing the deprivation.

FieldDescription
Responsible person (name and phone number)Required. Text. The name and contact number of the person responsible during the deprivation period.
ProtocolText. The approved or laboratory protocol governing this deprivation record.

Experimental Preparation Logs

Logs of handling, habituation and training that prepare a subject for experiments.

Habituation log

Logs sessions habituating a subject before experiments, with the method used, such as tail lift, cupping or glove.

FieldDescription
Method of habituationText. E.g., tail lift, cupping, glove.

Handling log

Logs handling sessions, with the method used, such as tail lift, cupping or glove.

FieldDescription
Method of handlingText. E.g., tail lift, cupping, glove.

Training session log

Logs a behavioral training session, with the task, setup, reinforcement type and performance level reached.

FieldDescription
Task of the trainingText. The behavioral task practiced during this training session.
Setup of the trainingText. The apparatus or setup configuration used for this training session.
Reinforcement typeText. The reinforcement type used during training (e.g. food, water, open-loop/closed loop.
The performance levelText. The performance level of the training. How well the subject performs the task

Genetic Logs

Logs of genotyping results for a subject.

Genotyping log

Logs a genotyping result for the subject, with the interpreted genotype, the sample used, assay or panel, confidence and per-locus calls.

FieldDescription
Genotype resultRequired. Text. Overall interpreted genotype for this subject (e.g., ‘PV-Cre/wt; Ai32/wt; Sex: F’ or ‘Negative for PV-Cre’).
SampleRequired. Text. Describe the biological sample used for the genotyping assay, including type and location (e.g., tail snip, ear punch, blood sample).
Assay / panel nameText. Which PCR/qPCR panel or service was used.
QC / confidenceChoice. Confidence or quality of the genotyping result. Options: High, Medium, Low, Ambiguous, Failed.
Per-locus callsTable of rows. Per-locus genotype calls reported for this genotyping event.
Per-locus calls › Marker / transgene / alleleRequired. Text. The marker, transgene, or allele tested at this locus.
Per-locus calls › CallRequired. Text. The reported genotype call for this marker or locus.
Per-locus calls › NotesText. A concise qualification of this locus-level genotype call.

Housing Logs

Logs of a subject’s housing location and cage conditions.

Housing log

Logs where and how a subject is housed, with location, cage ID and type, light cycle and enrichment.

FieldDescription
LocationText. The location the subject is housed, e.g. an animal housing unit with a specific status.
Cage IDText. The ID of the cage where the subject is housed.
Cage typeText. The type of cage, e.g. an IVC cage with a specific model number, NexGen500 or NexGen1800.
Light cycleText. The light cycle of the housing unit, e.g. normal or reversed, or specific time points
EnrichmentText. Enrichment items in the cage such as nesting material, shelter, or something to gnaw.

Observation Logs

Logs of behavioral observations and sensory tests, including the Hargreaves and Von Frey nociception assays.

Generic observation

Logs a behavioral or other observation that no specific log type covers, with its category, a description and the number of repetitions.

FieldDescription
Observation typeRequired. Choice. The category or behavioral domain of the observation. Options: Pain score, Grooming, Exploration, Freezing, Facial expression, Unusual behavior, Other.
ObservationRequired. Text. Description of the observed behavior.
RepetitionsInteger. How many times this observation was recorded under the same condition. Range: ≥ 1.

Hargreaves thermal sensitivity test

Logs Hargreaves tests of thermal sensitivity, with stimulus location, paw withdrawal latency, cutoff latency, a 0 to 3 response score and the number of trials.

FieldDescription
Stimulus locationRequired. Choice. Anatomical location where the thermal stimulus was applied using the Hargreaves test. Options: Left hind paw, Right hind paw, Left forepaw, Right forepaw, Face (left), Face (right), Tail, Other.
Withdrawal latencyRequired. Quantity with unit. Time from stimulus onset to paw withdrawal. Units: µs, ms, s, min, h.
Cutoff latencyQuantity with unit. Maximum allowable latency before automatic termination to prevent tissue damage. Units: µs, ms, s, min, h.
Response score (0–3)Required. Choice. Categorical assessment of behavioral response. 0: No response, 1: Delayed movement, 2: Normal withdrawal, 3: Exaggerated or escape behavior Options: 0 - No response, 1 - Delayed or uncertain movement, 2 - Clear paw withdrawal, 3 - Exaggerated withdrawal or escape behavior. Range: ≥ 0 and ≤ 3.
RepetitionsInteger. Number of repeated Hargreaves trials at the given location. Range: ≥ 1.

Von Frey mechanical sensitivity test

Logs Von Frey tests of mechanical sensitivity, with stimulus location, filament force, a 0 to 3 response score and the number of repetitions.

FieldDescription
Stimulus locationRequired. Choice. Anatomical location where the Von Frey filament was applied. Options: Left hind paw, Right hind paw, Left forepaw, Right forepaw, Face (left), Face (right), Tail, Other.
Stimulus forceRequired. Quantity with unit. Force of the Von Frey filament used for mechanical stimulation. Units: mg, g, kg.
Response score (0–3)Required. Choice. Categorical assessment of behavioral response to stimulation. 0: No response, 1: Slight movement, 2: Strong withdrawal, 3: Flinching or escape Options: 0 - No response, 1 - Slight movement, 2 - Strong withdrawal, 3 - Flinching or escape. Range: ≥ 0 and ≤ 3.
RepetitionsInteger. Number of repetitions of Von Frey stimulation at the given location. Range: ≥ 1.

Physical and Health Logs

Logs of body weight, physical condition, wellness and clinical welfare assessments.

Monitoring log

Logs routine monitoring of a subject, combining body weight, food and water consumed, body condition score and general health notes.

FieldDescription
WeightQuantity with unit. Body weight of the subject. Units: kg, g, mg.
Food consumedQuantity with unit. Amount of food consumed since last measurement. Units: kg, g, mg.
Water consumedQuantity with unit. Amount of water consumed since last measurement. Units: L, mL, µL.
Body condition score (1-5)Choice. Manual visual/palpation body condition score (Ullman-Cullere scale). Assessed by the observer independently of body weight — 1 = emaciated, 3 = ideal, 5 = obese. Options: 1 - Emaciated, 2 - Underconditioned, 3 - Ideal, 4 - Overconditioned, 5 - Obese.
Health observationsText (multi-line). General health notes, appearance, and behaviour observations.

Weighing log

Logs the subject’s body weight. Use Monitoring to record weight together with consumption and health observations.

FieldDescription
WeightRequired. Quantity with unit. Weight of subject. Units: kg, g, mg, µg.

Welfare check

Logs a clinical welfare assessment, with abnormal signs, condition and pain scores, condition of wound or implant sites, actions taken, the monitoring plan and whether a humane endpoint was met.

FieldDescription
Clinical signsMulti-select. Tick all abnormal clinical signs observed. Neurological or motor signs (seizure, tremor, circling, ataxia, paresis, head tilt) may be model- or procedure-related. Leave empty if none observed. Options: Hunched posture, Poor grooming, Piloerection / ruffled coat, Discharge or porphyrin staining, Dehydrated appearance, Reduced food / water intake, Reduced mobility / abnormal gait, Laboured breathing, Seizure, Tremor, Circling, Ataxia, Paresis or paralysis, Abnormal head tilt, Self-injury / excessive scratching, Abnormal vocalisation, Other (see observations).
Actions takenRequired. Multi-select. Select all actions taken. Treatments, analgesia, antibiotics, fluids, or euthanasia should also be recorded as linked Procedure / ProcedureEpisode entries. Options: No action needed — within normal limits, Continue monitoring, Increase monitoring frequency, Husbandry support, Food or water support, Clinical treatment given, Analgesia given, Veterinarian notified, Veterinary assessment requested, Procedure / protocol paused, Withdrawn from study, Humane endpoint applied (euthanasia), Other.
Condition & demeanour (0-4)Required. Choice. Overall clinical condition and demeanour on the BAR/QAR scale, scored 0 (normal) to 4 (worst). This is a demeanour score, not a Body Condition Score — record body weight and body condition in the Monitoring log. • 0: Bright, alert, responsive — normal behaviour and activity. • 1: Quiet but responsive — mildly subdued, still aware and reactive. • 2: Subdued, reduced activity — noticeably less active; may show early hunching. • 3: Lethargic, reluctant to move — markedly reduced activity, hunched/isolated; indicates distress. • 4: Moribund or non-responsive — humane endpoint; record the action taken and notify the named veterinary surgeon. Options: 0 - Bright, alert, responsive (normal), 1 - Quiet but responsive, 2 - Subdued, reduced activity, 3 - Lethargic, reluctant to move, 4 - Moribund or non-responsive.
Monitoring planText. Monitoring plan following this check (frequency and duration).
Pain scoring methodChoice. Pain / distress scoring instrument used. The scale range differs between instruments (shown in each option), so the method is recorded alongside the score to keep it interpretable. Grimace scales should be scored in awake animals. Options: Not assessed, Clinical numerical rating scale (0-5), Mouse Grimace Scale (0-10), Rat Grimace Scale (0-8), Institutional score sheet, Other.
Pain scoreNumber. Pain / distress score on the selected scale (e.g. 4 on a Rat Grimace Scale of 0-8). Range: ≥ 0.
Procedure / wound site typeChoice. Kind of procedure that created the site being assessed. Categories mirror the Procedure type groups. Use ‘Other’ for non-procedure lesions (e.g. barbering or fight wounds). Options: Not applicable, Surgical site, Implant site (headcap, connector, electrode, fibre…), Injection / infusion site, Sample-collection site, Other.
Site observationText. Condition of the wound, surgical, implant, injection, or sample-collection site.
Endpoint criterionText. Which humane endpoint criterion was met, if any. These are protocol-defined and vary by study and species.
Humane endpoint criteria metRequired. Choice. Whether predefined humane endpoint criteria were met at this check. If ‘Yes’, record the criterion and the action taken. Options: No, Yes.

Wellness log

Logs a brief overall wellness status for the subject, such as good health, fair or poor.

FieldDescription
WellnessRequired. Text. The current wellness status of the subject, such as good health, fair, or poor.

API access

The same types are documented for API users, with property codes, versions and payload examples, on the SubjectLog schemas API page.