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 · Water consumption log - Deprivation Logs: Logs of food or water restriction periods and the protocol governing them.
Food deprivation log · Water deprivation log - Experimental Preparation Logs: Logs of handling, habituation and training that prepare a subject for experiments.
Habituation log · Handling log · Training session log - Genetic Logs: Logs of genotyping results for a subject.
Genotyping log - Housing Logs: Logs of a subject’s housing location and cage conditions.
Housing log - Observation Logs: Logs of behavioral observations and sensory tests, including the Hargreaves and Von Frey nociception assays.
Generic observation · Hargreaves thermal sensitivity test · Von Frey mechanical sensitivity test - Physical and Health Logs: Logs of body weight, physical condition, wellness and clinical welfare assessments.
Monitoring log · Weighing log · Welfare check · Wellness log
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.
| Field | Description |
|---|---|
Food amount | Required. 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.
| Field | Description |
|---|---|
Water amount | Required. 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.
| Field | Description |
|---|---|
Responsible person (name and phone number) | Required. Text. The name and contact number of the person responsible during the deprivation period. |
Protocol | Text. 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.
| Field | Description |
|---|---|
Responsible person (name and phone number) | Required. Text. The name and contact number of the person responsible during the deprivation period. |
Protocol | Text. 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.
| Field | Description |
|---|---|
Method of habituation | Text. E.g., tail lift, cupping, glove. |
Handling log
Logs handling sessions, with the method used, such as tail lift, cupping or glove.
| Field | Description |
|---|---|
Method of handling | Text. E.g., tail lift, cupping, glove. |
Training session log
Logs a behavioral training session, with the task, setup, reinforcement type and performance level reached.
| Field | Description |
|---|---|
Task of the training | Text. The behavioral task practiced during this training session. |
Setup of the training | Text. The apparatus or setup configuration used for this training session. |
Reinforcement type | Text. The reinforcement type used during training (e.g. food, water, open-loop/closed loop. |
The performance level | Text. 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.
| Field | Description |
|---|---|
Genotype result | Required. Text. Overall interpreted genotype for this subject (e.g., ‘PV-Cre/wt; Ai32/wt; Sex: F’ or ‘Negative for PV-Cre’). |
Sample | Required. Text. Describe the biological sample used for the genotyping assay, including type and location (e.g., tail snip, ear punch, blood sample). |
Assay / panel name | Text. Which PCR/qPCR panel or service was used. |
QC / confidence | Choice. Confidence or quality of the genotyping result. Options: High, Medium, Low, Ambiguous, Failed. |
Per-locus calls | Table of rows. Per-locus genotype calls reported for this genotyping event. |
Per-locus calls › Marker / transgene / allele | Required. Text. The marker, transgene, or allele tested at this locus. |
Per-locus calls › Call | Required. Text. The reported genotype call for this marker or locus. |
Per-locus calls › Notes | Text. 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.
| Field | Description |
|---|---|
Location | Text. The location the subject is housed, e.g. an animal housing unit with a specific status. |
Cage ID | Text. The ID of the cage where the subject is housed. |
Cage type | Text. The type of cage, e.g. an IVC cage with a specific model number, NexGen500 or NexGen1800. |
Light cycle | Text. The light cycle of the housing unit, e.g. normal or reversed, or specific time points |
Enrichment | Text. 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.
| Field | Description |
|---|---|
Observation type | Required. Choice. The category or behavioral domain of the observation. Options: Pain score, Grooming, Exploration, Freezing, Facial expression, Unusual behavior, Other. |
Observation | Required. Text. Description of the observed behavior. |
Repetitions | Integer. 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.
| Field | Description |
|---|---|
Stimulus location | Required. 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 latency | Required. Quantity with unit. Time from stimulus onset to paw withdrawal. Units: µs, ms, s, min, h. |
Cutoff latency | Quantity 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. |
Repetitions | Integer. 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.
| Field | Description |
|---|---|
Stimulus location | Required. 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 force | Required. 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. |
Repetitions | Integer. 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.
| Field | Description |
|---|---|
Weight | Quantity with unit. Body weight of the subject. Units: kg, g, mg. |
Food consumed | Quantity with unit. Amount of food consumed since last measurement. Units: kg, g, mg. |
Water consumed | Quantity 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 observations | Text (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.
| Field | Description |
|---|---|
Weight | Required. 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.
| Field | Description |
|---|---|
Clinical signs | Multi-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 taken | Required. 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 plan | Text. Monitoring plan following this check (frequency and duration). |
Pain scoring method | Choice. 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 score | Number. Pain / distress score on the selected scale (e.g. 4 on a Rat Grimace Scale of 0-8). Range: ≥ 0. |
Procedure / wound site type | Choice. 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 observation | Text. Condition of the wound, surgical, implant, injection, or sample-collection site. |
Endpoint criterion | Text. Which humane endpoint criterion was met, if any. These are protocol-defined and vary by study and species. |
Humane endpoint criteria met | Required. 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.
| Field | Description |
|---|---|
Wellness | Required. 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.