valuesets 0.3.1__py3-none-any.whl

valuesets/enums/chemistry/reaction_directionality.py

@@ -0,0 +1,65 @@
+"""
+Reaction Directionality
+
+Directionality of chemical reactions and processes
+
+Generated from: chemistry/reaction_directionality.yaml
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Any, Optional
+from valuesets.generators.rich_enum import RichEnum
+
+class RelativeTimeEnum(RichEnum):
+    # Enum members
+    BEFORE = "BEFORE"
+    AFTER = "AFTER"
+    AT_SAME_TIME_AS = "AT_SAME_TIME_AS"
+
+# Set metadata after class creation
+RelativeTimeEnum._metadata = {
+}
+
+class PresenceEnum(RichEnum):
+    # Enum members
+    PRESENT = "PRESENT"
+    ABSENT = "ABSENT"
+    BELOW_DETECTION_LIMIT = "BELOW_DETECTION_LIMIT"
+    ABOVE_DETECTION_LIMIT = "ABOVE_DETECTION_LIMIT"
+
+# Set metadata after class creation
+PresenceEnum._metadata = {
+    "PRESENT": {'description': 'The entity is present'},
+    "ABSENT": {'description': 'The entity is absent'},
+    "BELOW_DETECTION_LIMIT": {'description': 'The entity is below the detection limit'},
+    "ABOVE_DETECTION_LIMIT": {'description': 'The entity is above the detection limit'},
+}
+
+class ReactionDirectionality(RichEnum):
+    """
+    The directionality of a chemical reaction or process
+    """
+    # Enum members
+    LEFT_TO_RIGHT = "LEFT_TO_RIGHT"
+    RIGHT_TO_LEFT = "RIGHT_TO_LEFT"
+    BIDIRECTIONAL = "BIDIRECTIONAL"
+    AGNOSTIC = "AGNOSTIC"
+    IRREVERSIBLE_LEFT_TO_RIGHT = "IRREVERSIBLE_LEFT_TO_RIGHT"
+    IRREVERSIBLE_RIGHT_TO_LEFT = "IRREVERSIBLE_RIGHT_TO_LEFT"
+
+# Set metadata after class creation
+ReactionDirectionality._metadata = {
+    "LEFT_TO_RIGHT": {'description': 'Reaction proceeds from left to right (forward direction)', 'aliases': ['LR', 'forward', '-->']},
+    "RIGHT_TO_LEFT": {'description': 'Reaction proceeds from right to left (reverse direction)', 'aliases': ['RL', 'reverse', 'backward', '<--']},
+    "BIDIRECTIONAL": {'description': 'Reaction can proceed in both directions', 'aliases': ['BIDI', 'reversible', '<-->']},
+    "AGNOSTIC": {'description': 'Direction is unknown or not specified', 'aliases': ['unknown', 'unspecified']},
+    "IRREVERSIBLE_LEFT_TO_RIGHT": {'description': 'Reaction proceeds only from left to right and cannot be reversed', 'aliases': ['irreversible forward', '->>']},
+    "IRREVERSIBLE_RIGHT_TO_LEFT": {'description': 'Reaction proceeds only from right to left and cannot be reversed', 'aliases': ['irreversible reverse', '<<-']},
+}
+
+__all__ = [
+    "RelativeTimeEnum",
+    "PresenceEnum",
+    "ReactionDirectionality",
+]

valuesets/enums/chemistry/reactions.py

@@ -0,0 +1,256 @@
+"""
+Chemical Reactions Value Sets
+
+Value sets for chemical reactions, reaction types, mechanisms, and kinetics.
+
+
+Generated from: chemistry/reactions.yaml
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Any, Optional
+from valuesets.generators.rich_enum import RichEnum
+
+class ReactionTypeEnum(RichEnum):
+    """
+    Types of chemical reactions
+    """
+    # Enum members
+    SYNTHESIS = "SYNTHESIS"
+    DECOMPOSITION = "DECOMPOSITION"
+    SINGLE_DISPLACEMENT = "SINGLE_DISPLACEMENT"
+    DOUBLE_DISPLACEMENT = "DOUBLE_DISPLACEMENT"
+    COMBUSTION = "COMBUSTION"
+    SUBSTITUTION = "SUBSTITUTION"
+    ELIMINATION = "ELIMINATION"
+    ADDITION = "ADDITION"
+    REARRANGEMENT = "REARRANGEMENT"
+    OXIDATION = "OXIDATION"
+    REDUCTION = "REDUCTION"
+    DIELS_ALDER = "DIELS_ALDER"
+    FRIEDEL_CRAFTS = "FRIEDEL_CRAFTS"
+    GRIGNARD = "GRIGNARD"
+    WITTIG = "WITTIG"
+    ALDOL = "ALDOL"
+    MICHAEL_ADDITION = "MICHAEL_ADDITION"
+
+# Set metadata after class creation
+ReactionTypeEnum._metadata = {
+    "SYNTHESIS": {'description': 'Combination reaction (A + B → AB)', 'annotations': {'aliases': 'combination, addition', 'pattern': 'A + B → AB'}},
+    "DECOMPOSITION": {'description': 'Breakdown reaction (AB → A + B)', 'annotations': {'aliases': 'analysis', 'pattern': 'AB → A + B'}},
+    "SINGLE_DISPLACEMENT": {'description': 'Single replacement reaction (A + BC → AC + B)', 'annotations': {'aliases': 'single replacement', 'pattern': 'A + BC → AC + B'}},
+    "DOUBLE_DISPLACEMENT": {'description': 'Double replacement reaction (AB + CD → AD + CB)', 'annotations': {'aliases': 'double replacement, metathesis', 'pattern': 'AB + CD → AD + CB'}},
+    "COMBUSTION": {'description': 'Reaction with oxygen producing heat and light', 'annotations': {'reactant': 'oxygen', 'products': 'usually CO2 and H2O'}},
+    "SUBSTITUTION": {'description': 'Replacement of one group by another', 'meaning': 'MOP:0000790', 'annotations': {'subtypes': 'SN1, SN2, SNAr'}},
+    "ELIMINATION": {'description': 'Removal of atoms/groups forming double bond', 'meaning': 'MOP:0000656', 'annotations': {'subtypes': 'E1, E2, E1cB'}},
+    "ADDITION": {'description': 'Addition to multiple bond', 'meaning': 'MOP:0000642', 'annotations': {'subtypes': 'electrophilic, nucleophilic, radical'}},
+    "REARRANGEMENT": {'description': 'Reorganization of molecular structure', 'annotations': {'examples': 'Claisen, Cope, Wagner-Meerwein'}},
+    "OXIDATION": {'description': 'Loss of electrons or increase in oxidation state', 'annotations': {'electron_change': 'loss'}},
+    "REDUCTION": {'description': 'Gain of electrons or decrease in oxidation state', 'annotations': {'electron_change': 'gain'}},
+    "DIELS_ALDER": {'description': '[4+2] cycloaddition reaction', 'meaning': 'RXNO:0000006', 'annotations': {'type': 'pericyclic', 'components': 'diene + dienophile'}},
+    "FRIEDEL_CRAFTS": {'description': 'Electrophilic aromatic substitution', 'meaning': 'RXNO:0000369', 'annotations': {'subtypes': 'alkylation, acylation'}},
+    "GRIGNARD": {'description': 'Organometallic addition reaction', 'meaning': 'RXNO:0000014', 'annotations': {'reagent': 'RMgX'}},
+    "WITTIG": {'description': 'Alkene formation from phosphonium ylide', 'meaning': 'RXNO:0000015', 'annotations': {'product': 'alkene'}},
+    "ALDOL": {'description': 'Condensation forming β-hydroxy carbonyl', 'meaning': 'RXNO:0000017', 'annotations': {'mechanism': 'enolate addition'}},
+    "MICHAEL_ADDITION": {'description': '1,4-addition to α,β-unsaturated carbonyl', 'meaning': 'RXNO:0000009', 'annotations': {'type': 'conjugate addition'}},
+}
+
+class ReactionMechanismEnum(RichEnum):
+    """
+    Reaction mechanism types
+    """
+    # Enum members
+    SN1 = "SN1"
+    SN2 = "SN2"
+    E1 = "E1"
+    E2 = "E2"
+    E1CB = "E1CB"
+    RADICAL = "RADICAL"
+    PERICYCLIC = "PERICYCLIC"
+    ELECTROPHILIC_AROMATIC = "ELECTROPHILIC_AROMATIC"
+    NUCLEOPHILIC_AROMATIC = "NUCLEOPHILIC_AROMATIC"
+    ADDITION_ELIMINATION = "ADDITION_ELIMINATION"
+
+# Set metadata after class creation
+ReactionMechanismEnum._metadata = {
+    "SN1": {'description': 'Unimolecular nucleophilic substitution', 'annotations': {'rate_determining': 'carbocation formation', 'stereochemistry': 'racemization'}},
+    "SN2": {'description': 'Bimolecular nucleophilic substitution', 'annotations': {'rate_determining': 'concerted', 'stereochemistry': 'inversion'}},
+    "E1": {'description': 'Unimolecular elimination', 'annotations': {'intermediate': 'carbocation'}},
+    "E2": {'description': 'Bimolecular elimination', 'annotations': {'requirement': 'antiperiplanar'}},
+    "E1CB": {'description': 'Elimination via conjugate base', 'annotations': {'intermediate': 'carbanion'}},
+    "RADICAL": {'description': 'Free radical mechanism', 'annotations': {'initiation': 'homolytic cleavage'}},
+    "PERICYCLIC": {'description': 'Concerted cyclic electron reorganization', 'annotations': {'examples': 'Diels-Alder, Cope'}},
+    "ELECTROPHILIC_AROMATIC": {'description': 'Electrophilic aromatic substitution', 'annotations': {'intermediate': 'arenium ion'}},
+    "NUCLEOPHILIC_AROMATIC": {'description': 'Nucleophilic aromatic substitution', 'annotations': {'requirement': 'electron-withdrawing groups'}},
+    "ADDITION_ELIMINATION": {'description': 'Addition followed by elimination', 'annotations': {'intermediate': 'tetrahedral'}},
+}
+
+class CatalystTypeEnum(RichEnum):
+    """
+    Types of catalysts
+    """
+    # Enum members
+    HOMOGENEOUS = "HOMOGENEOUS"
+    HETEROGENEOUS = "HETEROGENEOUS"
+    ENZYME = "ENZYME"
+    ORGANOCATALYST = "ORGANOCATALYST"
+    PHOTOCATALYST = "PHOTOCATALYST"
+    PHASE_TRANSFER = "PHASE_TRANSFER"
+    ACID = "ACID"
+    BASE = "BASE"
+    METAL = "METAL"
+    BIFUNCTIONAL = "BIFUNCTIONAL"
+
+# Set metadata after class creation
+CatalystTypeEnum._metadata = {
+    "HOMOGENEOUS": {'description': 'Catalyst in same phase as reactants', 'annotations': {'phase': 'same as reactants', 'examples': 'acid, base, metal complexes'}},
+    "HETEROGENEOUS": {'description': 'Catalyst in different phase from reactants', 'annotations': {'phase': 'different from reactants', 'examples': 'Pt/Pd on carbon, zeolites'}},
+    "ENZYME": {'description': 'Biological catalyst', 'meaning': 'CHEBI:23357', 'annotations': {'type': 'protein', 'specificity': 'high'}},
+    "ORGANOCATALYST": {'description': 'Small organic molecule catalyst', 'annotations': {'metal_free': 'true', 'examples': 'proline, thiourea'}},
+    "PHOTOCATALYST": {'description': 'Light-activated catalyst', 'annotations': {'activation': 'light', 'examples': 'TiO2, Ru complexes'}},
+    "PHASE_TRANSFER": {'description': 'Catalyst facilitating reaction between phases', 'annotations': {'function': 'transfers reactant between phases'}},
+    "ACID": {'description': 'Acid catalyst', 'annotations': {'mechanism': 'proton donation'}},
+    "BASE": {'description': 'Base catalyst', 'annotations': {'mechanism': 'proton abstraction'}},
+    "METAL": {'description': 'Metal catalyst', 'annotations': {'examples': 'Pd, Pt, Ni, Ru'}},
+    "BIFUNCTIONAL": {'description': 'Catalyst with two active sites', 'annotations': {'sites': 'multiple'}},
+}
+
+class ReactionConditionEnum(RichEnum):
+    """
+    Reaction conditions
+    """
+    # Enum members
+    ROOM_TEMPERATURE = "ROOM_TEMPERATURE"
+    REFLUX = "REFLUX"
+    CRYOGENIC = "CRYOGENIC"
+    HIGH_PRESSURE = "HIGH_PRESSURE"
+    VACUUM = "VACUUM"
+    INERT_ATMOSPHERE = "INERT_ATMOSPHERE"
+    MICROWAVE = "MICROWAVE"
+    ULTRASOUND = "ULTRASOUND"
+    PHOTOCHEMICAL = "PHOTOCHEMICAL"
+    ELECTROCHEMICAL = "ELECTROCHEMICAL"
+    FLOW = "FLOW"
+    BATCH = "BATCH"
+
+# Set metadata after class creation
+ReactionConditionEnum._metadata = {
+    "ROOM_TEMPERATURE": {'description': 'Standard room temperature (20-25°C)', 'annotations': {'temperature': '20-25°C'}},
+    "REFLUX": {'description': 'Boiling with condensation return', 'annotations': {'temperature': 'solvent boiling point'}},
+    "CRYOGENIC": {'description': 'Very low temperature conditions', 'annotations': {'temperature': '<-150°C', 'examples': 'liquid N2, liquid He'}},
+    "HIGH_PRESSURE": {'description': 'Elevated pressure conditions', 'annotations': {'pressure': '>10 atm'}},
+    "VACUUM": {'description': 'Reduced pressure conditions', 'annotations': {'pressure': '<1 atm'}},
+    "INERT_ATMOSPHERE": {'description': 'Non-reactive gas atmosphere', 'annotations': {'gases': 'N2, Ar'}},
+    "MICROWAVE": {'description': 'Microwave heating', 'annotations': {'heating': 'microwave irradiation'}},
+    "ULTRASOUND": {'description': 'Ultrasonic conditions', 'annotations': {'activation': 'ultrasound'}},
+    "PHOTOCHEMICAL": {'description': 'Light-induced conditions', 'annotations': {'activation': 'UV or visible light'}},
+    "ELECTROCHEMICAL": {'description': 'Electrically driven conditions', 'annotations': {'activation': 'electric current'}},
+    "FLOW": {'description': 'Continuous flow conditions', 'annotations': {'type': 'continuous process'}},
+    "BATCH": {'description': 'Batch reaction conditions', 'annotations': {'type': 'batch process'}},
+}
+
+class ReactionRateOrderEnum(RichEnum):
+    """
+    Reaction rate orders
+    """
+    # Enum members
+    ZERO_ORDER = "ZERO_ORDER"
+    FIRST_ORDER = "FIRST_ORDER"
+    SECOND_ORDER = "SECOND_ORDER"
+    PSEUDO_FIRST_ORDER = "PSEUDO_FIRST_ORDER"
+    FRACTIONAL_ORDER = "FRACTIONAL_ORDER"
+    MIXED_ORDER = "MIXED_ORDER"
+
+# Set metadata after class creation
+ReactionRateOrderEnum._metadata = {
+    "ZERO_ORDER": {'description': 'Rate independent of concentration', 'annotations': {'rate_law': 'rate = k', 'integrated': '[A] = [A]₀ - kt'}},
+    "FIRST_ORDER": {'description': 'Rate proportional to concentration', 'annotations': {'rate_law': 'rate = k[A]', 'integrated': 'ln[A] = ln[A]₀ - kt'}},
+    "SECOND_ORDER": {'description': 'Rate proportional to concentration squared', 'annotations': {'rate_law': 'rate = k[A]²', 'integrated': '1/[A] = 1/[A]₀ + kt'}},
+    "PSEUDO_FIRST_ORDER": {'description': 'Apparent first order (excess reagent)', 'annotations': {'condition': 'one reagent in large excess'}},
+    "FRACTIONAL_ORDER": {'description': 'Non-integer order', 'annotations': {'indicates': 'complex mechanism'}},
+    "MIXED_ORDER": {'description': 'Different orders for different reactants', 'annotations': {'example': 'rate = k[A][B]²'}},
+}
+
+class EnzymeClassEnum(RichEnum):
+    """
+    EC enzyme classification
+    """
+    # Enum members
+    OXIDOREDUCTASE = "OXIDOREDUCTASE"
+    TRANSFERASE = "TRANSFERASE"
+    HYDROLASE = "HYDROLASE"
+    LYASE = "LYASE"
+    ISOMERASE = "ISOMERASE"
+    LIGASE = "LIGASE"
+    TRANSLOCASE = "TRANSLOCASE"
+
+# Set metadata after class creation
+EnzymeClassEnum._metadata = {
+    "OXIDOREDUCTASE": {'description': 'Catalyzes oxidation-reduction reactions', 'meaning': 'EC:1', 'annotations': {'EC_class': '1', 'examples': 'dehydrogenases, oxidases'}},
+    "TRANSFERASE": {'description': 'Catalyzes group transfer reactions', 'meaning': 'EC:2', 'annotations': {'EC_class': '2', 'examples': 'kinases, transaminases'}},
+    "HYDROLASE": {'description': 'Catalyzes hydrolysis reactions', 'meaning': 'EC:3', 'annotations': {'EC_class': '3', 'examples': 'proteases, lipases'}},
+    "LYASE": {'description': 'Catalyzes non-hydrolytic additions/removals', 'meaning': 'EC:4', 'annotations': {'EC_class': '4', 'examples': 'decarboxylases, aldolases'}},
+    "ISOMERASE": {'description': 'Catalyzes isomerization reactions', 'meaning': 'EC:5', 'annotations': {'EC_class': '5', 'examples': 'racemases, epimerases'}},
+    "LIGASE": {'description': 'Catalyzes formation of bonds with ATP', 'meaning': 'EC:6', 'annotations': {'EC_class': '6', 'examples': 'synthetases, carboxylases'}},
+    "TRANSLOCASE": {'description': 'Catalyzes movement across membranes', 'meaning': 'EC:7', 'annotations': {'EC_class': '7', 'examples': 'ATPases, ion pumps'}},
+}
+
+class SolventClassEnum(RichEnum):
+    """
+    Classes of solvents
+    """
+    # Enum members
+    PROTIC = "PROTIC"
+    APROTIC_POLAR = "APROTIC_POLAR"
+    APROTIC_NONPOLAR = "APROTIC_NONPOLAR"
+    IONIC_LIQUID = "IONIC_LIQUID"
+    SUPERCRITICAL = "SUPERCRITICAL"
+    AQUEOUS = "AQUEOUS"
+    ORGANIC = "ORGANIC"
+    GREEN = "GREEN"
+
+# Set metadata after class creation
+SolventClassEnum._metadata = {
+    "PROTIC": {'description': 'Solvents with acidic hydrogen', 'annotations': {'H_bonding': 'donor', 'examples': 'water, alcohols, acids'}},
+    "APROTIC_POLAR": {'description': 'Polar solvents without acidic H', 'annotations': {'H_bonding': 'acceptor only', 'examples': 'DMSO, DMF, acetone'}},
+    "APROTIC_NONPOLAR": {'description': 'Nonpolar solvents', 'annotations': {'H_bonding': 'none', 'examples': 'hexane, benzene, CCl4'}},
+    "IONIC_LIQUID": {'description': 'Room temperature ionic liquids', 'annotations': {'state': 'liquid salt', 'examples': 'imidazolium salts'}},
+    "SUPERCRITICAL": {'description': 'Supercritical fluids', 'annotations': {'state': 'supercritical', 'examples': 'scCO2, scH2O'}},
+    "AQUEOUS": {'description': 'Water-based solvents', 'annotations': {'base': 'water'}},
+    "ORGANIC": {'description': 'Organic solvents', 'annotations': {'base': 'organic compounds'}},
+    "GREEN": {'description': 'Environmentally friendly solvents', 'annotations': {'property': 'low environmental impact', 'examples': 'water, ethanol, scCO2'}},
+}
+
+class ThermodynamicParameterEnum(RichEnum):
+    """
+    Thermodynamic parameters
+    """
+    # Enum members
+    ENTHALPY = "ENTHALPY"
+    ENTROPY = "ENTROPY"
+    GIBBS_ENERGY = "GIBBS_ENERGY"
+    ACTIVATION_ENERGY = "ACTIVATION_ENERGY"
+    HEAT_CAPACITY = "HEAT_CAPACITY"
+    INTERNAL_ENERGY = "INTERNAL_ENERGY"
+
+# Set metadata after class creation
+ThermodynamicParameterEnum._metadata = {
+    "ENTHALPY": {'description': 'Heat content (ΔH)', 'annotations': {'symbol': 'ΔH', 'units': 'kJ/mol'}},
+    "ENTROPY": {'description': 'Disorder (ΔS)', 'annotations': {'symbol': 'ΔS', 'units': 'J/mol·K'}},
+    "GIBBS_ENERGY": {'description': 'Free energy (ΔG)', 'annotations': {'symbol': 'ΔG', 'units': 'kJ/mol'}},
+    "ACTIVATION_ENERGY": {'description': 'Energy barrier (Ea)', 'annotations': {'symbol': 'Ea', 'units': 'kJ/mol'}},
+    "HEAT_CAPACITY": {'description': 'Heat capacity (Cp)', 'annotations': {'symbol': 'Cp', 'units': 'J/mol·K'}},
+    "INTERNAL_ENERGY": {'description': 'Internal energy (ΔU)', 'annotations': {'symbol': 'ΔU', 'units': 'kJ/mol'}},
+}
+
+__all__ = [
+    "ReactionTypeEnum",
+    "ReactionMechanismEnum",
+    "CatalystTypeEnum",
+    "ReactionConditionEnum",
+    "ReactionRateOrderEnum",
+    "EnzymeClassEnum",
+    "SolventClassEnum",
+    "ThermodynamicParameterEnum",
+]

