Skip to content

[ENH] Additional age related columns for participants.tsv file to cover animal data contd.#2340

Draft
ree-gupta wants to merge 1 commit intobids-standard:masterfrom
ree-gupta:animal-data-columns
Draft

[ENH] Additional age related columns for participants.tsv file to cover animal data contd.#2340
ree-gupta wants to merge 1 commit intobids-standard:masterfrom
ree-gupta:animal-data-columns

Conversation

@ree-gupta
Copy link
Member

@ree-gupta ree-gupta commented Feb 5, 2026

Summary

This PR adds age-related columns and metadata to participants.tsv to better support animal data and clarify age specifications across species. Key additions include:

  • life_cycle_stage column with enums based on UBERON ontology (embryo, neonate, juvenile, adult, etc.)
  • AgeReference metadata field for participants.json to specify what the age value is relative to (birth, fertilization, LMP_startdate)
  • birthdate/birthtime and deathdate/deathtime optional columns
  • Schema rules to recommend AgeReference when age column is present

This is a continuation of #1839, which was accidentally closed due to a force-push.
Please refer to #1839 for the full discussion history and review comments. Since the commits were too many and too conflicting to do a rebase, only the final edits with a single commit was made to restore from this point. A backup with the history of the commits is here.

Related Issues

TODO:

  • Add the info that either birthdate or age should be specified - decision to keep birthdate as optional and if age is specified, AgeReference must be used in sidecar JSON
  • Feedback on term name to include 'stage' to match UBERON - deviate slighly from UBERON and not use 'stage' in the enum names
  • Confirm introduction of AgeReference rule in schema for participant.tsv
  • Which key to use for age column definition that would specify that one must use AgeReference in sidecar?
  • Default for 'AgeReference'
  • Add rule that either birthdate or age must be specified
  • Formalized 'TermURL' as suggested by @yarikoptic here - ??
  • Resolve conflicts (definition was used - different from description and enums use)

cc: @bids-standard/bep032 @lzehl @yarikoptic @bendichter

@ree-gupta ree-gupta changed the title [ENH] Additional age related columns for participants.tsv file to cover animal data #1839 contd. [ENH] Additional age related columns for participants.tsv file to cover animal data contd. Feb 5, 2026
…data

Add new optional columns to participants.tsv for richer age and life cycle metadata:
- birthdate/birthtime: Date and time of birth
- deathdate/deathtime: Date and time of death
- age_category: Life cycle stage (embryo, neonate, infant, juvenile, adult, etc.)

These columns support animal studies and developmental research where precise
life cycle information is important. Human subjects should anonymize or omit
sensitive fields like birthdate.

Life cycle stage enums are inspired by UBERON ontology.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@ree-gupta ree-gupta force-pushed the animal-data-columns branch from 43c52fc to d7d060d Compare February 5, 2026 06:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant