Subject log types

Multiple log types are available to track and record various aspects of subject care, behavior, and experimental conditions.

Table of contents

  1. Diet and Consumption Logs
    1. Food consumption log
    2. Water consumption log
  2. Deprivation Logs
    1. Food deprivation log
    2. Water deprivation log
  3. Housing and Environment Logs
    1. Housing log
  4. Observation Logs
    1. Von Frey Mechanical sensitivity test
    2. Hargreaves thermal sensitivity test
    3. Generic observation
  5. Physical and Health Logs
    1. Weighing log
    2. Wellness log
  6. Experimental Preparation Logs
    1. Habituation log
    2. Handling log
    3. Training session log
  7. API access

Multiple log types are available to track and record various aspects of subject care, behavior, and experimental conditions. Each log type captures specific information critical for maintaining subject welfare and experimental integrity.

Diet and Consumption Logs

Food consumption log

Records the amount of food consumed by the subject. This information is crucial for studies examining the effects of diet on health, behavior, or disease progression.

FieldDescription
Food amountAmount of food consumed (float, ≥ 0). Required field that tracks precise food intake

Water consumption log

Details the amount of water consumed by the subject. Monitoring water intake is essential for studies related to hydration, kidney function, or the effects of various substances on thirst.

FieldDescription
Water amountVolume of water consumed (float, ≥ 0). Required field tracking fluid intake

Deprivation Logs

Food deprivation log

Documents periods when food is withheld from the subject. Food deprivation can be used as a motivational tool in behavioral experiments or to study the physiological and psychological effects of fasting.

FieldDescription
Responsible personContact information of the person overseeing the deprivation (string). Required field for accountability
ProtocolDescription of the food deprivation procedure (string). Details the specific protocol being followed

Water deprivation log

Notes periods during which water is withheld from the subject. Similar to food deprivation, water deprivation can be used to study the effects of hydration status.

FieldDescription
Responsible personContact information of the person overseeing the deprivation (string). Required field for accountability
ProtocolDescription of the water deprivation procedure (string). Details the specific protocol followed

Housing and Environment Logs

Housing log

Keeps track of the subject’s living conditions, including cage type, location, and environmental enrichments. This log helps ensure consistent and ethical housing standards.

FieldDescription
LocationPhysical location of the subject’s housing (string). Specifies the exact housing unit location
Cage IDUnique identifier for the housing cage (string). Enables precise tracking of housing units
Cage typeSpecification of the cage model used (string). Details the exact cage configuration
Light cycleDescription of the lighting schedule (string). Specifies normal or reversed light cycles
EnrichmentEnvironmental enrichment details (string). Lists items provided for subject welfare

Observation Logs

Von Frey Mechanical sensitivity test

Documents mechanical sensitivity testing using Von Frey filaments to assess tactile responses and sensory thresholds.

FieldDescription
Stimulus locationAnatomical location where the Von Frey filament was applied (string; enum). Options include: Left hind paw, Right hind paw, Left forepaw, Right forepaw, Face (left), Face (right), Tail, Other
Stimulus forceForce of the Von Frey filament used for mechanical stimulation (float, ≥ 0). Required field
Response scoreCategorical assessment of behavioral response to stimulation (integer, 0-3). Required field. 0: No response, 1: Slight movement, 2: Strong withdrawal, 3: Flinching or escape
RepetitionsNumber of repetitions of Von Frey stimulation at the given location (integer, ≥ 1; default: 10)

Hargreaves thermal sensitivity test

Documents thermal sensitivity testing using the Hargreaves method to assess responses to heat stimuli.

FieldDescription
Stimulus locationAnatomical location where the thermal stimulus was applied (string; enum). Options include: Left hind paw, Right hind paw, Left forepaw, Right forepaw, Face (left), Face (right), Tail, Other
Withdrawal latencyTime from stimulus onset to paw withdrawal (float, ≥ 0). Required field measuring reaction time
Cutoff latencyMaximum allowable latency before automatic termination to prevent tissue damage (float, ≥ 0; default: 20)
Response scoreCategorical assessment of behavioral response (integer, 0-3). Required field. 0: No response, 1: Delayed movement, 2: Normal withdrawal, 3: Exaggerated or escape behavior
RepetitionsNumber of repeated Hargreaves trials at the given location (integer, ≥ 1; default: 3)

Generic observation

Documents general observations about the subject that don’t fit into specific categories, allowing for flexible recording of various events or behaviors.

FieldDescription
Observation typeType or category of observation being recorded (string; enum). Options include: Pain score, Grooming, Exploration, Freezing, Facial expression, Unusual behavior, Other. Required field
ObservationDescription of the observed behavior (string). Required field providing full context
RepetitionsHow many times this observation was recorded under the same condition (integer, ≥ 1; default: 1)

Physical and Health Logs

Weighing log

Records the subject’s body weight over time. Regular weighing is critical for monitoring health, growth, and the effects of experimental treatments.

FieldDescription
WeightSubject’s measured weight (float, ≥ 0). Required field tracking body mass

Wellness log

Documents observations related to the subject’s general health and well-being, including behavior, physical appearance, and signs of distress or illness.

FieldDescription
WellnessDescription of the subject’s health status (string). Required field documenting overall condition

Experimental Preparation Logs

Habituation log

Records habituation procedures used to acclimate subjects to handling or experimental conditions, reducing stress and improving data quality.

FieldDescription
Method of habituationTechnique used for habituation (string). Examples include: tail lift, cupping, glove

Handling log

Documents handling sessions and techniques used to manage subjects, ensuring consistent and humane treatment.

FieldDescription
Method of handlingTechnique used for handling the subject (string). Examples include: tail lift, cupping, glove

Training session log

Records training sessions conducted to prepare subjects for experimental tasks or procedures.

FieldDescription
Task of the trainingSpecific task or behavior being trained (string). Describes the training objective
Setup of the trainingConfiguration or environment used for training (string). Describes the training setup
Reinforcement typeType of reinforcement used during training (string). Examples include: food, water, open-loop/closed loop
The performance levelAssessment of subject’s performance during training (string). Describes how well the subject performs the task

API access

The API allows for programmable access to Subject logs, enabling you to read, edit, and delete subject logs through the API. Learn more about the subject logs’ fields and data structure on the Subject log API page.