valuesets/enums/clinical/__init__.py

@@ -0,0 +1 @@
+"""Auto-generated package."""

valuesets/enums/clinical/nih_demographics.py

@@ -0,0 +1,177 @@
+"""
+NIH Demographics and Common Data Elements
+
+Standard value sets for NIH Common Data Elements (CDEs) including demographics,
+race, ethnicity, sex, and other clinical variables following NIH and OMB standards
+
+Generated from: clinical/nih_demographics.yaml
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Any, Optional
+from valuesets.generators.rich_enum import RichEnum
+
+class RaceOMB1997Enum(RichEnum):
+    """
+    Race categories following OMB 1997 standards used by NIH and federal agencies.
+    Respondents may select multiple races.
+    """
+    # Enum members
+    AMERICAN_INDIAN_OR_ALASKA_NATIVE = "AMERICAN_INDIAN_OR_ALASKA_NATIVE"
+    ASIAN = "ASIAN"
+    BLACK_OR_AFRICAN_AMERICAN = "BLACK_OR_AFRICAN_AMERICAN"
+    NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER = "NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER"
+    WHITE = "WHITE"
+    MORE_THAN_ONE_RACE = "MORE_THAN_ONE_RACE"
+    UNKNOWN_OR_NOT_REPORTED = "UNKNOWN_OR_NOT_REPORTED"
+
+# Set metadata after class creation
+RaceOMB1997Enum._metadata = {
+    "AMERICAN_INDIAN_OR_ALASKA_NATIVE": {'description': 'A person having origins in any of the original peoples of North and South America (including Central America), and who maintains tribal affiliation or community attachment', 'meaning': 'NCIT:C41259', 'annotations': {'omb_code': '1002-5'}},
+    "ASIAN": {'description': 'A person having origins in any of the original peoples of the Far East, Southeast Asia, or the Indian subcontinent', 'meaning': 'NCIT:C41260', 'annotations': {'omb_code': '2028-9', 'includes': 'Cambodia, China, India, Japan, Korea, Malaysia, Pakistan, Philippine Islands, Thailand, Vietnam'}},
+    "BLACK_OR_AFRICAN_AMERICAN": {'description': 'A person having origins in any of the black racial groups of Africa', 'meaning': 'NCIT:C16352', 'annotations': {'omb_code': '2054-5'}},
+    "NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER": {'description': 'A person having origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands', 'meaning': 'NCIT:C41219', 'annotations': {'omb_code': '2076-8'}},
+    "WHITE": {'description': 'A person having origins in any of the original peoples of Europe, the Middle East, or North Africa', 'meaning': 'NCIT:C41261', 'annotations': {'omb_code': '2106-3'}},
+    "MORE_THAN_ONE_RACE": {'description': 'Person identifies with more than one race category', 'meaning': 'NCIT:C67109', 'annotations': {'note': 'Added after 1997 revision to allow multiple race reporting'}},
+    "UNKNOWN_OR_NOT_REPORTED": {'description': 'Race not known, not reported, or declined to answer', 'meaning': 'NCIT:C17998', 'annotations': {'aliases': 'Unknown, Not Reported, Prefer not to answer'}},
+}
+
+class EthnicityOMB1997Enum(RichEnum):
+    """
+    Ethnicity categories following OMB 1997 standards used by NIH and federal agencies
+    """
+    # Enum members
+    HISPANIC_OR_LATINO = "HISPANIC_OR_LATINO"
+    NOT_HISPANIC_OR_LATINO = "NOT_HISPANIC_OR_LATINO"
+    UNKNOWN_OR_NOT_REPORTED = "UNKNOWN_OR_NOT_REPORTED"
+
+# Set metadata after class creation
+EthnicityOMB1997Enum._metadata = {
+    "HISPANIC_OR_LATINO": {'description': 'A person of Cuban, Mexican, Puerto Rican, South or Central American, or other Spanish culture or origin, regardless of race', 'meaning': 'NCIT:C17459', 'annotations': {'omb_code': '2135-2'}},
+    "NOT_HISPANIC_OR_LATINO": {'description': 'A person not of Hispanic or Latino origin', 'meaning': 'NCIT:C41222', 'annotations': {'omb_code': '2186-5'}},
+    "UNKNOWN_OR_NOT_REPORTED": {'description': 'Ethnicity not known, not reported, or declined to answer', 'meaning': 'NCIT:C17998', 'annotations': {'aliases': 'Unknown, Not Reported, Prefer not to answer'}},
+}
+
+class BiologicalSexEnum(RichEnum):
+    """
+    Biological sex assigned at birth based on anatomical and physiological traits.
+    Required by NIH as a biological variable in research.
+    """
+    # Enum members
+    MALE = "MALE"
+    FEMALE = "FEMALE"
+    INTERSEX = "INTERSEX"
+    UNKNOWN_OR_NOT_REPORTED = "UNKNOWN_OR_NOT_REPORTED"
+
+# Set metadata after class creation
+BiologicalSexEnum._metadata = {
+    "MALE": {'description': 'Male sex assigned at birth', 'meaning': 'PATO:0000384'},
+    "FEMALE": {'description': 'Female sex assigned at birth', 'meaning': 'PATO:0000383'},
+    "INTERSEX": {'description': "Born with reproductive or sexual anatomy that doesn't fit typical definitions of male or female", 'meaning': 'NCIT:C45908', 'annotations': {'prevalence': '0.018% to 1.7%', 'note': 'May be assigned male or female at birth'}},
+    "UNKNOWN_OR_NOT_REPORTED": {'description': 'Sex not known, not reported, or declined to answer', 'meaning': 'NCIT:C17998'},
+}
+
+class AgeGroupEnum(RichEnum):
+    """
+    Standard age groups used in NIH clinical research, particularly NINDS CDEs
+    """
+    # Enum members
+    NEONATE = "NEONATE"
+    INFANT = "INFANT"
+    YOUNG_PEDIATRIC = "YOUNG_PEDIATRIC"
+    PEDIATRIC = "PEDIATRIC"
+    ADOLESCENT = "ADOLESCENT"
+    YOUNG_ADULT = "YOUNG_ADULT"
+    ADULT = "ADULT"
+    OLDER_ADULT = "OLDER_ADULT"
+
+# Set metadata after class creation
+AgeGroupEnum._metadata = {
+    "NEONATE": {'description': 'Birth to 28 days', 'meaning': 'NCIT:C16731', 'annotations': {'max_age_days': 28}},
+    "INFANT": {'description': '29 days to less than 1 year', 'meaning': 'NCIT:C27956', 'annotations': {'min_age_days': 29, 'max_age_years': 1}},
+    "YOUNG_PEDIATRIC": {'description': '0 to 5 years (NINDS CDE definition)', 'meaning': 'NCIT:C39299', 'annotations': {'min_age_years': 0, 'max_age_years': 5, 'ninds_category': True}},
+    "PEDIATRIC": {'description': '6 to 12 years (NINDS CDE definition)', 'meaning': 'NCIT:C16423', 'annotations': {'min_age_years': 6, 'max_age_years': 12, 'ninds_category': True}},
+    "ADOLESCENT": {'description': '13 to 17 years', 'meaning': 'NCIT:C27954', 'annotations': {'min_age_years': 13, 'max_age_years': 17}},
+    "YOUNG_ADULT": {'description': '18 to 24 years', 'meaning': 'NCIT:C91107', 'annotations': {'min_age_years': 18, 'max_age_years': 24}},
+    "ADULT": {'description': '25 to 64 years', 'meaning': 'NCIT:C17600', 'annotations': {'min_age_years': 25, 'max_age_years': 64}},
+    "OLDER_ADULT": {'description': '65 years and older', 'meaning': 'NCIT:C16268', 'annotations': {'min_age_years': 65, 'aliases': 'Geriatric, Elderly, Senior'}},
+}
+
+class ParticipantVitalStatusEnum(RichEnum):
+    """
+    Vital status of a research participant in clinical studies
+    """
+    # Enum members
+    ALIVE = "ALIVE"
+    DECEASED = "DECEASED"
+    UNKNOWN = "UNKNOWN"
+
+# Set metadata after class creation
+ParticipantVitalStatusEnum._metadata = {
+    "ALIVE": {'description': 'Participant is living', 'meaning': 'NCIT:C37987'},
+    "DECEASED": {'description': 'Participant is deceased', 'meaning': 'NCIT:C28554'},
+    "UNKNOWN": {'description': 'Vital status unknown or lost to follow-up', 'meaning': 'NCIT:C17998'},
+}
+
+class RecruitmentStatusEnum(RichEnum):
+    """
+    Clinical trial or study recruitment status per NIH/ClinicalTrials.gov
+    """
+    # Enum members
+    NOT_YET_RECRUITING = "NOT_YET_RECRUITING"
+    RECRUITING = "RECRUITING"
+    ENROLLING_BY_INVITATION = "ENROLLING_BY_INVITATION"
+    ACTIVE_NOT_RECRUITING = "ACTIVE_NOT_RECRUITING"
+    SUSPENDED = "SUSPENDED"
+    TERMINATED = "TERMINATED"
+    COMPLETED = "COMPLETED"
+    WITHDRAWN = "WITHDRAWN"
+
+# Set metadata after class creation
+RecruitmentStatusEnum._metadata = {
+    "NOT_YET_RECRUITING": {'description': 'Study has not started recruiting participants', 'meaning': 'NCIT:C211610'},
+    "RECRUITING": {'description': 'Currently recruiting participants', 'meaning': 'NCIT:C142621'},
+    "ENROLLING_BY_INVITATION": {'description': 'Enrolling participants by invitation only', 'meaning': 'NCIT:C211611'},
+    "ACTIVE_NOT_RECRUITING": {'description': 'Study ongoing but not recruiting new participants', 'meaning': 'NCIT:C211612'},
+    "SUSPENDED": {'description': 'Study temporarily stopped', 'meaning': 'NCIT:C211613'},
+    "TERMINATED": {'description': 'Study stopped early and will not resume', 'meaning': 'NCIT:C70757'},
+    "COMPLETED": {'description': 'Study has ended normally', 'meaning': 'NCIT:C70756'},
+    "WITHDRAWN": {'description': 'Study withdrawn before enrollment', 'meaning': 'NCIT:C70758'},
+}
+
+class StudyPhaseEnum(RichEnum):
+    """
+    Clinical trial phases per FDA and NIH definitions
+    """
+    # Enum members
+    EARLY_PHASE_1 = "EARLY_PHASE_1"
+    PHASE_1 = "PHASE_1"
+    PHASE_1_2 = "PHASE_1_2"
+    PHASE_2 = "PHASE_2"
+    PHASE_2_3 = "PHASE_2_3"
+    PHASE_3 = "PHASE_3"
+    PHASE_4 = "PHASE_4"
+    NOT_APPLICABLE = "NOT_APPLICABLE"
+
+# Set metadata after class creation
+StudyPhaseEnum._metadata = {
+    "EARLY_PHASE_1": {'description': 'Exploratory trials before traditional Phase 1', 'meaning': 'NCIT:C54721', 'annotations': {'aliases': 'Phase 0'}},
+    "PHASE_1": {'description': 'Initial safety and dosage studies', 'meaning': 'NCIT:C15600', 'annotations': {'participants': '20-100'}},
+    "PHASE_1_2": {'description': 'Combined Phase 1 and Phase 2 trial', 'meaning': 'NCIT:C15694'},
+    "PHASE_2": {'description': 'Efficacy and side effects studies', 'meaning': 'NCIT:C15601', 'annotations': {'participants': '100-300'}},
+    "PHASE_2_3": {'description': 'Combined Phase 2 and Phase 3 trial', 'meaning': 'NCIT:C49686'},
+    "PHASE_3": {'description': 'Efficacy comparison with standard treatment', 'meaning': 'NCIT:C15602', 'annotations': {'participants': '300-3000'}},
+    "PHASE_4": {'description': 'Post-marketing surveillance', 'meaning': 'NCIT:C15603', 'annotations': {'note': 'After FDA approval'}},
+    "NOT_APPLICABLE": {'description': 'Not a phased clinical trial', 'meaning': 'NCIT:C48660', 'annotations': {'note': 'For observational studies, device trials, etc.'}},
+}
+
+__all__ = [
+    "RaceOMB1997Enum",
+    "EthnicityOMB1997Enum",
+    "BiologicalSexEnum",
+    "AgeGroupEnum",
+    "ParticipantVitalStatusEnum",
+    "RecruitmentStatusEnum",
+    "StudyPhaseEnum",
+]