diff --git a/docs/schema/valuesets.yaml b/docs/schema/valuesets.yaml index a73fc417..ac636536 100644 --- a/docs/schema/valuesets.yaml +++ b/docs/schema/valuesets.yaml @@ -39,6 +39,9 @@ imports: - energy/nuclear/nuclear_safety - energy/nuclear/nuclear_facilities - energy/nuclear/nuclear_operations +- energy/renewable/geothermal +- energy/renewable/hydrogen +- energy/renewable/bioenergy - industry/mining - industry/extractive_industry - statistics/prediction_outcomes @@ -1224,7 +1227,7 @@ enums: name: GOEvidenceCode definition_uri: https://w3id.org/valuesets/GOEvidenceCode instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -1402,7 +1405,7 @@ enums: name: GOElectronicMethods definition_uri: https://w3id.org/valuesets/GOElectronicMethods instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -3517,27 +3520,35 @@ enums: PROTEIN: text: PROTEIN description: Purified protein sample + meaning: NCIT:C17021 NUCLEIC_ACID: text: NUCLEIC_ACID description: Nucleic acid sample (DNA or RNA) + meaning: NCIT:C813 PROTEIN_COMPLEX: text: PROTEIN_COMPLEX description: Protein-protein or protein-nucleic acid complex + meaning: GO:0032991 MEMBRANE_PROTEIN: text: MEMBRANE_PROTEIN description: Membrane-associated protein sample + meaning: NCIT:C16837 VIRUS: text: VIRUS description: Viral particle or capsid + meaning: NCIT:C14283 ORGANELLE: text: ORGANELLE description: Cellular organelle (mitochondria, chloroplast, etc.) + meaning: GO:0043226 CELL: text: CELL description: Whole cell sample + meaning: NCIT:C12508 TISSUE: text: TISSUE description: Tissue sample + meaning: NCIT:C12801 StructuralBiologyTechnique: name: StructuralBiologyTechnique definition_uri: https://w3id.org/valuesets/StructuralBiologyTechnique @@ -3566,6 +3577,7 @@ enums: CRYO_ET: text: CRYO_ET description: Cryo-electron tomography + meaning: MI:2338 annotations: resolution_range: tag: resolution_range @@ -3573,6 +3585,7 @@ enums: aliases: tag: aliases value: cryoET, electron cryo-tomography + title: electron tomography X_RAY_CRYSTALLOGRAPHY: text: X_RAY_CRYSTALLOGRAPHY description: X-ray crystallography @@ -3588,10 +3601,12 @@ enums: NEUTRON_CRYSTALLOGRAPHY: text: NEUTRON_CRYSTALLOGRAPHY description: Neutron crystallography + meaning: CHMO:0000175 annotations: advantages: tag: advantages value: hydrogen positions, deuteration studies + title: neutron diffraction SAXS: text: SAXS description: Small-angle X-ray scattering @@ -3604,13 +3619,17 @@ enums: SANS: text: SANS description: Small-angle neutron scattering + meaning: CHMO:0000184 annotations: advantages: tag: advantages value: contrast variation with deuteration + title: small-angle neutron scattering WAXS: text: WAXS description: Wide-angle X-ray scattering + meaning: CHMO:0000213 + title: wide-angle X-ray scattering NMR: text: NMR description: Nuclear magnetic resonance spectroscopy @@ -3631,10 +3650,12 @@ enums: NEGATIVE_STAIN_EM: text: NEGATIVE_STAIN_EM description: Negative stain electron microscopy + meaning: FBbi:00000568 annotations: resolution_range: tag: resolution_range value: "15-30 \xC5 typical" + title: negative staining electron microscopy CryoEMPreparationType: name: CryoEMPreparationType definition_uri: https://w3id.org/valuesets/CryoEMPreparationType @@ -3848,6 +3869,7 @@ enums: SYNCHROTRON: text: SYNCHROTRON description: Synchrotron radiation source + meaning: CHMO:0001810 annotations: advantages: tag: advantages @@ -3855,9 +3877,12 @@ enums: brightness: tag: brightness value: "10^15-10^18 photons/s/mm\xB2/mrad\xB2" + exact_mappings: + - NCIT:C48205 ROTATING_ANODE: text: ROTATING_ANODE description: Rotating anode generator + meaning: CHMO:0001107 annotations: power: tag: power @@ -3901,6 +3926,7 @@ enums: DIRECT_ELECTRON: text: DIRECT_ELECTRON description: Direct electron detector (DED) + meaning: CHMO:0002837 annotations: examples: tag: examples @@ -3911,6 +3937,7 @@ enums: CCD: text: CCD description: Charge-coupled device camera + meaning: CHMO:0002171 annotations: applications: tag: applications @@ -3918,6 +3945,7 @@ enums: CMOS: text: CMOS description: Complementary metal-oxide semiconductor detector + meaning: CHMO:0002836 annotations: advantages: tag: advantages @@ -3935,6 +3963,7 @@ enums: PHOTOSTIMULABLE_PHOSPHOR: text: PHOTOSTIMULABLE_PHOSPHOR description: Photostimulable phosphor (image plate) + meaning: CHMO:0001069 annotations: applications: tag: applications @@ -4055,6 +4084,7 @@ enums: MRC: text: MRC description: MRC format for EM density maps + meaning: EDAM:3842 annotations: extension: tag: extension @@ -4065,6 +4095,7 @@ enums: TIFF: text: TIFF description: Tagged Image File Format + meaning: EDAM:3591 annotations: extension: tag: extension @@ -4075,6 +4106,7 @@ enums: HDF5: text: HDF5 description: Hierarchical Data Format 5 + meaning: EDAM:3590 annotations: extension: tag: extension @@ -4085,6 +4117,7 @@ enums: STAR: text: STAR description: Self-defining Text Archival and Retrieval format + meaning: EDAM:3906 annotations: extension: tag: extension @@ -4095,6 +4128,7 @@ enums: PDB: text: PDB description: Protein Data Bank coordinate format + meaning: EDAM:1476 annotations: extension: tag: extension @@ -4102,9 +4136,12 @@ enums: applications: tag: applications value: atomic coordinates, legacy format + exact_mappings: + - OBI:0001525 MMCIF: text: MMCIF description: Macromolecular Crystallographic Information File + meaning: EDAM:1477 annotations: extension: tag: extension @@ -4112,9 +4149,12 @@ enums: applications: tag: applications value: atomic coordinates, modern PDB format + exact_mappings: + - NCIT:C133997 MTZ: text: MTZ description: MTZ reflection data format + meaning: EDAM:3816 annotations: extension: tag: extension @@ -4125,6 +4165,7 @@ enums: CBF: text: CBF description: Crystallographic Binary Format + meaning: EDAM:3874 annotations: extension: tag: extension @@ -4318,13 +4359,11 @@ enums: SQUARE_PLANAR: text: SQUARE_PLANAR description: Square planar coordination geometry (4 ligands in plane) + meaning: NCIT:C103211 annotations: coordination_number: tag: coordination_number value: '4' - ncit_variants: - tag: ncit_variants - value: NCIT:C103211, NCIT:C103212, NCIT:C103213, NCIT:C103214 title: square planar molecular geometry TRIGONAL_BIPYRAMIDAL: text: TRIGONAL_BIPYRAMIDAL @@ -4350,13 +4389,11 @@ enums: OCTAHEDRAL: text: OCTAHEDRAL description: Octahedral coordination geometry (6 ligands) + meaning: NCIT:C103216 annotations: coordination_number: tag: coordination_number value: '6' - ncit_variants: - tag: ncit_variants - value: NCIT:C103216, NCIT:C103217, NCIT:C103218 title: octahedral molecular geometry TRIGONAL_PRISMATIC: text: TRIGONAL_PRISMATIC @@ -4457,6 +4494,7 @@ enums: METAL_COORDINATION: text: METAL_COORDINATION description: Metal coordination modification + meaning: MOD:00739 annotations: examples: tag: examples @@ -4464,33 +4502,43 @@ enums: PHOSPHORYLATION: text: PHOSPHORYLATION description: Phosphorylation modification + meaning: MOD:00696 GLYCOSYLATION: text: GLYCOSYLATION description: Glycosylation modification + meaning: MOD:00725 ACETYLATION: text: ACETYLATION description: Acetylation modification + meaning: MOD:00394 METHYLATION: text: METHYLATION description: Methylation modification + meaning: MOD:00599 UBIQUITINATION: text: UBIQUITINATION description: Ubiquitination modification + meaning: MOD:01240 SUMOYLATION: text: SUMOYLATION description: SUMOylation modification + meaning: MOD:01149 HYDROXYLATION: text: HYDROXYLATION description: Hydroxylation modification + meaning: MOD:00677 LIPIDATION: text: LIPIDATION description: Lipidation modification + meaning: MOD:00435 PROTEOLYTIC_CLEAVAGE: text: PROTEOLYTIC_CLEAVAGE description: Proteolytic cleavage + meaning: GO:0006508 CROSSLINKING: text: CROSSLINKING description: Crosslinking modification + meaning: MOD:00276 BiosafetyLevelEnum: name: BiosafetyLevelEnum definition_uri: https://w3id.org/valuesets/BiosafetyLevelEnum @@ -4541,7 +4589,7 @@ enums: name: InsdcMissingValueEnum definition_uri: https://w3id.org/valuesets/InsdcMissingValueEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -4669,7 +4717,7 @@ enums: name: InsdcGeographicLocationEnum definition_uri: https://w3id.org/valuesets/InsdcGeographicLocationEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -9612,9 +9660,19 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: solar energy + brick_label: + tag: brick_label + value: Solar Thermal Collector title: Solar energy (photovoltaic and thermal) aliases: - Solar radiation + exact_mappings: + - OEO:00000384 + related_mappings: + - brick:Solar_Thermal_Collector WIND: text: WIND annotations: @@ -9624,11 +9682,18 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: wind energy title: Wind power aliases: - wind wave energy + exact_mappings: + - OEO:00000446 related_mappings: - ENVO:2000033 + broad_mappings: + - sweet:phenAtmoWind/Wind HYDROELECTRIC: text: HYDROELECTRIC annotations: @@ -9638,9 +9703,14 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: hydro energy title: Hydroelectric power aliases: - hydroelectric dam + exact_mappings: + - OEO:00000218 related_mappings: - ENVO:00000468 GEOTHERMAL: @@ -9653,9 +9723,16 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: geothermal energy title: Geothermal energy aliases: - geothermal energy + exact_mappings: + - OEO:00000191 + close_mappings: + - sweet:phenEnergy/Geothermal BIOMASS: text: BIOMASS annotations: @@ -9665,9 +9742,16 @@ enums: emission_free: tag: emission_free value: false + oeo_label: + tag: oeo_label + value: bioenergy title: Biomass and bioenergy aliases: - organic material + exact_mappings: + - OEO:00010258 + close_mappings: + - sweet:matrBiomass/Biomass related_mappings: - ENVO:01000155 BIOFUEL: @@ -9679,7 +9763,14 @@ enums: emission_free: tag: emission_free value: false + oeo_label: + tag: oeo_label + value: biofuel title: Biofuels (ethanol, biodiesel) + exact_mappings: + - OEO:00000072 + close_mappings: + - sweet:matrEnergy/Biofuel TIDAL: text: TIDAL annotations: @@ -9689,7 +9780,13 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: marine tidal energy, marine wave energy title: Tidal and wave energy + close_mappings: + - OEO:00010100 + - OEO:00010102 HYDROGEN: text: HYDROGEN meaning: CHEBI:18276 @@ -9700,9 +9797,16 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: hydrogen title: Hydrogen fuel aliases: - dihydrogen + exact_mappings: + - OEO:00000220 + broad_mappings: + - sweet:matrElement/Hydrogen COAL: text: COAL meaning: ENVO:02000091 @@ -9716,7 +9820,14 @@ enums: fossil_fuel: tag: fossil_fuel value: true + oeo_label: + tag: oeo_label + value: coal title: Coal + exact_mappings: + - OEO:00000088 + close_mappings: + - sweet:matrNaturalResource/Coal NATURAL_GAS: text: NATURAL_GAS meaning: ENVO:01000552 @@ -9730,7 +9841,14 @@ enums: fossil_fuel: tag: fossil_fuel value: true + oeo_label: + tag: oeo_label + value: natural gas title: Natural gas + exact_mappings: + - OEO:00000292 + close_mappings: + - sweet:matrNaturalResource/NaturalGas PETROLEUM: text: PETROLEUM meaning: ENVO:00002984 @@ -9744,7 +9862,13 @@ enums: fossil_fuel: tag: fossil_fuel value: true + oeo_label: + tag: oeo_label + value: crude oil title: Petroleum/oil + close_mappings: + - sweet:matrNaturalResource/Petroleum + - OEO:00000115 DIESEL: text: DIESEL meaning: ENVO:03510006 @@ -9758,9 +9882,14 @@ enums: fossil_fuel: tag: fossil_fuel value: true + oeo_label: + tag: oeo_label + value: diesel fuel title: Diesel fuel aliases: - diesel fuel + exact_mappings: + - OEO:00010242 GASOLINE: text: GASOLINE annotations: @@ -9773,9 +9902,14 @@ enums: fossil_fuel: tag: fossil_fuel value: true + oeo_label: + tag: oeo_label + value: gasoline fuel title: Gasoline/petrol aliases: - fuel oil + exact_mappings: + - OEO:00010241 related_mappings: - ENVO:00002983 PROPANE: @@ -9803,11 +9937,16 @@ enums: emission_free: tag: emission_free value: true + oeo_label: + tag: oeo_label + value: nuclear fuel title: Nuclear fission aliases: - nuclear energy exact_mappings: - CHEBI:35231 + close_mappings: + - OEO:00000302 related_mappings: - ENVO:2000025 NUCLEAR_FUSION: @@ -9830,7 +9969,12 @@ enums: renewable: tag: renewable value: partial + oeo_label: + tag: oeo_label + value: supply grid title: Grid electricity (mixed sources) + close_mappings: + - OEO:00000200 BATTERY_STORAGE: text: BATTERY_STORAGE description: Battery storage systems @@ -9838,6 +9982,11 @@ enums: storage: tag: storage value: true + oeo_label: + tag: oeo_label + value: battery + close_mappings: + - OEO:00000068 EnergyUnit: name: EnergyUnit definition_uri: https://w3id.org/valuesets/EnergyUnit @@ -10379,6 +10528,12 @@ enums: MAIN_GRID: text: MAIN_GRID description: Main utility grid + annotations: + oeo_label: + tag: oeo_label + value: supply grid + exact_mappings: + - OEO:00000200 MICROGRID: text: MICROGRID description: Microgrid @@ -10394,54 +10549,474 @@ enums: VIRTUAL_POWER_PLANT: text: VIRTUAL_POWER_PLANT description: Virtual power plant - EnergyStorageType: - name: EnergyStorageType - definition_uri: https://w3id.org/valuesets/EnergyStorageType + BatteryType: + name: BatteryType + definition_uri: https://w3id.org/valuesets/BatteryType instantiates: - valuesets_meta:ValueSetEnumDefinition - description: Types of energy storage systems - title: Energy Storage Type + description: Types of battery technologies for energy storage + title: Battery Type from_schema: https://w3id.org/linkml/valuesets/energy/energy + exact_mappings: + - OEO:00000068 + - brick:Battery contributors: - orcid:0000-0002-6601-2165 - https://github.com/anthropics/claude-code status: DRAFT permissible_values: - LITHIUM_ION_BATTERY: - text: LITHIUM_ION_BATTERY + LITHIUM_ION: + text: LITHIUM_ION description: Lithium-ion battery annotations: - category: - tag: category - value: electrochemical - LEAD_ACID_BATTERY: - text: LEAD_ACID_BATTERY + chemistry: + tag: chemistry + value: lithium + aliases: + - Li-ion + - LIB + LITHIUM_IRON_PHOSPHATE: + text: LITHIUM_IRON_PHOSPHATE + description: Lithium iron phosphate (LFP) battery + annotations: + chemistry: + tag: chemistry + value: lithium + aliases: + - LFP + - LiFePO4 + LITHIUM_POLYMER: + text: LITHIUM_POLYMER + description: Lithium polymer battery + annotations: + chemistry: + tag: chemistry + value: lithium + aliases: + - LiPo + LEAD_ACID: + text: LEAD_ACID description: Lead-acid battery annotations: - category: - tag: category - value: electrochemical - FLOW_BATTERY: - text: FLOW_BATTERY - description: Flow battery (e.g., vanadium redox) + chemistry: + tag: chemistry + value: lead + aliases: + - Pb-acid + NICKEL_METAL_HYDRIDE: + text: NICKEL_METAL_HYDRIDE + description: Nickel-metal hydride battery annotations: - category: - tag: category - value: electrochemical - SOLID_STATE_BATTERY: - text: SOLID_STATE_BATTERY - description: Solid-state battery + chemistry: + tag: chemistry + value: nickel + aliases: + - NiMH + NICKEL_CADMIUM: + text: NICKEL_CADMIUM + description: Nickel-cadmium battery annotations: - category: - tag: category - value: electrochemical - SODIUM_ION_BATTERY: - text: SODIUM_ION_BATTERY + chemistry: + tag: chemistry + value: nickel + aliases: + - NiCd + SODIUM_ION: + text: SODIUM_ION description: Sodium-ion battery + annotations: + chemistry: + tag: chemistry + value: sodium + aliases: + - Na-ion + SOLID_STATE: + text: SOLID_STATE + description: Solid-state battery + annotations: + chemistry: + tag: chemistry + value: various + VANADIUM_REDOX_FLOW: + text: VANADIUM_REDOX_FLOW + description: Vanadium redox flow battery + annotations: + chemistry: + tag: chemistry + value: vanadium + type: + tag: type + value: flow + aliases: + - VRB + - VRFB + ZINC_BROMINE_FLOW: + text: ZINC_BROMINE_FLOW + description: Zinc-bromine flow battery + annotations: + chemistry: + tag: chemistry + value: zinc + type: + tag: type + value: flow + aliases: + - ZnBr + IRON_AIR: + text: IRON_AIR + description: Iron-air battery + annotations: + chemistry: + tag: chemistry + value: iron + ZINC_AIR: + text: ZINC_AIR + description: Zinc-air battery + annotations: + chemistry: + tag: chemistry + value: zinc + PVCellType: + name: PVCellType + definition_uri: https://w3id.org/valuesets/PVCellType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of photovoltaic cell technologies + title: Photovoltaic Cell Type + from_schema: https://w3id.org/linkml/valuesets/energy/energy + see_also: + - OEO:00000348 + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + MONOCRYSTALLINE_SILICON: + text: MONOCRYSTALLINE_SILICON + description: Monocrystalline silicon (mono-Si) cells + annotations: + material: + tag: material + value: silicon + efficiency_range: + tag: efficiency_range + value: 17-22% + aliases: + - mono-Si + - single-crystal silicon + related_mappings: + - CHEBI:27573 + POLYCRYSTALLINE_SILICON: + text: POLYCRYSTALLINE_SILICON + description: Polycrystalline silicon (poly-Si) cells + annotations: + material: + tag: material + value: silicon + efficiency_range: + tag: efficiency_range + value: 15-17% + aliases: + - poly-Si + - multi-crystalline silicon + related_mappings: + - CHEBI:27573 + PASSIVATED_EMITTER_REAR_CELL: + text: PASSIVATED_EMITTER_REAR_CELL + description: Passivated Emitter and Rear Cell (PERC) + annotations: + material: + tag: material + value: silicon + efficiency_range: + tag: efficiency_range + value: 19-22% + aliases: + - PERC + HETEROJUNCTION: + text: HETEROJUNCTION + description: Heterojunction (HJT) cells + annotations: + material: + tag: material + value: silicon + efficiency_range: + tag: efficiency_range + value: 21-24% + aliases: + - HJT + - HIT + TUNNEL_OXIDE_PASSIVATED_CONTACT: + text: TUNNEL_OXIDE_PASSIVATED_CONTACT + description: Tunnel Oxide Passivated Contact (TOPCon) cells + annotations: + material: + tag: material + value: silicon + efficiency_range: + tag: efficiency_range + value: 22-24% + aliases: + - TOPCon + INTERDIGITATED_BACK_CONTACT: + text: INTERDIGITATED_BACK_CONTACT + description: Interdigitated Back Contact (IBC) cells + annotations: + material: + tag: material + value: silicon + efficiency_range: + tag: efficiency_range + value: 22-24% + aliases: + - IBC + CADMIUM_TELLURIDE: + text: CADMIUM_TELLURIDE + description: Cadmium telluride (CdTe) thin-film cells + annotations: + material: + tag: material + value: cadmium_telluride + type: + tag: type + value: thin-film + efficiency_range: + tag: efficiency_range + value: 16-18% + aliases: + - CdTe + exact_mappings: + - CHEBI:232800 + COPPER_INDIUM_GALLIUM_SELENIDE: + text: COPPER_INDIUM_GALLIUM_SELENIDE + description: Copper indium gallium selenide (CIGS) thin-film cells + annotations: + material: + tag: material + value: CIGS + type: + tag: type + value: thin-film + efficiency_range: + tag: efficiency_range + value: 15-20% + aliases: + - CIGS + - CIS + AMORPHOUS_SILICON: + text: AMORPHOUS_SILICON + description: Amorphous silicon (a-Si) thin-film cells + annotations: + material: + tag: material + value: silicon + type: + tag: type + value: thin-film + efficiency_range: + tag: efficiency_range + value: 6-8% + aliases: + - a-Si + related_mappings: + - CHEBI:27573 + GALLIUM_ARSENIDE: + text: GALLIUM_ARSENIDE + description: Gallium arsenide (GaAs) cells + annotations: + material: + tag: material + value: gallium_arsenide + efficiency_range: + tag: efficiency_range + value: 25-30% + application: + tag: application + value: space, concentrator + aliases: + - GaAs + PEROVSKITE: + text: PEROVSKITE + description: Perovskite solar cells + annotations: + material: + tag: material + value: perovskite + efficiency_range: + tag: efficiency_range + value: 20-25% + status: + tag: status + value: emerging + ORGANIC: + text: ORGANIC + description: Organic photovoltaic (OPV) cells + annotations: + material: + tag: material + value: organic + type: + tag: type + value: thin-film + efficiency_range: + tag: efficiency_range + value: 10-15% + status: + tag: status + value: emerging + aliases: + - OPV + TANDEM: + text: TANDEM + description: Tandem/multi-junction cells + annotations: + efficiency_range: + tag: efficiency_range + value: 25-35% + aliases: + - multi-junction + PVSystemType: + name: PVSystemType + definition_uri: https://w3id.org/valuesets/PVSystemType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of photovoltaic system installations + title: Photovoltaic System Type + from_schema: https://w3id.org/linkml/valuesets/energy/energy + exact_mappings: + - OEO:00000324 + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + ROOFTOP_RESIDENTIAL: + text: ROOFTOP_RESIDENTIAL + description: Residential rooftop PV system + annotations: + scale: + tag: scale + value: residential + mounting: + tag: mounting + value: rooftop + broad_mappings: + - OEO:00000361 + ROOFTOP_COMMERCIAL: + text: ROOFTOP_COMMERCIAL + description: Commercial/industrial rooftop PV system + annotations: + scale: + tag: scale + value: commercial + mounting: + tag: mounting + value: rooftop + broad_mappings: + - OEO:00000361 + GROUND_MOUNTED: + text: GROUND_MOUNTED + description: Ground-mounted utility-scale PV system + annotations: + scale: + tag: scale + value: utility + mounting: + tag: mounting + value: ground + exact_mappings: + - OEO:00000165 + FLOATING: + text: FLOATING + description: Floating PV system (floatovoltaics) + annotations: + scale: + tag: scale + value: utility + mounting: + tag: mounting + value: floating + aliases: + - floatovoltaics + - FPV + BUILDING_INTEGRATED: + text: BUILDING_INTEGRATED + description: Building-integrated PV (BIPV) + annotations: + mounting: + tag: mounting + value: integrated + aliases: + - BIPV + AGRIVOLTAICS: + text: AGRIVOLTAICS + description: Agrivoltaic system (dual-use with agriculture) + annotations: + scale: + tag: scale + value: utility + dual_use: + tag: dual_use + value: agriculture + aliases: + - agrophotovoltaics + - APV + CARPORT: + text: CARPORT + description: Solar carport/parking canopy + annotations: + mounting: + tag: mounting + value: canopy + dual_use: + tag: dual_use + value: parking + TRACKER_SINGLE_AXIS: + text: TRACKER_SINGLE_AXIS + description: Single-axis tracking system + annotations: + tracking: + tag: tracking + value: single_axis + TRACKER_DUAL_AXIS: + text: TRACKER_DUAL_AXIS + description: Dual-axis tracking system + annotations: + tracking: + tag: tracking + value: dual_axis + CONCENTRATING: + text: CONCENTRATING + description: Concentrating PV (CPV) system + annotations: + type: + tag: type + value: concentrating + aliases: + - CPV + EnergyStorageType: + name: EnergyStorageType + definition_uri: https://w3id.org/valuesets/EnergyStorageType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of energy storage systems (categories) + title: Energy Storage Type + from_schema: https://w3id.org/linkml/valuesets/energy/energy + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + BATTERY: + text: BATTERY + description: Battery storage (see BatteryType for specific chemistries) annotations: category: tag: category value: electrochemical + exact_mappings: + - OEO:00000068 + - brick:Battery PUMPED_HYDRO: text: PUMPED_HYDRO description: Pumped hydroelectric storage @@ -10449,6 +11024,11 @@ enums: category: tag: category value: mechanical + oeo_label: + tag: oeo_label + value: pumped hydro storage power plant + exact_mappings: + - OEO:00010089 COMPRESSED_AIR: text: COMPRESSED_AIR description: Compressed air energy storage (CAES) @@ -10456,6 +11036,11 @@ enums: category: tag: category value: mechanical + oeo_label: + tag: oeo_label + value: compressed air + close_mappings: + - OEO:00000102 FLYWHEEL: text: FLYWHEEL description: Flywheel energy storage @@ -10498,6 +11083,11 @@ enums: category: tag: category value: chemical + oeo_label: + tag: oeo_label + value: hydrogen + close_mappings: + - OEO:00000220 SYNTHETIC_FUEL: text: SYNTHETIC_FUEL description: Synthetic fuel storage @@ -10505,6 +11095,11 @@ enums: category: tag: category value: chemical + oeo_label: + tag: oeo_label + value: synthetic fuel + close_mappings: + - OEO:00010017 SUPERCAPACITOR: text: SUPERCAPACITOR description: Supercapacitor @@ -10527,6 +11122,9 @@ enums: description: Greenhouse gas emission scopes (GHG Protocol) title: Emission Scope from_schema: https://w3id.org/linkml/valuesets/energy/energy + see_also: + - OEO:00000147 + - OEO:00000020 contributors: - orcid:0000-0002-6601-2165 - https://github.com/anthropics/claude-code @@ -10539,6 +11137,11 @@ enums: ghg_protocol: tag: ghg_protocol value: Scope 1 + oeo_label: + tag: oeo_label + value: greenhouse gas emission + related_mappings: + - OEO:00000199 SCOPE_2: text: SCOPE_2 description: Indirect emissions from purchased energy @@ -10546,6 +11149,11 @@ enums: ghg_protocol: tag: ghg_protocol value: Scope 2 + oeo_label: + tag: oeo_label + value: greenhouse gas emission + related_mappings: + - OEO:00000199 SCOPE_3: text: SCOPE_3 description: All other indirect emissions in value chain @@ -10553,6 +11161,11 @@ enums: ghg_protocol: tag: ghg_protocol value: Scope 3 + oeo_label: + tag: oeo_label + value: greenhouse gas emission + related_mappings: + - OEO:00000199 SCOPE_3_UPSTREAM: text: SCOPE_3_UPSTREAM description: Upstream Scope 3 emissions @@ -10560,6 +11173,11 @@ enums: ghg_protocol: tag: ghg_protocol value: Scope 3 + oeo_label: + tag: oeo_label + value: greenhouse gas emission + related_mappings: + - OEO:00000199 SCOPE_3_DOWNSTREAM: text: SCOPE_3_DOWNSTREAM description: Downstream Scope 3 emissions @@ -10567,6 +11185,11 @@ enums: ghg_protocol: tag: ghg_protocol value: Scope 3 + oeo_label: + tag: oeo_label + value: greenhouse gas emission + related_mappings: + - OEO:00000199 CarbonIntensity: name: CarbonIntensity definition_uri: https://w3id.org/valuesets/CarbonIntensity @@ -10665,6 +11288,94 @@ enums: POWER_PURCHASE_AGREEMENT: text: POWER_PURCHASE_AGREEMENT description: Power purchase agreement (PPA) + CapabilityStatus: + name: CapabilityStatus + definition_uri: https://w3id.org/valuesets/CapabilityStatus + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Operational status of a capability, facility, or infrastructure. + Applicable to energy facilities, research capabilities, and other infrastructure + throughout their lifecycle. + title: Capability Status + from_schema: https://w3id.org/linkml/valuesets/energy/energy + see_also: + - https://www.wikidata.org/wiki/Property:P5817 + - https://www.iaea.org/topics/nuclear-power-plant-life-cycle + - https://schema.org/ItemAvailability + - https://www.iso.org/standard/83053.html + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + OPERATIONAL: + text: OPERATIONAL + description: Fully operational and available to users + annotations: + wikidata_label: + tag: wikidata_label + value: in use + lifecycle_phase: + tag: lifecycle_phase + value: operation + title: Operational + exact_mappings: + - wikidata:Q55654238 + COMING_ONLINE: + text: COMING_ONLINE + description: Being commissioned, coming online soon + annotations: + wikidata_label: + tag: wikidata_label + value: building process + lifecycle_phase: + tag: lifecycle_phase + value: commissioning + iaea_equivalent: + tag: iaea_equivalent + value: commissioning + title: Coming Online + related_mappings: + - wikidata:Q811686 + PILOT: + text: PILOT + description: In pilot phase with limited access + annotations: + availability: + tag: availability + value: limited + lifecycle_phase: + tag: lifecycle_phase + value: testing + title: Pilot + related_mappings: + - schema:LimitedAvailability + UNDER_DEVELOPMENT: + text: UNDER_DEVELOPMENT + description: Under development, not yet available + annotations: + wikidata_label: + tag: wikidata_label + value: proposed building or structure + lifecycle_phase: + tag: lifecycle_phase + value: planning/construction + title: Under Development + exact_mappings: + - wikidata:Q811683 + DECOMMISSIONED: + text: DECOMMISSIONED + description: No longer available, permanently shut down + annotations: + lifecycle_phase: + tag: lifecycle_phase + value: end-of-life + iaea_equivalent: + tag: iaea_equivalent + value: decommissioned + title: Decommissioned + related_mappings: + - schema:Discontinued FossilFuelTypeEnum: name: FossilFuelTypeEnum definition_uri: https://w3id.org/valuesets/FossilFuelTypeEnum @@ -15469,6 +16180,1456 @@ enums: tag: coordination value: with law enforcement title: Security Procedure + GeothermalSystemType: + name: GeothermalSystemType + definition_uri: https://w3id.org/valuesets/GeothermalSystemType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of geothermal energy systems, including conventional hydrothermal + and enhanced/engineered geothermal systems. + title: Geothermal System Type + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + see_also: + - https://www.energy.gov/eere/geothermal/enhanced-geothermal-systems + - https://gdr.openei.org/ + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + HYDROTHERMAL: + text: HYDROTHERMAL + description: Naturally occurring geothermal system with heat, fluid, and permeability + sufficient for energy extraction without stimulation. + annotations: + conventional: + tag: conventional + value: true + title: Conventional Hydrothermal System + broad_mappings: + - sweet:phenEnergy/Geothermal + ENHANCED_GEOTHERMAL_SYSTEM: + text: ENHANCED_GEOTHERMAL_SYSTEM + description: Engineered reservoirs created to extract heat from low permeability + geothermal resources through stimulation methods. + annotations: + requires_stimulation: + tag: requires_stimulation + value: true + title: Enhanced Geothermal System (EGS) + aliases: + - EGS + - Engineered Geothermal System + ADVANCED_GEOTHERMAL_SYSTEM: + text: ADVANCED_GEOTHERMAL_SYSTEM + description: Closed-loop geothermal systems that circulate working fluid through + wellbores to extract heat conductively without reservoir stimulation. + annotations: + closed_loop: + tag: closed_loop + value: true + title: Advanced Geothermal System (AGS) + aliases: + - AGS + - Closed-Loop Geothermal + HOT_DRY_ROCK: + text: HOT_DRY_ROCK + description: Geothermal system targeting hot basement rock lacking natural + fluid or permeability, requiring artificial reservoir creation. + title: Hot Dry Rock (HDR) + aliases: + - HDR + GEOPRESSURED: + text: GEOPRESSURED + description: Deep sedimentary formations with abnormally high fluid pressure + containing hot brine and dissolved methane. + annotations: + methane_recovery: + tag: methane_recovery + value: true + title: Geopressured System + SUPERCRITICAL: + text: SUPERCRITICAL + description: Very high temperature systems (>374C) where water exists above + its critical point, offering higher energy density. + annotations: + temperature_min_c: + tag: temperature_min_c + value: 374 + title: Supercritical Geothermal System + GROUND_SOURCE_HEAT_PUMP: + text: GROUND_SOURCE_HEAT_PUMP + description: Shallow geothermal system using stable ground temperatures for + heating and cooling buildings. + annotations: + direct_use: + tag: direct_use + value: true + title: Ground Source Heat Pump (GSHP) + aliases: + - GSHP + - Geothermal Heat Pump + GeothermalReservoirType: + name: GeothermalReservoirType + definition_uri: https://w3id.org/valuesets/GeothermalReservoirType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Classification of geothermal reservoirs by geological setting and + characteristics. + title: Geothermal Reservoir Type + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + VOLCANIC: + text: VOLCANIC + description: Reservoir associated with volcanic activity, typically in active + volcanic regions with magma heat sources. + title: Volcanic Reservoir + related_mappings: + - ENVO:00000247 + broad_mappings: + - sweet:realmLandVolcanic/VolcanicField + SEDIMENTARY: + text: SEDIMENTARY + description: Reservoir in sedimentary formations with elevated temperatures + due to depth or regional heat flow. + title: Sedimentary Basin Reservoir + broad_mappings: + - sweet:realmGeolBasin/SedimentaryBasin + FRACTURED_BASEMENT: + text: FRACTURED_BASEMENT + description: Reservoir in fractured crystalline basement rocks, typically + granitic or metamorphic. + title: Fractured Basement Reservoir + aliases: + - Hot Fractured Rock + FAULT_CONTROLLED: + text: FAULT_CONTROLLED + description: Reservoir where fluid flow is controlled by fault systems providing + permeability pathways. + title: Fault-Controlled Reservoir + MAGMATIC: + text: MAGMATIC + description: Very high temperature reservoir near or in contact with magma + bodies or recent intrusions. + title: Magmatic/Near-Magmatic Reservoir + related_mappings: + - sweet:matrRockIgneous/Magma + CONDUCTION_DOMINATED: + text: CONDUCTION_DOMINATED + description: Low permeability reservoir where heat transfer is primarily through + conduction rather than convection. + title: Conduction-Dominated Reservoir + GeothermalWellType: + name: GeothermalWellType + definition_uri: https://w3id.org/valuesets/GeothermalWellType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of wells used in geothermal energy development and production. + title: Geothermal Well Type + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + PRODUCTION_WELL: + text: PRODUCTION_WELL + description: Well used to extract geothermal fluids or steam from the reservoir. + title: Production Well + INJECTION_WELL: + text: INJECTION_WELL + description: Well used to return cooled geothermal fluids to the reservoir + to maintain pressure and sustainability. + title: Injection Well + aliases: + - Reinjection Well + EXPLORATION_WELL: + text: EXPLORATION_WELL + description: Well drilled to evaluate geothermal resource characteristics. + title: Exploration Well + aliases: + - Wildcat Well + OBSERVATION_WELL: + text: OBSERVATION_WELL + description: Well used to monitor reservoir conditions and pressure. + title: Observation/Monitoring Well + aliases: + - Monitoring Well + SLIM_HOLE: + text: SLIM_HOLE + description: Smaller diameter well used for initial exploration and temperature + gradient measurement. + title: Slim Hole + DIRECTIONAL_WELL: + text: DIRECTIONAL_WELL + description: Well drilled at an angle to access reservoir from offset surface + location or increase reservoir contact. + title: Directional/Deviated Well + GeothermalApplication: + name: GeothermalApplication + definition_uri: https://w3id.org/valuesets/GeothermalApplication + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Applications and uses of geothermal energy. + title: Geothermal Application + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + ELECTRICITY_GENERATION: + text: ELECTRICITY_GENERATION + description: Use of geothermal resources for power generation through steam + turbines or binary cycle plants. + meaning: ENVO:2000034 + title: Electricity Generation + close_mappings: + - sweet:humanTechEnergy/ElectricalGeneration + DIRECT_USE_HEATING: + text: DIRECT_USE_HEATING + description: Direct use of geothermal heat for space heating, district heating, + or industrial processes. + title: Direct Use Heating + GREENHOUSE_HEATING: + text: GREENHOUSE_HEATING + description: Use of geothermal heat for agricultural greenhouses. + title: Greenhouse Heating + AQUACULTURE: + text: AQUACULTURE + description: Use of geothermal heat for fish farming and aquaculture. + title: Aquaculture Heating + INDUSTRIAL_PROCESS_HEAT: + text: INDUSTRIAL_PROCESS_HEAT + description: Use of geothermal heat for industrial manufacturing processes. + title: Industrial Process Heat + FOOD_PROCESSING: + text: FOOD_PROCESSING + description: Use of geothermal heat for food drying, pasteurization, and processing. + title: Food Processing + BATHING_RECREATION: + text: BATHING_RECREATION + description: Use of geothermal waters for spas, pools, and recreation. + title: Bathing and Recreation + LITHIUM_EXTRACTION: + text: LITHIUM_EXTRACTION + description: Extraction of lithium and other minerals from geothermal brines + as a co-product of energy production. + annotations: + co_production: + tag: co_production + value: true + title: Lithium Extraction + GeothermalResourceTemperature: + name: GeothermalResourceTemperature + definition_uri: https://w3id.org/valuesets/GeothermalResourceTemperature + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Classification of geothermal resources by temperature range. + title: Geothermal Resource Temperature Classification + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + LOW_TEMPERATURE: + text: LOW_TEMPERATURE + description: Geothermal resource below 90C, suitable for direct use applications. + annotations: + temperature_max_c: + tag: temperature_max_c + value: 90 + title: Low Temperature Resource + MODERATE_TEMPERATURE: + text: MODERATE_TEMPERATURE + description: Geothermal resource 90-150C, suitable for binary power generation. + annotations: + temperature_min_c: + tag: temperature_min_c + value: 90 + temperature_max_c: + tag: temperature_max_c + value: 150 + title: Moderate Temperature Resource + HIGH_TEMPERATURE: + text: HIGH_TEMPERATURE + description: Geothermal resource above 150C, suitable for flash steam power + generation. + annotations: + temperature_min_c: + tag: temperature_min_c + value: 150 + title: High Temperature Resource + SUPERCRITICAL: + text: SUPERCRITICAL + description: Very high temperature resource above 374C where water exists + in supercritical state. + annotations: + temperature_min_c: + tag: temperature_min_c + value: 374 + title: Supercritical Resource + HydrogenType: + name: HydrogenType + definition_uri: https://w3id.org/valuesets/HydrogenType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Color-coded classification of hydrogen based on production method + and carbon intensity. This informal industry taxonomy differentiates hydrogen + by its carbon footprint and energy source. + title: Hydrogen Type (Color Classification) + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + see_also: + - https://www.energy.gov/eere/fuelcells/hydrogen-production + - https://www.nationalgrid.com/stories/energy-explained/hydrogen-colour-spectrum + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + GREEN_HYDROGEN: + text: GREEN_HYDROGEN + description: Hydrogen produced via electrolysis powered by renewable energy + sources (solar, wind, hydro). Zero carbon emissions during production. + annotations: + production_method: + tag: production_method + value: electrolysis + energy_source: + tag: energy_source + value: renewable + carbon_intensity: + tag: carbon_intensity + value: zero + title: Green Hydrogen + aliases: + - Renewable Hydrogen + broad_mappings: + - sweet:matrElement/Hydrogen + BLUE_HYDROGEN: + text: BLUE_HYDROGEN + description: Hydrogen produced from natural gas via steam methane reforming + (SMR) with carbon capture and storage (CCS). Low carbon intensity. + annotations: + production_method: + tag: production_method + value: steam_methane_reforming + energy_source: + tag: energy_source + value: natural_gas + carbon_intensity: + tag: carbon_intensity + value: low + requires_ccs: + tag: requires_ccs + value: true + title: Blue Hydrogen + GREY_HYDROGEN: + text: GREY_HYDROGEN + description: Hydrogen produced from natural gas via steam methane reforming + without carbon capture. Most common production method currently. + annotations: + production_method: + tag: production_method + value: steam_methane_reforming + energy_source: + tag: energy_source + value: natural_gas + carbon_intensity: + tag: carbon_intensity + value: high + co2_per_kg_h2: + tag: co2_per_kg_h2 + value: 9-12 + title: Grey Hydrogen + aliases: + - Gray Hydrogen + BROWN_HYDROGEN: + text: BROWN_HYDROGEN + description: Hydrogen produced from brown coal (lignite) gasification without + carbon capture. High carbon intensity. + annotations: + production_method: + tag: production_method + value: coal_gasification + energy_source: + tag: energy_source + value: lignite + carbon_intensity: + tag: carbon_intensity + value: very_high + title: Brown Hydrogen + BLACK_HYDROGEN: + text: BLACK_HYDROGEN + description: Hydrogen produced from black coal (bituminous) gasification without + carbon capture. High carbon intensity. + annotations: + production_method: + tag: production_method + value: coal_gasification + energy_source: + tag: energy_source + value: bituminous_coal + carbon_intensity: + tag: carbon_intensity + value: very_high + title: Black Hydrogen + PINK_HYDROGEN: + text: PINK_HYDROGEN + description: Hydrogen produced via electrolysis powered by nuclear energy. + Zero carbon emissions during production. + annotations: + production_method: + tag: production_method + value: electrolysis + energy_source: + tag: energy_source + value: nuclear + carbon_intensity: + tag: carbon_intensity + value: zero + title: Pink Hydrogen + aliases: + - Purple Hydrogen + - Red Hydrogen + TURQUOISE_HYDROGEN: + text: TURQUOISE_HYDROGEN + description: Hydrogen produced via methane pyrolysis, producing solid carbon + instead of CO2. Lower carbon intensity than grey hydrogen. + annotations: + production_method: + tag: production_method + value: methane_pyrolysis + energy_source: + tag: energy_source + value: natural_gas + carbon_intensity: + tag: carbon_intensity + value: low + byproduct: + tag: byproduct + value: solid_carbon + title: Turquoise Hydrogen + WHITE_HYDROGEN: + text: WHITE_HYDROGEN + description: Naturally occurring geological hydrogen found in underground + deposits. Zero production emissions. + annotations: + production_method: + tag: production_method + value: geological_extraction + energy_source: + tag: energy_source + value: natural + carbon_intensity: + tag: carbon_intensity + value: zero + title: White Hydrogen + aliases: + - Natural Hydrogen + - Geological Hydrogen + - Gold Hydrogen + YELLOW_HYDROGEN: + text: YELLOW_HYDROGEN + description: Hydrogen produced via electrolysis powered by solar energy specifically. + A subset of green hydrogen. + annotations: + production_method: + tag: production_method + value: electrolysis + energy_source: + tag: energy_source + value: solar + carbon_intensity: + tag: carbon_intensity + value: zero + title: Yellow Hydrogen + ORANGE_HYDROGEN: + text: ORANGE_HYDROGEN + description: Hydrogen produced from plastic waste gasification or pyrolysis. + Emerging technology addressing both energy and waste challenges. + annotations: + production_method: + tag: production_method + value: waste_gasification + energy_source: + tag: energy_source + value: plastic_waste + carbon_intensity: + tag: carbon_intensity + value: varies + title: Orange Hydrogen + HydrogenProductionMethod: + name: HydrogenProductionMethod + definition_uri: https://w3id.org/valuesets/HydrogenProductionMethod + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Methods and processes for producing hydrogen. + title: Hydrogen Production Method + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + see_also: + - https://www.energy.gov/eere/fuelcells/hydrogen-production + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + STEAM_METHANE_REFORMING: + text: STEAM_METHANE_REFORMING + description: High temperature steam reacts with methane to produce hydrogen, + carbon monoxide, and carbon dioxide. + annotations: + feedstock: + tag: feedstock + value: natural_gas + temperature_c: + tag: temperature_c + value: 700-1000 + dominant_method: + tag: dominant_method + value: true + title: Steam Methane Reforming (SMR) + aliases: + - SMR + AUTOTHERMAL_REFORMING: + text: AUTOTHERMAL_REFORMING + description: Combines steam reforming and partial oxidation using oxygen and + steam to produce hydrogen from hydrocarbons. + title: Autothermal Reforming (ATR) + aliases: + - ATR + PARTIAL_OXIDATION: + text: PARTIAL_OXIDATION + description: Exothermic process reacting hydrocarbons with limited oxygen + to produce hydrogen and carbon monoxide. + title: Partial Oxidation (POX) + aliases: + - POX + COAL_GASIFICATION: + text: COAL_GASIFICATION + description: Conversion of coal to syngas (hydrogen and carbon monoxide) using + high temperature and steam. + meaning: CHMO:0001501 + title: Coal Gasification + WATER_ELECTROLYSIS: + text: WATER_ELECTROLYSIS + description: Splitting water into hydrogen and oxygen using electrical current. + Can be powered by various energy sources. + title: Water Electrolysis + aliases: + - Electrolysis + close_mappings: + - sweet:procChemical/Electrolysis + ALKALINE_ELECTROLYSIS: + text: ALKALINE_ELECTROLYSIS + description: Electrolysis using alkaline solution (typically KOH) as electrolyte. + Mature commercial technology. + annotations: + electrolyte: + tag: electrolyte + value: alkaline + maturity: + tag: maturity + value: commercial + title: Alkaline Electrolysis (AEL) + aliases: + - AEL + PEM_ELECTROLYSIS: + text: PEM_ELECTROLYSIS + description: Proton Exchange Membrane electrolysis using solid polymer electrolyte. + Higher efficiency, faster response. + annotations: + electrolyte: + tag: electrolyte + value: polymer_membrane + maturity: + tag: maturity + value: commercial + title: PEM Electrolysis + aliases: + - PEMEC + - Polymer Electrolyte Membrane Electrolysis + SOLID_OXIDE_ELECTROLYSIS: + text: SOLID_OXIDE_ELECTROLYSIS + description: High temperature electrolysis using solid ceramic electrolyte. + Higher efficiency when waste heat is available. + annotations: + electrolyte: + tag: electrolyte + value: solid_oxide + temperature_c: + tag: temperature_c + value: 700-850 + maturity: + tag: maturity + value: emerging + title: Solid Oxide Electrolysis (SOEC) + aliases: + - SOEC + METHANE_PYROLYSIS: + text: METHANE_PYROLYSIS + description: Thermal decomposition of methane into hydrogen and solid carbon + without oxygen. Produces no direct CO2. + annotations: + feedstock: + tag: feedstock + value: natural_gas + byproduct: + tag: byproduct + value: solid_carbon + title: Methane Pyrolysis + aliases: + - Thermal Cracking + BIOMASS_GASIFICATION: + text: BIOMASS_GASIFICATION + description: Thermochemical conversion of biomass to hydrogen-rich syngas + at high temperatures. + annotations: + feedstock: + tag: feedstock + value: biomass + renewable: + tag: renewable + value: true + title: Biomass Gasification + narrow_mappings: + - sweet:procPhysical/Gasification + BIOLOGICAL_PRODUCTION: + text: BIOLOGICAL_PRODUCTION + description: Production of hydrogen by microorganisms through photosynthesis, + fermentation, or other biological processes. + annotations: + renewable: + tag: renewable + value: true + maturity: + tag: maturity + value: research + title: Biological Hydrogen Production + aliases: + - Biohydrogen + THERMOCHEMICAL_WATER_SPLITTING: + text: THERMOCHEMICAL_WATER_SPLITTING + description: Using high temperatures from concentrated solar or nuclear to + drive chemical cycles that split water. + annotations: + temperature_c: + tag: temperature_c + value: 500-2000 + maturity: + tag: maturity + value: research + title: Thermochemical Water Splitting + PHOTOELECTROCHEMICAL: + text: PHOTOELECTROCHEMICAL + description: Direct conversion of sunlight to hydrogen using specialized semiconductor + materials in contact with water. + annotations: + maturity: + tag: maturity + value: research + title: Photoelectrochemical Water Splitting + aliases: + - PEC + HydrogenStorageMethod: + name: HydrogenStorageMethod + definition_uri: https://w3id.org/valuesets/HydrogenStorageMethod + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Methods for storing hydrogen for later use or transport. + title: Hydrogen Storage Method + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + COMPRESSED_GAS: + text: COMPRESSED_GAS + description: Storage of hydrogen as compressed gas at high pressure (350-700 + bar) in pressure vessels. + annotations: + pressure_bar: + tag: pressure_bar + value: 350-700 + maturity: + tag: maturity + value: commercial + title: Compressed Gas Storage + aliases: + - CGH2 + LIQUID_HYDROGEN: + text: LIQUID_HYDROGEN + description: Storage of hydrogen in liquid form at cryogenic temperatures + (-253C). Higher energy density but requires insulation. + annotations: + temperature_c: + tag: temperature_c + value: -253 + maturity: + tag: maturity + value: commercial + title: Liquid Hydrogen Storage + aliases: + - LH2 + METAL_HYDRIDE: + text: METAL_HYDRIDE + description: Storage of hydrogen absorbed into metal alloys forming metal + hydrides. Safer but heavier than compressed gas. + annotations: + maturity: + tag: maturity + value: commercial + title: Metal Hydride Storage + CHEMICAL_HYDRIDE: + text: CHEMICAL_HYDRIDE + description: Storage as chemical compounds (ammonia, methanol, LOHC) that + release hydrogen when processed. + title: Chemical Hydride Storage + aliases: + - LOHC + - Liquid Organic Hydrogen Carrier + UNDERGROUND_STORAGE: + text: UNDERGROUND_STORAGE + description: Large-scale storage in salt caverns, depleted gas fields, or + aquifers for grid-scale applications. + annotations: + scale: + tag: scale + value: utility + title: Underground Storage + aliases: + - Geological Storage + CRYO_COMPRESSED: + text: CRYO_COMPRESSED + description: Hybrid approach combining cryogenic cooling with high pressure + for improved density. + annotations: + maturity: + tag: maturity + value: emerging + title: Cryo-Compressed Storage + aliases: + - CcH2 + HydrogenApplication: + name: HydrogenApplication + definition_uri: https://w3id.org/valuesets/HydrogenApplication + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: End-use applications for hydrogen. + title: Hydrogen Application + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + FUEL_CELL_VEHICLE: + text: FUEL_CELL_VEHICLE + description: Use of hydrogen in fuel cells for transportation (cars, trucks, + buses). + title: Fuel Cell Electric Vehicle + aliases: + - FCEV + FUEL_CELL_STATIONARY: + text: FUEL_CELL_STATIONARY + description: Use of hydrogen in stationary fuel cells for power generation. + title: Stationary Fuel Cell + INDUSTRIAL_FEEDSTOCK: + text: INDUSTRIAL_FEEDSTOCK + description: Use of hydrogen as chemical feedstock for ammonia production, + petroleum refining, and chemical synthesis. + meaning: CHEBI:18276 + title: Industrial Feedstock + STEEL_PRODUCTION: + text: STEEL_PRODUCTION + description: Use of hydrogen to reduce iron ore in steelmaking, replacing + coal. + title: Steel Production (Direct Reduction) + aliases: + - Green Steel + AMMONIA_SYNTHESIS: + text: AMMONIA_SYNTHESIS + description: Use of hydrogen with nitrogen to produce ammonia for fertilizers. + title: Ammonia Synthesis + related_mappings: + - sweet:matrCompound/Ammonia + METHANOL_SYNTHESIS: + text: METHANOL_SYNTHESIS + description: Use of hydrogen with CO2 to produce methanol. + title: Methanol Synthesis + related_mappings: + - sweet:matrOrganicCompound/Methanol + POWER_TO_GAS: + text: POWER_TO_GAS + description: Conversion of excess renewable electricity to hydrogen for grid + balancing and energy storage. + title: Power-to-Gas + aliases: + - P2G + BLENDING_NATURAL_GAS: + text: BLENDING_NATURAL_GAS + description: Blending hydrogen into natural gas pipelines for decarbonization + of heating. + title: Natural Gas Blending + SYNTHETIC_FUELS: + text: SYNTHETIC_FUELS + description: Use of hydrogen with captured CO2 to produce synthetic hydrocarbons + (e-fuels, SAF). + title: Synthetic Fuel Production + aliases: + - E-Fuels + - Power-to-Liquid + BiomassFeedstockType: + name: BiomassFeedstockType + definition_uri: https://w3id.org/valuesets/BiomassFeedstockType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of biomass materials used as feedstocks for bioenergy production. + Includes dedicated energy crops, agricultural residues, forest residues, and + waste streams. + title: Biomass Feedstock Type + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + see_also: + - https://www.energy.gov/eere/bioenergy/feedstock-technologies + - https://www.energy.gov/eere/bioenergy/biomass-resources + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + CORN_STOVER: + text: CORN_STOVER + description: Agricultural residue consisting of leaves, stalks, and cobs remaining + after corn grain harvest. + annotations: + category: + tag: category + value: agricultural_residue + lignocellulosic: + tag: lignocellulosic + value: true + title: Corn Stover + aliases: + - Corn Residue + WHEAT_STRAW: + text: WHEAT_STRAW + description: Agricultural residue remaining after wheat grain harvest. + annotations: + category: + tag: category + value: agricultural_residue + lignocellulosic: + tag: lignocellulosic + value: true + title: Wheat Straw + RICE_STRAW: + text: RICE_STRAW + description: Agricultural residue remaining after rice grain harvest. + annotations: + category: + tag: category + value: agricultural_residue + lignocellulosic: + tag: lignocellulosic + value: true + title: Rice Straw + SWITCHGRASS: + text: SWITCHGRASS + description: Perennial warm-season grass native to North America, cultivated + as dedicated energy crop for cellulosic biofuel production. + annotations: + category: + tag: category + value: energy_crop + lignocellulosic: + tag: lignocellulosic + value: true + perennial: + tag: perennial + value: true + title: Switchgrass + related_mappings: + - AGRO:00000325 + MISCANTHUS: + text: MISCANTHUS + description: High-yielding perennial grass cultivated as dedicated energy + crop. + annotations: + category: + tag: category + value: energy_crop + lignocellulosic: + tag: lignocellulosic + value: true + perennial: + tag: perennial + value: true + title: Miscanthus + aliases: + - Elephant Grass + ENERGY_CANE: + text: ENERGY_CANE + description: High-fiber sugarcane varieties bred for biomass production rather + than sugar content. + annotations: + category: + tag: category + value: energy_crop + lignocellulosic: + tag: lignocellulosic + value: true + title: Energy Cane + SWEET_SORGHUM: + text: SWEET_SORGHUM + description: Sorghum variety with high sugar content in stalks, suitable for + both sugar and lignocellulosic conversion. + annotations: + category: + tag: category + value: energy_crop + sugar_crop: + tag: sugar_crop + value: true + title: Sweet Sorghum + POPLAR: + text: POPLAR + description: Fast-growing hardwood tree cultivated as short-rotation woody + crop for biomass. + annotations: + category: + tag: category + value: woody_crop + lignocellulosic: + tag: lignocellulosic + value: true + title: Poplar + aliases: + - Hybrid Poplar + WILLOW: + text: WILLOW + description: Fast-growing shrub cultivated as short-rotation woody crop. + annotations: + category: + tag: category + value: woody_crop + lignocellulosic: + tag: lignocellulosic + value: true + title: Willow + aliases: + - Shrub Willow + FOREST_RESIDUE: + text: FOREST_RESIDUE + description: Biomass from forest operations including logging residues, thinning + material, and salvage timber. + annotations: + category: + tag: category + value: forestry_residue + lignocellulosic: + tag: lignocellulosic + value: true + title: Forest Residue + aliases: + - Logging Residue + related_mappings: + - AGRO:00000546 + broad_mappings: + - sweet:matrBiomass/Biomass + WOOD_PROCESSING_RESIDUE: + text: WOOD_PROCESSING_RESIDUE + description: Byproducts from wood processing including sawdust, bark, shavings, + and wood chips. + annotations: + category: + tag: category + value: processing_residue + lignocellulosic: + tag: lignocellulosic + value: true + title: Wood Processing Residue + aliases: + - Mill Residue + MUNICIPAL_SOLID_WASTE: + text: MUNICIPAL_SOLID_WASTE + description: Organic portion of municipal solid waste suitable for bioenergy + conversion. + annotations: + category: + tag: category + value: waste + title: Municipal Solid Waste (Organic Fraction) + aliases: + - MSW + related_mappings: + - ENVO:00002273 + FOOD_WASTE: + text: FOOD_WASTE + description: Waste food from residential, commercial, and industrial sources. + annotations: + category: + tag: category + value: wet_waste + title: Food Waste + ANIMAL_MANURE: + text: ANIMAL_MANURE + description: Livestock waste including cattle, swine, and poultry manure. + annotations: + category: + tag: category + value: wet_waste + biogas_suitable: + tag: biogas_suitable + value: true + title: Animal Manure + related_mappings: + - ENVO:00003031 + ALGAE: + text: ALGAE + description: Microalgae or macroalgae cultivated for lipid or carbohydrate + content for biofuel production. + annotations: + category: + tag: category + value: aquatic_biomass + lipid_rich: + tag: lipid_rich + value: true + title: Algae + aliases: + - Microalgae + USED_COOKING_OIL: + text: USED_COOKING_OIL + description: Waste vegetable oils from food preparation. + annotations: + category: + tag: category + value: waste + lipid_rich: + tag: lipid_rich + value: true + title: Used Cooking Oil + aliases: + - UCO + - Waste Vegetable Oil + SOYBEAN_OIL: + text: SOYBEAN_OIL + description: Vegetable oil from soybean seeds, used for biodiesel. + meaning: CHEBI:166975 + annotations: + category: + tag: category + value: oil_crop + lipid_rich: + tag: lipid_rich + value: true + title: Soybean Oil + CORN_GRAIN: + text: CORN_GRAIN + description: Corn kernels used for starch-based ethanol production. + annotations: + category: + tag: category + value: grain + starch_crop: + tag: starch_crop + value: true + title: Corn Grain + SUGARCANE: + text: SUGARCANE + description: Sugar-rich crop used for first-generation ethanol production. + annotations: + category: + tag: category + value: sugar_crop + title: Sugarcane + BiofuelType: + name: BiofuelType + definition_uri: https://w3id.org/valuesets/BiofuelType + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Types of fuels produced from biomass feedstocks. + title: Biofuel Type + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + see_also: + - https://www.energy.gov/eere/bioenergy/full-text-glossary + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + ETHANOL: + text: ETHANOL + description: Alcohol biofuel (C2H5OH) produced by fermentation of sugars or + starches, or from cellulosic biomass. + meaning: CHEBI:16236 + annotations: + chemical_formula: + tag: chemical_formula + value: C2H5OH + title: Ethanol + aliases: + - Fuel Ethanol + - Bioethanol + close_mappings: + - sweet:matrEnergy/Ethanol + BIODIESEL: + text: BIODIESEL + description: Fatty acid methyl esters (FAME) produced by transesterification + of vegetable oils or animal fats. + meaning: MESH:D056804 + annotations: + production_method: + tag: production_method + value: transesterification + title: Biodiesel + aliases: + - FAME + close_mappings: + - sweet:matrEnergy/Biodiesel + RENEWABLE_DIESEL: + text: RENEWABLE_DIESEL + description: Hydrocarbon diesel produced by hydrotreating lipids. Chemically + identical to petroleum diesel. + annotations: + drop_in_fuel: + tag: drop_in_fuel + value: true + title: Renewable Diesel + aliases: + - Green Diesel + - HVO + - Hydrotreated Vegetable Oil + SUSTAINABLE_AVIATION_FUEL: + text: SUSTAINABLE_AVIATION_FUEL + description: Jet fuel produced from biomass or waste, meeting aviation fuel + specifications. + annotations: + drop_in_fuel: + tag: drop_in_fuel + value: true + title: Sustainable Aviation Fuel (SAF) + aliases: + - SAF + - Biojet + BIOGAS: + text: BIOGAS + description: Gaseous mixture of methane and CO2 produced by anaerobic digestion + of organic matter. + annotations: + methane_content_percent: + tag: methane_content_percent + value: 50-70 + title: Biogas + aliases: + - Raw Biogas + BIOMETHANE: + text: BIOMETHANE + description: Purified biogas upgraded to natural gas quality (>95% methane). + annotations: + methane_content_percent: + tag: methane_content_percent + value: 95+ + pipeline_quality: + tag: pipeline_quality + value: true + title: Biomethane + aliases: + - Renewable Natural Gas + - RNG + broad_mappings: + - sweet:matrOrganicCompound/Methane + BIO_OIL: + text: BIO_OIL + description: Liquid intermediate produced by pyrolysis or hydrothermal liquefaction + of biomass. + annotations: + intermediate: + tag: intermediate + value: true + title: Bio-Oil + aliases: + - Pyrolysis Oil + SYNGAS: + text: SYNGAS + description: Synthesis gas (CO + H2) produced by gasification of biomass. + meaning: CHMO:0001501 + annotations: + intermediate: + tag: intermediate + value: true + title: Syngas (Bio-Based) + aliases: + - Synthesis Gas + close_mappings: + - sweet:matrEnergy/Syngas + BUTANOL: + text: BUTANOL + description: Four-carbon alcohol biofuel with higher energy density than ethanol. + meaning: CHEBI:28885 + annotations: + chemical_formula: + tag: chemical_formula + value: C4H9OH + title: Biobutanol + METHANOL: + text: METHANOL + description: Methanol produced from biomass-derived syngas. + meaning: CHEBI:17790 + annotations: + chemical_formula: + tag: chemical_formula + value: CH3OH + title: Biomethanol + DIMETHYL_ETHER: + text: DIMETHYL_ETHER + description: Dimethyl ether produced from biomass, usable as diesel substitute. + meaning: CHEBI:28887 + title: Bio-DME + aliases: + - DME + BiofuelGeneration: + name: BiofuelGeneration + definition_uri: https://w3id.org/valuesets/BiofuelGeneration + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Classification of biofuels by feedstock source and technology generation. + title: Biofuel Generation + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + FIRST_GENERATION: + text: FIRST_GENERATION + description: Biofuels produced from food crops (sugar, starch, vegetable oils) + using conventional conversion technologies. + annotations: + feedstock: + tag: feedstock + value: food_crops + examples: + tag: examples + value: corn_ethanol,soy_biodiesel + title: First Generation Biofuel + aliases: + - 1G Biofuel + - Conventional Biofuel + SECOND_GENERATION: + text: SECOND_GENERATION + description: Biofuels produced from lignocellulosic biomass (non-food) using + advanced conversion technologies. + annotations: + feedstock: + tag: feedstock + value: lignocellulosic + examples: + tag: examples + value: cellulosic_ethanol,wood_diesel + title: Second Generation Biofuel + aliases: + - 2G Biofuel + - Cellulosic Biofuel + - Advanced Biofuel + THIRD_GENERATION: + text: THIRD_GENERATION + description: Biofuels produced from algae or other photosynthetic microorganisms. + annotations: + feedstock: + tag: feedstock + value: algae + title: Third Generation Biofuel + aliases: + - 3G Biofuel + - Algal Biofuel + FOURTH_GENERATION: + text: FOURTH_GENERATION + description: Biofuels from genetically engineered organisms designed for carbon + capture and enhanced fuel production. + annotations: + feedstock: + tag: feedstock + value: engineered_organisms + carbon_negative: + tag: carbon_negative + value: true + title: Fourth Generation Biofuel + aliases: + - 4G Biofuel + BioconversionProcess: + name: BioconversionProcess + definition_uri: https://w3id.org/valuesets/BioconversionProcess + instantiates: + - valuesets_meta:ValueSetEnumDefinition + description: Processes for converting biomass feedstocks into biofuels and bioproducts. + title: Bioconversion Process + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + status: DRAFT + permissible_values: + FERMENTATION: + text: FERMENTATION + description: Biological conversion of sugars to alcohols using yeast or bacteria. + annotations: + category: + tag: category + value: biochemical + products: + tag: products + value: ethanol,butanol + title: Fermentation + ANAEROBIC_DIGESTION: + text: ANAEROBIC_DIGESTION + description: Biological breakdown of organic matter by microorganisms in the + absence of oxygen, producing biogas. + annotations: + category: + tag: category + value: biochemical + products: + tag: products + value: biogas + title: Anaerobic Digestion + TRANSESTERIFICATION: + text: TRANSESTERIFICATION + description: Chemical reaction of triglycerides with alcohol to produce fatty + acid esters (biodiesel) and glycerol. + annotations: + category: + tag: category + value: chemical + products: + tag: products + value: biodiesel + title: Transesterification + HYDROTREATING: + text: HYDROTREATING + description: Catalytic reaction of lipids with hydrogen to produce hydrocarbon + fuels. + annotations: + category: + tag: category + value: thermochemical + products: + tag: products + value: renewable_diesel,SAF + title: Hydrotreating/Hydroprocessing + aliases: + - Hydroprocessing + PYROLYSIS: + text: PYROLYSIS + description: Thermal decomposition of biomass in the absence of oxygen to + produce bio-oil, syngas, and biochar. + annotations: + category: + tag: category + value: thermochemical + temperature_c: + tag: temperature_c + value: 400-600 + products: + tag: products + value: bio_oil,syngas,biochar + title: Pyrolysis + GASIFICATION: + text: GASIFICATION + description: High-temperature conversion of carbonaceous materials to syngas + using controlled oxygen and/or steam. + meaning: CHMO:0001501 + annotations: + category: + tag: category + value: thermochemical + temperature_c: + tag: temperature_c + value: 700-1500 + products: + tag: products + value: syngas + title: Gasification + HYDROTHERMAL_LIQUEFACTION: + text: HYDROTHERMAL_LIQUEFACTION + description: Conversion of wet biomass to bio-crude using high temperature + and pressure water. + annotations: + category: + tag: category + value: thermochemical + temperature_c: + tag: temperature_c + value: 250-400 + pressure_bar: + tag: pressure_bar + value: 100-200 + wet_feedstock: + tag: wet_feedstock + value: true + title: Hydrothermal Liquefaction (HTL) + aliases: + - HTL + ENZYMATIC_HYDROLYSIS: + text: ENZYMATIC_HYDROLYSIS + description: Breakdown of cellulose and hemicellulose to fermentable sugars + using enzymes. + annotations: + category: + tag: category + value: biochemical + pretreatment_step: + tag: pretreatment_step + value: true + title: Enzymatic Hydrolysis + ACID_HYDROLYSIS: + text: ACID_HYDROLYSIS + description: Chemical breakdown of cellulose to sugars using dilute or concentrated + acid. + annotations: + category: + tag: category + value: chemical + pretreatment_step: + tag: pretreatment_step + value: true + title: Acid Hydrolysis + FISCHER_TROPSCH: + text: FISCHER_TROPSCH + description: Catalytic conversion of syngas to liquid hydrocarbons. + annotations: + category: + tag: category + value: thermochemical + feedstock: + tag: feedstock + value: syngas + products: + tag: products + value: FT_diesel,FT_jet + title: Fischer-Tropsch Synthesis + aliases: + - FT Synthesis + ALCOHOL_TO_JET: + text: ALCOHOL_TO_JET + description: Conversion of alcohols (ethanol, isobutanol) to jet fuel through + dehydration, oligomerization, and hydrogenation. + annotations: + category: + tag: category + value: chemical + products: + tag: products + value: SAF + title: Alcohol-to-Jet (ATJ) + aliases: + - ATJ MiningType: name: MiningType definition_uri: https://w3id.org/valuesets/MiningType @@ -21392,6 +23553,183 @@ enums: context: tag: context value: neurons, polarized cells + AnatomicalOrientation: + name: AnatomicalOrientation + definition_uri: https://w3id.org/valuesets/AnatomicalOrientation + description: Directional orientation between anatomical positions based on OME + NGFF specification + from_schema: https://w3id.org/linkml/valuesets/spatial/spatial_qualifiers + permissible_values: + LEFT_TO_RIGHT: + text: LEFT_TO_RIGHT + description: Directional orientation from left to right lateral side of an + anatomical structure + annotations: + source: + tag: source + value: OME NGFF + title: Left to right orientation + RIGHT_TO_LEFT: + text: RIGHT_TO_LEFT + description: Directional orientation from right to left lateral side of an + anatomical structure + annotations: + source: + tag: source + value: OME NGFF + title: Right to left orientation + ANTERIOR_TO_POSTERIOR: + text: ANTERIOR_TO_POSTERIOR + description: Directional orientation from front to back of an anatomical structure + annotations: + source: + tag: source + value: OME NGFF + title: Anterior to posterior orientation + POSTERIOR_TO_ANTERIOR: + text: POSTERIOR_TO_ANTERIOR + description: Directional orientation from back to front of an anatomical structure + annotations: + source: + tag: source + value: OME NGFF + title: Posterior to anterior orientation + INFERIOR_TO_SUPERIOR: + text: INFERIOR_TO_SUPERIOR + description: Directional orientation from below to above in an anatomical + structure + annotations: + source: + tag: source + value: OME NGFF + title: Inferior to superior orientation + SUPERIOR_TO_INFERIOR: + text: SUPERIOR_TO_INFERIOR + description: Directional orientation from above to below in an anatomical + structure + annotations: + source: + tag: source + value: OME NGFF + title: Superior to inferior orientation + DORSAL_TO_VENTRAL: + text: DORSAL_TO_VENTRAL + description: Directional orientation from top/upper to belly/lower in an anatomical + structure + annotations: + source: + tag: source + value: OME NGFF + title: Dorsal to ventral orientation + VENTRAL_TO_DORSAL: + text: VENTRAL_TO_DORSAL + description: Directional orientation from belly/lower to top/upper in an anatomical + structure + annotations: + source: + tag: source + value: OME NGFF + title: Ventral to dorsal orientation + DORSAL_TO_PALMAR: + text: DORSAL_TO_PALMAR + description: Directional orientation from top/upper to palm of hand + annotations: + source: + tag: source + value: OME NGFF + context: + tag: context + value: hand anatomy + title: Dorsal to palmar orientation + PALMAR_TO_DORSAL: + text: PALMAR_TO_DORSAL + description: Directional orientation from palm of hand to top/upper + annotations: + source: + tag: source + value: OME NGFF + context: + tag: context + value: hand anatomy + title: Palmar to dorsal orientation + DORSAL_TO_PLANTAR: + text: DORSAL_TO_PLANTAR + description: Directional orientation from top/upper to sole of foot + annotations: + source: + tag: source + value: OME NGFF + context: + tag: context + value: foot anatomy + title: Dorsal to plantar orientation + PLANTAR_TO_DORSAL: + text: PLANTAR_TO_DORSAL + description: Directional orientation from sole of foot to top/upper + annotations: + source: + tag: source + value: OME NGFF + context: + tag: context + value: foot anatomy + title: Plantar to dorsal orientation + ROSTRAL_TO_CAUDAL: + text: ROSTRAL_TO_CAUDAL + description: Directional orientation from nasal to tail end, typically for + central nervous system + annotations: + source: + tag: source + value: OME NGFF + context: + tag: context + value: central nervous system + title: Rostral to caudal orientation + CAUDAL_TO_ROSTRAL: + text: CAUDAL_TO_ROSTRAL + description: Directional orientation from tail to nasal end, typically for + central nervous system + annotations: + source: + tag: source + value: OME NGFF + context: + tag: context + value: central nervous system + title: Caudal to rostral orientation + CRANIAL_TO_CAUDAL: + text: CRANIAL_TO_CAUDAL + description: Directional orientation from head to tail end of a structure + annotations: + source: + tag: source + value: OME NGFF + title: Cranial to caudal orientation + CAUDAL_TO_CRANIAL: + text: CAUDAL_TO_CRANIAL + description: Directional orientation from tail to head end of a structure + annotations: + source: + tag: source + value: OME NGFF + title: Caudal to cranial orientation + PROXIMAL_TO_DISTAL: + text: PROXIMAL_TO_DISTAL + description: Directional orientation from body center to periphery of a structure + annotations: + source: + tag: source + value: OME NGFF + title: Proximal to distal orientation + DISTAL_TO_PROXIMAL: + text: DISTAL_TO_PROXIMAL + description: Directional orientation from periphery to body center of a structure + annotations: + source: + tag: source + value: OME NGFF + title: Distal to proximal orientation CrystalSystemEnum: name: CrystalSystemEnum definition_uri: https://w3id.org/valuesets/CrystalSystemEnum @@ -40070,7 +42408,7 @@ enums: name: KaryotypicSexEnum definition_uri: https://w3id.org/valuesets/KaryotypicSexEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40210,7 +42548,7 @@ enums: name: PhenotypicSexEnum definition_uri: https://w3id.org/valuesets/PhenotypicSexEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40258,7 +42596,7 @@ enums: name: AllelicStateEnum definition_uri: https://w3id.org/valuesets/AllelicStateEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40331,7 +42669,7 @@ enums: name: LateralityEnum definition_uri: https://w3id.org/valuesets/LateralityEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40390,7 +42728,7 @@ enums: name: OnsetTimingEnum definition_uri: https://w3id.org/valuesets/OnsetTimingEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40498,7 +42836,7 @@ enums: name: ACMGPathogenicityEnum definition_uri: https://w3id.org/valuesets/ACMGPathogenicityEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40578,7 +42916,7 @@ enums: name: TherapeuticActionabilityEnum definition_uri: https://w3id.org/valuesets/TherapeuticActionabilityEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40621,7 +42959,7 @@ enums: name: InterpretationProgressEnum definition_uri: https://w3id.org/valuesets/InterpretationProgressEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40678,7 +43016,7 @@ enums: name: RegimenStatusEnum definition_uri: https://w3id.org/valuesets/RegimenStatusEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -40746,7 +43084,7 @@ enums: name: DrugResponseEnum definition_uri: https://w3id.org/valuesets/DrugResponseEnum instantiates: - - valuesets_meta:ValueSetEnumDefinitionWithStewardship + - valuesets_meta:ValueSetEnumDefinition annotations: stewards: tag: stewards @@ -55279,6 +57617,27 @@ slots: from_schema: https://w3id.org/linkml/valuesets/energy/energy slot_uri: valuesets:energy_storage range: EnergyStorageType + battery_type: + name: battery_type + definition_uri: https://w3id.org/valuesets/battery_type + description: Types of battery technologies + from_schema: https://w3id.org/linkml/valuesets/energy/energy + slot_uri: valuesets:battery_type + range: BatteryType + pv_cell_type: + name: pv_cell_type + definition_uri: https://w3id.org/valuesets/pv_cell_type + description: Types of photovoltaic cell technologies + from_schema: https://w3id.org/linkml/valuesets/energy/energy + slot_uri: valuesets:pv_cell_type + range: PVCellType + pv_system_type: + name: pv_system_type + definition_uri: https://w3id.org/valuesets/pv_system_type + description: Types of photovoltaic system installations + from_schema: https://w3id.org/linkml/valuesets/energy/energy + slot_uri: valuesets:pv_system_type + range: PVSystemType emission_scope: name: emission_scope definition_uri: https://w3id.org/valuesets/emission_scope @@ -55300,6 +57659,13 @@ slots: from_schema: https://w3id.org/linkml/valuesets/energy/energy slot_uri: valuesets:electricity_market range: ElectricityMarket + capability_status: + name: capability_status + definition_uri: https://w3id.org/valuesets/capability_status + description: Operational status of a capability or facility + from_schema: https://w3id.org/linkml/valuesets/energy/energy + slot_uri: valuesets:capability_status + range: CapabilityStatus fossil_fuel_type: name: fossil_fuel_type definition_uri: https://w3id.org/valuesets/fossil_fuel_type @@ -55573,6 +57939,97 @@ slots: from_schema: https://w3id.org/linkml/valuesets/energy/nuclear/nuclear_operations slot_uri: valuesets:operational_procedure range: OperationalProcedureEnum + geothermal_system_type: + name: geothermal_system_type + definition_uri: https://w3id.org/valuesets/geothermal_system_type + description: Type of geothermal system + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + slot_uri: valuesets:geothermal_system_type + range: GeothermalSystemType + geothermal_reservoir_type: + name: geothermal_reservoir_type + definition_uri: https://w3id.org/valuesets/geothermal_reservoir_type + description: Type of geothermal reservoir + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + slot_uri: valuesets:geothermal_reservoir_type + range: GeothermalReservoirType + geothermal_well_type: + name: geothermal_well_type + definition_uri: https://w3id.org/valuesets/geothermal_well_type + description: Type of geothermal well + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + slot_uri: valuesets:geothermal_well_type + range: GeothermalWellType + geothermal_application: + name: geothermal_application + definition_uri: https://w3id.org/valuesets/geothermal_application + description: Application of geothermal energy + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + slot_uri: valuesets:geothermal_application + range: GeothermalApplication + geothermal_resource_temperature: + name: geothermal_resource_temperature + definition_uri: https://w3id.org/valuesets/geothermal_resource_temperature + description: Temperature classification of geothermal resources + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/geothermal + slot_uri: valuesets:geothermal_resource_temperature + range: GeothermalResourceTemperature + hydrogen_type: + name: hydrogen_type + definition_uri: https://w3id.org/valuesets/hydrogen_type + description: Type of hydrogen classified by production method and carbon intensity + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + slot_uri: valuesets:hydrogen_type + range: HydrogenType + hydrogen_production_method: + name: hydrogen_production_method + definition_uri: https://w3id.org/valuesets/hydrogen_production_method + description: Method used to produce hydrogen + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + slot_uri: valuesets:hydrogen_production_method + range: HydrogenProductionMethod + hydrogen_storage_method: + name: hydrogen_storage_method + definition_uri: https://w3id.org/valuesets/hydrogen_storage_method + description: Method used to store hydrogen + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + slot_uri: valuesets:hydrogen_storage_method + range: HydrogenStorageMethod + hydrogen_application: + name: hydrogen_application + definition_uri: https://w3id.org/valuesets/hydrogen_application + description: Application or end use of hydrogen + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen + slot_uri: valuesets:hydrogen_application + range: HydrogenApplication + biomass_feedstock_type: + name: biomass_feedstock_type + definition_uri: https://w3id.org/valuesets/biomass_feedstock_type + description: Type of biomass feedstock for bioenergy production + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + slot_uri: valuesets:biomass_feedstock_type + range: BiomassFeedstockType + biofuel_type: + name: biofuel_type + definition_uri: https://w3id.org/valuesets/biofuel_type + description: Type of biofuel product + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + slot_uri: valuesets:biofuel_type + range: BiofuelType + biofuel_generation: + name: biofuel_generation + definition_uri: https://w3id.org/valuesets/biofuel_generation + description: Generation classification of biofuel + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + slot_uri: valuesets:biofuel_generation + range: BiofuelGeneration + bioconversion_process: + name: bioconversion_process + definition_uri: https://w3id.org/valuesets/bioconversion_process + description: Process for converting biomass to biofuel + from_schema: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy + slot_uri: valuesets:bioconversion_process + range: BioconversionProcess mining: name: mining definition_uri: https://w3id.org/valuesets/mining @@ -56057,6 +58514,13 @@ slots: from_schema: https://w3id.org/linkml/valuesets/spatial/spatial_qualifiers slot_uri: valuesets:cell_polarity range: CellPolarity + anatomical_orientation: + name: anatomical_orientation + definition_uri: https://w3id.org/valuesets/anatomical_orientation + description: Directional orientation between anatomical positions + from_schema: https://w3id.org/linkml/valuesets/spatial/spatial_qualifiers + slot_uri: valuesets:anatomical_orientation + range: AnatomicalOrientation crystal_system: name: crystal_system definition_uri: https://w3id.org/valuesets/crystal_system @@ -57829,7 +60293,7 @@ classes: class_uri: valuesets:Fake metamodel_version: 1.7.0 source_file: valuesets.yaml -source_file_date: '2025-11-25T10:16:53' -source_file_size: 2915 -generation_date: '2025-11-25T11:01:16' +source_file_date: '2025-12-05T22:33:14' +source_file_size: 3002 +generation_date: '2025-12-07T12:12:52' diff --git a/docs/slides/valuesets-slides.pdf b/docs/slides/valuesets-slides.pdf index d49aaacd..0688a0f7 100644 Binary files a/docs/slides/valuesets-slides.pdf and b/docs/slides/valuesets-slides.pdf differ diff --git a/docs/slides/valuesets-slides.pptx b/docs/slides/valuesets-slides.pptx index bf5b3ed1..138ae143 100644 Binary files a/docs/slides/valuesets-slides.pptx and b/docs/slides/valuesets-slides.pptx differ diff --git a/justfile b/justfile index 4cfec018..956b59a0 100644 --- a/justfile +++ b/justfile @@ -368,6 +368,12 @@ uniprot-stats: echo "Current YAML: [not found]"; \ fi +# Generate CSV report of all enums with mapping statistics +[group('reports')] +enum-report: + uv run python scripts/generate_enum_report.py + @echo "Report saved to enum_report.csv" + # ============== Include project-specific recipes ============== import "python.justfile" diff --git a/project/jsonschema/valuesets.schema.json b/project/jsonschema/valuesets.schema.json index 3f282e59..eb547a41 100644 --- a/project/jsonschema/valuesets.schema.json +++ b/project/jsonschema/valuesets.schema.json @@ -223,6 +223,31 @@ "title": "AnatomicalAxis", "type": "string" }, + "AnatomicalOrientation": { + "description": "Directional orientation between anatomical positions based on OME NGFF specification", + "enum": [ + "LEFT_TO_RIGHT", + "RIGHT_TO_LEFT", + "ANTERIOR_TO_POSTERIOR", + "POSTERIOR_TO_ANTERIOR", + "INFERIOR_TO_SUPERIOR", + "SUPERIOR_TO_INFERIOR", + "DORSAL_TO_VENTRAL", + "VENTRAL_TO_DORSAL", + "DORSAL_TO_PALMAR", + "PALMAR_TO_DORSAL", + "DORSAL_TO_PLANTAR", + "PLANTAR_TO_DORSAL", + "ROSTRAL_TO_CAUDAL", + "CAUDAL_TO_ROSTRAL", + "CRANIAL_TO_CAUDAL", + "CAUDAL_TO_CRANIAL", + "PROXIMAL_TO_DISTAL", + "DISTAL_TO_PROXIMAL" + ], + "title": "AnatomicalOrientation", + "type": "string" + }, "AnatomicalPlane": { "description": "Standard anatomical planes for sectioning", "enum": [ @@ -488,6 +513,25 @@ "title": "BasicEmotionEnum", "type": "string" }, + "BatteryType": { + "description": "Types of battery technologies for energy storage", + "enum": [ + "LITHIUM_ION", + "LITHIUM_IRON_PHOSPHATE", + "LITHIUM_POLYMER", + "LEAD_ACID", + "NICKEL_METAL_HYDRIDE", + "NICKEL_CADMIUM", + "SODIUM_ION", + "SOLID_STATE", + "VANADIUM_REDOX_FLOW", + "ZINC_BROMINE_FLOW", + "IRON_AIR", + "ZINC_AIR" + ], + "title": "BatteryType", + "type": "string" + }, "BeneficiationPathway": { "description": "Methods for mineral separation and concentration aligned with advanced ore processing initiatives (AOI-2).", "enum": [ @@ -528,6 +572,53 @@ "title": "BinaryClassificationEnum", "type": "string" }, + "BioconversionProcess": { + "description": "Processes for converting biomass feedstocks into biofuels and bioproducts.", + "enum": [ + "FERMENTATION", + "ANAEROBIC_DIGESTION", + "TRANSESTERIFICATION", + "HYDROTREATING", + "PYROLYSIS", + "GASIFICATION", + "HYDROTHERMAL_LIQUEFACTION", + "ENZYMATIC_HYDROLYSIS", + "ACID_HYDROLYSIS", + "FISCHER_TROPSCH", + "ALCOHOL_TO_JET" + ], + "title": "BioconversionProcess", + "type": "string" + }, + "BiofuelGeneration": { + "description": "Classification of biofuels by feedstock source and technology generation.", + "enum": [ + "FIRST_GENERATION", + "SECOND_GENERATION", + "THIRD_GENERATION", + "FOURTH_GENERATION" + ], + "title": "BiofuelGeneration", + "type": "string" + }, + "BiofuelType": { + "description": "Types of fuels produced from biomass feedstocks.", + "enum": [ + "ETHANOL", + "BIODIESEL", + "RENEWABLE_DIESEL", + "SUSTAINABLE_AVIATION_FUEL", + "BIOGAS", + "BIOMETHANE", + "BIO_OIL", + "SYNGAS", + "BUTANOL", + "METHANOL", + "DIMETHYL_ETHER" + ], + "title": "BiofuelType", + "type": "string" + }, "BioleachMode": { "description": "Mechanisms of bioleaching including indirect and direct bacterial action.", "enum": [ @@ -598,6 +689,32 @@ "title": "BiologicalSexEnum", "type": "string" }, + "BiomassFeedstockType": { + "description": "Types of biomass materials used as feedstocks for bioenergy production. Includes dedicated energy crops, agricultural residues, forest residues, and waste streams.", + "enum": [ + "CORN_STOVER", + "WHEAT_STRAW", + "RICE_STRAW", + "SWITCHGRASS", + "MISCANTHUS", + "ENERGY_CANE", + "SWEET_SORGHUM", + "POPLAR", + "WILLOW", + "FOREST_RESIDUE", + "WOOD_PROCESSING_RESIDUE", + "MUNICIPAL_SOLID_WASTE", + "FOOD_WASTE", + "ANIMAL_MANURE", + "ALGAE", + "USED_COOKING_OIL", + "SOYBEAN_OIL", + "CORN_GRAIN", + "SUGARCANE" + ], + "title": "BiomassFeedstockType", + "type": "string" + }, "BioreactorTypeEnum": { "description": "Types of bioreactors used in fermentation and cell culture", "enum": [ @@ -897,6 +1014,18 @@ "title": "CapabilityMaturityLevel", "type": "string" }, + "CapabilityStatus": { + "description": "Operational status of a capability, facility, or infrastructure. Applicable to energy facilities, research capabilities, and other infrastructure throughout their lifecycle.", + "enum": [ + "OPERATIONAL", + "COMING_ONLINE", + "PILOT", + "UNDER_DEVELOPMENT", + "DECOMMISSIONED" + ], + "title": "CapabilityStatus", + "type": "string" + }, "CarbonIntensity": { "description": "Carbon intensity levels for energy sources", "enum": [ @@ -2387,13 +2516,9 @@ "type": "string" }, "EnergyStorageType": { - "description": "Types of energy storage systems", + "description": "Types of energy storage systems (categories)", "enum": [ - "LITHIUM_ION_BATTERY", - "LEAD_ACID_BATTERY", - "FLOW_BATTERY", - "SOLID_STATE_BATTERY", - "SODIUM_ION_BATTERY", + "BATTERY", "PUMPED_HYDRO", "COMPRESSED_AIR", "FLYWHEEL", @@ -3307,6 +3432,72 @@ "title": "GeologicalEra", "type": "string" }, + "GeothermalApplication": { + "description": "Applications and uses of geothermal energy.", + "enum": [ + "ELECTRICITY_GENERATION", + "DIRECT_USE_HEATING", + "GREENHOUSE_HEATING", + "AQUACULTURE", + "INDUSTRIAL_PROCESS_HEAT", + "FOOD_PROCESSING", + "BATHING_RECREATION", + "LITHIUM_EXTRACTION" + ], + "title": "GeothermalApplication", + "type": "string" + }, + "GeothermalReservoirType": { + "description": "Classification of geothermal reservoirs by geological setting and characteristics.", + "enum": [ + "VOLCANIC", + "SEDIMENTARY", + "FRACTURED_BASEMENT", + "FAULT_CONTROLLED", + "MAGMATIC", + "CONDUCTION_DOMINATED" + ], + "title": "GeothermalReservoirType", + "type": "string" + }, + "GeothermalResourceTemperature": { + "description": "Classification of geothermal resources by temperature range.", + "enum": [ + "LOW_TEMPERATURE", + "MODERATE_TEMPERATURE", + "HIGH_TEMPERATURE", + "SUPERCRITICAL" + ], + "title": "GeothermalResourceTemperature", + "type": "string" + }, + "GeothermalSystemType": { + "description": "Types of geothermal energy systems, including conventional hydrothermal and enhanced/engineered geothermal systems.", + "enum": [ + "HYDROTHERMAL", + "ENHANCED_GEOTHERMAL_SYSTEM", + "ADVANCED_GEOTHERMAL_SYSTEM", + "HOT_DRY_ROCK", + "GEOPRESSURED", + "SUPERCRITICAL", + "GROUND_SOURCE_HEAT_PUMP" + ], + "title": "GeothermalSystemType", + "type": "string" + }, + "GeothermalWellType": { + "description": "Types of wells used in geothermal energy development and production.", + "enum": [ + "PRODUCTION_WELL", + "INJECTION_WELL", + "EXPLORATION_WELL", + "OBSERVATION_WELL", + "SLIM_HOLE", + "DIRECTIONAL_WELL" + ], + "title": "GeothermalWellType", + "type": "string" + }, "GridType": { "description": "Types of electrical grid systems", "enum": [ @@ -3479,6 +3670,72 @@ "title": "HumanDevelopmentalStage", "type": "string" }, + "HydrogenApplication": { + "description": "End-use applications for hydrogen.", + "enum": [ + "FUEL_CELL_VEHICLE", + "FUEL_CELL_STATIONARY", + "INDUSTRIAL_FEEDSTOCK", + "STEEL_PRODUCTION", + "AMMONIA_SYNTHESIS", + "METHANOL_SYNTHESIS", + "POWER_TO_GAS", + "BLENDING_NATURAL_GAS", + "SYNTHETIC_FUELS" + ], + "title": "HydrogenApplication", + "type": "string" + }, + "HydrogenProductionMethod": { + "description": "Methods and processes for producing hydrogen.", + "enum": [ + "STEAM_METHANE_REFORMING", + "AUTOTHERMAL_REFORMING", + "PARTIAL_OXIDATION", + "COAL_GASIFICATION", + "WATER_ELECTROLYSIS", + "ALKALINE_ELECTROLYSIS", + "PEM_ELECTROLYSIS", + "SOLID_OXIDE_ELECTROLYSIS", + "METHANE_PYROLYSIS", + "BIOMASS_GASIFICATION", + "BIOLOGICAL_PRODUCTION", + "THERMOCHEMICAL_WATER_SPLITTING", + "PHOTOELECTROCHEMICAL" + ], + "title": "HydrogenProductionMethod", + "type": "string" + }, + "HydrogenStorageMethod": { + "description": "Methods for storing hydrogen for later use or transport.", + "enum": [ + "COMPRESSED_GAS", + "LIQUID_HYDROGEN", + "METAL_HYDRIDE", + "CHEMICAL_HYDRIDE", + "UNDERGROUND_STORAGE", + "CRYO_COMPRESSED" + ], + "title": "HydrogenStorageMethod", + "type": "string" + }, + "HydrogenType": { + "description": "Color-coded classification of hydrogen based on production method and carbon intensity. This informal industry taxonomy differentiates hydrogen by its carbon footprint and energy source.", + "enum": [ + "GREEN_HYDROGEN", + "BLUE_HYDROGEN", + "GREY_HYDROGEN", + "BROWN_HYDROGEN", + "BLACK_HYDROGEN", + "PINK_HYDROGEN", + "TURQUOISE_HYDROGEN", + "WHITE_HYDROGEN", + "YELLOW_HYDROGEN", + "ORANGE_HYDROGEN" + ], + "title": "HydrogenType", + "type": "string" + }, "IAEAWasteClassificationEnum": { "description": "IAEA General Safety Requirements radioactive waste classification scheme", "enum": [ @@ -5613,6 +5870,43 @@ "title": "PCRPlateTypeEnum", "type": "string" }, + "PVCellType": { + "description": "Types of photovoltaic cell technologies", + "enum": [ + "MONOCRYSTALLINE_SILICON", + "POLYCRYSTALLINE_SILICON", + "PASSIVATED_EMITTER_REAR_CELL", + "HETEROJUNCTION", + "TUNNEL_OXIDE_PASSIVATED_CONTACT", + "INTERDIGITATED_BACK_CONTACT", + "CADMIUM_TELLURIDE", + "COPPER_INDIUM_GALLIUM_SELENIDE", + "AMORPHOUS_SILICON", + "GALLIUM_ARSENIDE", + "PEROVSKITE", + "ORGANIC", + "TANDEM" + ], + "title": "PVCellType", + "type": "string" + }, + "PVSystemType": { + "description": "Types of photovoltaic system installations", + "enum": [ + "ROOFTOP_RESIDENTIAL", + "ROOFTOP_COMMERCIAL", + "GROUND_MOUNTED", + "FLOATING", + "BUILDING_INTEGRATED", + "AGRIVOLTAICS", + "CARPORT", + "TRACKER_SINGLE_AXIS", + "TRACKER_DUAL_AXIS", + "CONCENTRATING" + ], + "title": "PVSystemType", + "type": "string" + }, "ParticipantIdentificationMethod": { "description": "Methods to identify interaction participants", "enum": [ diff --git a/scripts/generate_enum_report.py b/scripts/generate_enum_report.py new file mode 100644 index 00000000..ab016210 --- /dev/null +++ b/scripts/generate_enum_report.py @@ -0,0 +1,232 @@ +#!/usr/bin/env python3 +"""Generate a CSV report of all enums in the valuesets schema.""" + +import csv +import re +import sys +from collections import Counter +from pathlib import Path + +import yaml + + +def extract_prefix(curie: str) -> str | None: + """Extract prefix from a CURIE like ENVO:00000001.""" + if not curie: + return None + if ":" in curie: + return curie.split(":")[0] + return None + + +def calculate_heterogeneity(prefixes: list[str]) -> float: + """ + Calculate heterogeneity score based on prefix diversity. + Score ranges from 0 (all same) to 1 (all different). + Uses normalized entropy. + """ + if not prefixes: + return 0.0 + if len(prefixes) == 1: + return 0.0 + + counts = Counter(prefixes) + total = len(prefixes) + unique = len(counts) + + if unique == 1: + return 0.0 + + # Normalized count of unique prefixes relative to total + # More unique prefixes = higher heterogeneity + return round(unique / total, 3) + + +def analyze_enum(enum_name: str, enum_def: dict) -> dict: + """Analyze a single enum definition.""" + pvs = enum_def.get("permissible_values", {}) + if not pvs: + return None + + # Convert all keys to strings (handles YAML booleans like True/False) + pv_names = [str(k) for k in pvs.keys()] + num_pvs = len(pv_names) + + # Collect meanings and other mappings + meanings = [] + pvs_with_meaning = [] + pvs_without_meaning = [] + all_prefixes = [] + + for pv_key, pv_def in pvs.items(): + pv_name = str(pv_key) + if pv_def is None: + pv_def = {} + + has_mapping = False + + # Check meaning field + meaning = pv_def.get("meaning") + if meaning: + has_mapping = True + prefix = extract_prefix(meaning) + if prefix: + meanings.append(meaning) + all_prefixes.append(prefix) + + # Check exact_mappings + for m in pv_def.get("exact_mappings", []) or []: + prefix = extract_prefix(m) + if prefix: + has_mapping = True + all_prefixes.append(prefix) + + # Check related_mappings + for m in pv_def.get("related_mappings", []) or []: + prefix = extract_prefix(m) + if prefix: + has_mapping = True + all_prefixes.append(prefix) + + # Check close_mappings + for m in pv_def.get("close_mappings", []) or []: + prefix = extract_prefix(m) + if prefix: + has_mapping = True + all_prefixes.append(prefix) + + if has_mapping: + pvs_with_meaning.append(pv_name) + else: + pvs_without_meaning.append(pv_name) + + # Calculate stats + pct_with_meaning = round(100 * len(pvs_with_meaning) / num_pvs, 1) if num_pvs > 0 else 0 + + unique_prefixes = sorted(set(all_prefixes)) + heterogeneity = calculate_heterogeneity(all_prefixes) + + # Get status and other metadata + status = enum_def.get("status", "") + title = enum_def.get("title", "") + description = enum_def.get("description", "") + has_description = bool(description and len(description) > 10) + + return { + "enum": enum_name, + "title": title, + "num_pvs": num_pvs, + "num_with_mapping": len(pvs_with_meaning), + "pct_with_meaning": pct_with_meaning, + "heterogeneity": heterogeneity, + "num_vocabs": len(unique_prefixes), + "vocabs": "|".join(unique_prefixes), + "all_pvs": "|".join(pv_names), + "pvs_without_mapping": "|".join(pvs_without_meaning), + "status": status, + "has_description": has_description, + } + + +def process_schema_file(filepath: Path, base_path: Path) -> list[dict]: + """Process a single schema file and return enum analyses.""" + results = [] + + rel_path = filepath.relative_to(base_path) + parts = list(rel_path.parts) + + # Extract category (folder path) and module (filename without .yaml) + module = filepath.stem + if len(parts) > 1: + category = "/".join(parts[:-1]) + else: + category = "" + + with open(filepath) as f: + try: + schema = yaml.safe_load(f) + except yaml.YAMLError as e: + print(f"Error parsing {filepath}: {e}", file=sys.stderr) + return results + + if not schema: + return results + + enums = schema.get("enums", {}) + for enum_name, enum_def in enums.items(): + if not enum_def: + continue + + analysis = analyze_enum(enum_name, enum_def) + if analysis: + analysis["category"] = category + analysis["module"] = module + results.append(analysis) + + return results + + +def main(): + base_path = Path("src/valuesets/schema") + output_path = Path("enum_report.csv") + + if not base_path.exists(): + print(f"Schema path not found: {base_path}", file=sys.stderr) + sys.exit(1) + + all_results = [] + + # Find all YAML files + yaml_files = sorted(base_path.rglob("*.yaml")) + + for filepath in yaml_files: + results = process_schema_file(filepath, base_path) + all_results.extend(results) + + # Sort by category, module, enum + all_results.sort(key=lambda x: (x["category"], x["module"], x["enum"])) + + # Write CSV + fieldnames = [ + "category", + "module", + "enum", + "title", + "num_pvs", + "num_with_mapping", + "pct_with_meaning", + "heterogeneity", + "num_vocabs", + "vocabs", + "status", + "has_description", + "all_pvs", + "pvs_without_mapping", + ] + + with open(output_path, "w", newline="") as f: + writer = csv.DictWriter(f, fieldnames=fieldnames) + writer.writeheader() + writer.writerows(all_results) + + # Print summary + total_enums = len(all_results) + total_pvs = sum(r["num_pvs"] for r in all_results) + total_mapped = sum(r["num_with_mapping"] for r in all_results) + avg_pct = round(100 * total_mapped / total_pvs, 1) if total_pvs > 0 else 0 + + all_vocabs = set() + for r in all_results: + if r["vocabs"]: + all_vocabs.update(r["vocabs"].split("|")) + + print(f"Generated: {output_path}") + print(f"Total enums: {total_enums}") + print(f"Total permissible values: {total_pvs}") + print(f"Total with mappings: {total_mapped} ({avg_pct}%)") + print(f"Unique vocabularies used: {len(all_vocabs)}") + print(f"Vocabularies: {', '.join(sorted(all_vocabs))}") + + +if __name__ == "__main__": + main() diff --git a/src/valuesets/datamodel/valuesets.py b/src/valuesets/datamodel/valuesets.py index 4798862f..da072a96 100644 --- a/src/valuesets/datamodel/valuesets.py +++ b/src/valuesets/datamodel/valuesets.py @@ -1151,14 +1151,14 @@ class SampleType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member SampleType._metadata = { - "PROTEIN": {'description': 'Purified protein sample'}, - "NUCLEIC_ACID": {'description': 'Nucleic acid sample (DNA or RNA)'}, - "PROTEIN_COMPLEX": {'description': 'Protein-protein or protein-nucleic acid complex'}, - "MEMBRANE_PROTEIN": {'description': 'Membrane-associated protein sample'}, - "VIRUS": {'description': 'Viral particle or capsid'}, - "ORGANELLE": {'description': 'Cellular organelle (mitochondria, chloroplast, etc.)'}, - "CELL": {'description': 'Whole cell sample'}, - "TISSUE": {'description': 'Tissue sample'}, + "PROTEIN": {'description': 'Purified protein sample', 'meaning': 'NCIT:C17021'}, + "NUCLEIC_ACID": {'description': 'Nucleic acid sample (DNA or RNA)', 'meaning': 'NCIT:C813'}, + "PROTEIN_COMPLEX": {'description': 'Protein-protein or protein-nucleic acid complex', 'meaning': 'GO:0032991'}, + "MEMBRANE_PROTEIN": {'description': 'Membrane-associated protein sample', 'meaning': 'NCIT:C16837'}, + "VIRUS": {'description': 'Viral particle or capsid', 'meaning': 'NCIT:C14283'}, + "ORGANELLE": {'description': 'Cellular organelle (mitochondria, chloroplast, etc.)', 'meaning': 'GO:0043226'}, + "CELL": {'description': 'Whole cell sample', 'meaning': 'NCIT:C12508'}, + "TISSUE": {'description': 'Tissue sample', 'meaning': 'NCIT:C12801'}, } class StructuralBiologyTechnique(RichEnum): @@ -1180,15 +1180,15 @@ class StructuralBiologyTechnique(RichEnum): # Set metadata after class creation to avoid it becoming an enum member StructuralBiologyTechnique._metadata = { "CRYO_EM": {'description': 'Cryo-electron microscopy', 'meaning': 'CHMO:0002413', 'annotations': {'resolution_range': '2-30 Å typical', 'aliases': 'cryoEM, electron cryo-microscopy'}}, - "CRYO_ET": {'description': 'Cryo-electron tomography', 'annotations': {'resolution_range': '20-100 Å typical', 'aliases': 'cryoET, electron cryo-tomography'}}, + "CRYO_ET": {'description': 'Cryo-electron tomography', 'meaning': 'MI:2338', 'annotations': {'resolution_range': '20-100 Å typical', 'aliases': 'cryoET, electron cryo-tomography'}}, "X_RAY_CRYSTALLOGRAPHY": {'description': 'X-ray crystallography', 'meaning': 'CHMO:0000159', 'annotations': {'resolution_range': '1-4 Å typical', 'aliases': 'XRC, macromolecular crystallography'}}, - "NEUTRON_CRYSTALLOGRAPHY": {'description': 'Neutron crystallography', 'annotations': {'advantages': 'hydrogen positions, deuteration studies'}}, + "NEUTRON_CRYSTALLOGRAPHY": {'description': 'Neutron crystallography', 'meaning': 'CHMO:0000175', 'annotations': {'advantages': 'hydrogen positions, deuteration studies'}}, "SAXS": {'description': 'Small-angle X-ray scattering', 'meaning': 'CHMO:0000204', 'annotations': {'information': 'low-resolution structure, conformational changes'}}, - "SANS": {'description': 'Small-angle neutron scattering', 'annotations': {'advantages': 'contrast variation with deuteration'}}, - "WAXS": {'description': 'Wide-angle X-ray scattering'}, + "SANS": {'description': 'Small-angle neutron scattering', 'meaning': 'CHMO:0000184', 'annotations': {'advantages': 'contrast variation with deuteration'}}, + "WAXS": {'description': 'Wide-angle X-ray scattering', 'meaning': 'CHMO:0000213'}, "NMR": {'description': 'Nuclear magnetic resonance spectroscopy', 'meaning': 'CHMO:0000591', 'annotations': {'information': 'solution structure, dynamics'}}, "MASS_SPECTROMETRY": {'description': 'Mass spectrometry', 'meaning': 'CHMO:0000470', 'annotations': {'applications': 'native MS, crosslinking, HDX'}}, - "NEGATIVE_STAIN_EM": {'description': 'Negative stain electron microscopy', 'annotations': {'resolution_range': '15-30 Å typical'}}, + "NEGATIVE_STAIN_EM": {'description': 'Negative stain electron microscopy', 'meaning': 'FBbi:00000568', 'annotations': {'resolution_range': '15-30 Å typical'}}, } class CryoEMPreparationType(RichEnum): @@ -1283,8 +1283,8 @@ class XRaySource(RichEnum): # Set metadata after class creation to avoid it becoming an enum member XRaySource._metadata = { - "SYNCHROTRON": {'description': 'Synchrotron radiation source', 'annotations': {'advantages': 'high intensity, tunable wavelength', 'brightness': '10^15-10^18 photons/s/mm²/mrad²'}}, - "ROTATING_ANODE": {'description': 'Rotating anode generator', 'annotations': {'power': '3-18 kW typical', 'target': 'copper, molybdenum common'}}, + "SYNCHROTRON": {'description': 'Synchrotron radiation source', 'meaning': 'CHMO:0001810', 'annotations': {'advantages': 'high intensity, tunable wavelength', 'brightness': '10^15-10^18 photons/s/mm²/mrad²'}}, + "ROTATING_ANODE": {'description': 'Rotating anode generator', 'meaning': 'CHMO:0001107', 'annotations': {'power': '3-18 kW typical', 'target': 'copper, molybdenum common'}}, "MICROFOCUS": {'description': 'Microfocus sealed tube', 'annotations': {'spot_size': '10-50 μm', 'applications': 'small crystals, in-house screening'}}, "METAL_JET": {'description': 'Liquid metal jet source', 'annotations': {'advantages': 'higher power density, longer lifetime', 'metals': 'gallium, indium'}}, } @@ -1302,11 +1302,11 @@ class Detector(RichEnum): # Set metadata after class creation to avoid it becoming an enum member Detector._metadata = { - "DIRECT_ELECTRON": {'description': 'Direct electron detector (DED)', 'annotations': {'examples': 'K2, K3, Falcon, DE-series', 'advantages': 'high DQE, fast readout'}}, - "CCD": {'description': 'Charge-coupled device camera', 'annotations': {'applications': 'legacy EM, some crystallography'}}, - "CMOS": {'description': 'Complementary metal-oxide semiconductor detector', 'annotations': {'advantages': 'fast readout, low noise'}}, + "DIRECT_ELECTRON": {'description': 'Direct electron detector (DED)', 'meaning': 'CHMO:0002837', 'annotations': {'examples': 'K2, K3, Falcon, DE-series', 'advantages': 'high DQE, fast readout'}}, + "CCD": {'description': 'Charge-coupled device camera', 'meaning': 'CHMO:0002171', 'annotations': {'applications': 'legacy EM, some crystallography'}}, + "CMOS": {'description': 'Complementary metal-oxide semiconductor detector', 'meaning': 'CHMO:0002836', 'annotations': {'advantages': 'fast readout, low noise'}}, "HYBRID_PIXEL": {'description': 'Hybrid pixel detector', 'annotations': {'examples': 'Pilatus, Eiger', 'advantages': 'photon counting, zero noise'}}, - "PHOTOSTIMULABLE_PHOSPHOR": {'description': 'Photostimulable phosphor (image plate)', 'annotations': {'applications': 'legacy crystallography'}}, + "PHOTOSTIMULABLE_PHOSPHOR": {'description': 'Photostimulable phosphor (image plate)', 'meaning': 'CHMO:0001069', 'annotations': {'applications': 'legacy crystallography'}}, } class WorkflowType(RichEnum): @@ -1361,14 +1361,14 @@ class FileFormat(RichEnum): # Set metadata after class creation to avoid it becoming an enum member FileFormat._metadata = { - "MRC": {'description': 'MRC format for EM density maps', 'annotations': {'extension': '.mrc, .map', 'applications': 'EM volumes, tomograms'}}, - "TIFF": {'description': 'Tagged Image File Format', 'annotations': {'extension': '.tif, .tiff', 'applications': 'micrographs, general imaging'}}, - "HDF5": {'description': 'Hierarchical Data Format 5', 'annotations': {'extension': '.h5, .hdf5', 'applications': 'large datasets, metadata storage'}}, - "STAR": {'description': 'Self-defining Text Archival and Retrieval format', 'annotations': {'extension': '.star', 'applications': 'RELION metadata, particle parameters'}}, - "PDB": {'description': 'Protein Data Bank coordinate format', 'annotations': {'extension': '.pdb', 'applications': 'atomic coordinates, legacy format'}}, - "MMCIF": {'description': 'Macromolecular Crystallographic Information File', 'annotations': {'extension': '.cif', 'applications': 'atomic coordinates, modern PDB format'}}, - "MTZ": {'description': 'MTZ reflection data format', 'annotations': {'extension': '.mtz', 'applications': 'crystallographic reflections, phases'}}, - "CBF": {'description': 'Crystallographic Binary Format', 'annotations': {'extension': '.cbf', 'applications': 'detector images, diffraction data'}}, + "MRC": {'description': 'MRC format for EM density maps', 'meaning': 'EDAM:3842', 'annotations': {'extension': '.mrc, .map', 'applications': 'EM volumes, tomograms'}}, + "TIFF": {'description': 'Tagged Image File Format', 'meaning': 'EDAM:3591', 'annotations': {'extension': '.tif, .tiff', 'applications': 'micrographs, general imaging'}}, + "HDF5": {'description': 'Hierarchical Data Format 5', 'meaning': 'EDAM:3590', 'annotations': {'extension': '.h5, .hdf5', 'applications': 'large datasets, metadata storage'}}, + "STAR": {'description': 'Self-defining Text Archival and Retrieval format', 'meaning': 'EDAM:3906', 'annotations': {'extension': '.star', 'applications': 'RELION metadata, particle parameters'}}, + "PDB": {'description': 'Protein Data Bank coordinate format', 'meaning': 'EDAM:1476', 'annotations': {'extension': '.pdb', 'applications': 'atomic coordinates, legacy format'}}, + "MMCIF": {'description': 'Macromolecular Crystallographic Information File', 'meaning': 'EDAM:1477', 'annotations': {'extension': '.cif', 'applications': 'atomic coordinates, modern PDB format'}}, + "MTZ": {'description': 'MTZ reflection data format', 'meaning': 'EDAM:3816', 'annotations': {'extension': '.mtz', 'applications': 'crystallographic reflections, phases'}}, + "CBF": {'description': 'Crystallographic Binary Format', 'meaning': 'EDAM:3874', 'annotations': {'extension': '.cbf', 'applications': 'detector images, diffraction data'}}, "DM3": {'description': 'Digital Micrograph format', 'annotations': {'extension': '.dm3, .dm4', 'applications': 'FEI/Thermo Fisher EM data'}}, "SER": {'description': 'FEI series format', 'annotations': {'extension': '.ser', 'applications': 'FEI movie stacks'}}, } @@ -1458,11 +1458,11 @@ class CoordinationGeometry(RichEnum): "TRIGONAL_PYRAMIDAL": {'description': 'Trigonal pyramidal coordination geometry', 'annotations': {'coordination_number': '3'}}, "T_SHAPED": {'description': 'T-shaped coordination geometry', 'annotations': {'coordination_number': '3'}}, "TETRAHEDRAL": {'description': 'Tetrahedral coordination geometry (4 ligands, 109.5° angles)', 'meaning': 'NCIT:C103215', 'annotations': {'coordination_number': '4'}}, - "SQUARE_PLANAR": {'description': 'Square planar coordination geometry (4 ligands in plane)', 'annotations': {'coordination_number': '4', 'ncit_variants': 'NCIT:C103211, NCIT:C103212, NCIT:C103213, NCIT:C103214'}}, + "SQUARE_PLANAR": {'description': 'Square planar coordination geometry (4 ligands in plane)', 'meaning': 'NCIT:C103211', 'annotations': {'coordination_number': '4'}}, "TRIGONAL_BIPYRAMIDAL": {'description': 'Trigonal bipyramidal coordination geometry (5 ligands)', 'annotations': {'coordination_number': '5'}}, "SQUARE_PYRAMIDAL": {'description': 'Square pyramidal coordination geometry (5 ligands)', 'annotations': {'coordination_number': '5'}}, "PENTAGONAL_PLANAR": {'description': 'Pentagonal planar coordination geometry (5 ligands in plane)', 'annotations': {'coordination_number': '5'}}, - "OCTAHEDRAL": {'description': 'Octahedral coordination geometry (6 ligands)', 'annotations': {'coordination_number': '6', 'ncit_variants': 'NCIT:C103216, NCIT:C103217, NCIT:C103218'}}, + "OCTAHEDRAL": {'description': 'Octahedral coordination geometry (6 ligands)', 'meaning': 'NCIT:C103216', 'annotations': {'coordination_number': '6'}}, "TRIGONAL_PRISMATIC": {'description': 'Trigonal prismatic coordination geometry (6 ligands)', 'annotations': {'coordination_number': '6'}}, "PENTAGONAL_BIPYRAMIDAL": {'description': 'Pentagonal bipyramidal coordination geometry (7 ligands)', 'annotations': {'coordination_number': '7'}}, "HEXAGONAL_BIPYRAMIDAL": {'description': 'Hexagonal bipyramidal coordination geometry (8 ligands)', 'annotations': {'coordination_number': '8'}}, @@ -1506,17 +1506,17 @@ class ProteinModificationType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member ProteinModificationType._metadata = { - "METAL_COORDINATION": {'description': 'Metal coordination modification', 'annotations': {'examples': 'zinc finger, iron-sulfur cluster binding'}}, - "PHOSPHORYLATION": {'description': 'Phosphorylation modification'}, - "GLYCOSYLATION": {'description': 'Glycosylation modification'}, - "ACETYLATION": {'description': 'Acetylation modification'}, - "METHYLATION": {'description': 'Methylation modification'}, - "UBIQUITINATION": {'description': 'Ubiquitination modification'}, - "SUMOYLATION": {'description': 'SUMOylation modification'}, - "HYDROXYLATION": {'description': 'Hydroxylation modification'}, - "LIPIDATION": {'description': 'Lipidation modification'}, - "PROTEOLYTIC_CLEAVAGE": {'description': 'Proteolytic cleavage'}, - "CROSSLINKING": {'description': 'Crosslinking modification'}, + "METAL_COORDINATION": {'description': 'Metal coordination modification', 'meaning': 'MOD:00739', 'annotations': {'examples': 'zinc finger, iron-sulfur cluster binding'}}, + "PHOSPHORYLATION": {'description': 'Phosphorylation modification', 'meaning': 'MOD:00696'}, + "GLYCOSYLATION": {'description': 'Glycosylation modification', 'meaning': 'MOD:00725'}, + "ACETYLATION": {'description': 'Acetylation modification', 'meaning': 'MOD:00394'}, + "METHYLATION": {'description': 'Methylation modification', 'meaning': 'MOD:00599'}, + "UBIQUITINATION": {'description': 'Ubiquitination modification', 'meaning': 'MOD:01240'}, + "SUMOYLATION": {'description': 'SUMOylation modification', 'meaning': 'MOD:01149'}, + "HYDROXYLATION": {'description': 'Hydroxylation modification', 'meaning': 'MOD:00677'}, + "LIPIDATION": {'description': 'Lipidation modification', 'meaning': 'MOD:00435'}, + "PROTEOLYTIC_CLEAVAGE": {'description': 'Proteolytic cleavage', 'meaning': 'GO:0006508'}, + "CROSSLINKING": {'description': 'Crosslinking modification', 'meaning': 'MOD:00276'}, } class BiosafetyLevelEnum(RichEnum): @@ -3388,24 +3388,24 @@ class EnergySource(RichEnum): # Set metadata after class creation to avoid it becoming an enum member EnergySource._metadata = { - "SOLAR": {'meaning': 'ENVO:01001862', 'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['Solar radiation']}, - "WIND": {'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['wind wave energy']}, - "HYDROELECTRIC": {'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['hydroelectric dam']}, - "GEOTHERMAL": {'meaning': 'ENVO:2000034', 'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['geothermal energy']}, - "BIOMASS": {'annotations': {'renewable': True, 'emission_free': False}, 'aliases': ['organic material']}, - "BIOFUEL": {'annotations': {'renewable': True, 'emission_free': False}}, - "TIDAL": {'annotations': {'renewable': True, 'emission_free': True}}, - "HYDROGEN": {'meaning': 'CHEBI:18276', 'annotations': {'renewable': 'depends', 'emission_free': True}, 'aliases': ['dihydrogen']}, - "COAL": {'meaning': 'ENVO:02000091', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "NATURAL_GAS": {'meaning': 'ENVO:01000552', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "PETROLEUM": {'meaning': 'ENVO:00002984', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "DIESEL": {'meaning': 'ENVO:03510006', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['diesel fuel']}, - "GASOLINE": {'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['fuel oil']}, + "SOLAR": {'meaning': 'ENVO:01001862', 'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'solar energy', 'brick_label': 'Solar Thermal Collector'}, 'aliases': ['Solar radiation']}, + "WIND": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'wind energy'}, 'aliases': ['wind wave energy']}, + "HYDROELECTRIC": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'hydro energy'}, 'aliases': ['hydroelectric dam']}, + "GEOTHERMAL": {'meaning': 'ENVO:2000034', 'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'geothermal energy'}, 'aliases': ['geothermal energy']}, + "BIOMASS": {'annotations': {'renewable': True, 'emission_free': False, 'oeo_label': 'bioenergy'}, 'aliases': ['organic material']}, + "BIOFUEL": {'annotations': {'renewable': True, 'emission_free': False, 'oeo_label': 'biofuel'}}, + "TIDAL": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'marine tidal energy, marine wave energy'}}, + "HYDROGEN": {'meaning': 'CHEBI:18276', 'annotations': {'renewable': 'depends', 'emission_free': True, 'oeo_label': 'hydrogen'}, 'aliases': ['dihydrogen']}, + "COAL": {'meaning': 'ENVO:02000091', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'coal'}}, + "NATURAL_GAS": {'meaning': 'ENVO:01000552', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'natural gas'}}, + "PETROLEUM": {'meaning': 'ENVO:00002984', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'crude oil'}}, + "DIESEL": {'meaning': 'ENVO:03510006', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'diesel fuel'}, 'aliases': ['diesel fuel']}, + "GASOLINE": {'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'gasoline fuel'}, 'aliases': ['fuel oil']}, "PROPANE": {'meaning': 'ENVO:01000553', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['liquefied petroleum gas']}, - "NUCLEAR_FISSION": {'annotations': {'renewable': False, 'emission_free': True}, 'aliases': ['nuclear energy']}, + "NUCLEAR_FISSION": {'annotations': {'renewable': False, 'emission_free': True, 'oeo_label': 'nuclear fuel'}, 'aliases': ['nuclear energy']}, "NUCLEAR_FUSION": {'annotations': {'renewable': False, 'emission_free': True}, 'aliases': ['nuclear energy']}, - "GRID_MIX": {'annotations': {'renewable': 'partial'}}, - "BATTERY_STORAGE": {'description': 'Battery storage systems', 'annotations': {'storage': True}}, + "GRID_MIX": {'annotations': {'renewable': 'partial', 'oeo_label': 'supply grid'}}, + "BATTERY_STORAGE": {'description': 'Battery storage systems', 'annotations': {'storage': True, 'oeo_label': 'battery'}}, } class EnergyUnit(RichEnum): @@ -3558,7 +3558,7 @@ class GridType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member GridType._metadata = { - "MAIN_GRID": {'description': 'Main utility grid'}, + "MAIN_GRID": {'description': 'Main utility grid', 'annotations': {'oeo_label': 'supply grid'}}, "MICROGRID": {'description': 'Microgrid'}, "OFF_GRID": {'description': 'Off-grid/standalone'}, "SMART_GRID": {'description': 'Smart grid'}, @@ -3566,16 +3566,112 @@ class GridType(RichEnum): "VIRTUAL_POWER_PLANT": {'description': 'Virtual power plant'}, } +class BatteryType(RichEnum): + """ + Types of battery technologies for energy storage + """ + # Enum members + LITHIUM_ION = "LITHIUM_ION" + LITHIUM_IRON_PHOSPHATE = "LITHIUM_IRON_PHOSPHATE" + LITHIUM_POLYMER = "LITHIUM_POLYMER" + LEAD_ACID = "LEAD_ACID" + NICKEL_METAL_HYDRIDE = "NICKEL_METAL_HYDRIDE" + NICKEL_CADMIUM = "NICKEL_CADMIUM" + SODIUM_ION = "SODIUM_ION" + SOLID_STATE = "SOLID_STATE" + VANADIUM_REDOX_FLOW = "VANADIUM_REDOX_FLOW" + ZINC_BROMINE_FLOW = "ZINC_BROMINE_FLOW" + IRON_AIR = "IRON_AIR" + ZINC_AIR = "ZINC_AIR" + +# Set metadata after class creation to avoid it becoming an enum member +BatteryType._metadata = { + "LITHIUM_ION": {'description': 'Lithium-ion battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['Li-ion', 'LIB']}, + "LITHIUM_IRON_PHOSPHATE": {'description': 'Lithium iron phosphate (LFP) battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['LFP', 'LiFePO4']}, + "LITHIUM_POLYMER": {'description': 'Lithium polymer battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['LiPo']}, + "LEAD_ACID": {'description': 'Lead-acid battery', 'annotations': {'chemistry': 'lead'}, 'aliases': ['Pb-acid']}, + "NICKEL_METAL_HYDRIDE": {'description': 'Nickel-metal hydride battery', 'annotations': {'chemistry': 'nickel'}, 'aliases': ['NiMH']}, + "NICKEL_CADMIUM": {'description': 'Nickel-cadmium battery', 'annotations': {'chemistry': 'nickel'}, 'aliases': ['NiCd']}, + "SODIUM_ION": {'description': 'Sodium-ion battery', 'annotations': {'chemistry': 'sodium'}, 'aliases': ['Na-ion']}, + "SOLID_STATE": {'description': 'Solid-state battery', 'annotations': {'chemistry': 'various'}}, + "VANADIUM_REDOX_FLOW": {'description': 'Vanadium redox flow battery', 'annotations': {'chemistry': 'vanadium', 'type': 'flow'}, 'aliases': ['VRB', 'VRFB']}, + "ZINC_BROMINE_FLOW": {'description': 'Zinc-bromine flow battery', 'annotations': {'chemistry': 'zinc', 'type': 'flow'}, 'aliases': ['ZnBr']}, + "IRON_AIR": {'description': 'Iron-air battery', 'annotations': {'chemistry': 'iron'}}, + "ZINC_AIR": {'description': 'Zinc-air battery', 'annotations': {'chemistry': 'zinc'}}, +} + +class PVCellType(RichEnum): + """ + Types of photovoltaic cell technologies + """ + # Enum members + MONOCRYSTALLINE_SILICON = "MONOCRYSTALLINE_SILICON" + POLYCRYSTALLINE_SILICON = "POLYCRYSTALLINE_SILICON" + PASSIVATED_EMITTER_REAR_CELL = "PASSIVATED_EMITTER_REAR_CELL" + HETEROJUNCTION = "HETEROJUNCTION" + TUNNEL_OXIDE_PASSIVATED_CONTACT = "TUNNEL_OXIDE_PASSIVATED_CONTACT" + INTERDIGITATED_BACK_CONTACT = "INTERDIGITATED_BACK_CONTACT" + CADMIUM_TELLURIDE = "CADMIUM_TELLURIDE" + COPPER_INDIUM_GALLIUM_SELENIDE = "COPPER_INDIUM_GALLIUM_SELENIDE" + AMORPHOUS_SILICON = "AMORPHOUS_SILICON" + GALLIUM_ARSENIDE = "GALLIUM_ARSENIDE" + PEROVSKITE = "PEROVSKITE" + ORGANIC = "ORGANIC" + TANDEM = "TANDEM" + +# Set metadata after class creation to avoid it becoming an enum member +PVCellType._metadata = { + "MONOCRYSTALLINE_SILICON": {'description': 'Monocrystalline silicon (mono-Si) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '17-22%'}, 'aliases': ['mono-Si', 'single-crystal silicon']}, + "POLYCRYSTALLINE_SILICON": {'description': 'Polycrystalline silicon (poly-Si) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '15-17%'}, 'aliases': ['poly-Si', 'multi-crystalline silicon']}, + "PASSIVATED_EMITTER_REAR_CELL": {'description': 'Passivated Emitter and Rear Cell (PERC)', 'annotations': {'material': 'silicon', 'efficiency_range': '19-22%'}, 'aliases': ['PERC']}, + "HETEROJUNCTION": {'description': 'Heterojunction (HJT) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '21-24%'}, 'aliases': ['HJT', 'HIT']}, + "TUNNEL_OXIDE_PASSIVATED_CONTACT": {'description': 'Tunnel Oxide Passivated Contact (TOPCon) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '22-24%'}, 'aliases': ['TOPCon']}, + "INTERDIGITATED_BACK_CONTACT": {'description': 'Interdigitated Back Contact (IBC) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '22-24%'}, 'aliases': ['IBC']}, + "CADMIUM_TELLURIDE": {'description': 'Cadmium telluride (CdTe) thin-film cells', 'annotations': {'material': 'cadmium_telluride', 'type': 'thin-film', 'efficiency_range': '16-18%'}, 'aliases': ['CdTe']}, + "COPPER_INDIUM_GALLIUM_SELENIDE": {'description': 'Copper indium gallium selenide (CIGS) thin-film cells', 'annotations': {'material': 'CIGS', 'type': 'thin-film', 'efficiency_range': '15-20%'}, 'aliases': ['CIGS', 'CIS']}, + "AMORPHOUS_SILICON": {'description': 'Amorphous silicon (a-Si) thin-film cells', 'annotations': {'material': 'silicon', 'type': 'thin-film', 'efficiency_range': '6-8%'}, 'aliases': ['a-Si']}, + "GALLIUM_ARSENIDE": {'description': 'Gallium arsenide (GaAs) cells', 'annotations': {'material': 'gallium_arsenide', 'efficiency_range': '25-30%', 'application': 'space, concentrator'}, 'aliases': ['GaAs']}, + "PEROVSKITE": {'description': 'Perovskite solar cells', 'annotations': {'material': 'perovskite', 'efficiency_range': '20-25%', 'status': 'emerging'}}, + "ORGANIC": {'description': 'Organic photovoltaic (OPV) cells', 'annotations': {'material': 'organic', 'type': 'thin-film', 'efficiency_range': '10-15%', 'status': 'emerging'}, 'aliases': ['OPV']}, + "TANDEM": {'description': 'Tandem/multi-junction cells', 'annotations': {'efficiency_range': '25-35%'}, 'aliases': ['multi-junction']}, +} + +class PVSystemType(RichEnum): + """ + Types of photovoltaic system installations + """ + # Enum members + ROOFTOP_RESIDENTIAL = "ROOFTOP_RESIDENTIAL" + ROOFTOP_COMMERCIAL = "ROOFTOP_COMMERCIAL" + GROUND_MOUNTED = "GROUND_MOUNTED" + FLOATING = "FLOATING" + BUILDING_INTEGRATED = "BUILDING_INTEGRATED" + AGRIVOLTAICS = "AGRIVOLTAICS" + CARPORT = "CARPORT" + TRACKER_SINGLE_AXIS = "TRACKER_SINGLE_AXIS" + TRACKER_DUAL_AXIS = "TRACKER_DUAL_AXIS" + CONCENTRATING = "CONCENTRATING" + +# Set metadata after class creation to avoid it becoming an enum member +PVSystemType._metadata = { + "ROOFTOP_RESIDENTIAL": {'description': 'Residential rooftop PV system', 'annotations': {'scale': 'residential', 'mounting': 'rooftop'}}, + "ROOFTOP_COMMERCIAL": {'description': 'Commercial/industrial rooftop PV system', 'annotations': {'scale': 'commercial', 'mounting': 'rooftop'}}, + "GROUND_MOUNTED": {'description': 'Ground-mounted utility-scale PV system', 'annotations': {'scale': 'utility', 'mounting': 'ground'}}, + "FLOATING": {'description': 'Floating PV system (floatovoltaics)', 'annotations': {'scale': 'utility', 'mounting': 'floating'}, 'aliases': ['floatovoltaics', 'FPV']}, + "BUILDING_INTEGRATED": {'description': 'Building-integrated PV (BIPV)', 'annotations': {'mounting': 'integrated'}, 'aliases': ['BIPV']}, + "AGRIVOLTAICS": {'description': 'Agrivoltaic system (dual-use with agriculture)', 'annotations': {'scale': 'utility', 'dual_use': 'agriculture'}, 'aliases': ['agrophotovoltaics', 'APV']}, + "CARPORT": {'description': 'Solar carport/parking canopy', 'annotations': {'mounting': 'canopy', 'dual_use': 'parking'}}, + "TRACKER_SINGLE_AXIS": {'description': 'Single-axis tracking system', 'annotations': {'tracking': 'single_axis'}}, + "TRACKER_DUAL_AXIS": {'description': 'Dual-axis tracking system', 'annotations': {'tracking': 'dual_axis'}}, + "CONCENTRATING": {'description': 'Concentrating PV (CPV) system', 'annotations': {'type': 'concentrating'}, 'aliases': ['CPV']}, +} + class EnergyStorageType(RichEnum): """ - Types of energy storage systems + Types of energy storage systems (categories) """ # Enum members - LITHIUM_ION_BATTERY = "LITHIUM_ION_BATTERY" - LEAD_ACID_BATTERY = "LEAD_ACID_BATTERY" - FLOW_BATTERY = "FLOW_BATTERY" - SOLID_STATE_BATTERY = "SOLID_STATE_BATTERY" - SODIUM_ION_BATTERY = "SODIUM_ION_BATTERY" + BATTERY = "BATTERY" PUMPED_HYDRO = "PUMPED_HYDRO" COMPRESSED_AIR = "COMPRESSED_AIR" FLYWHEEL = "FLYWHEEL" @@ -3590,20 +3686,16 @@ class EnergyStorageType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member EnergyStorageType._metadata = { - "LITHIUM_ION_BATTERY": {'description': 'Lithium-ion battery', 'annotations': {'category': 'electrochemical'}}, - "LEAD_ACID_BATTERY": {'description': 'Lead-acid battery', 'annotations': {'category': 'electrochemical'}}, - "FLOW_BATTERY": {'description': 'Flow battery (e.g., vanadium redox)', 'annotations': {'category': 'electrochemical'}}, - "SOLID_STATE_BATTERY": {'description': 'Solid-state battery', 'annotations': {'category': 'electrochemical'}}, - "SODIUM_ION_BATTERY": {'description': 'Sodium-ion battery', 'annotations': {'category': 'electrochemical'}}, - "PUMPED_HYDRO": {'description': 'Pumped hydroelectric storage', 'annotations': {'category': 'mechanical'}}, - "COMPRESSED_AIR": {'description': 'Compressed air energy storage (CAES)', 'annotations': {'category': 'mechanical'}}, + "BATTERY": {'description': 'Battery storage (see BatteryType for specific chemistries)', 'annotations': {'category': 'electrochemical'}}, + "PUMPED_HYDRO": {'description': 'Pumped hydroelectric storage', 'annotations': {'category': 'mechanical', 'oeo_label': 'pumped hydro storage power plant'}}, + "COMPRESSED_AIR": {'description': 'Compressed air energy storage (CAES)', 'annotations': {'category': 'mechanical', 'oeo_label': 'compressed air'}}, "FLYWHEEL": {'description': 'Flywheel energy storage', 'annotations': {'category': 'mechanical'}}, "GRAVITY_STORAGE": {'description': 'Gravity-based storage', 'annotations': {'category': 'mechanical'}}, "MOLTEN_SALT": {'description': 'Molten salt thermal storage', 'annotations': {'category': 'thermal'}}, "ICE_STORAGE": {'description': 'Ice thermal storage', 'annotations': {'category': 'thermal'}}, "PHASE_CHANGE": {'description': 'Phase change materials', 'annotations': {'category': 'thermal'}}, - "HYDROGEN_STORAGE": {'description': 'Hydrogen storage', 'annotations': {'category': 'chemical'}}, - "SYNTHETIC_FUEL": {'description': 'Synthetic fuel storage', 'annotations': {'category': 'chemical'}}, + "HYDROGEN_STORAGE": {'description': 'Hydrogen storage', 'annotations': {'category': 'chemical', 'oeo_label': 'hydrogen'}}, + "SYNTHETIC_FUEL": {'description': 'Synthetic fuel storage', 'annotations': {'category': 'chemical', 'oeo_label': 'synthetic fuel'}}, "SUPERCAPACITOR": {'description': 'Supercapacitor', 'annotations': {'category': 'electrical'}}, "SUPERCONDUCTING": {'description': 'Superconducting magnetic energy storage (SMES)', 'annotations': {'category': 'electrical'}}, } @@ -3621,11 +3713,11 @@ class EmissionScope(RichEnum): # Set metadata after class creation to avoid it becoming an enum member EmissionScope._metadata = { - "SCOPE_1": {'description': 'Direct emissions from owned or controlled sources', 'annotations': {'ghg_protocol': 'Scope 1'}}, - "SCOPE_2": {'description': 'Indirect emissions from purchased energy', 'annotations': {'ghg_protocol': 'Scope 2'}}, - "SCOPE_3": {'description': 'All other indirect emissions in value chain', 'annotations': {'ghg_protocol': 'Scope 3'}}, - "SCOPE_3_UPSTREAM": {'description': 'Upstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3'}}, - "SCOPE_3_DOWNSTREAM": {'description': 'Downstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3'}}, + "SCOPE_1": {'description': 'Direct emissions from owned or controlled sources', 'annotations': {'ghg_protocol': 'Scope 1', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_2": {'description': 'Indirect emissions from purchased energy', 'annotations': {'ghg_protocol': 'Scope 2', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3": {'description': 'All other indirect emissions in value chain', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3_UPSTREAM": {'description': 'Upstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3_DOWNSTREAM": {'description': 'Downstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, } class CarbonIntensity(RichEnum): @@ -3680,6 +3772,26 @@ class ElectricityMarket(RichEnum): "POWER_PURCHASE_AGREEMENT": {'description': 'Power purchase agreement (PPA)'}, } +class CapabilityStatus(RichEnum): + """ + Operational status of a capability, facility, or infrastructure. Applicable to energy facilities, research capabilities, and other infrastructure throughout their lifecycle. + """ + # Enum members + OPERATIONAL = "OPERATIONAL" + COMING_ONLINE = "COMING_ONLINE" + PILOT = "PILOT" + UNDER_DEVELOPMENT = "UNDER_DEVELOPMENT" + DECOMMISSIONED = "DECOMMISSIONED" + +# Set metadata after class creation to avoid it becoming an enum member +CapabilityStatus._metadata = { + "OPERATIONAL": {'description': 'Fully operational and available to users', 'annotations': {'wikidata_label': 'in use', 'lifecycle_phase': 'operation'}}, + "COMING_ONLINE": {'description': 'Being commissioned, coming online soon', 'annotations': {'wikidata_label': 'building process', 'lifecycle_phase': 'commissioning', 'iaea_equivalent': 'commissioning'}}, + "PILOT": {'description': 'In pilot phase with limited access', 'annotations': {'availability': 'limited', 'lifecycle_phase': 'testing'}}, + "UNDER_DEVELOPMENT": {'description': 'Under development, not yet available', 'annotations': {'wikidata_label': 'proposed building or structure', 'lifecycle_phase': 'planning/construction'}}, + "DECOMMISSIONED": {'description': 'No longer available, permanently shut down', 'annotations': {'lifecycle_phase': 'end-of-life', 'iaea_equivalent': 'decommissioned'}}, +} + class FossilFuelTypeEnum(RichEnum): """ Types of fossil fuels used for energy generation @@ -4614,6 +4726,364 @@ class OperationalProcedureEnum(RichEnum): "SECURITY_PROCEDURE": {'description': 'Physical security and access control procedures', 'annotations': {'access_control': 'personnel access authorization', 'detection': 'intrusion detection systems', 'response': 'security force response', 'coordination': 'with law enforcement'}}, } +class GeothermalSystemType(RichEnum): + """ + Types of geothermal energy systems, including conventional hydrothermal and enhanced/engineered geothermal systems. + """ + # Enum members + HYDROTHERMAL = "HYDROTHERMAL" + ENHANCED_GEOTHERMAL_SYSTEM = "ENHANCED_GEOTHERMAL_SYSTEM" + ADVANCED_GEOTHERMAL_SYSTEM = "ADVANCED_GEOTHERMAL_SYSTEM" + HOT_DRY_ROCK = "HOT_DRY_ROCK" + GEOPRESSURED = "GEOPRESSURED" + SUPERCRITICAL = "SUPERCRITICAL" + GROUND_SOURCE_HEAT_PUMP = "GROUND_SOURCE_HEAT_PUMP" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalSystemType._metadata = { + "HYDROTHERMAL": {'description': 'Naturally occurring geothermal system with heat, fluid, and permeability sufficient for energy extraction without stimulation.', 'annotations': {'conventional': True}}, + "ENHANCED_GEOTHERMAL_SYSTEM": {'description': 'Engineered reservoirs created to extract heat from low permeability geothermal resources through stimulation methods.', 'annotations': {'requires_stimulation': True}, 'aliases': ['EGS', 'Engineered Geothermal System']}, + "ADVANCED_GEOTHERMAL_SYSTEM": {'description': 'Closed-loop geothermal systems that circulate working fluid through wellbores to extract heat conductively without reservoir stimulation.', 'annotations': {'closed_loop': True}, 'aliases': ['AGS', 'Closed-Loop Geothermal']}, + "HOT_DRY_ROCK": {'description': 'Geothermal system targeting hot basement rock lacking natural fluid or permeability, requiring artificial reservoir creation.', 'aliases': ['HDR']}, + "GEOPRESSURED": {'description': 'Deep sedimentary formations with abnormally high fluid pressure containing hot brine and dissolved methane.', 'annotations': {'methane_recovery': True}}, + "SUPERCRITICAL": {'description': 'Very high temperature systems (>374C) where water exists above its critical point, offering higher energy density.', 'annotations': {'temperature_min_c': 374}}, + "GROUND_SOURCE_HEAT_PUMP": {'description': 'Shallow geothermal system using stable ground temperatures for heating and cooling buildings.', 'annotations': {'direct_use': True}, 'aliases': ['GSHP', 'Geothermal Heat Pump']}, +} + +class GeothermalReservoirType(RichEnum): + """ + Classification of geothermal reservoirs by geological setting and characteristics. + """ + # Enum members + VOLCANIC = "VOLCANIC" + SEDIMENTARY = "SEDIMENTARY" + FRACTURED_BASEMENT = "FRACTURED_BASEMENT" + FAULT_CONTROLLED = "FAULT_CONTROLLED" + MAGMATIC = "MAGMATIC" + CONDUCTION_DOMINATED = "CONDUCTION_DOMINATED" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalReservoirType._metadata = { + "VOLCANIC": {'description': 'Reservoir associated with volcanic activity, typically in active volcanic regions with magma heat sources.'}, + "SEDIMENTARY": {'description': 'Reservoir in sedimentary formations with elevated temperatures due to depth or regional heat flow.'}, + "FRACTURED_BASEMENT": {'description': 'Reservoir in fractured crystalline basement rocks, typically granitic or metamorphic.', 'aliases': ['Hot Fractured Rock']}, + "FAULT_CONTROLLED": {'description': 'Reservoir where fluid flow is controlled by fault systems providing permeability pathways.'}, + "MAGMATIC": {'description': 'Very high temperature reservoir near or in contact with magma bodies or recent intrusions.'}, + "CONDUCTION_DOMINATED": {'description': 'Low permeability reservoir where heat transfer is primarily through conduction rather than convection.'}, +} + +class GeothermalWellType(RichEnum): + """ + Types of wells used in geothermal energy development and production. + """ + # Enum members + PRODUCTION_WELL = "PRODUCTION_WELL" + INJECTION_WELL = "INJECTION_WELL" + EXPLORATION_WELL = "EXPLORATION_WELL" + OBSERVATION_WELL = "OBSERVATION_WELL" + SLIM_HOLE = "SLIM_HOLE" + DIRECTIONAL_WELL = "DIRECTIONAL_WELL" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalWellType._metadata = { + "PRODUCTION_WELL": {'description': 'Well used to extract geothermal fluids or steam from the reservoir.'}, + "INJECTION_WELL": {'description': 'Well used to return cooled geothermal fluids to the reservoir to maintain pressure and sustainability.', 'aliases': ['Reinjection Well']}, + "EXPLORATION_WELL": {'description': 'Well drilled to evaluate geothermal resource characteristics.', 'aliases': ['Wildcat Well']}, + "OBSERVATION_WELL": {'description': 'Well used to monitor reservoir conditions and pressure.', 'aliases': ['Monitoring Well']}, + "SLIM_HOLE": {'description': 'Smaller diameter well used for initial exploration and temperature gradient measurement.'}, + "DIRECTIONAL_WELL": {'description': 'Well drilled at an angle to access reservoir from offset surface location or increase reservoir contact.'}, +} + +class GeothermalApplication(RichEnum): + """ + Applications and uses of geothermal energy. + """ + # Enum members + ELECTRICITY_GENERATION = "ELECTRICITY_GENERATION" + DIRECT_USE_HEATING = "DIRECT_USE_HEATING" + GREENHOUSE_HEATING = "GREENHOUSE_HEATING" + AQUACULTURE = "AQUACULTURE" + INDUSTRIAL_PROCESS_HEAT = "INDUSTRIAL_PROCESS_HEAT" + FOOD_PROCESSING = "FOOD_PROCESSING" + BATHING_RECREATION = "BATHING_RECREATION" + LITHIUM_EXTRACTION = "LITHIUM_EXTRACTION" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalApplication._metadata = { + "ELECTRICITY_GENERATION": {'description': 'Use of geothermal resources for power generation through steam turbines or binary cycle plants.', 'meaning': 'ENVO:2000034'}, + "DIRECT_USE_HEATING": {'description': 'Direct use of geothermal heat for space heating, district heating, or industrial processes.'}, + "GREENHOUSE_HEATING": {'description': 'Use of geothermal heat for agricultural greenhouses.'}, + "AQUACULTURE": {'description': 'Use of geothermal heat for fish farming and aquaculture.'}, + "INDUSTRIAL_PROCESS_HEAT": {'description': 'Use of geothermal heat for industrial manufacturing processes.'}, + "FOOD_PROCESSING": {'description': 'Use of geothermal heat for food drying, pasteurization, and processing.'}, + "BATHING_RECREATION": {'description': 'Use of geothermal waters for spas, pools, and recreation.'}, + "LITHIUM_EXTRACTION": {'description': 'Extraction of lithium and other minerals from geothermal brines as a co-product of energy production.', 'annotations': {'co_production': True}}, +} + +class GeothermalResourceTemperature(RichEnum): + """ + Classification of geothermal resources by temperature range. + """ + # Enum members + LOW_TEMPERATURE = "LOW_TEMPERATURE" + MODERATE_TEMPERATURE = "MODERATE_TEMPERATURE" + HIGH_TEMPERATURE = "HIGH_TEMPERATURE" + SUPERCRITICAL = "SUPERCRITICAL" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalResourceTemperature._metadata = { + "LOW_TEMPERATURE": {'description': 'Geothermal resource below 90C, suitable for direct use applications.', 'annotations': {'temperature_max_c': 90}}, + "MODERATE_TEMPERATURE": {'description': 'Geothermal resource 90-150C, suitable for binary power generation.', 'annotations': {'temperature_min_c': 90, 'temperature_max_c': 150}}, + "HIGH_TEMPERATURE": {'description': 'Geothermal resource above 150C, suitable for flash steam power generation.', 'annotations': {'temperature_min_c': 150}}, + "SUPERCRITICAL": {'description': 'Very high temperature resource above 374C where water exists in supercritical state.', 'annotations': {'temperature_min_c': 374}}, +} + +class HydrogenType(RichEnum): + """ + Color-coded classification of hydrogen based on production method and carbon intensity. This informal industry taxonomy differentiates hydrogen by its carbon footprint and energy source. + """ + # Enum members + GREEN_HYDROGEN = "GREEN_HYDROGEN" + BLUE_HYDROGEN = "BLUE_HYDROGEN" + GREY_HYDROGEN = "GREY_HYDROGEN" + BROWN_HYDROGEN = "BROWN_HYDROGEN" + BLACK_HYDROGEN = "BLACK_HYDROGEN" + PINK_HYDROGEN = "PINK_HYDROGEN" + TURQUOISE_HYDROGEN = "TURQUOISE_HYDROGEN" + WHITE_HYDROGEN = "WHITE_HYDROGEN" + YELLOW_HYDROGEN = "YELLOW_HYDROGEN" + ORANGE_HYDROGEN = "ORANGE_HYDROGEN" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenType._metadata = { + "GREEN_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by renewable energy sources (solar, wind, hydro). Zero carbon emissions during production.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'renewable', 'carbon_intensity': 'zero'}, 'aliases': ['Renewable Hydrogen']}, + "BLUE_HYDROGEN": {'description': 'Hydrogen produced from natural gas via steam methane reforming (SMR) with carbon capture and storage (CCS). Low carbon intensity.', 'annotations': {'production_method': 'steam_methane_reforming', 'energy_source': 'natural_gas', 'carbon_intensity': 'low', 'requires_ccs': True}}, + "GREY_HYDROGEN": {'description': 'Hydrogen produced from natural gas via steam methane reforming without carbon capture. Most common production method currently.', 'annotations': {'production_method': 'steam_methane_reforming', 'energy_source': 'natural_gas', 'carbon_intensity': 'high', 'co2_per_kg_h2': '9-12'}, 'aliases': ['Gray Hydrogen']}, + "BROWN_HYDROGEN": {'description': 'Hydrogen produced from brown coal (lignite) gasification without carbon capture. High carbon intensity.', 'annotations': {'production_method': 'coal_gasification', 'energy_source': 'lignite', 'carbon_intensity': 'very_high'}}, + "BLACK_HYDROGEN": {'description': 'Hydrogen produced from black coal (bituminous) gasification without carbon capture. High carbon intensity.', 'annotations': {'production_method': 'coal_gasification', 'energy_source': 'bituminous_coal', 'carbon_intensity': 'very_high'}}, + "PINK_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by nuclear energy. Zero carbon emissions during production.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'nuclear', 'carbon_intensity': 'zero'}, 'aliases': ['Purple Hydrogen', 'Red Hydrogen']}, + "TURQUOISE_HYDROGEN": {'description': 'Hydrogen produced via methane pyrolysis, producing solid carbon instead of CO2. Lower carbon intensity than grey hydrogen.', 'annotations': {'production_method': 'methane_pyrolysis', 'energy_source': 'natural_gas', 'carbon_intensity': 'low', 'byproduct': 'solid_carbon'}}, + "WHITE_HYDROGEN": {'description': 'Naturally occurring geological hydrogen found in underground deposits. Zero production emissions.', 'annotations': {'production_method': 'geological_extraction', 'energy_source': 'natural', 'carbon_intensity': 'zero'}, 'aliases': ['Natural Hydrogen', 'Geological Hydrogen', 'Gold Hydrogen']}, + "YELLOW_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by solar energy specifically. A subset of green hydrogen.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'solar', 'carbon_intensity': 'zero'}}, + "ORANGE_HYDROGEN": {'description': 'Hydrogen produced from plastic waste gasification or pyrolysis. Emerging technology addressing both energy and waste challenges.', 'annotations': {'production_method': 'waste_gasification', 'energy_source': 'plastic_waste', 'carbon_intensity': 'varies'}}, +} + +class HydrogenProductionMethod(RichEnum): + """ + Methods and processes for producing hydrogen. + """ + # Enum members + STEAM_METHANE_REFORMING = "STEAM_METHANE_REFORMING" + AUTOTHERMAL_REFORMING = "AUTOTHERMAL_REFORMING" + PARTIAL_OXIDATION = "PARTIAL_OXIDATION" + COAL_GASIFICATION = "COAL_GASIFICATION" + WATER_ELECTROLYSIS = "WATER_ELECTROLYSIS" + ALKALINE_ELECTROLYSIS = "ALKALINE_ELECTROLYSIS" + PEM_ELECTROLYSIS = "PEM_ELECTROLYSIS" + SOLID_OXIDE_ELECTROLYSIS = "SOLID_OXIDE_ELECTROLYSIS" + METHANE_PYROLYSIS = "METHANE_PYROLYSIS" + BIOMASS_GASIFICATION = "BIOMASS_GASIFICATION" + BIOLOGICAL_PRODUCTION = "BIOLOGICAL_PRODUCTION" + THERMOCHEMICAL_WATER_SPLITTING = "THERMOCHEMICAL_WATER_SPLITTING" + PHOTOELECTROCHEMICAL = "PHOTOELECTROCHEMICAL" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenProductionMethod._metadata = { + "STEAM_METHANE_REFORMING": {'description': 'High temperature steam reacts with methane to produce hydrogen, carbon monoxide, and carbon dioxide.', 'annotations': {'feedstock': 'natural_gas', 'temperature_c': '700-1000', 'dominant_method': True}, 'aliases': ['SMR']}, + "AUTOTHERMAL_REFORMING": {'description': 'Combines steam reforming and partial oxidation using oxygen and steam to produce hydrogen from hydrocarbons.', 'aliases': ['ATR']}, + "PARTIAL_OXIDATION": {'description': 'Exothermic process reacting hydrocarbons with limited oxygen to produce hydrogen and carbon monoxide.', 'aliases': ['POX']}, + "COAL_GASIFICATION": {'description': 'Conversion of coal to syngas (hydrogen and carbon monoxide) using high temperature and steam.', 'meaning': 'CHMO:0001501'}, + "WATER_ELECTROLYSIS": {'description': 'Splitting water into hydrogen and oxygen using electrical current. Can be powered by various energy sources.', 'aliases': ['Electrolysis']}, + "ALKALINE_ELECTROLYSIS": {'description': 'Electrolysis using alkaline solution (typically KOH) as electrolyte. Mature commercial technology.', 'annotations': {'electrolyte': 'alkaline', 'maturity': 'commercial'}, 'aliases': ['AEL']}, + "PEM_ELECTROLYSIS": {'description': 'Proton Exchange Membrane electrolysis using solid polymer electrolyte. Higher efficiency, faster response.', 'annotations': {'electrolyte': 'polymer_membrane', 'maturity': 'commercial'}, 'aliases': ['PEMEC', 'Polymer Electrolyte Membrane Electrolysis']}, + "SOLID_OXIDE_ELECTROLYSIS": {'description': 'High temperature electrolysis using solid ceramic electrolyte. Higher efficiency when waste heat is available.', 'annotations': {'electrolyte': 'solid_oxide', 'temperature_c': '700-850', 'maturity': 'emerging'}, 'aliases': ['SOEC']}, + "METHANE_PYROLYSIS": {'description': 'Thermal decomposition of methane into hydrogen and solid carbon without oxygen. Produces no direct CO2.', 'annotations': {'feedstock': 'natural_gas', 'byproduct': 'solid_carbon'}, 'aliases': ['Thermal Cracking']}, + "BIOMASS_GASIFICATION": {'description': 'Thermochemical conversion of biomass to hydrogen-rich syngas at high temperatures.', 'annotations': {'feedstock': 'biomass', 'renewable': True}}, + "BIOLOGICAL_PRODUCTION": {'description': 'Production of hydrogen by microorganisms through photosynthesis, fermentation, or other biological processes.', 'annotations': {'renewable': True, 'maturity': 'research'}, 'aliases': ['Biohydrogen']}, + "THERMOCHEMICAL_WATER_SPLITTING": {'description': 'Using high temperatures from concentrated solar or nuclear to drive chemical cycles that split water.', 'annotations': {'temperature_c': '500-2000', 'maturity': 'research'}}, + "PHOTOELECTROCHEMICAL": {'description': 'Direct conversion of sunlight to hydrogen using specialized semiconductor materials in contact with water.', 'annotations': {'maturity': 'research'}, 'aliases': ['PEC']}, +} + +class HydrogenStorageMethod(RichEnum): + """ + Methods for storing hydrogen for later use or transport. + """ + # Enum members + COMPRESSED_GAS = "COMPRESSED_GAS" + LIQUID_HYDROGEN = "LIQUID_HYDROGEN" + METAL_HYDRIDE = "METAL_HYDRIDE" + CHEMICAL_HYDRIDE = "CHEMICAL_HYDRIDE" + UNDERGROUND_STORAGE = "UNDERGROUND_STORAGE" + CRYO_COMPRESSED = "CRYO_COMPRESSED" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenStorageMethod._metadata = { + "COMPRESSED_GAS": {'description': 'Storage of hydrogen as compressed gas at high pressure (350-700 bar) in pressure vessels.', 'annotations': {'pressure_bar': '350-700', 'maturity': 'commercial'}, 'aliases': ['CGH2']}, + "LIQUID_HYDROGEN": {'description': 'Storage of hydrogen in liquid form at cryogenic temperatures (-253C). Higher energy density but requires insulation.', 'annotations': {'temperature_c': -253, 'maturity': 'commercial'}, 'aliases': ['LH2']}, + "METAL_HYDRIDE": {'description': 'Storage of hydrogen absorbed into metal alloys forming metal hydrides. Safer but heavier than compressed gas.', 'annotations': {'maturity': 'commercial'}}, + "CHEMICAL_HYDRIDE": {'description': 'Storage as chemical compounds (ammonia, methanol, LOHC) that release hydrogen when processed.', 'aliases': ['LOHC', 'Liquid Organic Hydrogen Carrier']}, + "UNDERGROUND_STORAGE": {'description': 'Large-scale storage in salt caverns, depleted gas fields, or aquifers for grid-scale applications.', 'annotations': {'scale': 'utility'}, 'aliases': ['Geological Storage']}, + "CRYO_COMPRESSED": {'description': 'Hybrid approach combining cryogenic cooling with high pressure for improved density.', 'annotations': {'maturity': 'emerging'}, 'aliases': ['CcH2']}, +} + +class HydrogenApplication(RichEnum): + """ + End-use applications for hydrogen. + """ + # Enum members + FUEL_CELL_VEHICLE = "FUEL_CELL_VEHICLE" + FUEL_CELL_STATIONARY = "FUEL_CELL_STATIONARY" + INDUSTRIAL_FEEDSTOCK = "INDUSTRIAL_FEEDSTOCK" + STEEL_PRODUCTION = "STEEL_PRODUCTION" + AMMONIA_SYNTHESIS = "AMMONIA_SYNTHESIS" + METHANOL_SYNTHESIS = "METHANOL_SYNTHESIS" + POWER_TO_GAS = "POWER_TO_GAS" + BLENDING_NATURAL_GAS = "BLENDING_NATURAL_GAS" + SYNTHETIC_FUELS = "SYNTHETIC_FUELS" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenApplication._metadata = { + "FUEL_CELL_VEHICLE": {'description': 'Use of hydrogen in fuel cells for transportation (cars, trucks, buses).', 'aliases': ['FCEV']}, + "FUEL_CELL_STATIONARY": {'description': 'Use of hydrogen in stationary fuel cells for power generation.'}, + "INDUSTRIAL_FEEDSTOCK": {'description': 'Use of hydrogen as chemical feedstock for ammonia production, petroleum refining, and chemical synthesis.', 'meaning': 'CHEBI:18276'}, + "STEEL_PRODUCTION": {'description': 'Use of hydrogen to reduce iron ore in steelmaking, replacing coal.', 'aliases': ['Green Steel']}, + "AMMONIA_SYNTHESIS": {'description': 'Use of hydrogen with nitrogen to produce ammonia for fertilizers.'}, + "METHANOL_SYNTHESIS": {'description': 'Use of hydrogen with CO2 to produce methanol.'}, + "POWER_TO_GAS": {'description': 'Conversion of excess renewable electricity to hydrogen for grid balancing and energy storage.', 'aliases': ['P2G']}, + "BLENDING_NATURAL_GAS": {'description': 'Blending hydrogen into natural gas pipelines for decarbonization of heating.'}, + "SYNTHETIC_FUELS": {'description': 'Use of hydrogen with captured CO2 to produce synthetic hydrocarbons (e-fuels, SAF).', 'aliases': ['E-Fuels', 'Power-to-Liquid']}, +} + +class BiomassFeedstockType(RichEnum): + """ + Types of biomass materials used as feedstocks for bioenergy production. Includes dedicated energy crops, agricultural residues, forest residues, and waste streams. + """ + # Enum members + CORN_STOVER = "CORN_STOVER" + WHEAT_STRAW = "WHEAT_STRAW" + RICE_STRAW = "RICE_STRAW" + SWITCHGRASS = "SWITCHGRASS" + MISCANTHUS = "MISCANTHUS" + ENERGY_CANE = "ENERGY_CANE" + SWEET_SORGHUM = "SWEET_SORGHUM" + POPLAR = "POPLAR" + WILLOW = "WILLOW" + FOREST_RESIDUE = "FOREST_RESIDUE" + WOOD_PROCESSING_RESIDUE = "WOOD_PROCESSING_RESIDUE" + MUNICIPAL_SOLID_WASTE = "MUNICIPAL_SOLID_WASTE" + FOOD_WASTE = "FOOD_WASTE" + ANIMAL_MANURE = "ANIMAL_MANURE" + ALGAE = "ALGAE" + USED_COOKING_OIL = "USED_COOKING_OIL" + SOYBEAN_OIL = "SOYBEAN_OIL" + CORN_GRAIN = "CORN_GRAIN" + SUGARCANE = "SUGARCANE" + +# Set metadata after class creation to avoid it becoming an enum member +BiomassFeedstockType._metadata = { + "CORN_STOVER": {'description': 'Agricultural residue consisting of leaves, stalks, and cobs remaining after corn grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}, 'aliases': ['Corn Residue']}, + "WHEAT_STRAW": {'description': 'Agricultural residue remaining after wheat grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}}, + "RICE_STRAW": {'description': 'Agricultural residue remaining after rice grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}}, + "SWITCHGRASS": {'description': 'Perennial warm-season grass native to North America, cultivated as dedicated energy crop for cellulosic biofuel production.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True, 'perennial': True}}, + "MISCANTHUS": {'description': 'High-yielding perennial grass cultivated as dedicated energy crop.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True, 'perennial': True}, 'aliases': ['Elephant Grass']}, + "ENERGY_CANE": {'description': 'High-fiber sugarcane varieties bred for biomass production rather than sugar content.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True}}, + "SWEET_SORGHUM": {'description': 'Sorghum variety with high sugar content in stalks, suitable for both sugar and lignocellulosic conversion.', 'annotations': {'category': 'energy_crop', 'sugar_crop': True}}, + "POPLAR": {'description': 'Fast-growing hardwood tree cultivated as short-rotation woody crop for biomass.', 'annotations': {'category': 'woody_crop', 'lignocellulosic': True}, 'aliases': ['Hybrid Poplar']}, + "WILLOW": {'description': 'Fast-growing shrub cultivated as short-rotation woody crop.', 'annotations': {'category': 'woody_crop', 'lignocellulosic': True}, 'aliases': ['Shrub Willow']}, + "FOREST_RESIDUE": {'description': 'Biomass from forest operations including logging residues, thinning material, and salvage timber.', 'annotations': {'category': 'forestry_residue', 'lignocellulosic': True}, 'aliases': ['Logging Residue']}, + "WOOD_PROCESSING_RESIDUE": {'description': 'Byproducts from wood processing including sawdust, bark, shavings, and wood chips.', 'annotations': {'category': 'processing_residue', 'lignocellulosic': True}, 'aliases': ['Mill Residue']}, + "MUNICIPAL_SOLID_WASTE": {'description': 'Organic portion of municipal solid waste suitable for bioenergy conversion.', 'annotations': {'category': 'waste'}, 'aliases': ['MSW']}, + "FOOD_WASTE": {'description': 'Waste food from residential, commercial, and industrial sources.', 'annotations': {'category': 'wet_waste'}}, + "ANIMAL_MANURE": {'description': 'Livestock waste including cattle, swine, and poultry manure.', 'annotations': {'category': 'wet_waste', 'biogas_suitable': True}}, + "ALGAE": {'description': 'Microalgae or macroalgae cultivated for lipid or carbohydrate content for biofuel production.', 'annotations': {'category': 'aquatic_biomass', 'lipid_rich': True}, 'aliases': ['Microalgae']}, + "USED_COOKING_OIL": {'description': 'Waste vegetable oils from food preparation.', 'annotations': {'category': 'waste', 'lipid_rich': True}, 'aliases': ['UCO', 'Waste Vegetable Oil']}, + "SOYBEAN_OIL": {'description': 'Vegetable oil from soybean seeds, used for biodiesel.', 'meaning': 'CHEBI:166975', 'annotations': {'category': 'oil_crop', 'lipid_rich': True}}, + "CORN_GRAIN": {'description': 'Corn kernels used for starch-based ethanol production.', 'annotations': {'category': 'grain', 'starch_crop': True}}, + "SUGARCANE": {'description': 'Sugar-rich crop used for first-generation ethanol production.', 'annotations': {'category': 'sugar_crop'}}, +} + +class BiofuelType(RichEnum): + """ + Types of fuels produced from biomass feedstocks. + """ + # Enum members + ETHANOL = "ETHANOL" + BIODIESEL = "BIODIESEL" + RENEWABLE_DIESEL = "RENEWABLE_DIESEL" + SUSTAINABLE_AVIATION_FUEL = "SUSTAINABLE_AVIATION_FUEL" + BIOGAS = "BIOGAS" + BIOMETHANE = "BIOMETHANE" + BIO_OIL = "BIO_OIL" + SYNGAS = "SYNGAS" + BUTANOL = "BUTANOL" + METHANOL = "METHANOL" + DIMETHYL_ETHER = "DIMETHYL_ETHER" + +# Set metadata after class creation to avoid it becoming an enum member +BiofuelType._metadata = { + "ETHANOL": {'description': 'Alcohol biofuel (C2H5OH) produced by fermentation of sugars or starches, or from cellulosic biomass.', 'meaning': 'CHEBI:16236', 'annotations': {'chemical_formula': 'C2H5OH'}, 'aliases': ['Fuel Ethanol', 'Bioethanol']}, + "BIODIESEL": {'description': 'Fatty acid methyl esters (FAME) produced by transesterification of vegetable oils or animal fats.', 'meaning': 'MESH:D056804', 'annotations': {'production_method': 'transesterification'}, 'aliases': ['FAME']}, + "RENEWABLE_DIESEL": {'description': 'Hydrocarbon diesel produced by hydrotreating lipids. Chemically identical to petroleum diesel.', 'annotations': {'drop_in_fuel': True}, 'aliases': ['Green Diesel', 'HVO', 'Hydrotreated Vegetable Oil']}, + "SUSTAINABLE_AVIATION_FUEL": {'description': 'Jet fuel produced from biomass or waste, meeting aviation fuel specifications.', 'annotations': {'drop_in_fuel': True}, 'aliases': ['SAF', 'Biojet']}, + "BIOGAS": {'description': 'Gaseous mixture of methane and CO2 produced by anaerobic digestion of organic matter.', 'annotations': {'methane_content_percent': '50-70'}, 'aliases': ['Raw Biogas']}, + "BIOMETHANE": {'description': 'Purified biogas upgraded to natural gas quality (>95% methane).', 'annotations': {'methane_content_percent': '95+', 'pipeline_quality': True}, 'aliases': ['Renewable Natural Gas', 'RNG']}, + "BIO_OIL": {'description': 'Liquid intermediate produced by pyrolysis or hydrothermal liquefaction of biomass.', 'annotations': {'intermediate': True}, 'aliases': ['Pyrolysis Oil']}, + "SYNGAS": {'description': 'Synthesis gas (CO + H2) produced by gasification of biomass.', 'meaning': 'CHMO:0001501', 'annotations': {'intermediate': True}, 'aliases': ['Synthesis Gas']}, + "BUTANOL": {'description': 'Four-carbon alcohol biofuel with higher energy density than ethanol.', 'meaning': 'CHEBI:28885', 'annotations': {'chemical_formula': 'C4H9OH'}}, + "METHANOL": {'description': 'Methanol produced from biomass-derived syngas.', 'meaning': 'CHEBI:17790', 'annotations': {'chemical_formula': 'CH3OH'}}, + "DIMETHYL_ETHER": {'description': 'Dimethyl ether produced from biomass, usable as diesel substitute.', 'meaning': 'CHEBI:28887', 'aliases': ['DME']}, +} + +class BiofuelGeneration(RichEnum): + """ + Classification of biofuels by feedstock source and technology generation. + """ + # Enum members + FIRST_GENERATION = "FIRST_GENERATION" + SECOND_GENERATION = "SECOND_GENERATION" + THIRD_GENERATION = "THIRD_GENERATION" + FOURTH_GENERATION = "FOURTH_GENERATION" + +# Set metadata after class creation to avoid it becoming an enum member +BiofuelGeneration._metadata = { + "FIRST_GENERATION": {'description': 'Biofuels produced from food crops (sugar, starch, vegetable oils) using conventional conversion technologies.', 'annotations': {'feedstock': 'food_crops', 'examples': 'corn_ethanol,soy_biodiesel'}, 'aliases': ['1G Biofuel', 'Conventional Biofuel']}, + "SECOND_GENERATION": {'description': 'Biofuels produced from lignocellulosic biomass (non-food) using advanced conversion technologies.', 'annotations': {'feedstock': 'lignocellulosic', 'examples': 'cellulosic_ethanol,wood_diesel'}, 'aliases': ['2G Biofuel', 'Cellulosic Biofuel', 'Advanced Biofuel']}, + "THIRD_GENERATION": {'description': 'Biofuels produced from algae or other photosynthetic microorganisms.', 'annotations': {'feedstock': 'algae'}, 'aliases': ['3G Biofuel', 'Algal Biofuel']}, + "FOURTH_GENERATION": {'description': 'Biofuels from genetically engineered organisms designed for carbon capture and enhanced fuel production.', 'annotations': {'feedstock': 'engineered_organisms', 'carbon_negative': True}, 'aliases': ['4G Biofuel']}, +} + +class BioconversionProcess(RichEnum): + """ + Processes for converting biomass feedstocks into biofuels and bioproducts. + """ + # Enum members + FERMENTATION = "FERMENTATION" + ANAEROBIC_DIGESTION = "ANAEROBIC_DIGESTION" + TRANSESTERIFICATION = "TRANSESTERIFICATION" + HYDROTREATING = "HYDROTREATING" + PYROLYSIS = "PYROLYSIS" + GASIFICATION = "GASIFICATION" + HYDROTHERMAL_LIQUEFACTION = "HYDROTHERMAL_LIQUEFACTION" + ENZYMATIC_HYDROLYSIS = "ENZYMATIC_HYDROLYSIS" + ACID_HYDROLYSIS = "ACID_HYDROLYSIS" + FISCHER_TROPSCH = "FISCHER_TROPSCH" + ALCOHOL_TO_JET = "ALCOHOL_TO_JET" + +# Set metadata after class creation to avoid it becoming an enum member +BioconversionProcess._metadata = { + "FERMENTATION": {'description': 'Biological conversion of sugars to alcohols using yeast or bacteria.', 'annotations': {'category': 'biochemical', 'products': 'ethanol,butanol'}}, + "ANAEROBIC_DIGESTION": {'description': 'Biological breakdown of organic matter by microorganisms in the absence of oxygen, producing biogas.', 'annotations': {'category': 'biochemical', 'products': 'biogas'}}, + "TRANSESTERIFICATION": {'description': 'Chemical reaction of triglycerides with alcohol to produce fatty acid esters (biodiesel) and glycerol.', 'annotations': {'category': 'chemical', 'products': 'biodiesel'}}, + "HYDROTREATING": {'description': 'Catalytic reaction of lipids with hydrogen to produce hydrocarbon fuels.', 'annotations': {'category': 'thermochemical', 'products': 'renewable_diesel,SAF'}, 'aliases': ['Hydroprocessing']}, + "PYROLYSIS": {'description': 'Thermal decomposition of biomass in the absence of oxygen to produce bio-oil, syngas, and biochar.', 'annotations': {'category': 'thermochemical', 'temperature_c': '400-600', 'products': 'bio_oil,syngas,biochar'}}, + "GASIFICATION": {'description': 'High-temperature conversion of carbonaceous materials to syngas using controlled oxygen and/or steam.', 'meaning': 'CHMO:0001501', 'annotations': {'category': 'thermochemical', 'temperature_c': '700-1500', 'products': 'syngas'}}, + "HYDROTHERMAL_LIQUEFACTION": {'description': 'Conversion of wet biomass to bio-crude using high temperature and pressure water.', 'annotations': {'category': 'thermochemical', 'temperature_c': '250-400', 'pressure_bar': '100-200', 'wet_feedstock': True}, 'aliases': ['HTL']}, + "ENZYMATIC_HYDROLYSIS": {'description': 'Breakdown of cellulose and hemicellulose to fermentable sugars using enzymes.', 'annotations': {'category': 'biochemical', 'pretreatment_step': True}}, + "ACID_HYDROLYSIS": {'description': 'Chemical breakdown of cellulose to sugars using dilute or concentrated acid.', 'annotations': {'category': 'chemical', 'pretreatment_step': True}}, + "FISCHER_TROPSCH": {'description': 'Catalytic conversion of syngas to liquid hydrocarbons.', 'annotations': {'category': 'thermochemical', 'feedstock': 'syngas', 'products': 'FT_diesel,FT_jet'}, 'aliases': ['FT Synthesis']}, + "ALCOHOL_TO_JET": {'description': 'Conversion of alcohols (ethanol, isobutanol) to jet fuel through dehydration, oligomerization, and hydrogenation.', 'annotations': {'category': 'chemical', 'products': 'SAF'}, 'aliases': ['ATJ']}, +} + class MiningType(RichEnum): """ Types of mining operations @@ -6969,6 +7439,52 @@ class CellPolarity(RichEnum): "DISTAL_POLE": {'description': 'Pole further from the cell body', 'annotations': {'context': 'neurons, polarized cells'}}, } +class AnatomicalOrientation(RichEnum): + """ + Directional orientation between anatomical positions based on OME NGFF specification + """ + # Enum members + LEFT_TO_RIGHT = "LEFT_TO_RIGHT" + RIGHT_TO_LEFT = "RIGHT_TO_LEFT" + ANTERIOR_TO_POSTERIOR = "ANTERIOR_TO_POSTERIOR" + POSTERIOR_TO_ANTERIOR = "POSTERIOR_TO_ANTERIOR" + INFERIOR_TO_SUPERIOR = "INFERIOR_TO_SUPERIOR" + SUPERIOR_TO_INFERIOR = "SUPERIOR_TO_INFERIOR" + DORSAL_TO_VENTRAL = "DORSAL_TO_VENTRAL" + VENTRAL_TO_DORSAL = "VENTRAL_TO_DORSAL" + DORSAL_TO_PALMAR = "DORSAL_TO_PALMAR" + PALMAR_TO_DORSAL = "PALMAR_TO_DORSAL" + DORSAL_TO_PLANTAR = "DORSAL_TO_PLANTAR" + PLANTAR_TO_DORSAL = "PLANTAR_TO_DORSAL" + ROSTRAL_TO_CAUDAL = "ROSTRAL_TO_CAUDAL" + CAUDAL_TO_ROSTRAL = "CAUDAL_TO_ROSTRAL" + CRANIAL_TO_CAUDAL = "CRANIAL_TO_CAUDAL" + CAUDAL_TO_CRANIAL = "CAUDAL_TO_CRANIAL" + PROXIMAL_TO_DISTAL = "PROXIMAL_TO_DISTAL" + DISTAL_TO_PROXIMAL = "DISTAL_TO_PROXIMAL" + +# Set metadata after class creation to avoid it becoming an enum member +AnatomicalOrientation._metadata = { + "LEFT_TO_RIGHT": {'description': 'Directional orientation from left to right lateral side of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "RIGHT_TO_LEFT": {'description': 'Directional orientation from right to left lateral side of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "ANTERIOR_TO_POSTERIOR": {'description': 'Directional orientation from front to back of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "POSTERIOR_TO_ANTERIOR": {'description': 'Directional orientation from back to front of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "INFERIOR_TO_SUPERIOR": {'description': 'Directional orientation from below to above in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "SUPERIOR_TO_INFERIOR": {'description': 'Directional orientation from above to below in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "DORSAL_TO_VENTRAL": {'description': 'Directional orientation from top/upper to belly/lower in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "VENTRAL_TO_DORSAL": {'description': 'Directional orientation from belly/lower to top/upper in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "DORSAL_TO_PALMAR": {'description': 'Directional orientation from top/upper to palm of hand', 'annotations': {'source': 'OME NGFF', 'context': 'hand anatomy'}}, + "PALMAR_TO_DORSAL": {'description': 'Directional orientation from palm of hand to top/upper', 'annotations': {'source': 'OME NGFF', 'context': 'hand anatomy'}}, + "DORSAL_TO_PLANTAR": {'description': 'Directional orientation from top/upper to sole of foot', 'annotations': {'source': 'OME NGFF', 'context': 'foot anatomy'}}, + "PLANTAR_TO_DORSAL": {'description': 'Directional orientation from sole of foot to top/upper', 'annotations': {'source': 'OME NGFF', 'context': 'foot anatomy'}}, + "ROSTRAL_TO_CAUDAL": {'description': 'Directional orientation from nasal to tail end, typically for central nervous system', 'annotations': {'source': 'OME NGFF', 'context': 'central nervous system'}}, + "CAUDAL_TO_ROSTRAL": {'description': 'Directional orientation from tail to nasal end, typically for central nervous system', 'annotations': {'source': 'OME NGFF', 'context': 'central nervous system'}}, + "CRANIAL_TO_CAUDAL": {'description': 'Directional orientation from head to tail end of a structure', 'annotations': {'source': 'OME NGFF'}}, + "CAUDAL_TO_CRANIAL": {'description': 'Directional orientation from tail to head end of a structure', 'annotations': {'source': 'OME NGFF'}}, + "PROXIMAL_TO_DISTAL": {'description': 'Directional orientation from body center to periphery of a structure', 'annotations': {'source': 'OME NGFF'}}, + "DISTAL_TO_PROXIMAL": {'description': 'Directional orientation from periphery to body center of a structure', 'annotations': {'source': 'OME NGFF'}}, +} + class CrystalSystemEnum(RichEnum): """ The seven crystal systems in crystallography diff --git a/src/valuesets/datamodel/valuesets_dataclass.py b/src/valuesets/datamodel/valuesets_dataclass.py index cb73833f..d8790a37 100644 --- a/src/valuesets/datamodel/valuesets_dataclass.py +++ b/src/valuesets/datamodel/valuesets_dataclass.py @@ -1,5 +1,5 @@ # Auto generated from valuesets.yaml by pythongen.py version: 0.0.1 -# Generation date: 2025-11-25T10:23:04 +# Generation date: 2025-12-06T18:56:38 # Schema: valuesets # # id: https://w3id.org/linkml/valuesets @@ -2324,28 +2324,36 @@ class SampleType(EnumDefinitionImpl): """ PROTEIN = PermissibleValue( text="PROTEIN", - description="Purified protein sample") + description="Purified protein sample", + meaning=NCIT["C17021"]) NUCLEIC_ACID = PermissibleValue( text="NUCLEIC_ACID", - description="Nucleic acid sample (DNA or RNA)") + description="Nucleic acid sample (DNA or RNA)", + meaning=NCIT["C813"]) PROTEIN_COMPLEX = PermissibleValue( text="PROTEIN_COMPLEX", - description="Protein-protein or protein-nucleic acid complex") + description="Protein-protein or protein-nucleic acid complex", + meaning=GO["0032991"]) MEMBRANE_PROTEIN = PermissibleValue( text="MEMBRANE_PROTEIN", - description="Membrane-associated protein sample") + description="Membrane-associated protein sample", + meaning=NCIT["C16837"]) VIRUS = PermissibleValue( text="VIRUS", - description="Viral particle or capsid") + description="Viral particle or capsid", + meaning=NCIT["C14283"]) ORGANELLE = PermissibleValue( text="ORGANELLE", - description="Cellular organelle (mitochondria, chloroplast, etc.)") + description="Cellular organelle (mitochondria, chloroplast, etc.)", + meaning=GO["0043226"]) CELL = PermissibleValue( text="CELL", - description="Whole cell sample") + description="Whole cell sample", + meaning=NCIT["C12508"]) TISSUE = PermissibleValue( text="TISSUE", - description="Tissue sample") + description="Tissue sample", + meaning=NCIT["C12801"]) _defn = EnumDefinition( name="SampleType", @@ -2363,7 +2371,9 @@ class StructuralBiologyTechnique(EnumDefinitionImpl): meaning=CHMO["0002413"]) CRYO_ET = PermissibleValue( text="CRYO_ET", - description="Cryo-electron tomography") + title="electron tomography", + description="Cryo-electron tomography", + meaning=MI["2338"]) X_RAY_CRYSTALLOGRAPHY = PermissibleValue( text="X_RAY_CRYSTALLOGRAPHY", title="single crystal X-ray diffraction", @@ -2371,7 +2381,9 @@ class StructuralBiologyTechnique(EnumDefinitionImpl): meaning=CHMO["0000159"]) NEUTRON_CRYSTALLOGRAPHY = PermissibleValue( text="NEUTRON_CRYSTALLOGRAPHY", - description="Neutron crystallography") + title="neutron diffraction", + description="Neutron crystallography", + meaning=CHMO["0000175"]) SAXS = PermissibleValue( text="SAXS", title="small-angle X-ray scattering", @@ -2379,10 +2391,14 @@ class StructuralBiologyTechnique(EnumDefinitionImpl): meaning=CHMO["0000204"]) SANS = PermissibleValue( text="SANS", - description="Small-angle neutron scattering") + title="small-angle neutron scattering", + description="Small-angle neutron scattering", + meaning=CHMO["0000184"]) WAXS = PermissibleValue( text="WAXS", - description="Wide-angle X-ray scattering") + title="wide-angle X-ray scattering", + description="Wide-angle X-ray scattering", + meaning=CHMO["0000213"]) NMR = PermissibleValue( text="NMR", title="nuclear magnetic resonance spectroscopy", @@ -2394,7 +2410,9 @@ class StructuralBiologyTechnique(EnumDefinitionImpl): meaning=CHMO["0000470"]) NEGATIVE_STAIN_EM = PermissibleValue( text="NEGATIVE_STAIN_EM", - description="Negative stain electron microscopy") + title="negative staining electron microscopy", + description="Negative stain electron microscopy", + meaning=FBBI["00000568"]) _defn = EnumDefinition( name="StructuralBiologyTechnique", @@ -2507,10 +2525,12 @@ class XRaySource(EnumDefinitionImpl): """ SYNCHROTRON = PermissibleValue( text="SYNCHROTRON", - description="Synchrotron radiation source") + description="Synchrotron radiation source", + meaning=CHMO["0001810"]) ROTATING_ANODE = PermissibleValue( text="ROTATING_ANODE", - description="Rotating anode generator") + description="Rotating anode generator", + meaning=CHMO["0001107"]) MICROFOCUS = PermissibleValue( text="MICROFOCUS", description="Microfocus sealed tube") @@ -2529,19 +2549,23 @@ class Detector(EnumDefinitionImpl): """ DIRECT_ELECTRON = PermissibleValue( text="DIRECT_ELECTRON", - description="Direct electron detector (DED)") + description="Direct electron detector (DED)", + meaning=CHMO["0002837"]) CCD = PermissibleValue( text="CCD", - description="Charge-coupled device camera") + description="Charge-coupled device camera", + meaning=CHMO["0002171"]) CMOS = PermissibleValue( text="CMOS", - description="Complementary metal-oxide semiconductor detector") + description="Complementary metal-oxide semiconductor detector", + meaning=CHMO["0002836"]) HYBRID_PIXEL = PermissibleValue( text="HYBRID_PIXEL", description="Hybrid pixel detector") PHOTOSTIMULABLE_PHOSPHOR = PermissibleValue( text="PHOTOSTIMULABLE_PHOSPHOR", - description="Photostimulable phosphor (image plate)") + description="Photostimulable phosphor (image plate)", + meaning=CHMO["0001069"]) _defn = EnumDefinition( name="Detector", @@ -2600,28 +2624,36 @@ class FileFormat(EnumDefinitionImpl): """ MRC = PermissibleValue( text="MRC", - description="MRC format for EM density maps") + description="MRC format for EM density maps", + meaning=EDAM["3842"]) TIFF = PermissibleValue( text="TIFF", - description="Tagged Image File Format") + description="Tagged Image File Format", + meaning=EDAM["3591"]) HDF5 = PermissibleValue( text="HDF5", - description="Hierarchical Data Format 5") + description="Hierarchical Data Format 5", + meaning=EDAM["3590"]) STAR = PermissibleValue( text="STAR", - description="Self-defining Text Archival and Retrieval format") + description="Self-defining Text Archival and Retrieval format", + meaning=EDAM["3906"]) PDB = PermissibleValue( text="PDB", - description="Protein Data Bank coordinate format") + description="Protein Data Bank coordinate format", + meaning=EDAM["1476"]) MMCIF = PermissibleValue( text="MMCIF", - description="Macromolecular Crystallographic Information File") + description="Macromolecular Crystallographic Information File", + meaning=EDAM["1477"]) MTZ = PermissibleValue( text="MTZ", - description="MTZ reflection data format") + description="MTZ reflection data format", + meaning=EDAM["3816"]) CBF = PermissibleValue( text="CBF", - description="Crystallographic Binary Format") + description="Crystallographic Binary Format", + meaning=EDAM["3874"]) DM3 = PermissibleValue( text="DM3", description="Digital Micrograph format") @@ -2729,7 +2761,8 @@ class CoordinationGeometry(EnumDefinitionImpl): SQUARE_PLANAR = PermissibleValue( text="SQUARE_PLANAR", title="square planar molecular geometry", - description="Square planar coordination geometry (4 ligands in plane)") + description="Square planar coordination geometry (4 ligands in plane)", + meaning=NCIT["C103211"]) TRIGONAL_BIPYRAMIDAL = PermissibleValue( text="TRIGONAL_BIPYRAMIDAL", description="Trigonal bipyramidal coordination geometry (5 ligands)") @@ -2742,7 +2775,8 @@ class CoordinationGeometry(EnumDefinitionImpl): OCTAHEDRAL = PermissibleValue( text="OCTAHEDRAL", title="octahedral molecular geometry", - description="Octahedral coordination geometry (6 ligands)") + description="Octahedral coordination geometry (6 ligands)", + meaning=NCIT["C103216"]) TRIGONAL_PRISMATIC = PermissibleValue( text="TRIGONAL_PRISMATIC", description="Trigonal prismatic coordination geometry (6 ligands)") @@ -2795,37 +2829,48 @@ class ProteinModificationType(EnumDefinitionImpl): """ METAL_COORDINATION = PermissibleValue( text="METAL_COORDINATION", - description="Metal coordination modification") + description="Metal coordination modification", + meaning=MOD["00739"]) PHOSPHORYLATION = PermissibleValue( text="PHOSPHORYLATION", - description="Phosphorylation modification") + description="Phosphorylation modification", + meaning=MOD["00696"]) GLYCOSYLATION = PermissibleValue( text="GLYCOSYLATION", - description="Glycosylation modification") + description="Glycosylation modification", + meaning=MOD["00725"]) ACETYLATION = PermissibleValue( text="ACETYLATION", - description="Acetylation modification") + description="Acetylation modification", + meaning=MOD["00394"]) METHYLATION = PermissibleValue( text="METHYLATION", - description="Methylation modification") + description="Methylation modification", + meaning=MOD["00599"]) UBIQUITINATION = PermissibleValue( text="UBIQUITINATION", - description="Ubiquitination modification") + description="Ubiquitination modification", + meaning=MOD["01240"]) SUMOYLATION = PermissibleValue( text="SUMOYLATION", - description="SUMOylation modification") + description="SUMOylation modification", + meaning=MOD["01149"]) HYDROXYLATION = PermissibleValue( text="HYDROXYLATION", - description="Hydroxylation modification") + description="Hydroxylation modification", + meaning=MOD["00677"]) LIPIDATION = PermissibleValue( text="LIPIDATION", - description="Lipidation modification") + description="Lipidation modification", + meaning=MOD["00435"]) PROTEOLYTIC_CLEAVAGE = PermissibleValue( text="PROTEOLYTIC_CLEAVAGE", - description="Proteolytic cleavage") + description="Proteolytic cleavage", + meaning=GO["0006508"]) CROSSLINKING = PermissibleValue( text="CROSSLINKING", - description="Crosslinking modification") + description="Crosslinking modification", + meaning=MOD["00276"]) _defn = EnumDefinition( name="ProteinModificationType", @@ -6642,6 +6687,37 @@ class ElectricityMarket(EnumDefinitionImpl): description="Types of electricity markets and pricing", ) +class CapabilityStatus(EnumDefinitionImpl): + """ + Operational status of a capability, facility, or infrastructure. Applicable to energy facilities, research + capabilities, and other infrastructure throughout their lifecycle. + """ + OPERATIONAL = PermissibleValue( + text="OPERATIONAL", + title="Operational", + description="Fully operational and available to users") + COMING_ONLINE = PermissibleValue( + text="COMING_ONLINE", + title="Coming Online", + description="Being commissioned, coming online soon") + PILOT = PermissibleValue( + text="PILOT", + title="Pilot", + description="In pilot phase with limited access") + UNDER_DEVELOPMENT = PermissibleValue( + text="UNDER_DEVELOPMENT", + title="Under Development", + description="Under development, not yet available") + DECOMMISSIONED = PermissibleValue( + text="DECOMMISSIONED", + title="Decommissioned", + description="No longer available, permanently shut down") + + _defn = EnumDefinition( + name="CapabilityStatus", + description="""Operational status of a capability, facility, or infrastructure. Applicable to energy facilities, research capabilities, and other infrastructure throughout their lifecycle.""", + ) + class FossilFuelTypeEnum(EnumDefinitionImpl): """ Types of fossil fuels used for energy generation @@ -8125,6 +8201,605 @@ class OperationalProcedureEnum(EnumDefinitionImpl): description="Standard nuclear facility operational procedures", ) +class GeothermalSystemType(EnumDefinitionImpl): + """ + Types of geothermal energy systems, including conventional hydrothermal and enhanced/engineered geothermal systems. + """ + HYDROTHERMAL = PermissibleValue( + text="HYDROTHERMAL", + title="Conventional Hydrothermal System", + description="""Naturally occurring geothermal system with heat, fluid, and permeability sufficient for energy extraction without stimulation.""") + ENHANCED_GEOTHERMAL_SYSTEM = PermissibleValue( + text="ENHANCED_GEOTHERMAL_SYSTEM", + title="Enhanced Geothermal System (EGS)", + description="""Engineered reservoirs created to extract heat from low permeability geothermal resources through stimulation methods.""") + ADVANCED_GEOTHERMAL_SYSTEM = PermissibleValue( + text="ADVANCED_GEOTHERMAL_SYSTEM", + title="Advanced Geothermal System (AGS)", + description="""Closed-loop geothermal systems that circulate working fluid through wellbores to extract heat conductively without reservoir stimulation.""") + HOT_DRY_ROCK = PermissibleValue( + text="HOT_DRY_ROCK", + title="Hot Dry Rock (HDR)", + description="""Geothermal system targeting hot basement rock lacking natural fluid or permeability, requiring artificial reservoir creation.""") + GEOPRESSURED = PermissibleValue( + text="GEOPRESSURED", + title="Geopressured System", + description="""Deep sedimentary formations with abnormally high fluid pressure containing hot brine and dissolved methane.""") + SUPERCRITICAL = PermissibleValue( + text="SUPERCRITICAL", + title="Supercritical Geothermal System", + description="""Very high temperature systems (>374C) where water exists above its critical point, offering higher energy density.""") + GROUND_SOURCE_HEAT_PUMP = PermissibleValue( + text="GROUND_SOURCE_HEAT_PUMP", + title="Ground Source Heat Pump (GSHP)", + description="Shallow geothermal system using stable ground temperatures for heating and cooling buildings.") + + _defn = EnumDefinition( + name="GeothermalSystemType", + description="""Types of geothermal energy systems, including conventional hydrothermal and enhanced/engineered geothermal systems.""", + ) + +class GeothermalReservoirType(EnumDefinitionImpl): + """ + Classification of geothermal reservoirs by geological setting and characteristics. + """ + VOLCANIC = PermissibleValue( + text="VOLCANIC", + title="Volcanic Reservoir", + description="""Reservoir associated with volcanic activity, typically in active volcanic regions with magma heat sources.""") + SEDIMENTARY = PermissibleValue( + text="SEDIMENTARY", + title="Sedimentary Basin Reservoir", + description="""Reservoir in sedimentary formations with elevated temperatures due to depth or regional heat flow.""") + FRACTURED_BASEMENT = PermissibleValue( + text="FRACTURED_BASEMENT", + title="Fractured Basement Reservoir", + description="Reservoir in fractured crystalline basement rocks, typically granitic or metamorphic.") + FAULT_CONTROLLED = PermissibleValue( + text="FAULT_CONTROLLED", + title="Fault-Controlled Reservoir", + description="Reservoir where fluid flow is controlled by fault systems providing permeability pathways.") + MAGMATIC = PermissibleValue( + text="MAGMATIC", + title="Magmatic/Near-Magmatic Reservoir", + description="Very high temperature reservoir near or in contact with magma bodies or recent intrusions.") + CONDUCTION_DOMINATED = PermissibleValue( + text="CONDUCTION_DOMINATED", + title="Conduction-Dominated Reservoir", + description="""Low permeability reservoir where heat transfer is primarily through conduction rather than convection.""") + + _defn = EnumDefinition( + name="GeothermalReservoirType", + description="Classification of geothermal reservoirs by geological setting and characteristics.", + ) + +class GeothermalWellType(EnumDefinitionImpl): + """ + Types of wells used in geothermal energy development and production. + """ + PRODUCTION_WELL = PermissibleValue( + text="PRODUCTION_WELL", + title="Production Well", + description="Well used to extract geothermal fluids or steam from the reservoir.") + INJECTION_WELL = PermissibleValue( + text="INJECTION_WELL", + title="Injection Well", + description="""Well used to return cooled geothermal fluids to the reservoir to maintain pressure and sustainability.""") + EXPLORATION_WELL = PermissibleValue( + text="EXPLORATION_WELL", + title="Exploration Well", + description="Well drilled to evaluate geothermal resource characteristics.") + OBSERVATION_WELL = PermissibleValue( + text="OBSERVATION_WELL", + title="Observation/Monitoring Well", + description="Well used to monitor reservoir conditions and pressure.") + SLIM_HOLE = PermissibleValue( + text="SLIM_HOLE", + title="Slim Hole", + description="Smaller diameter well used for initial exploration and temperature gradient measurement.") + DIRECTIONAL_WELL = PermissibleValue( + text="DIRECTIONAL_WELL", + title="Directional/Deviated Well", + description="""Well drilled at an angle to access reservoir from offset surface location or increase reservoir contact.""") + + _defn = EnumDefinition( + name="GeothermalWellType", + description="Types of wells used in geothermal energy development and production.", + ) + +class GeothermalApplication(EnumDefinitionImpl): + """ + Applications and uses of geothermal energy. + """ + ELECTRICITY_GENERATION = PermissibleValue( + text="ELECTRICITY_GENERATION", + title="Electricity Generation", + description="""Use of geothermal resources for power generation through steam turbines or binary cycle plants.""", + meaning=ENVO["2000034"]) + DIRECT_USE_HEATING = PermissibleValue( + text="DIRECT_USE_HEATING", + title="Direct Use Heating", + description="Direct use of geothermal heat for space heating, district heating, or industrial processes.") + GREENHOUSE_HEATING = PermissibleValue( + text="GREENHOUSE_HEATING", + title="Greenhouse Heating", + description="Use of geothermal heat for agricultural greenhouses.") + AQUACULTURE = PermissibleValue( + text="AQUACULTURE", + title="Aquaculture Heating", + description="Use of geothermal heat for fish farming and aquaculture.") + INDUSTRIAL_PROCESS_HEAT = PermissibleValue( + text="INDUSTRIAL_PROCESS_HEAT", + title="Industrial Process Heat", + description="Use of geothermal heat for industrial manufacturing processes.") + FOOD_PROCESSING = PermissibleValue( + text="FOOD_PROCESSING", + title="Food Processing", + description="Use of geothermal heat for food drying, pasteurization, and processing.") + BATHING_RECREATION = PermissibleValue( + text="BATHING_RECREATION", + title="Bathing and Recreation", + description="Use of geothermal waters for spas, pools, and recreation.") + LITHIUM_EXTRACTION = PermissibleValue( + text="LITHIUM_EXTRACTION", + title="Lithium Extraction", + description="""Extraction of lithium and other minerals from geothermal brines as a co-product of energy production.""") + + _defn = EnumDefinition( + name="GeothermalApplication", + description="Applications and uses of geothermal energy.", + ) + +class GeothermalResourceTemperature(EnumDefinitionImpl): + """ + Classification of geothermal resources by temperature range. + """ + LOW_TEMPERATURE = PermissibleValue( + text="LOW_TEMPERATURE", + title="Low Temperature Resource", + description="Geothermal resource below 90C, suitable for direct use applications.") + MODERATE_TEMPERATURE = PermissibleValue( + text="MODERATE_TEMPERATURE", + title="Moderate Temperature Resource", + description="Geothermal resource 90-150C, suitable for binary power generation.") + HIGH_TEMPERATURE = PermissibleValue( + text="HIGH_TEMPERATURE", + title="High Temperature Resource", + description="Geothermal resource above 150C, suitable for flash steam power generation.") + SUPERCRITICAL = PermissibleValue( + text="SUPERCRITICAL", + title="Supercritical Resource", + description="Very high temperature resource above 374C where water exists in supercritical state.") + + _defn = EnumDefinition( + name="GeothermalResourceTemperature", + description="Classification of geothermal resources by temperature range.", + ) + +class HydrogenType(EnumDefinitionImpl): + """ + Color-coded classification of hydrogen based on production method and carbon intensity. This informal industry + taxonomy differentiates hydrogen by its carbon footprint and energy source. + """ + GREEN_HYDROGEN = PermissibleValue( + text="GREEN_HYDROGEN", + title="Green Hydrogen", + description="""Hydrogen produced via electrolysis powered by renewable energy sources (solar, wind, hydro). Zero carbon emissions during production.""") + BLUE_HYDROGEN = PermissibleValue( + text="BLUE_HYDROGEN", + title="Blue Hydrogen", + description="""Hydrogen produced from natural gas via steam methane reforming (SMR) with carbon capture and storage (CCS). Low carbon intensity.""") + GREY_HYDROGEN = PermissibleValue( + text="GREY_HYDROGEN", + title="Grey Hydrogen", + description="""Hydrogen produced from natural gas via steam methane reforming without carbon capture. Most common production method currently.""") + BROWN_HYDROGEN = PermissibleValue( + text="BROWN_HYDROGEN", + title="Brown Hydrogen", + description="""Hydrogen produced from brown coal (lignite) gasification without carbon capture. High carbon intensity.""") + BLACK_HYDROGEN = PermissibleValue( + text="BLACK_HYDROGEN", + title="Black Hydrogen", + description="""Hydrogen produced from black coal (bituminous) gasification without carbon capture. High carbon intensity.""") + PINK_HYDROGEN = PermissibleValue( + text="PINK_HYDROGEN", + title="Pink Hydrogen", + description="""Hydrogen produced via electrolysis powered by nuclear energy. Zero carbon emissions during production.""") + TURQUOISE_HYDROGEN = PermissibleValue( + text="TURQUOISE_HYDROGEN", + title="Turquoise Hydrogen", + description="""Hydrogen produced via methane pyrolysis, producing solid carbon instead of CO2. Lower carbon intensity than grey hydrogen.""") + WHITE_HYDROGEN = PermissibleValue( + text="WHITE_HYDROGEN", + title="White Hydrogen", + description="""Naturally occurring geological hydrogen found in underground deposits. Zero production emissions.""") + YELLOW_HYDROGEN = PermissibleValue( + text="YELLOW_HYDROGEN", + title="Yellow Hydrogen", + description="""Hydrogen produced via electrolysis powered by solar energy specifically. A subset of green hydrogen.""") + ORANGE_HYDROGEN = PermissibleValue( + text="ORANGE_HYDROGEN", + title="Orange Hydrogen", + description="""Hydrogen produced from plastic waste gasification or pyrolysis. Emerging technology addressing both energy and waste challenges.""") + + _defn = EnumDefinition( + name="HydrogenType", + description="""Color-coded classification of hydrogen based on production method and carbon intensity. This informal industry taxonomy differentiates hydrogen by its carbon footprint and energy source.""", + ) + +class HydrogenProductionMethod(EnumDefinitionImpl): + """ + Methods and processes for producing hydrogen. + """ + STEAM_METHANE_REFORMING = PermissibleValue( + text="STEAM_METHANE_REFORMING", + title="Steam Methane Reforming (SMR)", + description="""High temperature steam reacts with methane to produce hydrogen, carbon monoxide, and carbon dioxide.""") + AUTOTHERMAL_REFORMING = PermissibleValue( + text="AUTOTHERMAL_REFORMING", + title="Autothermal Reforming (ATR)", + description="""Combines steam reforming and partial oxidation using oxygen and steam to produce hydrogen from hydrocarbons.""") + PARTIAL_OXIDATION = PermissibleValue( + text="PARTIAL_OXIDATION", + title="Partial Oxidation (POX)", + description="""Exothermic process reacting hydrocarbons with limited oxygen to produce hydrogen and carbon monoxide.""") + COAL_GASIFICATION = PermissibleValue( + text="COAL_GASIFICATION", + title="Coal Gasification", + description="Conversion of coal to syngas (hydrogen and carbon monoxide) using high temperature and steam.", + meaning=CHMO["0001501"]) + WATER_ELECTROLYSIS = PermissibleValue( + text="WATER_ELECTROLYSIS", + title="Water Electrolysis", + description="""Splitting water into hydrogen and oxygen using electrical current. Can be powered by various energy sources.""") + ALKALINE_ELECTROLYSIS = PermissibleValue( + text="ALKALINE_ELECTROLYSIS", + title="Alkaline Electrolysis (AEL)", + description="""Electrolysis using alkaline solution (typically KOH) as electrolyte. Mature commercial technology.""") + PEM_ELECTROLYSIS = PermissibleValue( + text="PEM_ELECTROLYSIS", + title="PEM Electrolysis", + description="""Proton Exchange Membrane electrolysis using solid polymer electrolyte. Higher efficiency, faster response.""") + SOLID_OXIDE_ELECTROLYSIS = PermissibleValue( + text="SOLID_OXIDE_ELECTROLYSIS", + title="Solid Oxide Electrolysis (SOEC)", + description="""High temperature electrolysis using solid ceramic electrolyte. Higher efficiency when waste heat is available.""") + METHANE_PYROLYSIS = PermissibleValue( + text="METHANE_PYROLYSIS", + title="Methane Pyrolysis", + description="""Thermal decomposition of methane into hydrogen and solid carbon without oxygen. Produces no direct CO2.""") + BIOMASS_GASIFICATION = PermissibleValue( + text="BIOMASS_GASIFICATION", + title="Biomass Gasification", + description="Thermochemical conversion of biomass to hydrogen-rich syngas at high temperatures.") + BIOLOGICAL_PRODUCTION = PermissibleValue( + text="BIOLOGICAL_PRODUCTION", + title="Biological Hydrogen Production", + description="""Production of hydrogen by microorganisms through photosynthesis, fermentation, or other biological processes.""") + THERMOCHEMICAL_WATER_SPLITTING = PermissibleValue( + text="THERMOCHEMICAL_WATER_SPLITTING", + title="Thermochemical Water Splitting", + description="""Using high temperatures from concentrated solar or nuclear to drive chemical cycles that split water.""") + PHOTOELECTROCHEMICAL = PermissibleValue( + text="PHOTOELECTROCHEMICAL", + title="Photoelectrochemical Water Splitting", + description="""Direct conversion of sunlight to hydrogen using specialized semiconductor materials in contact with water.""") + + _defn = EnumDefinition( + name="HydrogenProductionMethod", + description="Methods and processes for producing hydrogen.", + ) + +class HydrogenStorageMethod(EnumDefinitionImpl): + """ + Methods for storing hydrogen for later use or transport. + """ + COMPRESSED_GAS = PermissibleValue( + text="COMPRESSED_GAS", + title="Compressed Gas Storage", + description="Storage of hydrogen as compressed gas at high pressure (350-700 bar) in pressure vessels.") + LIQUID_HYDROGEN = PermissibleValue( + text="LIQUID_HYDROGEN", + title="Liquid Hydrogen Storage", + description="""Storage of hydrogen in liquid form at cryogenic temperatures (-253C). Higher energy density but requires insulation.""") + METAL_HYDRIDE = PermissibleValue( + text="METAL_HYDRIDE", + title="Metal Hydride Storage", + description="""Storage of hydrogen absorbed into metal alloys forming metal hydrides. Safer but heavier than compressed gas.""") + CHEMICAL_HYDRIDE = PermissibleValue( + text="CHEMICAL_HYDRIDE", + title="Chemical Hydride Storage", + description="Storage as chemical compounds (ammonia, methanol, LOHC) that release hydrogen when processed.") + UNDERGROUND_STORAGE = PermissibleValue( + text="UNDERGROUND_STORAGE", + title="Underground Storage", + description="""Large-scale storage in salt caverns, depleted gas fields, or aquifers for grid-scale applications.""") + CRYO_COMPRESSED = PermissibleValue( + text="CRYO_COMPRESSED", + title="Cryo-Compressed Storage", + description="Hybrid approach combining cryogenic cooling with high pressure for improved density.") + + _defn = EnumDefinition( + name="HydrogenStorageMethod", + description="Methods for storing hydrogen for later use or transport.", + ) + +class HydrogenApplication(EnumDefinitionImpl): + """ + End-use applications for hydrogen. + """ + FUEL_CELL_VEHICLE = PermissibleValue( + text="FUEL_CELL_VEHICLE", + title="Fuel Cell Electric Vehicle", + description="Use of hydrogen in fuel cells for transportation (cars, trucks, buses).") + FUEL_CELL_STATIONARY = PermissibleValue( + text="FUEL_CELL_STATIONARY", + title="Stationary Fuel Cell", + description="Use of hydrogen in stationary fuel cells for power generation.") + INDUSTRIAL_FEEDSTOCK = PermissibleValue( + text="INDUSTRIAL_FEEDSTOCK", + title="Industrial Feedstock", + description="""Use of hydrogen as chemical feedstock for ammonia production, petroleum refining, and chemical synthesis.""", + meaning=CHEBI["18276"]) + STEEL_PRODUCTION = PermissibleValue( + text="STEEL_PRODUCTION", + title="Steel Production (Direct Reduction)", + description="Use of hydrogen to reduce iron ore in steelmaking, replacing coal.") + AMMONIA_SYNTHESIS = PermissibleValue( + text="AMMONIA_SYNTHESIS", + title="Ammonia Synthesis", + description="Use of hydrogen with nitrogen to produce ammonia for fertilizers.") + METHANOL_SYNTHESIS = PermissibleValue( + text="METHANOL_SYNTHESIS", + title="Methanol Synthesis", + description="Use of hydrogen with CO2 to produce methanol.") + POWER_TO_GAS = PermissibleValue( + text="POWER_TO_GAS", + title="Power-to-Gas", + description="Conversion of excess renewable electricity to hydrogen for grid balancing and energy storage.") + BLENDING_NATURAL_GAS = PermissibleValue( + text="BLENDING_NATURAL_GAS", + title="Natural Gas Blending", + description="Blending hydrogen into natural gas pipelines for decarbonization of heating.") + SYNTHETIC_FUELS = PermissibleValue( + text="SYNTHETIC_FUELS", + title="Synthetic Fuel Production", + description="Use of hydrogen with captured CO2 to produce synthetic hydrocarbons (e-fuels, SAF).") + + _defn = EnumDefinition( + name="HydrogenApplication", + description="End-use applications for hydrogen.", + ) + +class BiomassFeedstockType(EnumDefinitionImpl): + """ + Types of biomass materials used as feedstocks for bioenergy production. Includes dedicated energy crops, + agricultural residues, forest residues, and waste streams. + """ + CORN_STOVER = PermissibleValue( + text="CORN_STOVER", + title="Corn Stover", + description="""Agricultural residue consisting of leaves, stalks, and cobs remaining after corn grain harvest.""") + WHEAT_STRAW = PermissibleValue( + text="WHEAT_STRAW", + title="Wheat Straw", + description="Agricultural residue remaining after wheat grain harvest.") + RICE_STRAW = PermissibleValue( + text="RICE_STRAW", + title="Rice Straw", + description="Agricultural residue remaining after rice grain harvest.") + SWITCHGRASS = PermissibleValue( + text="SWITCHGRASS", + title="Switchgrass", + description="""Perennial warm-season grass native to North America, cultivated as dedicated energy crop for cellulosic biofuel production.""") + MISCANTHUS = PermissibleValue( + text="MISCANTHUS", + title="Miscanthus", + description="High-yielding perennial grass cultivated as dedicated energy crop.") + ENERGY_CANE = PermissibleValue( + text="ENERGY_CANE", + title="Energy Cane", + description="High-fiber sugarcane varieties bred for biomass production rather than sugar content.") + SWEET_SORGHUM = PermissibleValue( + text="SWEET_SORGHUM", + title="Sweet Sorghum", + description="""Sorghum variety with high sugar content in stalks, suitable for both sugar and lignocellulosic conversion.""") + POPLAR = PermissibleValue( + text="POPLAR", + title="Poplar", + description="Fast-growing hardwood tree cultivated as short-rotation woody crop for biomass.") + WILLOW = PermissibleValue( + text="WILLOW", + title="Willow", + description="Fast-growing shrub cultivated as short-rotation woody crop.") + FOREST_RESIDUE = PermissibleValue( + text="FOREST_RESIDUE", + title="Forest Residue", + description="""Biomass from forest operations including logging residues, thinning material, and salvage timber.""") + WOOD_PROCESSING_RESIDUE = PermissibleValue( + text="WOOD_PROCESSING_RESIDUE", + title="Wood Processing Residue", + description="Byproducts from wood processing including sawdust, bark, shavings, and wood chips.") + MUNICIPAL_SOLID_WASTE = PermissibleValue( + text="MUNICIPAL_SOLID_WASTE", + title="Municipal Solid Waste (Organic Fraction)", + description="Organic portion of municipal solid waste suitable for bioenergy conversion.") + FOOD_WASTE = PermissibleValue( + text="FOOD_WASTE", + title="Food Waste", + description="Waste food from residential, commercial, and industrial sources.") + ANIMAL_MANURE = PermissibleValue( + text="ANIMAL_MANURE", + title="Animal Manure", + description="Livestock waste including cattle, swine, and poultry manure.") + ALGAE = PermissibleValue( + text="ALGAE", + title="Algae", + description="Microalgae or macroalgae cultivated for lipid or carbohydrate content for biofuel production.") + USED_COOKING_OIL = PermissibleValue( + text="USED_COOKING_OIL", + title="Used Cooking Oil", + description="Waste vegetable oils from food preparation.") + SOYBEAN_OIL = PermissibleValue( + text="SOYBEAN_OIL", + title="Soybean Oil", + description="Vegetable oil from soybean seeds, used for biodiesel.", + meaning=CHEBI["166975"]) + CORN_GRAIN = PermissibleValue( + text="CORN_GRAIN", + title="Corn Grain", + description="Corn kernels used for starch-based ethanol production.") + SUGARCANE = PermissibleValue( + text="SUGARCANE", + title="Sugarcane", + description="Sugar-rich crop used for first-generation ethanol production.") + + _defn = EnumDefinition( + name="BiomassFeedstockType", + description="""Types of biomass materials used as feedstocks for bioenergy production. Includes dedicated energy crops, agricultural residues, forest residues, and waste streams.""", + ) + +class BiofuelType(EnumDefinitionImpl): + """ + Types of fuels produced from biomass feedstocks. + """ + ETHANOL = PermissibleValue( + text="ETHANOL", + title="Ethanol", + description="""Alcohol biofuel (C2H5OH) produced by fermentation of sugars or starches, or from cellulosic biomass.""", + meaning=CHEBI["16236"]) + BIODIESEL = PermissibleValue( + text="BIODIESEL", + title="Biodiesel", + description="""Fatty acid methyl esters (FAME) produced by transesterification of vegetable oils or animal fats.""", + meaning=MESH["D056804"]) + RENEWABLE_DIESEL = PermissibleValue( + text="RENEWABLE_DIESEL", + title="Renewable Diesel", + description="Hydrocarbon diesel produced by hydrotreating lipids. Chemically identical to petroleum diesel.") + SUSTAINABLE_AVIATION_FUEL = PermissibleValue( + text="SUSTAINABLE_AVIATION_FUEL", + title="Sustainable Aviation Fuel (SAF)", + description="Jet fuel produced from biomass or waste, meeting aviation fuel specifications.") + BIOGAS = PermissibleValue( + text="BIOGAS", + title="Biogas", + description="Gaseous mixture of methane and CO2 produced by anaerobic digestion of organic matter.") + BIOMETHANE = PermissibleValue( + text="BIOMETHANE", + title="Biomethane", + description="Purified biogas upgraded to natural gas quality (>95% methane).") + BIO_OIL = PermissibleValue( + text="BIO_OIL", + title="Bio-Oil", + description="Liquid intermediate produced by pyrolysis or hydrothermal liquefaction of biomass.") + SYNGAS = PermissibleValue( + text="SYNGAS", + title="Syngas (Bio-Based)", + description="Synthesis gas (CO + H2) produced by gasification of biomass.", + meaning=CHMO["0001501"]) + BUTANOL = PermissibleValue( + text="BUTANOL", + title="Biobutanol", + description="Four-carbon alcohol biofuel with higher energy density than ethanol.", + meaning=CHEBI["28885"]) + METHANOL = PermissibleValue( + text="METHANOL", + title="Biomethanol", + description="Methanol produced from biomass-derived syngas.", + meaning=CHEBI["17790"]) + DIMETHYL_ETHER = PermissibleValue( + text="DIMETHYL_ETHER", + title="Bio-DME", + description="Dimethyl ether produced from biomass, usable as diesel substitute.", + meaning=CHEBI["28887"]) + + _defn = EnumDefinition( + name="BiofuelType", + description="Types of fuels produced from biomass feedstocks.", + ) + +class BiofuelGeneration(EnumDefinitionImpl): + """ + Classification of biofuels by feedstock source and technology generation. + """ + FIRST_GENERATION = PermissibleValue( + text="FIRST_GENERATION", + title="First Generation Biofuel", + description="""Biofuels produced from food crops (sugar, starch, vegetable oils) using conventional conversion technologies.""") + SECOND_GENERATION = PermissibleValue( + text="SECOND_GENERATION", + title="Second Generation Biofuel", + description="""Biofuels produced from lignocellulosic biomass (non-food) using advanced conversion technologies.""") + THIRD_GENERATION = PermissibleValue( + text="THIRD_GENERATION", + title="Third Generation Biofuel", + description="Biofuels produced from algae or other photosynthetic microorganisms.") + FOURTH_GENERATION = PermissibleValue( + text="FOURTH_GENERATION", + title="Fourth Generation Biofuel", + description="""Biofuels from genetically engineered organisms designed for carbon capture and enhanced fuel production.""") + + _defn = EnumDefinition( + name="BiofuelGeneration", + description="Classification of biofuels by feedstock source and technology generation.", + ) + +class BioconversionProcess(EnumDefinitionImpl): + """ + Processes for converting biomass feedstocks into biofuels and bioproducts. + """ + FERMENTATION = PermissibleValue( + text="FERMENTATION", + title="Fermentation", + description="Biological conversion of sugars to alcohols using yeast or bacteria.") + ANAEROBIC_DIGESTION = PermissibleValue( + text="ANAEROBIC_DIGESTION", + title="Anaerobic Digestion", + description="""Biological breakdown of organic matter by microorganisms in the absence of oxygen, producing biogas.""") + TRANSESTERIFICATION = PermissibleValue( + text="TRANSESTERIFICATION", + title="Transesterification", + description="""Chemical reaction of triglycerides with alcohol to produce fatty acid esters (biodiesel) and glycerol.""") + HYDROTREATING = PermissibleValue( + text="HYDROTREATING", + title="Hydrotreating/Hydroprocessing", + description="Catalytic reaction of lipids with hydrogen to produce hydrocarbon fuels.") + PYROLYSIS = PermissibleValue( + text="PYROLYSIS", + title="Pyrolysis", + description="""Thermal decomposition of biomass in the absence of oxygen to produce bio-oil, syngas, and biochar.""") + GASIFICATION = PermissibleValue( + text="GASIFICATION", + title="Gasification", + description="""High-temperature conversion of carbonaceous materials to syngas using controlled oxygen and/or steam.""", + meaning=CHMO["0001501"]) + HYDROTHERMAL_LIQUEFACTION = PermissibleValue( + text="HYDROTHERMAL_LIQUEFACTION", + title="Hydrothermal Liquefaction (HTL)", + description="Conversion of wet biomass to bio-crude using high temperature and pressure water.") + ENZYMATIC_HYDROLYSIS = PermissibleValue( + text="ENZYMATIC_HYDROLYSIS", + title="Enzymatic Hydrolysis", + description="Breakdown of cellulose and hemicellulose to fermentable sugars using enzymes.") + ACID_HYDROLYSIS = PermissibleValue( + text="ACID_HYDROLYSIS", + title="Acid Hydrolysis", + description="Chemical breakdown of cellulose to sugars using dilute or concentrated acid.") + FISCHER_TROPSCH = PermissibleValue( + text="FISCHER_TROPSCH", + title="Fischer-Tropsch Synthesis", + description="Catalytic conversion of syngas to liquid hydrocarbons.") + ALCOHOL_TO_JET = PermissibleValue( + text="ALCOHOL_TO_JET", + title="Alcohol-to-Jet (ATJ)", + description="""Conversion of alcohols (ethanol, isobutanol) to jet fuel through dehydration, oligomerization, and hydrogenation.""") + + _defn = EnumDefinition( + name="BioconversionProcess", + description="Processes for converting biomass feedstocks into biofuels and bioproducts.", + ) + class MiningType(EnumDefinitionImpl): """ Types of mining operations @@ -11944,6 +12619,88 @@ class CellPolarity(EnumDefinitionImpl): description="Spatial polarity in cells and tissues", ) +class AnatomicalOrientation(EnumDefinitionImpl): + """ + Directional orientation between anatomical positions based on OME NGFF specification + """ + LEFT_TO_RIGHT = PermissibleValue( + text="LEFT_TO_RIGHT", + title="Left to right orientation", + description="Directional orientation from left to right lateral side of an anatomical structure") + RIGHT_TO_LEFT = PermissibleValue( + text="RIGHT_TO_LEFT", + title="Right to left orientation", + description="Directional orientation from right to left lateral side of an anatomical structure") + ANTERIOR_TO_POSTERIOR = PermissibleValue( + text="ANTERIOR_TO_POSTERIOR", + title="Anterior to posterior orientation", + description="Directional orientation from front to back of an anatomical structure") + POSTERIOR_TO_ANTERIOR = PermissibleValue( + text="POSTERIOR_TO_ANTERIOR", + title="Posterior to anterior orientation", + description="Directional orientation from back to front of an anatomical structure") + INFERIOR_TO_SUPERIOR = PermissibleValue( + text="INFERIOR_TO_SUPERIOR", + title="Inferior to superior orientation", + description="Directional orientation from below to above in an anatomical structure") + SUPERIOR_TO_INFERIOR = PermissibleValue( + text="SUPERIOR_TO_INFERIOR", + title="Superior to inferior orientation", + description="Directional orientation from above to below in an anatomical structure") + DORSAL_TO_VENTRAL = PermissibleValue( + text="DORSAL_TO_VENTRAL", + title="Dorsal to ventral orientation", + description="Directional orientation from top/upper to belly/lower in an anatomical structure") + VENTRAL_TO_DORSAL = PermissibleValue( + text="VENTRAL_TO_DORSAL", + title="Ventral to dorsal orientation", + description="Directional orientation from belly/lower to top/upper in an anatomical structure") + DORSAL_TO_PALMAR = PermissibleValue( + text="DORSAL_TO_PALMAR", + title="Dorsal to palmar orientation", + description="Directional orientation from top/upper to palm of hand") + PALMAR_TO_DORSAL = PermissibleValue( + text="PALMAR_TO_DORSAL", + title="Palmar to dorsal orientation", + description="Directional orientation from palm of hand to top/upper") + DORSAL_TO_PLANTAR = PermissibleValue( + text="DORSAL_TO_PLANTAR", + title="Dorsal to plantar orientation", + description="Directional orientation from top/upper to sole of foot") + PLANTAR_TO_DORSAL = PermissibleValue( + text="PLANTAR_TO_DORSAL", + title="Plantar to dorsal orientation", + description="Directional orientation from sole of foot to top/upper") + ROSTRAL_TO_CAUDAL = PermissibleValue( + text="ROSTRAL_TO_CAUDAL", + title="Rostral to caudal orientation", + description="Directional orientation from nasal to tail end, typically for central nervous system") + CAUDAL_TO_ROSTRAL = PermissibleValue( + text="CAUDAL_TO_ROSTRAL", + title="Caudal to rostral orientation", + description="Directional orientation from tail to nasal end, typically for central nervous system") + CRANIAL_TO_CAUDAL = PermissibleValue( + text="CRANIAL_TO_CAUDAL", + title="Cranial to caudal orientation", + description="Directional orientation from head to tail end of a structure") + CAUDAL_TO_CRANIAL = PermissibleValue( + text="CAUDAL_TO_CRANIAL", + title="Caudal to cranial orientation", + description="Directional orientation from tail to head end of a structure") + PROXIMAL_TO_DISTAL = PermissibleValue( + text="PROXIMAL_TO_DISTAL", + title="Proximal to distal orientation", + description="Directional orientation from body center to periphery of a structure") + DISTAL_TO_PROXIMAL = PermissibleValue( + text="DISTAL_TO_PROXIMAL", + title="Distal to proximal orientation", + description="Directional orientation from periphery to body center of a structure") + + _defn = EnumDefinition( + name="AnatomicalOrientation", + description="Directional orientation between anatomical positions based on OME NGFF specification", + ) + class CrystalSystemEnum(EnumDefinitionImpl): """ The seven crystal systems in crystallography @@ -26627,6 +27384,9 @@ class slots: slots.electricity_market = Slot(uri=VALUESETS.electricity_market, name="electricity_market", curie=VALUESETS.curie('electricity_market'), model_uri=VALUESETS.electricity_market, domain=None, range=Optional[Union[str, "ElectricityMarket"]]) +slots.capability_status = Slot(uri=VALUESETS.capability_status, name="capability_status", curie=VALUESETS.curie('capability_status'), + model_uri=VALUESETS.capability_status, domain=None, range=Optional[Union[str, "CapabilityStatus"]]) + slots.fossil_fuel_type = Slot(uri=VALUESETS.fossil_fuel_type, name="fossil_fuel_type", curie=VALUESETS.curie('fossil_fuel_type'), model_uri=VALUESETS.fossil_fuel_type, domain=None, range=Optional[Union[str, "FossilFuelTypeEnum"]]) @@ -26744,6 +27504,45 @@ class slots: slots.operational_procedure = Slot(uri=VALUESETS.operational_procedure, name="operational_procedure", curie=VALUESETS.curie('operational_procedure'), model_uri=VALUESETS.operational_procedure, domain=None, range=Optional[Union[str, "OperationalProcedureEnum"]]) +slots.geothermal_system_type = Slot(uri=VALUESETS.geothermal_system_type, name="geothermal_system_type", curie=VALUESETS.curie('geothermal_system_type'), + model_uri=VALUESETS.geothermal_system_type, domain=None, range=Optional[Union[str, "GeothermalSystemType"]]) + +slots.geothermal_reservoir_type = Slot(uri=VALUESETS.geothermal_reservoir_type, name="geothermal_reservoir_type", curie=VALUESETS.curie('geothermal_reservoir_type'), + model_uri=VALUESETS.geothermal_reservoir_type, domain=None, range=Optional[Union[str, "GeothermalReservoirType"]]) + +slots.geothermal_well_type = Slot(uri=VALUESETS.geothermal_well_type, name="geothermal_well_type", curie=VALUESETS.curie('geothermal_well_type'), + model_uri=VALUESETS.geothermal_well_type, domain=None, range=Optional[Union[str, "GeothermalWellType"]]) + +slots.geothermal_application = Slot(uri=VALUESETS.geothermal_application, name="geothermal_application", curie=VALUESETS.curie('geothermal_application'), + model_uri=VALUESETS.geothermal_application, domain=None, range=Optional[Union[str, "GeothermalApplication"]]) + +slots.geothermal_resource_temperature = Slot(uri=VALUESETS.geothermal_resource_temperature, name="geothermal_resource_temperature", curie=VALUESETS.curie('geothermal_resource_temperature'), + model_uri=VALUESETS.geothermal_resource_temperature, domain=None, range=Optional[Union[str, "GeothermalResourceTemperature"]]) + +slots.hydrogen_type = Slot(uri=VALUESETS.hydrogen_type, name="hydrogen_type", curie=VALUESETS.curie('hydrogen_type'), + model_uri=VALUESETS.hydrogen_type, domain=None, range=Optional[Union[str, "HydrogenType"]]) + +slots.hydrogen_production_method = Slot(uri=VALUESETS.hydrogen_production_method, name="hydrogen_production_method", curie=VALUESETS.curie('hydrogen_production_method'), + model_uri=VALUESETS.hydrogen_production_method, domain=None, range=Optional[Union[str, "HydrogenProductionMethod"]]) + +slots.hydrogen_storage_method = Slot(uri=VALUESETS.hydrogen_storage_method, name="hydrogen_storage_method", curie=VALUESETS.curie('hydrogen_storage_method'), + model_uri=VALUESETS.hydrogen_storage_method, domain=None, range=Optional[Union[str, "HydrogenStorageMethod"]]) + +slots.hydrogen_application = Slot(uri=VALUESETS.hydrogen_application, name="hydrogen_application", curie=VALUESETS.curie('hydrogen_application'), + model_uri=VALUESETS.hydrogen_application, domain=None, range=Optional[Union[str, "HydrogenApplication"]]) + +slots.biomass_feedstock_type = Slot(uri=VALUESETS.biomass_feedstock_type, name="biomass_feedstock_type", curie=VALUESETS.curie('biomass_feedstock_type'), + model_uri=VALUESETS.biomass_feedstock_type, domain=None, range=Optional[Union[str, "BiomassFeedstockType"]]) + +slots.biofuel_type = Slot(uri=VALUESETS.biofuel_type, name="biofuel_type", curie=VALUESETS.curie('biofuel_type'), + model_uri=VALUESETS.biofuel_type, domain=None, range=Optional[Union[str, "BiofuelType"]]) + +slots.biofuel_generation = Slot(uri=VALUESETS.biofuel_generation, name="biofuel_generation", curie=VALUESETS.curie('biofuel_generation'), + model_uri=VALUESETS.biofuel_generation, domain=None, range=Optional[Union[str, "BiofuelGeneration"]]) + +slots.bioconversion_process = Slot(uri=VALUESETS.bioconversion_process, name="bioconversion_process", curie=VALUESETS.curie('bioconversion_process'), + model_uri=VALUESETS.bioconversion_process, domain=None, range=Optional[Union[str, "BioconversionProcess"]]) + slots.mining = Slot(uri=VALUESETS.mining, name="mining", curie=VALUESETS.curie('mining'), model_uri=VALUESETS.mining, domain=None, range=Optional[Union[str, "MiningType"]]) @@ -26951,6 +27750,9 @@ class slots: slots.cell_polarity = Slot(uri=VALUESETS.cell_polarity, name="cell_polarity", curie=VALUESETS.curie('cell_polarity'), model_uri=VALUESETS.cell_polarity, domain=None, range=Optional[Union[str, "CellPolarity"]]) +slots.anatomical_orientation = Slot(uri=VALUESETS.anatomical_orientation, name="anatomical_orientation", curie=VALUESETS.curie('anatomical_orientation'), + model_uri=VALUESETS.anatomical_orientation, domain=None, range=Optional[Union[str, "AnatomicalOrientation"]]) + slots.crystal_system = Slot(uri=VALUESETS.crystal_system, name="crystal_system", curie=VALUESETS.curie('crystal_system'), model_uri=VALUESETS.crystal_system, domain=None, range=Optional[Union[str, "CrystalSystemEnum"]]) diff --git a/src/valuesets/datamodel/valuesets_pydantic.py b/src/valuesets/datamodel/valuesets_pydantic.py index 4798862f..da072a96 100644 --- a/src/valuesets/datamodel/valuesets_pydantic.py +++ b/src/valuesets/datamodel/valuesets_pydantic.py @@ -1151,14 +1151,14 @@ class SampleType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member SampleType._metadata = { - "PROTEIN": {'description': 'Purified protein sample'}, - "NUCLEIC_ACID": {'description': 'Nucleic acid sample (DNA or RNA)'}, - "PROTEIN_COMPLEX": {'description': 'Protein-protein or protein-nucleic acid complex'}, - "MEMBRANE_PROTEIN": {'description': 'Membrane-associated protein sample'}, - "VIRUS": {'description': 'Viral particle or capsid'}, - "ORGANELLE": {'description': 'Cellular organelle (mitochondria, chloroplast, etc.)'}, - "CELL": {'description': 'Whole cell sample'}, - "TISSUE": {'description': 'Tissue sample'}, + "PROTEIN": {'description': 'Purified protein sample', 'meaning': 'NCIT:C17021'}, + "NUCLEIC_ACID": {'description': 'Nucleic acid sample (DNA or RNA)', 'meaning': 'NCIT:C813'}, + "PROTEIN_COMPLEX": {'description': 'Protein-protein or protein-nucleic acid complex', 'meaning': 'GO:0032991'}, + "MEMBRANE_PROTEIN": {'description': 'Membrane-associated protein sample', 'meaning': 'NCIT:C16837'}, + "VIRUS": {'description': 'Viral particle or capsid', 'meaning': 'NCIT:C14283'}, + "ORGANELLE": {'description': 'Cellular organelle (mitochondria, chloroplast, etc.)', 'meaning': 'GO:0043226'}, + "CELL": {'description': 'Whole cell sample', 'meaning': 'NCIT:C12508'}, + "TISSUE": {'description': 'Tissue sample', 'meaning': 'NCIT:C12801'}, } class StructuralBiologyTechnique(RichEnum): @@ -1180,15 +1180,15 @@ class StructuralBiologyTechnique(RichEnum): # Set metadata after class creation to avoid it becoming an enum member StructuralBiologyTechnique._metadata = { "CRYO_EM": {'description': 'Cryo-electron microscopy', 'meaning': 'CHMO:0002413', 'annotations': {'resolution_range': '2-30 Å typical', 'aliases': 'cryoEM, electron cryo-microscopy'}}, - "CRYO_ET": {'description': 'Cryo-electron tomography', 'annotations': {'resolution_range': '20-100 Å typical', 'aliases': 'cryoET, electron cryo-tomography'}}, + "CRYO_ET": {'description': 'Cryo-electron tomography', 'meaning': 'MI:2338', 'annotations': {'resolution_range': '20-100 Å typical', 'aliases': 'cryoET, electron cryo-tomography'}}, "X_RAY_CRYSTALLOGRAPHY": {'description': 'X-ray crystallography', 'meaning': 'CHMO:0000159', 'annotations': {'resolution_range': '1-4 Å typical', 'aliases': 'XRC, macromolecular crystallography'}}, - "NEUTRON_CRYSTALLOGRAPHY": {'description': 'Neutron crystallography', 'annotations': {'advantages': 'hydrogen positions, deuteration studies'}}, + "NEUTRON_CRYSTALLOGRAPHY": {'description': 'Neutron crystallography', 'meaning': 'CHMO:0000175', 'annotations': {'advantages': 'hydrogen positions, deuteration studies'}}, "SAXS": {'description': 'Small-angle X-ray scattering', 'meaning': 'CHMO:0000204', 'annotations': {'information': 'low-resolution structure, conformational changes'}}, - "SANS": {'description': 'Small-angle neutron scattering', 'annotations': {'advantages': 'contrast variation with deuteration'}}, - "WAXS": {'description': 'Wide-angle X-ray scattering'}, + "SANS": {'description': 'Small-angle neutron scattering', 'meaning': 'CHMO:0000184', 'annotations': {'advantages': 'contrast variation with deuteration'}}, + "WAXS": {'description': 'Wide-angle X-ray scattering', 'meaning': 'CHMO:0000213'}, "NMR": {'description': 'Nuclear magnetic resonance spectroscopy', 'meaning': 'CHMO:0000591', 'annotations': {'information': 'solution structure, dynamics'}}, "MASS_SPECTROMETRY": {'description': 'Mass spectrometry', 'meaning': 'CHMO:0000470', 'annotations': {'applications': 'native MS, crosslinking, HDX'}}, - "NEGATIVE_STAIN_EM": {'description': 'Negative stain electron microscopy', 'annotations': {'resolution_range': '15-30 Å typical'}}, + "NEGATIVE_STAIN_EM": {'description': 'Negative stain electron microscopy', 'meaning': 'FBbi:00000568', 'annotations': {'resolution_range': '15-30 Å typical'}}, } class CryoEMPreparationType(RichEnum): @@ -1283,8 +1283,8 @@ class XRaySource(RichEnum): # Set metadata after class creation to avoid it becoming an enum member XRaySource._metadata = { - "SYNCHROTRON": {'description': 'Synchrotron radiation source', 'annotations': {'advantages': 'high intensity, tunable wavelength', 'brightness': '10^15-10^18 photons/s/mm²/mrad²'}}, - "ROTATING_ANODE": {'description': 'Rotating anode generator', 'annotations': {'power': '3-18 kW typical', 'target': 'copper, molybdenum common'}}, + "SYNCHROTRON": {'description': 'Synchrotron radiation source', 'meaning': 'CHMO:0001810', 'annotations': {'advantages': 'high intensity, tunable wavelength', 'brightness': '10^15-10^18 photons/s/mm²/mrad²'}}, + "ROTATING_ANODE": {'description': 'Rotating anode generator', 'meaning': 'CHMO:0001107', 'annotations': {'power': '3-18 kW typical', 'target': 'copper, molybdenum common'}}, "MICROFOCUS": {'description': 'Microfocus sealed tube', 'annotations': {'spot_size': '10-50 μm', 'applications': 'small crystals, in-house screening'}}, "METAL_JET": {'description': 'Liquid metal jet source', 'annotations': {'advantages': 'higher power density, longer lifetime', 'metals': 'gallium, indium'}}, } @@ -1302,11 +1302,11 @@ class Detector(RichEnum): # Set metadata after class creation to avoid it becoming an enum member Detector._metadata = { - "DIRECT_ELECTRON": {'description': 'Direct electron detector (DED)', 'annotations': {'examples': 'K2, K3, Falcon, DE-series', 'advantages': 'high DQE, fast readout'}}, - "CCD": {'description': 'Charge-coupled device camera', 'annotations': {'applications': 'legacy EM, some crystallography'}}, - "CMOS": {'description': 'Complementary metal-oxide semiconductor detector', 'annotations': {'advantages': 'fast readout, low noise'}}, + "DIRECT_ELECTRON": {'description': 'Direct electron detector (DED)', 'meaning': 'CHMO:0002837', 'annotations': {'examples': 'K2, K3, Falcon, DE-series', 'advantages': 'high DQE, fast readout'}}, + "CCD": {'description': 'Charge-coupled device camera', 'meaning': 'CHMO:0002171', 'annotations': {'applications': 'legacy EM, some crystallography'}}, + "CMOS": {'description': 'Complementary metal-oxide semiconductor detector', 'meaning': 'CHMO:0002836', 'annotations': {'advantages': 'fast readout, low noise'}}, "HYBRID_PIXEL": {'description': 'Hybrid pixel detector', 'annotations': {'examples': 'Pilatus, Eiger', 'advantages': 'photon counting, zero noise'}}, - "PHOTOSTIMULABLE_PHOSPHOR": {'description': 'Photostimulable phosphor (image plate)', 'annotations': {'applications': 'legacy crystallography'}}, + "PHOTOSTIMULABLE_PHOSPHOR": {'description': 'Photostimulable phosphor (image plate)', 'meaning': 'CHMO:0001069', 'annotations': {'applications': 'legacy crystallography'}}, } class WorkflowType(RichEnum): @@ -1361,14 +1361,14 @@ class FileFormat(RichEnum): # Set metadata after class creation to avoid it becoming an enum member FileFormat._metadata = { - "MRC": {'description': 'MRC format for EM density maps', 'annotations': {'extension': '.mrc, .map', 'applications': 'EM volumes, tomograms'}}, - "TIFF": {'description': 'Tagged Image File Format', 'annotations': {'extension': '.tif, .tiff', 'applications': 'micrographs, general imaging'}}, - "HDF5": {'description': 'Hierarchical Data Format 5', 'annotations': {'extension': '.h5, .hdf5', 'applications': 'large datasets, metadata storage'}}, - "STAR": {'description': 'Self-defining Text Archival and Retrieval format', 'annotations': {'extension': '.star', 'applications': 'RELION metadata, particle parameters'}}, - "PDB": {'description': 'Protein Data Bank coordinate format', 'annotations': {'extension': '.pdb', 'applications': 'atomic coordinates, legacy format'}}, - "MMCIF": {'description': 'Macromolecular Crystallographic Information File', 'annotations': {'extension': '.cif', 'applications': 'atomic coordinates, modern PDB format'}}, - "MTZ": {'description': 'MTZ reflection data format', 'annotations': {'extension': '.mtz', 'applications': 'crystallographic reflections, phases'}}, - "CBF": {'description': 'Crystallographic Binary Format', 'annotations': {'extension': '.cbf', 'applications': 'detector images, diffraction data'}}, + "MRC": {'description': 'MRC format for EM density maps', 'meaning': 'EDAM:3842', 'annotations': {'extension': '.mrc, .map', 'applications': 'EM volumes, tomograms'}}, + "TIFF": {'description': 'Tagged Image File Format', 'meaning': 'EDAM:3591', 'annotations': {'extension': '.tif, .tiff', 'applications': 'micrographs, general imaging'}}, + "HDF5": {'description': 'Hierarchical Data Format 5', 'meaning': 'EDAM:3590', 'annotations': {'extension': '.h5, .hdf5', 'applications': 'large datasets, metadata storage'}}, + "STAR": {'description': 'Self-defining Text Archival and Retrieval format', 'meaning': 'EDAM:3906', 'annotations': {'extension': '.star', 'applications': 'RELION metadata, particle parameters'}}, + "PDB": {'description': 'Protein Data Bank coordinate format', 'meaning': 'EDAM:1476', 'annotations': {'extension': '.pdb', 'applications': 'atomic coordinates, legacy format'}}, + "MMCIF": {'description': 'Macromolecular Crystallographic Information File', 'meaning': 'EDAM:1477', 'annotations': {'extension': '.cif', 'applications': 'atomic coordinates, modern PDB format'}}, + "MTZ": {'description': 'MTZ reflection data format', 'meaning': 'EDAM:3816', 'annotations': {'extension': '.mtz', 'applications': 'crystallographic reflections, phases'}}, + "CBF": {'description': 'Crystallographic Binary Format', 'meaning': 'EDAM:3874', 'annotations': {'extension': '.cbf', 'applications': 'detector images, diffraction data'}}, "DM3": {'description': 'Digital Micrograph format', 'annotations': {'extension': '.dm3, .dm4', 'applications': 'FEI/Thermo Fisher EM data'}}, "SER": {'description': 'FEI series format', 'annotations': {'extension': '.ser', 'applications': 'FEI movie stacks'}}, } @@ -1458,11 +1458,11 @@ class CoordinationGeometry(RichEnum): "TRIGONAL_PYRAMIDAL": {'description': 'Trigonal pyramidal coordination geometry', 'annotations': {'coordination_number': '3'}}, "T_SHAPED": {'description': 'T-shaped coordination geometry', 'annotations': {'coordination_number': '3'}}, "TETRAHEDRAL": {'description': 'Tetrahedral coordination geometry (4 ligands, 109.5° angles)', 'meaning': 'NCIT:C103215', 'annotations': {'coordination_number': '4'}}, - "SQUARE_PLANAR": {'description': 'Square planar coordination geometry (4 ligands in plane)', 'annotations': {'coordination_number': '4', 'ncit_variants': 'NCIT:C103211, NCIT:C103212, NCIT:C103213, NCIT:C103214'}}, + "SQUARE_PLANAR": {'description': 'Square planar coordination geometry (4 ligands in plane)', 'meaning': 'NCIT:C103211', 'annotations': {'coordination_number': '4'}}, "TRIGONAL_BIPYRAMIDAL": {'description': 'Trigonal bipyramidal coordination geometry (5 ligands)', 'annotations': {'coordination_number': '5'}}, "SQUARE_PYRAMIDAL": {'description': 'Square pyramidal coordination geometry (5 ligands)', 'annotations': {'coordination_number': '5'}}, "PENTAGONAL_PLANAR": {'description': 'Pentagonal planar coordination geometry (5 ligands in plane)', 'annotations': {'coordination_number': '5'}}, - "OCTAHEDRAL": {'description': 'Octahedral coordination geometry (6 ligands)', 'annotations': {'coordination_number': '6', 'ncit_variants': 'NCIT:C103216, NCIT:C103217, NCIT:C103218'}}, + "OCTAHEDRAL": {'description': 'Octahedral coordination geometry (6 ligands)', 'meaning': 'NCIT:C103216', 'annotations': {'coordination_number': '6'}}, "TRIGONAL_PRISMATIC": {'description': 'Trigonal prismatic coordination geometry (6 ligands)', 'annotations': {'coordination_number': '6'}}, "PENTAGONAL_BIPYRAMIDAL": {'description': 'Pentagonal bipyramidal coordination geometry (7 ligands)', 'annotations': {'coordination_number': '7'}}, "HEXAGONAL_BIPYRAMIDAL": {'description': 'Hexagonal bipyramidal coordination geometry (8 ligands)', 'annotations': {'coordination_number': '8'}}, @@ -1506,17 +1506,17 @@ class ProteinModificationType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member ProteinModificationType._metadata = { - "METAL_COORDINATION": {'description': 'Metal coordination modification', 'annotations': {'examples': 'zinc finger, iron-sulfur cluster binding'}}, - "PHOSPHORYLATION": {'description': 'Phosphorylation modification'}, - "GLYCOSYLATION": {'description': 'Glycosylation modification'}, - "ACETYLATION": {'description': 'Acetylation modification'}, - "METHYLATION": {'description': 'Methylation modification'}, - "UBIQUITINATION": {'description': 'Ubiquitination modification'}, - "SUMOYLATION": {'description': 'SUMOylation modification'}, - "HYDROXYLATION": {'description': 'Hydroxylation modification'}, - "LIPIDATION": {'description': 'Lipidation modification'}, - "PROTEOLYTIC_CLEAVAGE": {'description': 'Proteolytic cleavage'}, - "CROSSLINKING": {'description': 'Crosslinking modification'}, + "METAL_COORDINATION": {'description': 'Metal coordination modification', 'meaning': 'MOD:00739', 'annotations': {'examples': 'zinc finger, iron-sulfur cluster binding'}}, + "PHOSPHORYLATION": {'description': 'Phosphorylation modification', 'meaning': 'MOD:00696'}, + "GLYCOSYLATION": {'description': 'Glycosylation modification', 'meaning': 'MOD:00725'}, + "ACETYLATION": {'description': 'Acetylation modification', 'meaning': 'MOD:00394'}, + "METHYLATION": {'description': 'Methylation modification', 'meaning': 'MOD:00599'}, + "UBIQUITINATION": {'description': 'Ubiquitination modification', 'meaning': 'MOD:01240'}, + "SUMOYLATION": {'description': 'SUMOylation modification', 'meaning': 'MOD:01149'}, + "HYDROXYLATION": {'description': 'Hydroxylation modification', 'meaning': 'MOD:00677'}, + "LIPIDATION": {'description': 'Lipidation modification', 'meaning': 'MOD:00435'}, + "PROTEOLYTIC_CLEAVAGE": {'description': 'Proteolytic cleavage', 'meaning': 'GO:0006508'}, + "CROSSLINKING": {'description': 'Crosslinking modification', 'meaning': 'MOD:00276'}, } class BiosafetyLevelEnum(RichEnum): @@ -3388,24 +3388,24 @@ class EnergySource(RichEnum): # Set metadata after class creation to avoid it becoming an enum member EnergySource._metadata = { - "SOLAR": {'meaning': 'ENVO:01001862', 'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['Solar radiation']}, - "WIND": {'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['wind wave energy']}, - "HYDROELECTRIC": {'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['hydroelectric dam']}, - "GEOTHERMAL": {'meaning': 'ENVO:2000034', 'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['geothermal energy']}, - "BIOMASS": {'annotations': {'renewable': True, 'emission_free': False}, 'aliases': ['organic material']}, - "BIOFUEL": {'annotations': {'renewable': True, 'emission_free': False}}, - "TIDAL": {'annotations': {'renewable': True, 'emission_free': True}}, - "HYDROGEN": {'meaning': 'CHEBI:18276', 'annotations': {'renewable': 'depends', 'emission_free': True}, 'aliases': ['dihydrogen']}, - "COAL": {'meaning': 'ENVO:02000091', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "NATURAL_GAS": {'meaning': 'ENVO:01000552', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "PETROLEUM": {'meaning': 'ENVO:00002984', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "DIESEL": {'meaning': 'ENVO:03510006', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['diesel fuel']}, - "GASOLINE": {'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['fuel oil']}, + "SOLAR": {'meaning': 'ENVO:01001862', 'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'solar energy', 'brick_label': 'Solar Thermal Collector'}, 'aliases': ['Solar radiation']}, + "WIND": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'wind energy'}, 'aliases': ['wind wave energy']}, + "HYDROELECTRIC": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'hydro energy'}, 'aliases': ['hydroelectric dam']}, + "GEOTHERMAL": {'meaning': 'ENVO:2000034', 'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'geothermal energy'}, 'aliases': ['geothermal energy']}, + "BIOMASS": {'annotations': {'renewable': True, 'emission_free': False, 'oeo_label': 'bioenergy'}, 'aliases': ['organic material']}, + "BIOFUEL": {'annotations': {'renewable': True, 'emission_free': False, 'oeo_label': 'biofuel'}}, + "TIDAL": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'marine tidal energy, marine wave energy'}}, + "HYDROGEN": {'meaning': 'CHEBI:18276', 'annotations': {'renewable': 'depends', 'emission_free': True, 'oeo_label': 'hydrogen'}, 'aliases': ['dihydrogen']}, + "COAL": {'meaning': 'ENVO:02000091', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'coal'}}, + "NATURAL_GAS": {'meaning': 'ENVO:01000552', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'natural gas'}}, + "PETROLEUM": {'meaning': 'ENVO:00002984', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'crude oil'}}, + "DIESEL": {'meaning': 'ENVO:03510006', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'diesel fuel'}, 'aliases': ['diesel fuel']}, + "GASOLINE": {'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'gasoline fuel'}, 'aliases': ['fuel oil']}, "PROPANE": {'meaning': 'ENVO:01000553', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['liquefied petroleum gas']}, - "NUCLEAR_FISSION": {'annotations': {'renewable': False, 'emission_free': True}, 'aliases': ['nuclear energy']}, + "NUCLEAR_FISSION": {'annotations': {'renewable': False, 'emission_free': True, 'oeo_label': 'nuclear fuel'}, 'aliases': ['nuclear energy']}, "NUCLEAR_FUSION": {'annotations': {'renewable': False, 'emission_free': True}, 'aliases': ['nuclear energy']}, - "GRID_MIX": {'annotations': {'renewable': 'partial'}}, - "BATTERY_STORAGE": {'description': 'Battery storage systems', 'annotations': {'storage': True}}, + "GRID_MIX": {'annotations': {'renewable': 'partial', 'oeo_label': 'supply grid'}}, + "BATTERY_STORAGE": {'description': 'Battery storage systems', 'annotations': {'storage': True, 'oeo_label': 'battery'}}, } class EnergyUnit(RichEnum): @@ -3558,7 +3558,7 @@ class GridType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member GridType._metadata = { - "MAIN_GRID": {'description': 'Main utility grid'}, + "MAIN_GRID": {'description': 'Main utility grid', 'annotations': {'oeo_label': 'supply grid'}}, "MICROGRID": {'description': 'Microgrid'}, "OFF_GRID": {'description': 'Off-grid/standalone'}, "SMART_GRID": {'description': 'Smart grid'}, @@ -3566,16 +3566,112 @@ class GridType(RichEnum): "VIRTUAL_POWER_PLANT": {'description': 'Virtual power plant'}, } +class BatteryType(RichEnum): + """ + Types of battery technologies for energy storage + """ + # Enum members + LITHIUM_ION = "LITHIUM_ION" + LITHIUM_IRON_PHOSPHATE = "LITHIUM_IRON_PHOSPHATE" + LITHIUM_POLYMER = "LITHIUM_POLYMER" + LEAD_ACID = "LEAD_ACID" + NICKEL_METAL_HYDRIDE = "NICKEL_METAL_HYDRIDE" + NICKEL_CADMIUM = "NICKEL_CADMIUM" + SODIUM_ION = "SODIUM_ION" + SOLID_STATE = "SOLID_STATE" + VANADIUM_REDOX_FLOW = "VANADIUM_REDOX_FLOW" + ZINC_BROMINE_FLOW = "ZINC_BROMINE_FLOW" + IRON_AIR = "IRON_AIR" + ZINC_AIR = "ZINC_AIR" + +# Set metadata after class creation to avoid it becoming an enum member +BatteryType._metadata = { + "LITHIUM_ION": {'description': 'Lithium-ion battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['Li-ion', 'LIB']}, + "LITHIUM_IRON_PHOSPHATE": {'description': 'Lithium iron phosphate (LFP) battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['LFP', 'LiFePO4']}, + "LITHIUM_POLYMER": {'description': 'Lithium polymer battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['LiPo']}, + "LEAD_ACID": {'description': 'Lead-acid battery', 'annotations': {'chemistry': 'lead'}, 'aliases': ['Pb-acid']}, + "NICKEL_METAL_HYDRIDE": {'description': 'Nickel-metal hydride battery', 'annotations': {'chemistry': 'nickel'}, 'aliases': ['NiMH']}, + "NICKEL_CADMIUM": {'description': 'Nickel-cadmium battery', 'annotations': {'chemistry': 'nickel'}, 'aliases': ['NiCd']}, + "SODIUM_ION": {'description': 'Sodium-ion battery', 'annotations': {'chemistry': 'sodium'}, 'aliases': ['Na-ion']}, + "SOLID_STATE": {'description': 'Solid-state battery', 'annotations': {'chemistry': 'various'}}, + "VANADIUM_REDOX_FLOW": {'description': 'Vanadium redox flow battery', 'annotations': {'chemistry': 'vanadium', 'type': 'flow'}, 'aliases': ['VRB', 'VRFB']}, + "ZINC_BROMINE_FLOW": {'description': 'Zinc-bromine flow battery', 'annotations': {'chemistry': 'zinc', 'type': 'flow'}, 'aliases': ['ZnBr']}, + "IRON_AIR": {'description': 'Iron-air battery', 'annotations': {'chemistry': 'iron'}}, + "ZINC_AIR": {'description': 'Zinc-air battery', 'annotations': {'chemistry': 'zinc'}}, +} + +class PVCellType(RichEnum): + """ + Types of photovoltaic cell technologies + """ + # Enum members + MONOCRYSTALLINE_SILICON = "MONOCRYSTALLINE_SILICON" + POLYCRYSTALLINE_SILICON = "POLYCRYSTALLINE_SILICON" + PASSIVATED_EMITTER_REAR_CELL = "PASSIVATED_EMITTER_REAR_CELL" + HETEROJUNCTION = "HETEROJUNCTION" + TUNNEL_OXIDE_PASSIVATED_CONTACT = "TUNNEL_OXIDE_PASSIVATED_CONTACT" + INTERDIGITATED_BACK_CONTACT = "INTERDIGITATED_BACK_CONTACT" + CADMIUM_TELLURIDE = "CADMIUM_TELLURIDE" + COPPER_INDIUM_GALLIUM_SELENIDE = "COPPER_INDIUM_GALLIUM_SELENIDE" + AMORPHOUS_SILICON = "AMORPHOUS_SILICON" + GALLIUM_ARSENIDE = "GALLIUM_ARSENIDE" + PEROVSKITE = "PEROVSKITE" + ORGANIC = "ORGANIC" + TANDEM = "TANDEM" + +# Set metadata after class creation to avoid it becoming an enum member +PVCellType._metadata = { + "MONOCRYSTALLINE_SILICON": {'description': 'Monocrystalline silicon (mono-Si) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '17-22%'}, 'aliases': ['mono-Si', 'single-crystal silicon']}, + "POLYCRYSTALLINE_SILICON": {'description': 'Polycrystalline silicon (poly-Si) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '15-17%'}, 'aliases': ['poly-Si', 'multi-crystalline silicon']}, + "PASSIVATED_EMITTER_REAR_CELL": {'description': 'Passivated Emitter and Rear Cell (PERC)', 'annotations': {'material': 'silicon', 'efficiency_range': '19-22%'}, 'aliases': ['PERC']}, + "HETEROJUNCTION": {'description': 'Heterojunction (HJT) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '21-24%'}, 'aliases': ['HJT', 'HIT']}, + "TUNNEL_OXIDE_PASSIVATED_CONTACT": {'description': 'Tunnel Oxide Passivated Contact (TOPCon) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '22-24%'}, 'aliases': ['TOPCon']}, + "INTERDIGITATED_BACK_CONTACT": {'description': 'Interdigitated Back Contact (IBC) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '22-24%'}, 'aliases': ['IBC']}, + "CADMIUM_TELLURIDE": {'description': 'Cadmium telluride (CdTe) thin-film cells', 'annotations': {'material': 'cadmium_telluride', 'type': 'thin-film', 'efficiency_range': '16-18%'}, 'aliases': ['CdTe']}, + "COPPER_INDIUM_GALLIUM_SELENIDE": {'description': 'Copper indium gallium selenide (CIGS) thin-film cells', 'annotations': {'material': 'CIGS', 'type': 'thin-film', 'efficiency_range': '15-20%'}, 'aliases': ['CIGS', 'CIS']}, + "AMORPHOUS_SILICON": {'description': 'Amorphous silicon (a-Si) thin-film cells', 'annotations': {'material': 'silicon', 'type': 'thin-film', 'efficiency_range': '6-8%'}, 'aliases': ['a-Si']}, + "GALLIUM_ARSENIDE": {'description': 'Gallium arsenide (GaAs) cells', 'annotations': {'material': 'gallium_arsenide', 'efficiency_range': '25-30%', 'application': 'space, concentrator'}, 'aliases': ['GaAs']}, + "PEROVSKITE": {'description': 'Perovskite solar cells', 'annotations': {'material': 'perovskite', 'efficiency_range': '20-25%', 'status': 'emerging'}}, + "ORGANIC": {'description': 'Organic photovoltaic (OPV) cells', 'annotations': {'material': 'organic', 'type': 'thin-film', 'efficiency_range': '10-15%', 'status': 'emerging'}, 'aliases': ['OPV']}, + "TANDEM": {'description': 'Tandem/multi-junction cells', 'annotations': {'efficiency_range': '25-35%'}, 'aliases': ['multi-junction']}, +} + +class PVSystemType(RichEnum): + """ + Types of photovoltaic system installations + """ + # Enum members + ROOFTOP_RESIDENTIAL = "ROOFTOP_RESIDENTIAL" + ROOFTOP_COMMERCIAL = "ROOFTOP_COMMERCIAL" + GROUND_MOUNTED = "GROUND_MOUNTED" + FLOATING = "FLOATING" + BUILDING_INTEGRATED = "BUILDING_INTEGRATED" + AGRIVOLTAICS = "AGRIVOLTAICS" + CARPORT = "CARPORT" + TRACKER_SINGLE_AXIS = "TRACKER_SINGLE_AXIS" + TRACKER_DUAL_AXIS = "TRACKER_DUAL_AXIS" + CONCENTRATING = "CONCENTRATING" + +# Set metadata after class creation to avoid it becoming an enum member +PVSystemType._metadata = { + "ROOFTOP_RESIDENTIAL": {'description': 'Residential rooftop PV system', 'annotations': {'scale': 'residential', 'mounting': 'rooftop'}}, + "ROOFTOP_COMMERCIAL": {'description': 'Commercial/industrial rooftop PV system', 'annotations': {'scale': 'commercial', 'mounting': 'rooftop'}}, + "GROUND_MOUNTED": {'description': 'Ground-mounted utility-scale PV system', 'annotations': {'scale': 'utility', 'mounting': 'ground'}}, + "FLOATING": {'description': 'Floating PV system (floatovoltaics)', 'annotations': {'scale': 'utility', 'mounting': 'floating'}, 'aliases': ['floatovoltaics', 'FPV']}, + "BUILDING_INTEGRATED": {'description': 'Building-integrated PV (BIPV)', 'annotations': {'mounting': 'integrated'}, 'aliases': ['BIPV']}, + "AGRIVOLTAICS": {'description': 'Agrivoltaic system (dual-use with agriculture)', 'annotations': {'scale': 'utility', 'dual_use': 'agriculture'}, 'aliases': ['agrophotovoltaics', 'APV']}, + "CARPORT": {'description': 'Solar carport/parking canopy', 'annotations': {'mounting': 'canopy', 'dual_use': 'parking'}}, + "TRACKER_SINGLE_AXIS": {'description': 'Single-axis tracking system', 'annotations': {'tracking': 'single_axis'}}, + "TRACKER_DUAL_AXIS": {'description': 'Dual-axis tracking system', 'annotations': {'tracking': 'dual_axis'}}, + "CONCENTRATING": {'description': 'Concentrating PV (CPV) system', 'annotations': {'type': 'concentrating'}, 'aliases': ['CPV']}, +} + class EnergyStorageType(RichEnum): """ - Types of energy storage systems + Types of energy storage systems (categories) """ # Enum members - LITHIUM_ION_BATTERY = "LITHIUM_ION_BATTERY" - LEAD_ACID_BATTERY = "LEAD_ACID_BATTERY" - FLOW_BATTERY = "FLOW_BATTERY" - SOLID_STATE_BATTERY = "SOLID_STATE_BATTERY" - SODIUM_ION_BATTERY = "SODIUM_ION_BATTERY" + BATTERY = "BATTERY" PUMPED_HYDRO = "PUMPED_HYDRO" COMPRESSED_AIR = "COMPRESSED_AIR" FLYWHEEL = "FLYWHEEL" @@ -3590,20 +3686,16 @@ class EnergyStorageType(RichEnum): # Set metadata after class creation to avoid it becoming an enum member EnergyStorageType._metadata = { - "LITHIUM_ION_BATTERY": {'description': 'Lithium-ion battery', 'annotations': {'category': 'electrochemical'}}, - "LEAD_ACID_BATTERY": {'description': 'Lead-acid battery', 'annotations': {'category': 'electrochemical'}}, - "FLOW_BATTERY": {'description': 'Flow battery (e.g., vanadium redox)', 'annotations': {'category': 'electrochemical'}}, - "SOLID_STATE_BATTERY": {'description': 'Solid-state battery', 'annotations': {'category': 'electrochemical'}}, - "SODIUM_ION_BATTERY": {'description': 'Sodium-ion battery', 'annotations': {'category': 'electrochemical'}}, - "PUMPED_HYDRO": {'description': 'Pumped hydroelectric storage', 'annotations': {'category': 'mechanical'}}, - "COMPRESSED_AIR": {'description': 'Compressed air energy storage (CAES)', 'annotations': {'category': 'mechanical'}}, + "BATTERY": {'description': 'Battery storage (see BatteryType for specific chemistries)', 'annotations': {'category': 'electrochemical'}}, + "PUMPED_HYDRO": {'description': 'Pumped hydroelectric storage', 'annotations': {'category': 'mechanical', 'oeo_label': 'pumped hydro storage power plant'}}, + "COMPRESSED_AIR": {'description': 'Compressed air energy storage (CAES)', 'annotations': {'category': 'mechanical', 'oeo_label': 'compressed air'}}, "FLYWHEEL": {'description': 'Flywheel energy storage', 'annotations': {'category': 'mechanical'}}, "GRAVITY_STORAGE": {'description': 'Gravity-based storage', 'annotations': {'category': 'mechanical'}}, "MOLTEN_SALT": {'description': 'Molten salt thermal storage', 'annotations': {'category': 'thermal'}}, "ICE_STORAGE": {'description': 'Ice thermal storage', 'annotations': {'category': 'thermal'}}, "PHASE_CHANGE": {'description': 'Phase change materials', 'annotations': {'category': 'thermal'}}, - "HYDROGEN_STORAGE": {'description': 'Hydrogen storage', 'annotations': {'category': 'chemical'}}, - "SYNTHETIC_FUEL": {'description': 'Synthetic fuel storage', 'annotations': {'category': 'chemical'}}, + "HYDROGEN_STORAGE": {'description': 'Hydrogen storage', 'annotations': {'category': 'chemical', 'oeo_label': 'hydrogen'}}, + "SYNTHETIC_FUEL": {'description': 'Synthetic fuel storage', 'annotations': {'category': 'chemical', 'oeo_label': 'synthetic fuel'}}, "SUPERCAPACITOR": {'description': 'Supercapacitor', 'annotations': {'category': 'electrical'}}, "SUPERCONDUCTING": {'description': 'Superconducting magnetic energy storage (SMES)', 'annotations': {'category': 'electrical'}}, } @@ -3621,11 +3713,11 @@ class EmissionScope(RichEnum): # Set metadata after class creation to avoid it becoming an enum member EmissionScope._metadata = { - "SCOPE_1": {'description': 'Direct emissions from owned or controlled sources', 'annotations': {'ghg_protocol': 'Scope 1'}}, - "SCOPE_2": {'description': 'Indirect emissions from purchased energy', 'annotations': {'ghg_protocol': 'Scope 2'}}, - "SCOPE_3": {'description': 'All other indirect emissions in value chain', 'annotations': {'ghg_protocol': 'Scope 3'}}, - "SCOPE_3_UPSTREAM": {'description': 'Upstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3'}}, - "SCOPE_3_DOWNSTREAM": {'description': 'Downstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3'}}, + "SCOPE_1": {'description': 'Direct emissions from owned or controlled sources', 'annotations': {'ghg_protocol': 'Scope 1', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_2": {'description': 'Indirect emissions from purchased energy', 'annotations': {'ghg_protocol': 'Scope 2', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3": {'description': 'All other indirect emissions in value chain', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3_UPSTREAM": {'description': 'Upstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3_DOWNSTREAM": {'description': 'Downstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, } class CarbonIntensity(RichEnum): @@ -3680,6 +3772,26 @@ class ElectricityMarket(RichEnum): "POWER_PURCHASE_AGREEMENT": {'description': 'Power purchase agreement (PPA)'}, } +class CapabilityStatus(RichEnum): + """ + Operational status of a capability, facility, or infrastructure. Applicable to energy facilities, research capabilities, and other infrastructure throughout their lifecycle. + """ + # Enum members + OPERATIONAL = "OPERATIONAL" + COMING_ONLINE = "COMING_ONLINE" + PILOT = "PILOT" + UNDER_DEVELOPMENT = "UNDER_DEVELOPMENT" + DECOMMISSIONED = "DECOMMISSIONED" + +# Set metadata after class creation to avoid it becoming an enum member +CapabilityStatus._metadata = { + "OPERATIONAL": {'description': 'Fully operational and available to users', 'annotations': {'wikidata_label': 'in use', 'lifecycle_phase': 'operation'}}, + "COMING_ONLINE": {'description': 'Being commissioned, coming online soon', 'annotations': {'wikidata_label': 'building process', 'lifecycle_phase': 'commissioning', 'iaea_equivalent': 'commissioning'}}, + "PILOT": {'description': 'In pilot phase with limited access', 'annotations': {'availability': 'limited', 'lifecycle_phase': 'testing'}}, + "UNDER_DEVELOPMENT": {'description': 'Under development, not yet available', 'annotations': {'wikidata_label': 'proposed building or structure', 'lifecycle_phase': 'planning/construction'}}, + "DECOMMISSIONED": {'description': 'No longer available, permanently shut down', 'annotations': {'lifecycle_phase': 'end-of-life', 'iaea_equivalent': 'decommissioned'}}, +} + class FossilFuelTypeEnum(RichEnum): """ Types of fossil fuels used for energy generation @@ -4614,6 +4726,364 @@ class OperationalProcedureEnum(RichEnum): "SECURITY_PROCEDURE": {'description': 'Physical security and access control procedures', 'annotations': {'access_control': 'personnel access authorization', 'detection': 'intrusion detection systems', 'response': 'security force response', 'coordination': 'with law enforcement'}}, } +class GeothermalSystemType(RichEnum): + """ + Types of geothermal energy systems, including conventional hydrothermal and enhanced/engineered geothermal systems. + """ + # Enum members + HYDROTHERMAL = "HYDROTHERMAL" + ENHANCED_GEOTHERMAL_SYSTEM = "ENHANCED_GEOTHERMAL_SYSTEM" + ADVANCED_GEOTHERMAL_SYSTEM = "ADVANCED_GEOTHERMAL_SYSTEM" + HOT_DRY_ROCK = "HOT_DRY_ROCK" + GEOPRESSURED = "GEOPRESSURED" + SUPERCRITICAL = "SUPERCRITICAL" + GROUND_SOURCE_HEAT_PUMP = "GROUND_SOURCE_HEAT_PUMP" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalSystemType._metadata = { + "HYDROTHERMAL": {'description': 'Naturally occurring geothermal system with heat, fluid, and permeability sufficient for energy extraction without stimulation.', 'annotations': {'conventional': True}}, + "ENHANCED_GEOTHERMAL_SYSTEM": {'description': 'Engineered reservoirs created to extract heat from low permeability geothermal resources through stimulation methods.', 'annotations': {'requires_stimulation': True}, 'aliases': ['EGS', 'Engineered Geothermal System']}, + "ADVANCED_GEOTHERMAL_SYSTEM": {'description': 'Closed-loop geothermal systems that circulate working fluid through wellbores to extract heat conductively without reservoir stimulation.', 'annotations': {'closed_loop': True}, 'aliases': ['AGS', 'Closed-Loop Geothermal']}, + "HOT_DRY_ROCK": {'description': 'Geothermal system targeting hot basement rock lacking natural fluid or permeability, requiring artificial reservoir creation.', 'aliases': ['HDR']}, + "GEOPRESSURED": {'description': 'Deep sedimentary formations with abnormally high fluid pressure containing hot brine and dissolved methane.', 'annotations': {'methane_recovery': True}}, + "SUPERCRITICAL": {'description': 'Very high temperature systems (>374C) where water exists above its critical point, offering higher energy density.', 'annotations': {'temperature_min_c': 374}}, + "GROUND_SOURCE_HEAT_PUMP": {'description': 'Shallow geothermal system using stable ground temperatures for heating and cooling buildings.', 'annotations': {'direct_use': True}, 'aliases': ['GSHP', 'Geothermal Heat Pump']}, +} + +class GeothermalReservoirType(RichEnum): + """ + Classification of geothermal reservoirs by geological setting and characteristics. + """ + # Enum members + VOLCANIC = "VOLCANIC" + SEDIMENTARY = "SEDIMENTARY" + FRACTURED_BASEMENT = "FRACTURED_BASEMENT" + FAULT_CONTROLLED = "FAULT_CONTROLLED" + MAGMATIC = "MAGMATIC" + CONDUCTION_DOMINATED = "CONDUCTION_DOMINATED" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalReservoirType._metadata = { + "VOLCANIC": {'description': 'Reservoir associated with volcanic activity, typically in active volcanic regions with magma heat sources.'}, + "SEDIMENTARY": {'description': 'Reservoir in sedimentary formations with elevated temperatures due to depth or regional heat flow.'}, + "FRACTURED_BASEMENT": {'description': 'Reservoir in fractured crystalline basement rocks, typically granitic or metamorphic.', 'aliases': ['Hot Fractured Rock']}, + "FAULT_CONTROLLED": {'description': 'Reservoir where fluid flow is controlled by fault systems providing permeability pathways.'}, + "MAGMATIC": {'description': 'Very high temperature reservoir near or in contact with magma bodies or recent intrusions.'}, + "CONDUCTION_DOMINATED": {'description': 'Low permeability reservoir where heat transfer is primarily through conduction rather than convection.'}, +} + +class GeothermalWellType(RichEnum): + """ + Types of wells used in geothermal energy development and production. + """ + # Enum members + PRODUCTION_WELL = "PRODUCTION_WELL" + INJECTION_WELL = "INJECTION_WELL" + EXPLORATION_WELL = "EXPLORATION_WELL" + OBSERVATION_WELL = "OBSERVATION_WELL" + SLIM_HOLE = "SLIM_HOLE" + DIRECTIONAL_WELL = "DIRECTIONAL_WELL" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalWellType._metadata = { + "PRODUCTION_WELL": {'description': 'Well used to extract geothermal fluids or steam from the reservoir.'}, + "INJECTION_WELL": {'description': 'Well used to return cooled geothermal fluids to the reservoir to maintain pressure and sustainability.', 'aliases': ['Reinjection Well']}, + "EXPLORATION_WELL": {'description': 'Well drilled to evaluate geothermal resource characteristics.', 'aliases': ['Wildcat Well']}, + "OBSERVATION_WELL": {'description': 'Well used to monitor reservoir conditions and pressure.', 'aliases': ['Monitoring Well']}, + "SLIM_HOLE": {'description': 'Smaller diameter well used for initial exploration and temperature gradient measurement.'}, + "DIRECTIONAL_WELL": {'description': 'Well drilled at an angle to access reservoir from offset surface location or increase reservoir contact.'}, +} + +class GeothermalApplication(RichEnum): + """ + Applications and uses of geothermal energy. + """ + # Enum members + ELECTRICITY_GENERATION = "ELECTRICITY_GENERATION" + DIRECT_USE_HEATING = "DIRECT_USE_HEATING" + GREENHOUSE_HEATING = "GREENHOUSE_HEATING" + AQUACULTURE = "AQUACULTURE" + INDUSTRIAL_PROCESS_HEAT = "INDUSTRIAL_PROCESS_HEAT" + FOOD_PROCESSING = "FOOD_PROCESSING" + BATHING_RECREATION = "BATHING_RECREATION" + LITHIUM_EXTRACTION = "LITHIUM_EXTRACTION" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalApplication._metadata = { + "ELECTRICITY_GENERATION": {'description': 'Use of geothermal resources for power generation through steam turbines or binary cycle plants.', 'meaning': 'ENVO:2000034'}, + "DIRECT_USE_HEATING": {'description': 'Direct use of geothermal heat for space heating, district heating, or industrial processes.'}, + "GREENHOUSE_HEATING": {'description': 'Use of geothermal heat for agricultural greenhouses.'}, + "AQUACULTURE": {'description': 'Use of geothermal heat for fish farming and aquaculture.'}, + "INDUSTRIAL_PROCESS_HEAT": {'description': 'Use of geothermal heat for industrial manufacturing processes.'}, + "FOOD_PROCESSING": {'description': 'Use of geothermal heat for food drying, pasteurization, and processing.'}, + "BATHING_RECREATION": {'description': 'Use of geothermal waters for spas, pools, and recreation.'}, + "LITHIUM_EXTRACTION": {'description': 'Extraction of lithium and other minerals from geothermal brines as a co-product of energy production.', 'annotations': {'co_production': True}}, +} + +class GeothermalResourceTemperature(RichEnum): + """ + Classification of geothermal resources by temperature range. + """ + # Enum members + LOW_TEMPERATURE = "LOW_TEMPERATURE" + MODERATE_TEMPERATURE = "MODERATE_TEMPERATURE" + HIGH_TEMPERATURE = "HIGH_TEMPERATURE" + SUPERCRITICAL = "SUPERCRITICAL" + +# Set metadata after class creation to avoid it becoming an enum member +GeothermalResourceTemperature._metadata = { + "LOW_TEMPERATURE": {'description': 'Geothermal resource below 90C, suitable for direct use applications.', 'annotations': {'temperature_max_c': 90}}, + "MODERATE_TEMPERATURE": {'description': 'Geothermal resource 90-150C, suitable for binary power generation.', 'annotations': {'temperature_min_c': 90, 'temperature_max_c': 150}}, + "HIGH_TEMPERATURE": {'description': 'Geothermal resource above 150C, suitable for flash steam power generation.', 'annotations': {'temperature_min_c': 150}}, + "SUPERCRITICAL": {'description': 'Very high temperature resource above 374C where water exists in supercritical state.', 'annotations': {'temperature_min_c': 374}}, +} + +class HydrogenType(RichEnum): + """ + Color-coded classification of hydrogen based on production method and carbon intensity. This informal industry taxonomy differentiates hydrogen by its carbon footprint and energy source. + """ + # Enum members + GREEN_HYDROGEN = "GREEN_HYDROGEN" + BLUE_HYDROGEN = "BLUE_HYDROGEN" + GREY_HYDROGEN = "GREY_HYDROGEN" + BROWN_HYDROGEN = "BROWN_HYDROGEN" + BLACK_HYDROGEN = "BLACK_HYDROGEN" + PINK_HYDROGEN = "PINK_HYDROGEN" + TURQUOISE_HYDROGEN = "TURQUOISE_HYDROGEN" + WHITE_HYDROGEN = "WHITE_HYDROGEN" + YELLOW_HYDROGEN = "YELLOW_HYDROGEN" + ORANGE_HYDROGEN = "ORANGE_HYDROGEN" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenType._metadata = { + "GREEN_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by renewable energy sources (solar, wind, hydro). Zero carbon emissions during production.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'renewable', 'carbon_intensity': 'zero'}, 'aliases': ['Renewable Hydrogen']}, + "BLUE_HYDROGEN": {'description': 'Hydrogen produced from natural gas via steam methane reforming (SMR) with carbon capture and storage (CCS). Low carbon intensity.', 'annotations': {'production_method': 'steam_methane_reforming', 'energy_source': 'natural_gas', 'carbon_intensity': 'low', 'requires_ccs': True}}, + "GREY_HYDROGEN": {'description': 'Hydrogen produced from natural gas via steam methane reforming without carbon capture. Most common production method currently.', 'annotations': {'production_method': 'steam_methane_reforming', 'energy_source': 'natural_gas', 'carbon_intensity': 'high', 'co2_per_kg_h2': '9-12'}, 'aliases': ['Gray Hydrogen']}, + "BROWN_HYDROGEN": {'description': 'Hydrogen produced from brown coal (lignite) gasification without carbon capture. High carbon intensity.', 'annotations': {'production_method': 'coal_gasification', 'energy_source': 'lignite', 'carbon_intensity': 'very_high'}}, + "BLACK_HYDROGEN": {'description': 'Hydrogen produced from black coal (bituminous) gasification without carbon capture. High carbon intensity.', 'annotations': {'production_method': 'coal_gasification', 'energy_source': 'bituminous_coal', 'carbon_intensity': 'very_high'}}, + "PINK_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by nuclear energy. Zero carbon emissions during production.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'nuclear', 'carbon_intensity': 'zero'}, 'aliases': ['Purple Hydrogen', 'Red Hydrogen']}, + "TURQUOISE_HYDROGEN": {'description': 'Hydrogen produced via methane pyrolysis, producing solid carbon instead of CO2. Lower carbon intensity than grey hydrogen.', 'annotations': {'production_method': 'methane_pyrolysis', 'energy_source': 'natural_gas', 'carbon_intensity': 'low', 'byproduct': 'solid_carbon'}}, + "WHITE_HYDROGEN": {'description': 'Naturally occurring geological hydrogen found in underground deposits. Zero production emissions.', 'annotations': {'production_method': 'geological_extraction', 'energy_source': 'natural', 'carbon_intensity': 'zero'}, 'aliases': ['Natural Hydrogen', 'Geological Hydrogen', 'Gold Hydrogen']}, + "YELLOW_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by solar energy specifically. A subset of green hydrogen.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'solar', 'carbon_intensity': 'zero'}}, + "ORANGE_HYDROGEN": {'description': 'Hydrogen produced from plastic waste gasification or pyrolysis. Emerging technology addressing both energy and waste challenges.', 'annotations': {'production_method': 'waste_gasification', 'energy_source': 'plastic_waste', 'carbon_intensity': 'varies'}}, +} + +class HydrogenProductionMethod(RichEnum): + """ + Methods and processes for producing hydrogen. + """ + # Enum members + STEAM_METHANE_REFORMING = "STEAM_METHANE_REFORMING" + AUTOTHERMAL_REFORMING = "AUTOTHERMAL_REFORMING" + PARTIAL_OXIDATION = "PARTIAL_OXIDATION" + COAL_GASIFICATION = "COAL_GASIFICATION" + WATER_ELECTROLYSIS = "WATER_ELECTROLYSIS" + ALKALINE_ELECTROLYSIS = "ALKALINE_ELECTROLYSIS" + PEM_ELECTROLYSIS = "PEM_ELECTROLYSIS" + SOLID_OXIDE_ELECTROLYSIS = "SOLID_OXIDE_ELECTROLYSIS" + METHANE_PYROLYSIS = "METHANE_PYROLYSIS" + BIOMASS_GASIFICATION = "BIOMASS_GASIFICATION" + BIOLOGICAL_PRODUCTION = "BIOLOGICAL_PRODUCTION" + THERMOCHEMICAL_WATER_SPLITTING = "THERMOCHEMICAL_WATER_SPLITTING" + PHOTOELECTROCHEMICAL = "PHOTOELECTROCHEMICAL" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenProductionMethod._metadata = { + "STEAM_METHANE_REFORMING": {'description': 'High temperature steam reacts with methane to produce hydrogen, carbon monoxide, and carbon dioxide.', 'annotations': {'feedstock': 'natural_gas', 'temperature_c': '700-1000', 'dominant_method': True}, 'aliases': ['SMR']}, + "AUTOTHERMAL_REFORMING": {'description': 'Combines steam reforming and partial oxidation using oxygen and steam to produce hydrogen from hydrocarbons.', 'aliases': ['ATR']}, + "PARTIAL_OXIDATION": {'description': 'Exothermic process reacting hydrocarbons with limited oxygen to produce hydrogen and carbon monoxide.', 'aliases': ['POX']}, + "COAL_GASIFICATION": {'description': 'Conversion of coal to syngas (hydrogen and carbon monoxide) using high temperature and steam.', 'meaning': 'CHMO:0001501'}, + "WATER_ELECTROLYSIS": {'description': 'Splitting water into hydrogen and oxygen using electrical current. Can be powered by various energy sources.', 'aliases': ['Electrolysis']}, + "ALKALINE_ELECTROLYSIS": {'description': 'Electrolysis using alkaline solution (typically KOH) as electrolyte. Mature commercial technology.', 'annotations': {'electrolyte': 'alkaline', 'maturity': 'commercial'}, 'aliases': ['AEL']}, + "PEM_ELECTROLYSIS": {'description': 'Proton Exchange Membrane electrolysis using solid polymer electrolyte. Higher efficiency, faster response.', 'annotations': {'electrolyte': 'polymer_membrane', 'maturity': 'commercial'}, 'aliases': ['PEMEC', 'Polymer Electrolyte Membrane Electrolysis']}, + "SOLID_OXIDE_ELECTROLYSIS": {'description': 'High temperature electrolysis using solid ceramic electrolyte. Higher efficiency when waste heat is available.', 'annotations': {'electrolyte': 'solid_oxide', 'temperature_c': '700-850', 'maturity': 'emerging'}, 'aliases': ['SOEC']}, + "METHANE_PYROLYSIS": {'description': 'Thermal decomposition of methane into hydrogen and solid carbon without oxygen. Produces no direct CO2.', 'annotations': {'feedstock': 'natural_gas', 'byproduct': 'solid_carbon'}, 'aliases': ['Thermal Cracking']}, + "BIOMASS_GASIFICATION": {'description': 'Thermochemical conversion of biomass to hydrogen-rich syngas at high temperatures.', 'annotations': {'feedstock': 'biomass', 'renewable': True}}, + "BIOLOGICAL_PRODUCTION": {'description': 'Production of hydrogen by microorganisms through photosynthesis, fermentation, or other biological processes.', 'annotations': {'renewable': True, 'maturity': 'research'}, 'aliases': ['Biohydrogen']}, + "THERMOCHEMICAL_WATER_SPLITTING": {'description': 'Using high temperatures from concentrated solar or nuclear to drive chemical cycles that split water.', 'annotations': {'temperature_c': '500-2000', 'maturity': 'research'}}, + "PHOTOELECTROCHEMICAL": {'description': 'Direct conversion of sunlight to hydrogen using specialized semiconductor materials in contact with water.', 'annotations': {'maturity': 'research'}, 'aliases': ['PEC']}, +} + +class HydrogenStorageMethod(RichEnum): + """ + Methods for storing hydrogen for later use or transport. + """ + # Enum members + COMPRESSED_GAS = "COMPRESSED_GAS" + LIQUID_HYDROGEN = "LIQUID_HYDROGEN" + METAL_HYDRIDE = "METAL_HYDRIDE" + CHEMICAL_HYDRIDE = "CHEMICAL_HYDRIDE" + UNDERGROUND_STORAGE = "UNDERGROUND_STORAGE" + CRYO_COMPRESSED = "CRYO_COMPRESSED" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenStorageMethod._metadata = { + "COMPRESSED_GAS": {'description': 'Storage of hydrogen as compressed gas at high pressure (350-700 bar) in pressure vessels.', 'annotations': {'pressure_bar': '350-700', 'maturity': 'commercial'}, 'aliases': ['CGH2']}, + "LIQUID_HYDROGEN": {'description': 'Storage of hydrogen in liquid form at cryogenic temperatures (-253C). Higher energy density but requires insulation.', 'annotations': {'temperature_c': -253, 'maturity': 'commercial'}, 'aliases': ['LH2']}, + "METAL_HYDRIDE": {'description': 'Storage of hydrogen absorbed into metal alloys forming metal hydrides. Safer but heavier than compressed gas.', 'annotations': {'maturity': 'commercial'}}, + "CHEMICAL_HYDRIDE": {'description': 'Storage as chemical compounds (ammonia, methanol, LOHC) that release hydrogen when processed.', 'aliases': ['LOHC', 'Liquid Organic Hydrogen Carrier']}, + "UNDERGROUND_STORAGE": {'description': 'Large-scale storage in salt caverns, depleted gas fields, or aquifers for grid-scale applications.', 'annotations': {'scale': 'utility'}, 'aliases': ['Geological Storage']}, + "CRYO_COMPRESSED": {'description': 'Hybrid approach combining cryogenic cooling with high pressure for improved density.', 'annotations': {'maturity': 'emerging'}, 'aliases': ['CcH2']}, +} + +class HydrogenApplication(RichEnum): + """ + End-use applications for hydrogen. + """ + # Enum members + FUEL_CELL_VEHICLE = "FUEL_CELL_VEHICLE" + FUEL_CELL_STATIONARY = "FUEL_CELL_STATIONARY" + INDUSTRIAL_FEEDSTOCK = "INDUSTRIAL_FEEDSTOCK" + STEEL_PRODUCTION = "STEEL_PRODUCTION" + AMMONIA_SYNTHESIS = "AMMONIA_SYNTHESIS" + METHANOL_SYNTHESIS = "METHANOL_SYNTHESIS" + POWER_TO_GAS = "POWER_TO_GAS" + BLENDING_NATURAL_GAS = "BLENDING_NATURAL_GAS" + SYNTHETIC_FUELS = "SYNTHETIC_FUELS" + +# Set metadata after class creation to avoid it becoming an enum member +HydrogenApplication._metadata = { + "FUEL_CELL_VEHICLE": {'description': 'Use of hydrogen in fuel cells for transportation (cars, trucks, buses).', 'aliases': ['FCEV']}, + "FUEL_CELL_STATIONARY": {'description': 'Use of hydrogen in stationary fuel cells for power generation.'}, + "INDUSTRIAL_FEEDSTOCK": {'description': 'Use of hydrogen as chemical feedstock for ammonia production, petroleum refining, and chemical synthesis.', 'meaning': 'CHEBI:18276'}, + "STEEL_PRODUCTION": {'description': 'Use of hydrogen to reduce iron ore in steelmaking, replacing coal.', 'aliases': ['Green Steel']}, + "AMMONIA_SYNTHESIS": {'description': 'Use of hydrogen with nitrogen to produce ammonia for fertilizers.'}, + "METHANOL_SYNTHESIS": {'description': 'Use of hydrogen with CO2 to produce methanol.'}, + "POWER_TO_GAS": {'description': 'Conversion of excess renewable electricity to hydrogen for grid balancing and energy storage.', 'aliases': ['P2G']}, + "BLENDING_NATURAL_GAS": {'description': 'Blending hydrogen into natural gas pipelines for decarbonization of heating.'}, + "SYNTHETIC_FUELS": {'description': 'Use of hydrogen with captured CO2 to produce synthetic hydrocarbons (e-fuels, SAF).', 'aliases': ['E-Fuels', 'Power-to-Liquid']}, +} + +class BiomassFeedstockType(RichEnum): + """ + Types of biomass materials used as feedstocks for bioenergy production. Includes dedicated energy crops, agricultural residues, forest residues, and waste streams. + """ + # Enum members + CORN_STOVER = "CORN_STOVER" + WHEAT_STRAW = "WHEAT_STRAW" + RICE_STRAW = "RICE_STRAW" + SWITCHGRASS = "SWITCHGRASS" + MISCANTHUS = "MISCANTHUS" + ENERGY_CANE = "ENERGY_CANE" + SWEET_SORGHUM = "SWEET_SORGHUM" + POPLAR = "POPLAR" + WILLOW = "WILLOW" + FOREST_RESIDUE = "FOREST_RESIDUE" + WOOD_PROCESSING_RESIDUE = "WOOD_PROCESSING_RESIDUE" + MUNICIPAL_SOLID_WASTE = "MUNICIPAL_SOLID_WASTE" + FOOD_WASTE = "FOOD_WASTE" + ANIMAL_MANURE = "ANIMAL_MANURE" + ALGAE = "ALGAE" + USED_COOKING_OIL = "USED_COOKING_OIL" + SOYBEAN_OIL = "SOYBEAN_OIL" + CORN_GRAIN = "CORN_GRAIN" + SUGARCANE = "SUGARCANE" + +# Set metadata after class creation to avoid it becoming an enum member +BiomassFeedstockType._metadata = { + "CORN_STOVER": {'description': 'Agricultural residue consisting of leaves, stalks, and cobs remaining after corn grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}, 'aliases': ['Corn Residue']}, + "WHEAT_STRAW": {'description': 'Agricultural residue remaining after wheat grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}}, + "RICE_STRAW": {'description': 'Agricultural residue remaining after rice grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}}, + "SWITCHGRASS": {'description': 'Perennial warm-season grass native to North America, cultivated as dedicated energy crop for cellulosic biofuel production.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True, 'perennial': True}}, + "MISCANTHUS": {'description': 'High-yielding perennial grass cultivated as dedicated energy crop.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True, 'perennial': True}, 'aliases': ['Elephant Grass']}, + "ENERGY_CANE": {'description': 'High-fiber sugarcane varieties bred for biomass production rather than sugar content.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True}}, + "SWEET_SORGHUM": {'description': 'Sorghum variety with high sugar content in stalks, suitable for both sugar and lignocellulosic conversion.', 'annotations': {'category': 'energy_crop', 'sugar_crop': True}}, + "POPLAR": {'description': 'Fast-growing hardwood tree cultivated as short-rotation woody crop for biomass.', 'annotations': {'category': 'woody_crop', 'lignocellulosic': True}, 'aliases': ['Hybrid Poplar']}, + "WILLOW": {'description': 'Fast-growing shrub cultivated as short-rotation woody crop.', 'annotations': {'category': 'woody_crop', 'lignocellulosic': True}, 'aliases': ['Shrub Willow']}, + "FOREST_RESIDUE": {'description': 'Biomass from forest operations including logging residues, thinning material, and salvage timber.', 'annotations': {'category': 'forestry_residue', 'lignocellulosic': True}, 'aliases': ['Logging Residue']}, + "WOOD_PROCESSING_RESIDUE": {'description': 'Byproducts from wood processing including sawdust, bark, shavings, and wood chips.', 'annotations': {'category': 'processing_residue', 'lignocellulosic': True}, 'aliases': ['Mill Residue']}, + "MUNICIPAL_SOLID_WASTE": {'description': 'Organic portion of municipal solid waste suitable for bioenergy conversion.', 'annotations': {'category': 'waste'}, 'aliases': ['MSW']}, + "FOOD_WASTE": {'description': 'Waste food from residential, commercial, and industrial sources.', 'annotations': {'category': 'wet_waste'}}, + "ANIMAL_MANURE": {'description': 'Livestock waste including cattle, swine, and poultry manure.', 'annotations': {'category': 'wet_waste', 'biogas_suitable': True}}, + "ALGAE": {'description': 'Microalgae or macroalgae cultivated for lipid or carbohydrate content for biofuel production.', 'annotations': {'category': 'aquatic_biomass', 'lipid_rich': True}, 'aliases': ['Microalgae']}, + "USED_COOKING_OIL": {'description': 'Waste vegetable oils from food preparation.', 'annotations': {'category': 'waste', 'lipid_rich': True}, 'aliases': ['UCO', 'Waste Vegetable Oil']}, + "SOYBEAN_OIL": {'description': 'Vegetable oil from soybean seeds, used for biodiesel.', 'meaning': 'CHEBI:166975', 'annotations': {'category': 'oil_crop', 'lipid_rich': True}}, + "CORN_GRAIN": {'description': 'Corn kernels used for starch-based ethanol production.', 'annotations': {'category': 'grain', 'starch_crop': True}}, + "SUGARCANE": {'description': 'Sugar-rich crop used for first-generation ethanol production.', 'annotations': {'category': 'sugar_crop'}}, +} + +class BiofuelType(RichEnum): + """ + Types of fuels produced from biomass feedstocks. + """ + # Enum members + ETHANOL = "ETHANOL" + BIODIESEL = "BIODIESEL" + RENEWABLE_DIESEL = "RENEWABLE_DIESEL" + SUSTAINABLE_AVIATION_FUEL = "SUSTAINABLE_AVIATION_FUEL" + BIOGAS = "BIOGAS" + BIOMETHANE = "BIOMETHANE" + BIO_OIL = "BIO_OIL" + SYNGAS = "SYNGAS" + BUTANOL = "BUTANOL" + METHANOL = "METHANOL" + DIMETHYL_ETHER = "DIMETHYL_ETHER" + +# Set metadata after class creation to avoid it becoming an enum member +BiofuelType._metadata = { + "ETHANOL": {'description': 'Alcohol biofuel (C2H5OH) produced by fermentation of sugars or starches, or from cellulosic biomass.', 'meaning': 'CHEBI:16236', 'annotations': {'chemical_formula': 'C2H5OH'}, 'aliases': ['Fuel Ethanol', 'Bioethanol']}, + "BIODIESEL": {'description': 'Fatty acid methyl esters (FAME) produced by transesterification of vegetable oils or animal fats.', 'meaning': 'MESH:D056804', 'annotations': {'production_method': 'transesterification'}, 'aliases': ['FAME']}, + "RENEWABLE_DIESEL": {'description': 'Hydrocarbon diesel produced by hydrotreating lipids. Chemically identical to petroleum diesel.', 'annotations': {'drop_in_fuel': True}, 'aliases': ['Green Diesel', 'HVO', 'Hydrotreated Vegetable Oil']}, + "SUSTAINABLE_AVIATION_FUEL": {'description': 'Jet fuel produced from biomass or waste, meeting aviation fuel specifications.', 'annotations': {'drop_in_fuel': True}, 'aliases': ['SAF', 'Biojet']}, + "BIOGAS": {'description': 'Gaseous mixture of methane and CO2 produced by anaerobic digestion of organic matter.', 'annotations': {'methane_content_percent': '50-70'}, 'aliases': ['Raw Biogas']}, + "BIOMETHANE": {'description': 'Purified biogas upgraded to natural gas quality (>95% methane).', 'annotations': {'methane_content_percent': '95+', 'pipeline_quality': True}, 'aliases': ['Renewable Natural Gas', 'RNG']}, + "BIO_OIL": {'description': 'Liquid intermediate produced by pyrolysis or hydrothermal liquefaction of biomass.', 'annotations': {'intermediate': True}, 'aliases': ['Pyrolysis Oil']}, + "SYNGAS": {'description': 'Synthesis gas (CO + H2) produced by gasification of biomass.', 'meaning': 'CHMO:0001501', 'annotations': {'intermediate': True}, 'aliases': ['Synthesis Gas']}, + "BUTANOL": {'description': 'Four-carbon alcohol biofuel with higher energy density than ethanol.', 'meaning': 'CHEBI:28885', 'annotations': {'chemical_formula': 'C4H9OH'}}, + "METHANOL": {'description': 'Methanol produced from biomass-derived syngas.', 'meaning': 'CHEBI:17790', 'annotations': {'chemical_formula': 'CH3OH'}}, + "DIMETHYL_ETHER": {'description': 'Dimethyl ether produced from biomass, usable as diesel substitute.', 'meaning': 'CHEBI:28887', 'aliases': ['DME']}, +} + +class BiofuelGeneration(RichEnum): + """ + Classification of biofuels by feedstock source and technology generation. + """ + # Enum members + FIRST_GENERATION = "FIRST_GENERATION" + SECOND_GENERATION = "SECOND_GENERATION" + THIRD_GENERATION = "THIRD_GENERATION" + FOURTH_GENERATION = "FOURTH_GENERATION" + +# Set metadata after class creation to avoid it becoming an enum member +BiofuelGeneration._metadata = { + "FIRST_GENERATION": {'description': 'Biofuels produced from food crops (sugar, starch, vegetable oils) using conventional conversion technologies.', 'annotations': {'feedstock': 'food_crops', 'examples': 'corn_ethanol,soy_biodiesel'}, 'aliases': ['1G Biofuel', 'Conventional Biofuel']}, + "SECOND_GENERATION": {'description': 'Biofuels produced from lignocellulosic biomass (non-food) using advanced conversion technologies.', 'annotations': {'feedstock': 'lignocellulosic', 'examples': 'cellulosic_ethanol,wood_diesel'}, 'aliases': ['2G Biofuel', 'Cellulosic Biofuel', 'Advanced Biofuel']}, + "THIRD_GENERATION": {'description': 'Biofuels produced from algae or other photosynthetic microorganisms.', 'annotations': {'feedstock': 'algae'}, 'aliases': ['3G Biofuel', 'Algal Biofuel']}, + "FOURTH_GENERATION": {'description': 'Biofuels from genetically engineered organisms designed for carbon capture and enhanced fuel production.', 'annotations': {'feedstock': 'engineered_organisms', 'carbon_negative': True}, 'aliases': ['4G Biofuel']}, +} + +class BioconversionProcess(RichEnum): + """ + Processes for converting biomass feedstocks into biofuels and bioproducts. + """ + # Enum members + FERMENTATION = "FERMENTATION" + ANAEROBIC_DIGESTION = "ANAEROBIC_DIGESTION" + TRANSESTERIFICATION = "TRANSESTERIFICATION" + HYDROTREATING = "HYDROTREATING" + PYROLYSIS = "PYROLYSIS" + GASIFICATION = "GASIFICATION" + HYDROTHERMAL_LIQUEFACTION = "HYDROTHERMAL_LIQUEFACTION" + ENZYMATIC_HYDROLYSIS = "ENZYMATIC_HYDROLYSIS" + ACID_HYDROLYSIS = "ACID_HYDROLYSIS" + FISCHER_TROPSCH = "FISCHER_TROPSCH" + ALCOHOL_TO_JET = "ALCOHOL_TO_JET" + +# Set metadata after class creation to avoid it becoming an enum member +BioconversionProcess._metadata = { + "FERMENTATION": {'description': 'Biological conversion of sugars to alcohols using yeast or bacteria.', 'annotations': {'category': 'biochemical', 'products': 'ethanol,butanol'}}, + "ANAEROBIC_DIGESTION": {'description': 'Biological breakdown of organic matter by microorganisms in the absence of oxygen, producing biogas.', 'annotations': {'category': 'biochemical', 'products': 'biogas'}}, + "TRANSESTERIFICATION": {'description': 'Chemical reaction of triglycerides with alcohol to produce fatty acid esters (biodiesel) and glycerol.', 'annotations': {'category': 'chemical', 'products': 'biodiesel'}}, + "HYDROTREATING": {'description': 'Catalytic reaction of lipids with hydrogen to produce hydrocarbon fuels.', 'annotations': {'category': 'thermochemical', 'products': 'renewable_diesel,SAF'}, 'aliases': ['Hydroprocessing']}, + "PYROLYSIS": {'description': 'Thermal decomposition of biomass in the absence of oxygen to produce bio-oil, syngas, and biochar.', 'annotations': {'category': 'thermochemical', 'temperature_c': '400-600', 'products': 'bio_oil,syngas,biochar'}}, + "GASIFICATION": {'description': 'High-temperature conversion of carbonaceous materials to syngas using controlled oxygen and/or steam.', 'meaning': 'CHMO:0001501', 'annotations': {'category': 'thermochemical', 'temperature_c': '700-1500', 'products': 'syngas'}}, + "HYDROTHERMAL_LIQUEFACTION": {'description': 'Conversion of wet biomass to bio-crude using high temperature and pressure water.', 'annotations': {'category': 'thermochemical', 'temperature_c': '250-400', 'pressure_bar': '100-200', 'wet_feedstock': True}, 'aliases': ['HTL']}, + "ENZYMATIC_HYDROLYSIS": {'description': 'Breakdown of cellulose and hemicellulose to fermentable sugars using enzymes.', 'annotations': {'category': 'biochemical', 'pretreatment_step': True}}, + "ACID_HYDROLYSIS": {'description': 'Chemical breakdown of cellulose to sugars using dilute or concentrated acid.', 'annotations': {'category': 'chemical', 'pretreatment_step': True}}, + "FISCHER_TROPSCH": {'description': 'Catalytic conversion of syngas to liquid hydrocarbons.', 'annotations': {'category': 'thermochemical', 'feedstock': 'syngas', 'products': 'FT_diesel,FT_jet'}, 'aliases': ['FT Synthesis']}, + "ALCOHOL_TO_JET": {'description': 'Conversion of alcohols (ethanol, isobutanol) to jet fuel through dehydration, oligomerization, and hydrogenation.', 'annotations': {'category': 'chemical', 'products': 'SAF'}, 'aliases': ['ATJ']}, +} + class MiningType(RichEnum): """ Types of mining operations @@ -6969,6 +7439,52 @@ class CellPolarity(RichEnum): "DISTAL_POLE": {'description': 'Pole further from the cell body', 'annotations': {'context': 'neurons, polarized cells'}}, } +class AnatomicalOrientation(RichEnum): + """ + Directional orientation between anatomical positions based on OME NGFF specification + """ + # Enum members + LEFT_TO_RIGHT = "LEFT_TO_RIGHT" + RIGHT_TO_LEFT = "RIGHT_TO_LEFT" + ANTERIOR_TO_POSTERIOR = "ANTERIOR_TO_POSTERIOR" + POSTERIOR_TO_ANTERIOR = "POSTERIOR_TO_ANTERIOR" + INFERIOR_TO_SUPERIOR = "INFERIOR_TO_SUPERIOR" + SUPERIOR_TO_INFERIOR = "SUPERIOR_TO_INFERIOR" + DORSAL_TO_VENTRAL = "DORSAL_TO_VENTRAL" + VENTRAL_TO_DORSAL = "VENTRAL_TO_DORSAL" + DORSAL_TO_PALMAR = "DORSAL_TO_PALMAR" + PALMAR_TO_DORSAL = "PALMAR_TO_DORSAL" + DORSAL_TO_PLANTAR = "DORSAL_TO_PLANTAR" + PLANTAR_TO_DORSAL = "PLANTAR_TO_DORSAL" + ROSTRAL_TO_CAUDAL = "ROSTRAL_TO_CAUDAL" + CAUDAL_TO_ROSTRAL = "CAUDAL_TO_ROSTRAL" + CRANIAL_TO_CAUDAL = "CRANIAL_TO_CAUDAL" + CAUDAL_TO_CRANIAL = "CAUDAL_TO_CRANIAL" + PROXIMAL_TO_DISTAL = "PROXIMAL_TO_DISTAL" + DISTAL_TO_PROXIMAL = "DISTAL_TO_PROXIMAL" + +# Set metadata after class creation to avoid it becoming an enum member +AnatomicalOrientation._metadata = { + "LEFT_TO_RIGHT": {'description': 'Directional orientation from left to right lateral side of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "RIGHT_TO_LEFT": {'description': 'Directional orientation from right to left lateral side of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "ANTERIOR_TO_POSTERIOR": {'description': 'Directional orientation from front to back of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "POSTERIOR_TO_ANTERIOR": {'description': 'Directional orientation from back to front of an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "INFERIOR_TO_SUPERIOR": {'description': 'Directional orientation from below to above in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "SUPERIOR_TO_INFERIOR": {'description': 'Directional orientation from above to below in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "DORSAL_TO_VENTRAL": {'description': 'Directional orientation from top/upper to belly/lower in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "VENTRAL_TO_DORSAL": {'description': 'Directional orientation from belly/lower to top/upper in an anatomical structure', 'annotations': {'source': 'OME NGFF'}}, + "DORSAL_TO_PALMAR": {'description': 'Directional orientation from top/upper to palm of hand', 'annotations': {'source': 'OME NGFF', 'context': 'hand anatomy'}}, + "PALMAR_TO_DORSAL": {'description': 'Directional orientation from palm of hand to top/upper', 'annotations': {'source': 'OME NGFF', 'context': 'hand anatomy'}}, + "DORSAL_TO_PLANTAR": {'description': 'Directional orientation from top/upper to sole of foot', 'annotations': {'source': 'OME NGFF', 'context': 'foot anatomy'}}, + "PLANTAR_TO_DORSAL": {'description': 'Directional orientation from sole of foot to top/upper', 'annotations': {'source': 'OME NGFF', 'context': 'foot anatomy'}}, + "ROSTRAL_TO_CAUDAL": {'description': 'Directional orientation from nasal to tail end, typically for central nervous system', 'annotations': {'source': 'OME NGFF', 'context': 'central nervous system'}}, + "CAUDAL_TO_ROSTRAL": {'description': 'Directional orientation from tail to nasal end, typically for central nervous system', 'annotations': {'source': 'OME NGFF', 'context': 'central nervous system'}}, + "CRANIAL_TO_CAUDAL": {'description': 'Directional orientation from head to tail end of a structure', 'annotations': {'source': 'OME NGFF'}}, + "CAUDAL_TO_CRANIAL": {'description': 'Directional orientation from tail to head end of a structure', 'annotations': {'source': 'OME NGFF'}}, + "PROXIMAL_TO_DISTAL": {'description': 'Directional orientation from body center to periphery of a structure', 'annotations': {'source': 'OME NGFF'}}, + "DISTAL_TO_PROXIMAL": {'description': 'Directional orientation from periphery to body center of a structure', 'annotations': {'source': 'OME NGFF'}}, +} + class CrystalSystemEnum(RichEnum): """ The seven crystal systems in crystallography diff --git a/src/valuesets/enums/__init__.py b/src/valuesets/enums/__init__.py index c2c7bf63..6c43451e 100644 --- a/src/valuesets/enums/__init__.py +++ b/src/valuesets/enums/__init__.py @@ -110,7 +110,7 @@ from .earth_science.sample_types import SESARSampleType # Energy domain -from .energy.energy import EnergySource, EnergyUnit, PowerUnit, EnergyEfficiencyRating, BuildingEnergyStandard, GridType, EnergyStorageType, EmissionScope, CarbonIntensity, ElectricityMarket +from .energy.energy import EnergySource, EnergyUnit, PowerUnit, EnergyEfficiencyRating, BuildingEnergyStandard, GridType, BatteryType, PVCellType, PVSystemType, EnergyStorageType, EmissionScope, CarbonIntensity, ElectricityMarket, CapabilityStatus from .energy.fossil_fuels import FossilFuelTypeEnum from .energy.nuclear.nuclear_facilities import NuclearFacilityTypeEnum, PowerPlantStatusEnum, ResearchReactorTypeEnum, FuelCycleFacilityTypeEnum, WasteFacilityTypeEnum, NuclearShipTypeEnum from .energy.nuclear.nuclear_fuel_cycle import NuclearFuelCycleStageEnum, NuclearFuelFormEnum, EnrichmentProcessEnum @@ -120,6 +120,9 @@ from .energy.nuclear.nuclear_safety import INESLevelEnum, EmergencyClassificationEnum, NuclearSecurityCategoryEnum, SafetySystemClassEnum, ReactorSafetyFunctionEnum, DefenseInDepthLevelEnum, RadiationProtectionZoneEnum from .energy.nuclear.nuclear_waste import IAEAWasteClassificationEnum, NRCWasteClassEnum, WasteHeatGenerationEnum, WasteHalfLifeCategoryEnum, WasteDisposalMethodEnum, WasteSourceEnum, TransuranicWasteCategoryEnum from .energy.nuclear.reactor_types import ReactorTypeEnum, ReactorGenerationEnum, ReactorCoolantEnum, ReactorModeratorEnum, ReactorNeutronSpectrumEnum, ReactorSizeCategoryEnum +from .energy.renewable.bioenergy import BiomassFeedstockType, BiofuelType, BiofuelGeneration, BioconversionProcess +from .energy.renewable.geothermal import GeothermalSystemType, GeothermalReservoirType, GeothermalWellType, GeothermalApplication, GeothermalResourceTemperature +from .energy.renewable.hydrogen import HydrogenType, HydrogenProductionMethod, HydrogenStorageMethod, HydrogenApplication # Environmental_Health domain from .environmental_health.exposures import AirPollutantEnum, PesticideTypeEnum, HeavyMetalEnum, ExposureRouteEnum, ExposureSourceEnum, WaterContaminantEnum, EndocrineDisruptorEnum, ExposureDurationEnum, SmokingStatusEnum, ExposureStressorTypeEnum, ExposureTransportPathEnum, ExposureFrequencyEnum, StudyPopulationEnum @@ -163,7 +166,7 @@ from .social.person_status import PersonStatusEnum # Spatial domain -from .spatial.spatial_qualifiers import SimpleSpatialDirection, AnatomicalSide, AnatomicalRegion, AnatomicalAxis, AnatomicalPlane, SpatialRelationship, CellPolarity +from .spatial.spatial_qualifiers import SimpleSpatialDirection, AnatomicalSide, AnatomicalRegion, AnatomicalAxis, AnatomicalPlane, SpatialRelationship, CellPolarity, AnatomicalOrientation # Statistics domain from .statistics.prediction_outcomes import OutcomeTypeEnum @@ -190,6 +193,7 @@ "AminoAcidExtendedEnum", "AnalyticalControlType", "AnatomicalAxis", + "AnatomicalOrientation", "AnatomicalPlane", "AnatomicalRegion", "AnatomicalSide", @@ -206,14 +210,19 @@ "BMIClassificationEnum", "BasicColorEnum", "BasicEmotionEnum", + "BatteryType", "BeneficiationPathway", "BenefitsCategoryEnum", "BinaryClassificationEnum", + "BioconversionProcess", + "BiofuelGeneration", + "BiofuelType", "BioleachMode", "BioleachOrganism", "BiologicalKingdom", "BiologicalRole", "BiologicalSexEnum", + "BiomassFeedstockType", "BioreactorTypeEnum", "BiosafetyLevelEnum", "BioticInteractionType", @@ -231,6 +240,7 @@ "CIOConfidenceLevel", "CanadianProvinceCodeEnum", "CapabilityMaturityLevel", + "CapabilityStatus", "CarbonIntensity", "CaseOrControlEnum", "CatalystTypeEnum", @@ -364,6 +374,11 @@ "GeneticRelationship", "GenomeFeatureType", "GeologicalEra", + "GeothermalApplication", + "GeothermalReservoirType", + "GeothermalResourceTemperature", + "GeothermalSystemType", + "GeothermalWellType", "GridType", "HRFunctionEnum", "HairColorEnum", @@ -374,6 +389,10 @@ "HistoricalPeriod", "HousingStatus", "HumanDevelopmentalStage", + "HydrogenApplication", + "HydrogenProductionMethod", + "HydrogenStorageMethod", + "HydrogenType", "IAEAWasteClassificationEnum", "INESLevelEnum", "IPCCConfidenceLevel", @@ -486,6 +505,8 @@ "OxygenationStrategyEnum", "PCROperationTypeEnum", "PCRPlateTypeEnum", + "PVCellType", + "PVSystemType", "ParticipantIdentificationMethod", "ParticipantVitalStatusEnum", "PeakAnnotationSeriesLabel", diff --git a/src/valuesets/enums/bio/structural_biology.py b/src/valuesets/enums/bio/structural_biology.py index 17171f73..c958e3a2 100644 --- a/src/valuesets/enums/bio/structural_biology.py +++ b/src/valuesets/enums/bio/structural_biology.py @@ -27,14 +27,14 @@ class SampleType(RichEnum): # Set metadata after class creation SampleType._metadata = { - "PROTEIN": {'description': 'Purified protein sample'}, - "NUCLEIC_ACID": {'description': 'Nucleic acid sample (DNA or RNA)'}, - "PROTEIN_COMPLEX": {'description': 'Protein-protein or protein-nucleic acid complex'}, - "MEMBRANE_PROTEIN": {'description': 'Membrane-associated protein sample'}, - "VIRUS": {'description': 'Viral particle or capsid'}, - "ORGANELLE": {'description': 'Cellular organelle (mitochondria, chloroplast, etc.)'}, - "CELL": {'description': 'Whole cell sample'}, - "TISSUE": {'description': 'Tissue sample'}, + "PROTEIN": {'description': 'Purified protein sample', 'meaning': 'NCIT:C17021'}, + "NUCLEIC_ACID": {'description': 'Nucleic acid sample (DNA or RNA)', 'meaning': 'NCIT:C813'}, + "PROTEIN_COMPLEX": {'description': 'Protein-protein or protein-nucleic acid complex', 'meaning': 'GO:0032991'}, + "MEMBRANE_PROTEIN": {'description': 'Membrane-associated protein sample', 'meaning': 'NCIT:C16837'}, + "VIRUS": {'description': 'Viral particle or capsid', 'meaning': 'NCIT:C14283'}, + "ORGANELLE": {'description': 'Cellular organelle (mitochondria, chloroplast, etc.)', 'meaning': 'GO:0043226'}, + "CELL": {'description': 'Whole cell sample', 'meaning': 'NCIT:C12508'}, + "TISSUE": {'description': 'Tissue sample', 'meaning': 'NCIT:C12801'}, } class StructuralBiologyTechnique(RichEnum): @@ -56,15 +56,15 @@ class StructuralBiologyTechnique(RichEnum): # Set metadata after class creation StructuralBiologyTechnique._metadata = { "CRYO_EM": {'description': 'Cryo-electron microscopy', 'meaning': 'CHMO:0002413', 'annotations': {'resolution_range': '2-30 Å typical', 'aliases': 'cryoEM, electron cryo-microscopy'}}, - "CRYO_ET": {'description': 'Cryo-electron tomography', 'annotations': {'resolution_range': '20-100 Å typical', 'aliases': 'cryoET, electron cryo-tomography'}}, + "CRYO_ET": {'description': 'Cryo-electron tomography', 'meaning': 'MI:2338', 'annotations': {'resolution_range': '20-100 Å typical', 'aliases': 'cryoET, electron cryo-tomography'}}, "X_RAY_CRYSTALLOGRAPHY": {'description': 'X-ray crystallography', 'meaning': 'CHMO:0000159', 'annotations': {'resolution_range': '1-4 Å typical', 'aliases': 'XRC, macromolecular crystallography'}}, - "NEUTRON_CRYSTALLOGRAPHY": {'description': 'Neutron crystallography', 'annotations': {'advantages': 'hydrogen positions, deuteration studies'}}, + "NEUTRON_CRYSTALLOGRAPHY": {'description': 'Neutron crystallography', 'meaning': 'CHMO:0000175', 'annotations': {'advantages': 'hydrogen positions, deuteration studies'}}, "SAXS": {'description': 'Small-angle X-ray scattering', 'meaning': 'CHMO:0000204', 'annotations': {'information': 'low-resolution structure, conformational changes'}}, - "SANS": {'description': 'Small-angle neutron scattering', 'annotations': {'advantages': 'contrast variation with deuteration'}}, - "WAXS": {'description': 'Wide-angle X-ray scattering'}, + "SANS": {'description': 'Small-angle neutron scattering', 'meaning': 'CHMO:0000184', 'annotations': {'advantages': 'contrast variation with deuteration'}}, + "WAXS": {'description': 'Wide-angle X-ray scattering', 'meaning': 'CHMO:0000213'}, "NMR": {'description': 'Nuclear magnetic resonance spectroscopy', 'meaning': 'CHMO:0000591', 'annotations': {'information': 'solution structure, dynamics'}}, "MASS_SPECTROMETRY": {'description': 'Mass spectrometry', 'meaning': 'CHMO:0000470', 'annotations': {'applications': 'native MS, crosslinking, HDX'}}, - "NEGATIVE_STAIN_EM": {'description': 'Negative stain electron microscopy', 'annotations': {'resolution_range': '15-30 Å typical'}}, + "NEGATIVE_STAIN_EM": {'description': 'Negative stain electron microscopy', 'meaning': 'FBbi:00000568', 'annotations': {'resolution_range': '15-30 Å typical'}}, } class CryoEMPreparationType(RichEnum): @@ -159,8 +159,8 @@ class XRaySource(RichEnum): # Set metadata after class creation XRaySource._metadata = { - "SYNCHROTRON": {'description': 'Synchrotron radiation source', 'annotations': {'advantages': 'high intensity, tunable wavelength', 'brightness': '10^15-10^18 photons/s/mm²/mrad²'}}, - "ROTATING_ANODE": {'description': 'Rotating anode generator', 'annotations': {'power': '3-18 kW typical', 'target': 'copper, molybdenum common'}}, + "SYNCHROTRON": {'description': 'Synchrotron radiation source', 'meaning': 'CHMO:0001810', 'annotations': {'advantages': 'high intensity, tunable wavelength', 'brightness': '10^15-10^18 photons/s/mm²/mrad²'}}, + "ROTATING_ANODE": {'description': 'Rotating anode generator', 'meaning': 'CHMO:0001107', 'annotations': {'power': '3-18 kW typical', 'target': 'copper, molybdenum common'}}, "MICROFOCUS": {'description': 'Microfocus sealed tube', 'annotations': {'spot_size': '10-50 μm', 'applications': 'small crystals, in-house screening'}}, "METAL_JET": {'description': 'Liquid metal jet source', 'annotations': {'advantages': 'higher power density, longer lifetime', 'metals': 'gallium, indium'}}, } @@ -178,11 +178,11 @@ class Detector(RichEnum): # Set metadata after class creation Detector._metadata = { - "DIRECT_ELECTRON": {'description': 'Direct electron detector (DED)', 'annotations': {'examples': 'K2, K3, Falcon, DE-series', 'advantages': 'high DQE, fast readout'}}, - "CCD": {'description': 'Charge-coupled device camera', 'annotations': {'applications': 'legacy EM, some crystallography'}}, - "CMOS": {'description': 'Complementary metal-oxide semiconductor detector', 'annotations': {'advantages': 'fast readout, low noise'}}, + "DIRECT_ELECTRON": {'description': 'Direct electron detector (DED)', 'meaning': 'CHMO:0002837', 'annotations': {'examples': 'K2, K3, Falcon, DE-series', 'advantages': 'high DQE, fast readout'}}, + "CCD": {'description': 'Charge-coupled device camera', 'meaning': 'CHMO:0002171', 'annotations': {'applications': 'legacy EM, some crystallography'}}, + "CMOS": {'description': 'Complementary metal-oxide semiconductor detector', 'meaning': 'CHMO:0002836', 'annotations': {'advantages': 'fast readout, low noise'}}, "HYBRID_PIXEL": {'description': 'Hybrid pixel detector', 'annotations': {'examples': 'Pilatus, Eiger', 'advantages': 'photon counting, zero noise'}}, - "PHOTOSTIMULABLE_PHOSPHOR": {'description': 'Photostimulable phosphor (image plate)', 'annotations': {'applications': 'legacy crystallography'}}, + "PHOTOSTIMULABLE_PHOSPHOR": {'description': 'Photostimulable phosphor (image plate)', 'meaning': 'CHMO:0001069', 'annotations': {'applications': 'legacy crystallography'}}, } class WorkflowType(RichEnum): @@ -237,14 +237,14 @@ class FileFormat(RichEnum): # Set metadata after class creation FileFormat._metadata = { - "MRC": {'description': 'MRC format for EM density maps', 'annotations': {'extension': '.mrc, .map', 'applications': 'EM volumes, tomograms'}}, - "TIFF": {'description': 'Tagged Image File Format', 'annotations': {'extension': '.tif, .tiff', 'applications': 'micrographs, general imaging'}}, - "HDF5": {'description': 'Hierarchical Data Format 5', 'annotations': {'extension': '.h5, .hdf5', 'applications': 'large datasets, metadata storage'}}, - "STAR": {'description': 'Self-defining Text Archival and Retrieval format', 'annotations': {'extension': '.star', 'applications': 'RELION metadata, particle parameters'}}, - "PDB": {'description': 'Protein Data Bank coordinate format', 'annotations': {'extension': '.pdb', 'applications': 'atomic coordinates, legacy format'}}, - "MMCIF": {'description': 'Macromolecular Crystallographic Information File', 'annotations': {'extension': '.cif', 'applications': 'atomic coordinates, modern PDB format'}}, - "MTZ": {'description': 'MTZ reflection data format', 'annotations': {'extension': '.mtz', 'applications': 'crystallographic reflections, phases'}}, - "CBF": {'description': 'Crystallographic Binary Format', 'annotations': {'extension': '.cbf', 'applications': 'detector images, diffraction data'}}, + "MRC": {'description': 'MRC format for EM density maps', 'meaning': 'EDAM:3842', 'annotations': {'extension': '.mrc, .map', 'applications': 'EM volumes, tomograms'}}, + "TIFF": {'description': 'Tagged Image File Format', 'meaning': 'EDAM:3591', 'annotations': {'extension': '.tif, .tiff', 'applications': 'micrographs, general imaging'}}, + "HDF5": {'description': 'Hierarchical Data Format 5', 'meaning': 'EDAM:3590', 'annotations': {'extension': '.h5, .hdf5', 'applications': 'large datasets, metadata storage'}}, + "STAR": {'description': 'Self-defining Text Archival and Retrieval format', 'meaning': 'EDAM:3906', 'annotations': {'extension': '.star', 'applications': 'RELION metadata, particle parameters'}}, + "PDB": {'description': 'Protein Data Bank coordinate format', 'meaning': 'EDAM:1476', 'annotations': {'extension': '.pdb', 'applications': 'atomic coordinates, legacy format'}}, + "MMCIF": {'description': 'Macromolecular Crystallographic Information File', 'meaning': 'EDAM:1477', 'annotations': {'extension': '.cif', 'applications': 'atomic coordinates, modern PDB format'}}, + "MTZ": {'description': 'MTZ reflection data format', 'meaning': 'EDAM:3816', 'annotations': {'extension': '.mtz', 'applications': 'crystallographic reflections, phases'}}, + "CBF": {'description': 'Crystallographic Binary Format', 'meaning': 'EDAM:3874', 'annotations': {'extension': '.cbf', 'applications': 'detector images, diffraction data'}}, "DM3": {'description': 'Digital Micrograph format', 'annotations': {'extension': '.dm3, .dm4', 'applications': 'FEI/Thermo Fisher EM data'}}, "SER": {'description': 'FEI series format', 'annotations': {'extension': '.ser', 'applications': 'FEI movie stacks'}}, } @@ -334,11 +334,11 @@ class CoordinationGeometry(RichEnum): "TRIGONAL_PYRAMIDAL": {'description': 'Trigonal pyramidal coordination geometry', 'annotations': {'coordination_number': '3'}}, "T_SHAPED": {'description': 'T-shaped coordination geometry', 'annotations': {'coordination_number': '3'}}, "TETRAHEDRAL": {'description': 'Tetrahedral coordination geometry (4 ligands, 109.5° angles)', 'meaning': 'NCIT:C103215', 'annotations': {'coordination_number': '4'}}, - "SQUARE_PLANAR": {'description': 'Square planar coordination geometry (4 ligands in plane)', 'annotations': {'coordination_number': '4', 'ncit_variants': 'NCIT:C103211, NCIT:C103212, NCIT:C103213, NCIT:C103214'}}, + "SQUARE_PLANAR": {'description': 'Square planar coordination geometry (4 ligands in plane)', 'meaning': 'NCIT:C103211', 'annotations': {'coordination_number': '4'}}, "TRIGONAL_BIPYRAMIDAL": {'description': 'Trigonal bipyramidal coordination geometry (5 ligands)', 'annotations': {'coordination_number': '5'}}, "SQUARE_PYRAMIDAL": {'description': 'Square pyramidal coordination geometry (5 ligands)', 'annotations': {'coordination_number': '5'}}, "PENTAGONAL_PLANAR": {'description': 'Pentagonal planar coordination geometry (5 ligands in plane)', 'annotations': {'coordination_number': '5'}}, - "OCTAHEDRAL": {'description': 'Octahedral coordination geometry (6 ligands)', 'annotations': {'coordination_number': '6', 'ncit_variants': 'NCIT:C103216, NCIT:C103217, NCIT:C103218'}}, + "OCTAHEDRAL": {'description': 'Octahedral coordination geometry (6 ligands)', 'meaning': 'NCIT:C103216', 'annotations': {'coordination_number': '6'}}, "TRIGONAL_PRISMATIC": {'description': 'Trigonal prismatic coordination geometry (6 ligands)', 'annotations': {'coordination_number': '6'}}, "PENTAGONAL_BIPYRAMIDAL": {'description': 'Pentagonal bipyramidal coordination geometry (7 ligands)', 'annotations': {'coordination_number': '7'}}, "HEXAGONAL_BIPYRAMIDAL": {'description': 'Hexagonal bipyramidal coordination geometry (8 ligands)', 'annotations': {'coordination_number': '8'}}, @@ -382,17 +382,17 @@ class ProteinModificationType(RichEnum): # Set metadata after class creation ProteinModificationType._metadata = { - "METAL_COORDINATION": {'description': 'Metal coordination modification', 'annotations': {'examples': 'zinc finger, iron-sulfur cluster binding'}}, - "PHOSPHORYLATION": {'description': 'Phosphorylation modification'}, - "GLYCOSYLATION": {'description': 'Glycosylation modification'}, - "ACETYLATION": {'description': 'Acetylation modification'}, - "METHYLATION": {'description': 'Methylation modification'}, - "UBIQUITINATION": {'description': 'Ubiquitination modification'}, - "SUMOYLATION": {'description': 'SUMOylation modification'}, - "HYDROXYLATION": {'description': 'Hydroxylation modification'}, - "LIPIDATION": {'description': 'Lipidation modification'}, - "PROTEOLYTIC_CLEAVAGE": {'description': 'Proteolytic cleavage'}, - "CROSSLINKING": {'description': 'Crosslinking modification'}, + "METAL_COORDINATION": {'description': 'Metal coordination modification', 'meaning': 'MOD:00739', 'annotations': {'examples': 'zinc finger, iron-sulfur cluster binding'}}, + "PHOSPHORYLATION": {'description': 'Phosphorylation modification', 'meaning': 'MOD:00696'}, + "GLYCOSYLATION": {'description': 'Glycosylation modification', 'meaning': 'MOD:00725'}, + "ACETYLATION": {'description': 'Acetylation modification', 'meaning': 'MOD:00394'}, + "METHYLATION": {'description': 'Methylation modification', 'meaning': 'MOD:00599'}, + "UBIQUITINATION": {'description': 'Ubiquitination modification', 'meaning': 'MOD:01240'}, + "SUMOYLATION": {'description': 'SUMOylation modification', 'meaning': 'MOD:01149'}, + "HYDROXYLATION": {'description': 'Hydroxylation modification', 'meaning': 'MOD:00677'}, + "LIPIDATION": {'description': 'Lipidation modification', 'meaning': 'MOD:00435'}, + "PROTEOLYTIC_CLEAVAGE": {'description': 'Proteolytic cleavage', 'meaning': 'GO:0006508'}, + "CROSSLINKING": {'description': 'Crosslinking modification', 'meaning': 'MOD:00276'}, } __all__ = [ diff --git a/src/valuesets/enums/energy/energy.py b/src/valuesets/enums/energy/energy.py index fc3ef83f..9f4e4b02 100644 --- a/src/valuesets/enums/energy/energy.py +++ b/src/valuesets/enums/energy/energy.py @@ -36,24 +36,24 @@ class EnergySource(RichEnum): # Set metadata after class creation EnergySource._metadata = { - "SOLAR": {'meaning': 'ENVO:01001862', 'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['Solar radiation']}, - "WIND": {'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['wind wave energy']}, - "HYDROELECTRIC": {'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['hydroelectric dam']}, - "GEOTHERMAL": {'meaning': 'ENVO:2000034', 'annotations': {'renewable': True, 'emission_free': True}, 'aliases': ['geothermal energy']}, - "BIOMASS": {'annotations': {'renewable': True, 'emission_free': False}, 'aliases': ['organic material']}, - "BIOFUEL": {'annotations': {'renewable': True, 'emission_free': False}}, - "TIDAL": {'annotations': {'renewable': True, 'emission_free': True}}, - "HYDROGEN": {'meaning': 'CHEBI:18276', 'annotations': {'renewable': 'depends', 'emission_free': True}, 'aliases': ['dihydrogen']}, - "COAL": {'meaning': 'ENVO:02000091', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "NATURAL_GAS": {'meaning': 'ENVO:01000552', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "PETROLEUM": {'meaning': 'ENVO:00002984', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}}, - "DIESEL": {'meaning': 'ENVO:03510006', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['diesel fuel']}, - "GASOLINE": {'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['fuel oil']}, + "SOLAR": {'meaning': 'ENVO:01001862', 'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'solar energy', 'brick_label': 'Solar Thermal Collector'}, 'aliases': ['Solar radiation']}, + "WIND": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'wind energy'}, 'aliases': ['wind wave energy']}, + "HYDROELECTRIC": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'hydro energy'}, 'aliases': ['hydroelectric dam']}, + "GEOTHERMAL": {'meaning': 'ENVO:2000034', 'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'geothermal energy'}, 'aliases': ['geothermal energy']}, + "BIOMASS": {'annotations': {'renewable': True, 'emission_free': False, 'oeo_label': 'bioenergy'}, 'aliases': ['organic material']}, + "BIOFUEL": {'annotations': {'renewable': True, 'emission_free': False, 'oeo_label': 'biofuel'}}, + "TIDAL": {'annotations': {'renewable': True, 'emission_free': True, 'oeo_label': 'marine tidal energy, marine wave energy'}}, + "HYDROGEN": {'meaning': 'CHEBI:18276', 'annotations': {'renewable': 'depends', 'emission_free': True, 'oeo_label': 'hydrogen'}, 'aliases': ['dihydrogen']}, + "COAL": {'meaning': 'ENVO:02000091', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'coal'}}, + "NATURAL_GAS": {'meaning': 'ENVO:01000552', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'natural gas'}}, + "PETROLEUM": {'meaning': 'ENVO:00002984', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'crude oil'}}, + "DIESEL": {'meaning': 'ENVO:03510006', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'diesel fuel'}, 'aliases': ['diesel fuel']}, + "GASOLINE": {'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True, 'oeo_label': 'gasoline fuel'}, 'aliases': ['fuel oil']}, "PROPANE": {'meaning': 'ENVO:01000553', 'annotations': {'renewable': False, 'emission_free': False, 'fossil_fuel': True}, 'aliases': ['liquefied petroleum gas']}, - "NUCLEAR_FISSION": {'annotations': {'renewable': False, 'emission_free': True}, 'aliases': ['nuclear energy']}, + "NUCLEAR_FISSION": {'annotations': {'renewable': False, 'emission_free': True, 'oeo_label': 'nuclear fuel'}, 'aliases': ['nuclear energy']}, "NUCLEAR_FUSION": {'annotations': {'renewable': False, 'emission_free': True}, 'aliases': ['nuclear energy']}, - "GRID_MIX": {'annotations': {'renewable': 'partial'}}, - "BATTERY_STORAGE": {'description': 'Battery storage systems', 'annotations': {'storage': True}}, + "GRID_MIX": {'annotations': {'renewable': 'partial', 'oeo_label': 'supply grid'}}, + "BATTERY_STORAGE": {'description': 'Battery storage systems', 'annotations': {'storage': True, 'oeo_label': 'battery'}}, } class EnergyUnit(RichEnum): @@ -206,7 +206,7 @@ class GridType(RichEnum): # Set metadata after class creation GridType._metadata = { - "MAIN_GRID": {'description': 'Main utility grid'}, + "MAIN_GRID": {'description': 'Main utility grid', 'annotations': {'oeo_label': 'supply grid'}}, "MICROGRID": {'description': 'Microgrid'}, "OFF_GRID": {'description': 'Off-grid/standalone'}, "SMART_GRID": {'description': 'Smart grid'}, @@ -214,16 +214,112 @@ class GridType(RichEnum): "VIRTUAL_POWER_PLANT": {'description': 'Virtual power plant'}, } +class BatteryType(RichEnum): + """ + Types of battery technologies for energy storage + """ + # Enum members + LITHIUM_ION = "LITHIUM_ION" + LITHIUM_IRON_PHOSPHATE = "LITHIUM_IRON_PHOSPHATE" + LITHIUM_POLYMER = "LITHIUM_POLYMER" + LEAD_ACID = "LEAD_ACID" + NICKEL_METAL_HYDRIDE = "NICKEL_METAL_HYDRIDE" + NICKEL_CADMIUM = "NICKEL_CADMIUM" + SODIUM_ION = "SODIUM_ION" + SOLID_STATE = "SOLID_STATE" + VANADIUM_REDOX_FLOW = "VANADIUM_REDOX_FLOW" + ZINC_BROMINE_FLOW = "ZINC_BROMINE_FLOW" + IRON_AIR = "IRON_AIR" + ZINC_AIR = "ZINC_AIR" + +# Set metadata after class creation +BatteryType._metadata = { + "LITHIUM_ION": {'description': 'Lithium-ion battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['Li-ion', 'LIB']}, + "LITHIUM_IRON_PHOSPHATE": {'description': 'Lithium iron phosphate (LFP) battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['LFP', 'LiFePO4']}, + "LITHIUM_POLYMER": {'description': 'Lithium polymer battery', 'annotations': {'chemistry': 'lithium'}, 'aliases': ['LiPo']}, + "LEAD_ACID": {'description': 'Lead-acid battery', 'annotations': {'chemistry': 'lead'}, 'aliases': ['Pb-acid']}, + "NICKEL_METAL_HYDRIDE": {'description': 'Nickel-metal hydride battery', 'annotations': {'chemistry': 'nickel'}, 'aliases': ['NiMH']}, + "NICKEL_CADMIUM": {'description': 'Nickel-cadmium battery', 'annotations': {'chemistry': 'nickel'}, 'aliases': ['NiCd']}, + "SODIUM_ION": {'description': 'Sodium-ion battery', 'annotations': {'chemistry': 'sodium'}, 'aliases': ['Na-ion']}, + "SOLID_STATE": {'description': 'Solid-state battery', 'annotations': {'chemistry': 'various'}}, + "VANADIUM_REDOX_FLOW": {'description': 'Vanadium redox flow battery', 'annotations': {'chemistry': 'vanadium', 'type': 'flow'}, 'aliases': ['VRB', 'VRFB']}, + "ZINC_BROMINE_FLOW": {'description': 'Zinc-bromine flow battery', 'annotations': {'chemistry': 'zinc', 'type': 'flow'}, 'aliases': ['ZnBr']}, + "IRON_AIR": {'description': 'Iron-air battery', 'annotations': {'chemistry': 'iron'}}, + "ZINC_AIR": {'description': 'Zinc-air battery', 'annotations': {'chemistry': 'zinc'}}, +} + +class PVCellType(RichEnum): + """ + Types of photovoltaic cell technologies + """ + # Enum members + MONOCRYSTALLINE_SILICON = "MONOCRYSTALLINE_SILICON" + POLYCRYSTALLINE_SILICON = "POLYCRYSTALLINE_SILICON" + PASSIVATED_EMITTER_REAR_CELL = "PASSIVATED_EMITTER_REAR_CELL" + HETEROJUNCTION = "HETEROJUNCTION" + TUNNEL_OXIDE_PASSIVATED_CONTACT = "TUNNEL_OXIDE_PASSIVATED_CONTACT" + INTERDIGITATED_BACK_CONTACT = "INTERDIGITATED_BACK_CONTACT" + CADMIUM_TELLURIDE = "CADMIUM_TELLURIDE" + COPPER_INDIUM_GALLIUM_SELENIDE = "COPPER_INDIUM_GALLIUM_SELENIDE" + AMORPHOUS_SILICON = "AMORPHOUS_SILICON" + GALLIUM_ARSENIDE = "GALLIUM_ARSENIDE" + PEROVSKITE = "PEROVSKITE" + ORGANIC = "ORGANIC" + TANDEM = "TANDEM" + +# Set metadata after class creation +PVCellType._metadata = { + "MONOCRYSTALLINE_SILICON": {'description': 'Monocrystalline silicon (mono-Si) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '17-22%'}, 'aliases': ['mono-Si', 'single-crystal silicon']}, + "POLYCRYSTALLINE_SILICON": {'description': 'Polycrystalline silicon (poly-Si) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '15-17%'}, 'aliases': ['poly-Si', 'multi-crystalline silicon']}, + "PASSIVATED_EMITTER_REAR_CELL": {'description': 'Passivated Emitter and Rear Cell (PERC)', 'annotations': {'material': 'silicon', 'efficiency_range': '19-22%'}, 'aliases': ['PERC']}, + "HETEROJUNCTION": {'description': 'Heterojunction (HJT) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '21-24%'}, 'aliases': ['HJT', 'HIT']}, + "TUNNEL_OXIDE_PASSIVATED_CONTACT": {'description': 'Tunnel Oxide Passivated Contact (TOPCon) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '22-24%'}, 'aliases': ['TOPCon']}, + "INTERDIGITATED_BACK_CONTACT": {'description': 'Interdigitated Back Contact (IBC) cells', 'annotations': {'material': 'silicon', 'efficiency_range': '22-24%'}, 'aliases': ['IBC']}, + "CADMIUM_TELLURIDE": {'description': 'Cadmium telluride (CdTe) thin-film cells', 'annotations': {'material': 'cadmium_telluride', 'type': 'thin-film', 'efficiency_range': '16-18%'}, 'aliases': ['CdTe']}, + "COPPER_INDIUM_GALLIUM_SELENIDE": {'description': 'Copper indium gallium selenide (CIGS) thin-film cells', 'annotations': {'material': 'CIGS', 'type': 'thin-film', 'efficiency_range': '15-20%'}, 'aliases': ['CIGS', 'CIS']}, + "AMORPHOUS_SILICON": {'description': 'Amorphous silicon (a-Si) thin-film cells', 'annotations': {'material': 'silicon', 'type': 'thin-film', 'efficiency_range': '6-8%'}, 'aliases': ['a-Si']}, + "GALLIUM_ARSENIDE": {'description': 'Gallium arsenide (GaAs) cells', 'annotations': {'material': 'gallium_arsenide', 'efficiency_range': '25-30%', 'application': 'space, concentrator'}, 'aliases': ['GaAs']}, + "PEROVSKITE": {'description': 'Perovskite solar cells', 'annotations': {'material': 'perovskite', 'efficiency_range': '20-25%', 'status': 'emerging'}}, + "ORGANIC": {'description': 'Organic photovoltaic (OPV) cells', 'annotations': {'material': 'organic', 'type': 'thin-film', 'efficiency_range': '10-15%', 'status': 'emerging'}, 'aliases': ['OPV']}, + "TANDEM": {'description': 'Tandem/multi-junction cells', 'annotations': {'efficiency_range': '25-35%'}, 'aliases': ['multi-junction']}, +} + +class PVSystemType(RichEnum): + """ + Types of photovoltaic system installations + """ + # Enum members + ROOFTOP_RESIDENTIAL = "ROOFTOP_RESIDENTIAL" + ROOFTOP_COMMERCIAL = "ROOFTOP_COMMERCIAL" + GROUND_MOUNTED = "GROUND_MOUNTED" + FLOATING = "FLOATING" + BUILDING_INTEGRATED = "BUILDING_INTEGRATED" + AGRIVOLTAICS = "AGRIVOLTAICS" + CARPORT = "CARPORT" + TRACKER_SINGLE_AXIS = "TRACKER_SINGLE_AXIS" + TRACKER_DUAL_AXIS = "TRACKER_DUAL_AXIS" + CONCENTRATING = "CONCENTRATING" + +# Set metadata after class creation +PVSystemType._metadata = { + "ROOFTOP_RESIDENTIAL": {'description': 'Residential rooftop PV system', 'annotations': {'scale': 'residential', 'mounting': 'rooftop'}}, + "ROOFTOP_COMMERCIAL": {'description': 'Commercial/industrial rooftop PV system', 'annotations': {'scale': 'commercial', 'mounting': 'rooftop'}}, + "GROUND_MOUNTED": {'description': 'Ground-mounted utility-scale PV system', 'annotations': {'scale': 'utility', 'mounting': 'ground'}}, + "FLOATING": {'description': 'Floating PV system (floatovoltaics)', 'annotations': {'scale': 'utility', 'mounting': 'floating'}, 'aliases': ['floatovoltaics', 'FPV']}, + "BUILDING_INTEGRATED": {'description': 'Building-integrated PV (BIPV)', 'annotations': {'mounting': 'integrated'}, 'aliases': ['BIPV']}, + "AGRIVOLTAICS": {'description': 'Agrivoltaic system (dual-use with agriculture)', 'annotations': {'scale': 'utility', 'dual_use': 'agriculture'}, 'aliases': ['agrophotovoltaics', 'APV']}, + "CARPORT": {'description': 'Solar carport/parking canopy', 'annotations': {'mounting': 'canopy', 'dual_use': 'parking'}}, + "TRACKER_SINGLE_AXIS": {'description': 'Single-axis tracking system', 'annotations': {'tracking': 'single_axis'}}, + "TRACKER_DUAL_AXIS": {'description': 'Dual-axis tracking system', 'annotations': {'tracking': 'dual_axis'}}, + "CONCENTRATING": {'description': 'Concentrating PV (CPV) system', 'annotations': {'type': 'concentrating'}, 'aliases': ['CPV']}, +} + class EnergyStorageType(RichEnum): """ - Types of energy storage systems + Types of energy storage systems (categories) """ # Enum members - LITHIUM_ION_BATTERY = "LITHIUM_ION_BATTERY" - LEAD_ACID_BATTERY = "LEAD_ACID_BATTERY" - FLOW_BATTERY = "FLOW_BATTERY" - SOLID_STATE_BATTERY = "SOLID_STATE_BATTERY" - SODIUM_ION_BATTERY = "SODIUM_ION_BATTERY" + BATTERY = "BATTERY" PUMPED_HYDRO = "PUMPED_HYDRO" COMPRESSED_AIR = "COMPRESSED_AIR" FLYWHEEL = "FLYWHEEL" @@ -238,20 +334,16 @@ class EnergyStorageType(RichEnum): # Set metadata after class creation EnergyStorageType._metadata = { - "LITHIUM_ION_BATTERY": {'description': 'Lithium-ion battery', 'annotations': {'category': 'electrochemical'}}, - "LEAD_ACID_BATTERY": {'description': 'Lead-acid battery', 'annotations': {'category': 'electrochemical'}}, - "FLOW_BATTERY": {'description': 'Flow battery (e.g., vanadium redox)', 'annotations': {'category': 'electrochemical'}}, - "SOLID_STATE_BATTERY": {'description': 'Solid-state battery', 'annotations': {'category': 'electrochemical'}}, - "SODIUM_ION_BATTERY": {'description': 'Sodium-ion battery', 'annotations': {'category': 'electrochemical'}}, - "PUMPED_HYDRO": {'description': 'Pumped hydroelectric storage', 'annotations': {'category': 'mechanical'}}, - "COMPRESSED_AIR": {'description': 'Compressed air energy storage (CAES)', 'annotations': {'category': 'mechanical'}}, + "BATTERY": {'description': 'Battery storage (see BatteryType for specific chemistries)', 'annotations': {'category': 'electrochemical'}}, + "PUMPED_HYDRO": {'description': 'Pumped hydroelectric storage', 'annotations': {'category': 'mechanical', 'oeo_label': 'pumped hydro storage power plant'}}, + "COMPRESSED_AIR": {'description': 'Compressed air energy storage (CAES)', 'annotations': {'category': 'mechanical', 'oeo_label': 'compressed air'}}, "FLYWHEEL": {'description': 'Flywheel energy storage', 'annotations': {'category': 'mechanical'}}, "GRAVITY_STORAGE": {'description': 'Gravity-based storage', 'annotations': {'category': 'mechanical'}}, "MOLTEN_SALT": {'description': 'Molten salt thermal storage', 'annotations': {'category': 'thermal'}}, "ICE_STORAGE": {'description': 'Ice thermal storage', 'annotations': {'category': 'thermal'}}, "PHASE_CHANGE": {'description': 'Phase change materials', 'annotations': {'category': 'thermal'}}, - "HYDROGEN_STORAGE": {'description': 'Hydrogen storage', 'annotations': {'category': 'chemical'}}, - "SYNTHETIC_FUEL": {'description': 'Synthetic fuel storage', 'annotations': {'category': 'chemical'}}, + "HYDROGEN_STORAGE": {'description': 'Hydrogen storage', 'annotations': {'category': 'chemical', 'oeo_label': 'hydrogen'}}, + "SYNTHETIC_FUEL": {'description': 'Synthetic fuel storage', 'annotations': {'category': 'chemical', 'oeo_label': 'synthetic fuel'}}, "SUPERCAPACITOR": {'description': 'Supercapacitor', 'annotations': {'category': 'electrical'}}, "SUPERCONDUCTING": {'description': 'Superconducting magnetic energy storage (SMES)', 'annotations': {'category': 'electrical'}}, } @@ -269,11 +361,11 @@ class EmissionScope(RichEnum): # Set metadata after class creation EmissionScope._metadata = { - "SCOPE_1": {'description': 'Direct emissions from owned or controlled sources', 'annotations': {'ghg_protocol': 'Scope 1'}}, - "SCOPE_2": {'description': 'Indirect emissions from purchased energy', 'annotations': {'ghg_protocol': 'Scope 2'}}, - "SCOPE_3": {'description': 'All other indirect emissions in value chain', 'annotations': {'ghg_protocol': 'Scope 3'}}, - "SCOPE_3_UPSTREAM": {'description': 'Upstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3'}}, - "SCOPE_3_DOWNSTREAM": {'description': 'Downstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3'}}, + "SCOPE_1": {'description': 'Direct emissions from owned or controlled sources', 'annotations': {'ghg_protocol': 'Scope 1', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_2": {'description': 'Indirect emissions from purchased energy', 'annotations': {'ghg_protocol': 'Scope 2', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3": {'description': 'All other indirect emissions in value chain', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3_UPSTREAM": {'description': 'Upstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, + "SCOPE_3_DOWNSTREAM": {'description': 'Downstream Scope 3 emissions', 'annotations': {'ghg_protocol': 'Scope 3', 'oeo_label': 'greenhouse gas emission'}}, } class CarbonIntensity(RichEnum): @@ -328,6 +420,26 @@ class ElectricityMarket(RichEnum): "POWER_PURCHASE_AGREEMENT": {'description': 'Power purchase agreement (PPA)'}, } +class CapabilityStatus(RichEnum): + """ + Operational status of a capability, facility, or infrastructure. Applicable to energy facilities, research capabilities, and other infrastructure throughout their lifecycle. + """ + # Enum members + OPERATIONAL = "OPERATIONAL" + COMING_ONLINE = "COMING_ONLINE" + PILOT = "PILOT" + UNDER_DEVELOPMENT = "UNDER_DEVELOPMENT" + DECOMMISSIONED = "DECOMMISSIONED" + +# Set metadata after class creation +CapabilityStatus._metadata = { + "OPERATIONAL": {'description': 'Fully operational and available to users', 'annotations': {'wikidata_label': 'in use', 'lifecycle_phase': 'operation'}}, + "COMING_ONLINE": {'description': 'Being commissioned, coming online soon', 'annotations': {'wikidata_label': 'building process', 'lifecycle_phase': 'commissioning', 'iaea_equivalent': 'commissioning'}}, + "PILOT": {'description': 'In pilot phase with limited access', 'annotations': {'availability': 'limited', 'lifecycle_phase': 'testing'}}, + "UNDER_DEVELOPMENT": {'description': 'Under development, not yet available', 'annotations': {'wikidata_label': 'proposed building or structure', 'lifecycle_phase': 'planning/construction'}}, + "DECOMMISSIONED": {'description': 'No longer available, permanently shut down', 'annotations': {'lifecycle_phase': 'end-of-life', 'iaea_equivalent': 'decommissioned'}}, +} + __all__ = [ "EnergySource", "EnergyUnit", @@ -335,8 +447,12 @@ class ElectricityMarket(RichEnum): "EnergyEfficiencyRating", "BuildingEnergyStandard", "GridType", + "BatteryType", + "PVCellType", + "PVSystemType", "EnergyStorageType", "EmissionScope", "CarbonIntensity", "ElectricityMarket", + "CapabilityStatus", ] \ No newline at end of file diff --git a/src/valuesets/enums/energy/renewable/__init__.py b/src/valuesets/enums/energy/renewable/__init__.py new file mode 100644 index 00000000..633c553c --- /dev/null +++ b/src/valuesets/enums/energy/renewable/__init__.py @@ -0,0 +1 @@ +"""Auto-generated package.""" diff --git a/src/valuesets/enums/energy/renewable/bioenergy.py b/src/valuesets/enums/energy/renewable/bioenergy.py new file mode 100644 index 00000000..ae42b486 --- /dev/null +++ b/src/valuesets/enums/energy/renewable/bioenergy.py @@ -0,0 +1,148 @@ +""" +Bioenergy and Biofuels Value Sets + +Value sets for bioenergy feedstocks, biofuels, and conversion processes. Based on DOE Bioenergy Technologies Office terminology and glossary. + +Generated from: energy/renewable/bioenergy.yaml +""" + +from __future__ import annotations + +from valuesets.generators.rich_enum import RichEnum + +class BiomassFeedstockType(RichEnum): + """ + Types of biomass materials used as feedstocks for bioenergy production. Includes dedicated energy crops, agricultural residues, forest residues, and waste streams. + """ + # Enum members + CORN_STOVER = "CORN_STOVER" + WHEAT_STRAW = "WHEAT_STRAW" + RICE_STRAW = "RICE_STRAW" + SWITCHGRASS = "SWITCHGRASS" + MISCANTHUS = "MISCANTHUS" + ENERGY_CANE = "ENERGY_CANE" + SWEET_SORGHUM = "SWEET_SORGHUM" + POPLAR = "POPLAR" + WILLOW = "WILLOW" + FOREST_RESIDUE = "FOREST_RESIDUE" + WOOD_PROCESSING_RESIDUE = "WOOD_PROCESSING_RESIDUE" + MUNICIPAL_SOLID_WASTE = "MUNICIPAL_SOLID_WASTE" + FOOD_WASTE = "FOOD_WASTE" + ANIMAL_MANURE = "ANIMAL_MANURE" + ALGAE = "ALGAE" + USED_COOKING_OIL = "USED_COOKING_OIL" + SOYBEAN_OIL = "SOYBEAN_OIL" + CORN_GRAIN = "CORN_GRAIN" + SUGARCANE = "SUGARCANE" + +# Set metadata after class creation +BiomassFeedstockType._metadata = { + "CORN_STOVER": {'description': 'Agricultural residue consisting of leaves, stalks, and cobs remaining after corn grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}, 'aliases': ['Corn Residue']}, + "WHEAT_STRAW": {'description': 'Agricultural residue remaining after wheat grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}}, + "RICE_STRAW": {'description': 'Agricultural residue remaining after rice grain harvest.', 'annotations': {'category': 'agricultural_residue', 'lignocellulosic': True}}, + "SWITCHGRASS": {'description': 'Perennial warm-season grass native to North America, cultivated as dedicated energy crop for cellulosic biofuel production.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True, 'perennial': True}}, + "MISCANTHUS": {'description': 'High-yielding perennial grass cultivated as dedicated energy crop.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True, 'perennial': True}, 'aliases': ['Elephant Grass']}, + "ENERGY_CANE": {'description': 'High-fiber sugarcane varieties bred for biomass production rather than sugar content.', 'annotations': {'category': 'energy_crop', 'lignocellulosic': True}}, + "SWEET_SORGHUM": {'description': 'Sorghum variety with high sugar content in stalks, suitable for both sugar and lignocellulosic conversion.', 'annotations': {'category': 'energy_crop', 'sugar_crop': True}}, + "POPLAR": {'description': 'Fast-growing hardwood tree cultivated as short-rotation woody crop for biomass.', 'annotations': {'category': 'woody_crop', 'lignocellulosic': True}, 'aliases': ['Hybrid Poplar']}, + "WILLOW": {'description': 'Fast-growing shrub cultivated as short-rotation woody crop.', 'annotations': {'category': 'woody_crop', 'lignocellulosic': True}, 'aliases': ['Shrub Willow']}, + "FOREST_RESIDUE": {'description': 'Biomass from forest operations including logging residues, thinning material, and salvage timber.', 'annotations': {'category': 'forestry_residue', 'lignocellulosic': True}, 'aliases': ['Logging Residue']}, + "WOOD_PROCESSING_RESIDUE": {'description': 'Byproducts from wood processing including sawdust, bark, shavings, and wood chips.', 'annotations': {'category': 'processing_residue', 'lignocellulosic': True}, 'aliases': ['Mill Residue']}, + "MUNICIPAL_SOLID_WASTE": {'description': 'Organic portion of municipal solid waste suitable for bioenergy conversion.', 'annotations': {'category': 'waste'}, 'aliases': ['MSW']}, + "FOOD_WASTE": {'description': 'Waste food from residential, commercial, and industrial sources.', 'annotations': {'category': 'wet_waste'}}, + "ANIMAL_MANURE": {'description': 'Livestock waste including cattle, swine, and poultry manure.', 'annotations': {'category': 'wet_waste', 'biogas_suitable': True}}, + "ALGAE": {'description': 'Microalgae or macroalgae cultivated for lipid or carbohydrate content for biofuel production.', 'annotations': {'category': 'aquatic_biomass', 'lipid_rich': True}, 'aliases': ['Microalgae']}, + "USED_COOKING_OIL": {'description': 'Waste vegetable oils from food preparation.', 'annotations': {'category': 'waste', 'lipid_rich': True}, 'aliases': ['UCO', 'Waste Vegetable Oil']}, + "SOYBEAN_OIL": {'description': 'Vegetable oil from soybean seeds, used for biodiesel.', 'meaning': 'CHEBI:166975', 'annotations': {'category': 'oil_crop', 'lipid_rich': True}}, + "CORN_GRAIN": {'description': 'Corn kernels used for starch-based ethanol production.', 'annotations': {'category': 'grain', 'starch_crop': True}}, + "SUGARCANE": {'description': 'Sugar-rich crop used for first-generation ethanol production.', 'annotations': {'category': 'sugar_crop'}}, +} + +class BiofuelType(RichEnum): + """ + Types of fuels produced from biomass feedstocks. + """ + # Enum members + ETHANOL = "ETHANOL" + BIODIESEL = "BIODIESEL" + RENEWABLE_DIESEL = "RENEWABLE_DIESEL" + SUSTAINABLE_AVIATION_FUEL = "SUSTAINABLE_AVIATION_FUEL" + BIOGAS = "BIOGAS" + BIOMETHANE = "BIOMETHANE" + BIO_OIL = "BIO_OIL" + SYNGAS = "SYNGAS" + BUTANOL = "BUTANOL" + METHANOL = "METHANOL" + DIMETHYL_ETHER = "DIMETHYL_ETHER" + +# Set metadata after class creation +BiofuelType._metadata = { + "ETHANOL": {'description': 'Alcohol biofuel (C2H5OH) produced by fermentation of sugars or starches, or from cellulosic biomass.', 'meaning': 'CHEBI:16236', 'annotations': {'chemical_formula': 'C2H5OH'}, 'aliases': ['Fuel Ethanol', 'Bioethanol']}, + "BIODIESEL": {'description': 'Fatty acid methyl esters (FAME) produced by transesterification of vegetable oils or animal fats.', 'meaning': 'MESH:D056804', 'annotations': {'production_method': 'transesterification'}, 'aliases': ['FAME']}, + "RENEWABLE_DIESEL": {'description': 'Hydrocarbon diesel produced by hydrotreating lipids. Chemically identical to petroleum diesel.', 'annotations': {'drop_in_fuel': True}, 'aliases': ['Green Diesel', 'HVO', 'Hydrotreated Vegetable Oil']}, + "SUSTAINABLE_AVIATION_FUEL": {'description': 'Jet fuel produced from biomass or waste, meeting aviation fuel specifications.', 'annotations': {'drop_in_fuel': True}, 'aliases': ['SAF', 'Biojet']}, + "BIOGAS": {'description': 'Gaseous mixture of methane and CO2 produced by anaerobic digestion of organic matter.', 'annotations': {'methane_content_percent': '50-70'}, 'aliases': ['Raw Biogas']}, + "BIOMETHANE": {'description': 'Purified biogas upgraded to natural gas quality (>95% methane).', 'annotations': {'methane_content_percent': '95+', 'pipeline_quality': True}, 'aliases': ['Renewable Natural Gas', 'RNG']}, + "BIO_OIL": {'description': 'Liquid intermediate produced by pyrolysis or hydrothermal liquefaction of biomass.', 'annotations': {'intermediate': True}, 'aliases': ['Pyrolysis Oil']}, + "SYNGAS": {'description': 'Synthesis gas (CO + H2) produced by gasification of biomass.', 'meaning': 'CHMO:0001501', 'annotations': {'intermediate': True}, 'aliases': ['Synthesis Gas']}, + "BUTANOL": {'description': 'Four-carbon alcohol biofuel with higher energy density than ethanol.', 'meaning': 'CHEBI:28885', 'annotations': {'chemical_formula': 'C4H9OH'}}, + "METHANOL": {'description': 'Methanol produced from biomass-derived syngas.', 'meaning': 'CHEBI:17790', 'annotations': {'chemical_formula': 'CH3OH'}}, + "DIMETHYL_ETHER": {'description': 'Dimethyl ether produced from biomass, usable as diesel substitute.', 'meaning': 'CHEBI:28887', 'aliases': ['DME']}, +} + +class BiofuelGeneration(RichEnum): + """ + Classification of biofuels by feedstock source and technology generation. + """ + # Enum members + FIRST_GENERATION = "FIRST_GENERATION" + SECOND_GENERATION = "SECOND_GENERATION" + THIRD_GENERATION = "THIRD_GENERATION" + FOURTH_GENERATION = "FOURTH_GENERATION" + +# Set metadata after class creation +BiofuelGeneration._metadata = { + "FIRST_GENERATION": {'description': 'Biofuels produced from food crops (sugar, starch, vegetable oils) using conventional conversion technologies.', 'annotations': {'feedstock': 'food_crops', 'examples': 'corn_ethanol,soy_biodiesel'}, 'aliases': ['1G Biofuel', 'Conventional Biofuel']}, + "SECOND_GENERATION": {'description': 'Biofuels produced from lignocellulosic biomass (non-food) using advanced conversion technologies.', 'annotations': {'feedstock': 'lignocellulosic', 'examples': 'cellulosic_ethanol,wood_diesel'}, 'aliases': ['2G Biofuel', 'Cellulosic Biofuel', 'Advanced Biofuel']}, + "THIRD_GENERATION": {'description': 'Biofuels produced from algae or other photosynthetic microorganisms.', 'annotations': {'feedstock': 'algae'}, 'aliases': ['3G Biofuel', 'Algal Biofuel']}, + "FOURTH_GENERATION": {'description': 'Biofuels from genetically engineered organisms designed for carbon capture and enhanced fuel production.', 'annotations': {'feedstock': 'engineered_organisms', 'carbon_negative': True}, 'aliases': ['4G Biofuel']}, +} + +class BioconversionProcess(RichEnum): + """ + Processes for converting biomass feedstocks into biofuels and bioproducts. + """ + # Enum members + FERMENTATION = "FERMENTATION" + ANAEROBIC_DIGESTION = "ANAEROBIC_DIGESTION" + TRANSESTERIFICATION = "TRANSESTERIFICATION" + HYDROTREATING = "HYDROTREATING" + PYROLYSIS = "PYROLYSIS" + GASIFICATION = "GASIFICATION" + HYDROTHERMAL_LIQUEFACTION = "HYDROTHERMAL_LIQUEFACTION" + ENZYMATIC_HYDROLYSIS = "ENZYMATIC_HYDROLYSIS" + ACID_HYDROLYSIS = "ACID_HYDROLYSIS" + FISCHER_TROPSCH = "FISCHER_TROPSCH" + ALCOHOL_TO_JET = "ALCOHOL_TO_JET" + +# Set metadata after class creation +BioconversionProcess._metadata = { + "FERMENTATION": {'description': 'Biological conversion of sugars to alcohols using yeast or bacteria.', 'annotations': {'category': 'biochemical', 'products': 'ethanol,butanol'}}, + "ANAEROBIC_DIGESTION": {'description': 'Biological breakdown of organic matter by microorganisms in the absence of oxygen, producing biogas.', 'annotations': {'category': 'biochemical', 'products': 'biogas'}}, + "TRANSESTERIFICATION": {'description': 'Chemical reaction of triglycerides with alcohol to produce fatty acid esters (biodiesel) and glycerol.', 'annotations': {'category': 'chemical', 'products': 'biodiesel'}}, + "HYDROTREATING": {'description': 'Catalytic reaction of lipids with hydrogen to produce hydrocarbon fuels.', 'annotations': {'category': 'thermochemical', 'products': 'renewable_diesel,SAF'}, 'aliases': ['Hydroprocessing']}, + "PYROLYSIS": {'description': 'Thermal decomposition of biomass in the absence of oxygen to produce bio-oil, syngas, and biochar.', 'annotations': {'category': 'thermochemical', 'temperature_c': '400-600', 'products': 'bio_oil,syngas,biochar'}}, + "GASIFICATION": {'description': 'High-temperature conversion of carbonaceous materials to syngas using controlled oxygen and/or steam.', 'meaning': 'CHMO:0001501', 'annotations': {'category': 'thermochemical', 'temperature_c': '700-1500', 'products': 'syngas'}}, + "HYDROTHERMAL_LIQUEFACTION": {'description': 'Conversion of wet biomass to bio-crude using high temperature and pressure water.', 'annotations': {'category': 'thermochemical', 'temperature_c': '250-400', 'pressure_bar': '100-200', 'wet_feedstock': True}, 'aliases': ['HTL']}, + "ENZYMATIC_HYDROLYSIS": {'description': 'Breakdown of cellulose and hemicellulose to fermentable sugars using enzymes.', 'annotations': {'category': 'biochemical', 'pretreatment_step': True}}, + "ACID_HYDROLYSIS": {'description': 'Chemical breakdown of cellulose to sugars using dilute or concentrated acid.', 'annotations': {'category': 'chemical', 'pretreatment_step': True}}, + "FISCHER_TROPSCH": {'description': 'Catalytic conversion of syngas to liquid hydrocarbons.', 'annotations': {'category': 'thermochemical', 'feedstock': 'syngas', 'products': 'FT_diesel,FT_jet'}, 'aliases': ['FT Synthesis']}, + "ALCOHOL_TO_JET": {'description': 'Conversion of alcohols (ethanol, isobutanol) to jet fuel through dehydration, oligomerization, and hydrogenation.', 'annotations': {'category': 'chemical', 'products': 'SAF'}, 'aliases': ['ATJ']}, +} + +__all__ = [ + "BiomassFeedstockType", + "BiofuelType", + "BiofuelGeneration", + "BioconversionProcess", +] \ No newline at end of file diff --git a/src/valuesets/enums/energy/renewable/geothermal.py b/src/valuesets/enums/energy/renewable/geothermal.py new file mode 100644 index 00000000..a47dfba9 --- /dev/null +++ b/src/valuesets/enums/energy/renewable/geothermal.py @@ -0,0 +1,131 @@ +""" +Geothermal Energy Value Sets + +Value sets for geothermal energy systems, reservoir types, well types, and technologies. Based on DOE Geothermal Technologies Office terminology and the Geothermal Data Repository standards. + +Generated from: energy/renewable/geothermal.yaml +""" + +from __future__ import annotations + +from valuesets.generators.rich_enum import RichEnum + +class GeothermalSystemType(RichEnum): + """ + Types of geothermal energy systems, including conventional hydrothermal and enhanced/engineered geothermal systems. + """ + # Enum members + HYDROTHERMAL = "HYDROTHERMAL" + ENHANCED_GEOTHERMAL_SYSTEM = "ENHANCED_GEOTHERMAL_SYSTEM" + ADVANCED_GEOTHERMAL_SYSTEM = "ADVANCED_GEOTHERMAL_SYSTEM" + HOT_DRY_ROCK = "HOT_DRY_ROCK" + GEOPRESSURED = "GEOPRESSURED" + SUPERCRITICAL = "SUPERCRITICAL" + GROUND_SOURCE_HEAT_PUMP = "GROUND_SOURCE_HEAT_PUMP" + +# Set metadata after class creation +GeothermalSystemType._metadata = { + "HYDROTHERMAL": {'description': 'Naturally occurring geothermal system with heat, fluid, and permeability sufficient for energy extraction without stimulation.', 'annotations': {'conventional': True}}, + "ENHANCED_GEOTHERMAL_SYSTEM": {'description': 'Engineered reservoirs created to extract heat from low permeability geothermal resources through stimulation methods.', 'annotations': {'requires_stimulation': True}, 'aliases': ['EGS', 'Engineered Geothermal System']}, + "ADVANCED_GEOTHERMAL_SYSTEM": {'description': 'Closed-loop geothermal systems that circulate working fluid through wellbores to extract heat conductively without reservoir stimulation.', 'annotations': {'closed_loop': True}, 'aliases': ['AGS', 'Closed-Loop Geothermal']}, + "HOT_DRY_ROCK": {'description': 'Geothermal system targeting hot basement rock lacking natural fluid or permeability, requiring artificial reservoir creation.', 'aliases': ['HDR']}, + "GEOPRESSURED": {'description': 'Deep sedimentary formations with abnormally high fluid pressure containing hot brine and dissolved methane.', 'annotations': {'methane_recovery': True}}, + "SUPERCRITICAL": {'description': 'Very high temperature systems (>374C) where water exists above its critical point, offering higher energy density.', 'annotations': {'temperature_min_c': 374}}, + "GROUND_SOURCE_HEAT_PUMP": {'description': 'Shallow geothermal system using stable ground temperatures for heating and cooling buildings.', 'annotations': {'direct_use': True}, 'aliases': ['GSHP', 'Geothermal Heat Pump']}, +} + +class GeothermalReservoirType(RichEnum): + """ + Classification of geothermal reservoirs by geological setting and characteristics. + """ + # Enum members + VOLCANIC = "VOLCANIC" + SEDIMENTARY = "SEDIMENTARY" + FRACTURED_BASEMENT = "FRACTURED_BASEMENT" + FAULT_CONTROLLED = "FAULT_CONTROLLED" + MAGMATIC = "MAGMATIC" + CONDUCTION_DOMINATED = "CONDUCTION_DOMINATED" + +# Set metadata after class creation +GeothermalReservoirType._metadata = { + "VOLCANIC": {'description': 'Reservoir associated with volcanic activity, typically in active volcanic regions with magma heat sources.'}, + "SEDIMENTARY": {'description': 'Reservoir in sedimentary formations with elevated temperatures due to depth or regional heat flow.'}, + "FRACTURED_BASEMENT": {'description': 'Reservoir in fractured crystalline basement rocks, typically granitic or metamorphic.', 'aliases': ['Hot Fractured Rock']}, + "FAULT_CONTROLLED": {'description': 'Reservoir where fluid flow is controlled by fault systems providing permeability pathways.'}, + "MAGMATIC": {'description': 'Very high temperature reservoir near or in contact with magma bodies or recent intrusions.'}, + "CONDUCTION_DOMINATED": {'description': 'Low permeability reservoir where heat transfer is primarily through conduction rather than convection.'}, +} + +class GeothermalWellType(RichEnum): + """ + Types of wells used in geothermal energy development and production. + """ + # Enum members + PRODUCTION_WELL = "PRODUCTION_WELL" + INJECTION_WELL = "INJECTION_WELL" + EXPLORATION_WELL = "EXPLORATION_WELL" + OBSERVATION_WELL = "OBSERVATION_WELL" + SLIM_HOLE = "SLIM_HOLE" + DIRECTIONAL_WELL = "DIRECTIONAL_WELL" + +# Set metadata after class creation +GeothermalWellType._metadata = { + "PRODUCTION_WELL": {'description': 'Well used to extract geothermal fluids or steam from the reservoir.'}, + "INJECTION_WELL": {'description': 'Well used to return cooled geothermal fluids to the reservoir to maintain pressure and sustainability.', 'aliases': ['Reinjection Well']}, + "EXPLORATION_WELL": {'description': 'Well drilled to evaluate geothermal resource characteristics.', 'aliases': ['Wildcat Well']}, + "OBSERVATION_WELL": {'description': 'Well used to monitor reservoir conditions and pressure.', 'aliases': ['Monitoring Well']}, + "SLIM_HOLE": {'description': 'Smaller diameter well used for initial exploration and temperature gradient measurement.'}, + "DIRECTIONAL_WELL": {'description': 'Well drilled at an angle to access reservoir from offset surface location or increase reservoir contact.'}, +} + +class GeothermalApplication(RichEnum): + """ + Applications and uses of geothermal energy. + """ + # Enum members + ELECTRICITY_GENERATION = "ELECTRICITY_GENERATION" + DIRECT_USE_HEATING = "DIRECT_USE_HEATING" + GREENHOUSE_HEATING = "GREENHOUSE_HEATING" + AQUACULTURE = "AQUACULTURE" + INDUSTRIAL_PROCESS_HEAT = "INDUSTRIAL_PROCESS_HEAT" + FOOD_PROCESSING = "FOOD_PROCESSING" + BATHING_RECREATION = "BATHING_RECREATION" + LITHIUM_EXTRACTION = "LITHIUM_EXTRACTION" + +# Set metadata after class creation +GeothermalApplication._metadata = { + "ELECTRICITY_GENERATION": {'description': 'Use of geothermal resources for power generation through steam turbines or binary cycle plants.', 'meaning': 'ENVO:2000034'}, + "DIRECT_USE_HEATING": {'description': 'Direct use of geothermal heat for space heating, district heating, or industrial processes.'}, + "GREENHOUSE_HEATING": {'description': 'Use of geothermal heat for agricultural greenhouses.'}, + "AQUACULTURE": {'description': 'Use of geothermal heat for fish farming and aquaculture.'}, + "INDUSTRIAL_PROCESS_HEAT": {'description': 'Use of geothermal heat for industrial manufacturing processes.'}, + "FOOD_PROCESSING": {'description': 'Use of geothermal heat for food drying, pasteurization, and processing.'}, + "BATHING_RECREATION": {'description': 'Use of geothermal waters for spas, pools, and recreation.'}, + "LITHIUM_EXTRACTION": {'description': 'Extraction of lithium and other minerals from geothermal brines as a co-product of energy production.', 'annotations': {'co_production': True}}, +} + +class GeothermalResourceTemperature(RichEnum): + """ + Classification of geothermal resources by temperature range. + """ + # Enum members + LOW_TEMPERATURE = "LOW_TEMPERATURE" + MODERATE_TEMPERATURE = "MODERATE_TEMPERATURE" + HIGH_TEMPERATURE = "HIGH_TEMPERATURE" + SUPERCRITICAL = "SUPERCRITICAL" + +# Set metadata after class creation +GeothermalResourceTemperature._metadata = { + "LOW_TEMPERATURE": {'description': 'Geothermal resource below 90C, suitable for direct use applications.', 'annotations': {'temperature_max_c': 90}}, + "MODERATE_TEMPERATURE": {'description': 'Geothermal resource 90-150C, suitable for binary power generation.', 'annotations': {'temperature_min_c': 90, 'temperature_max_c': 150}}, + "HIGH_TEMPERATURE": {'description': 'Geothermal resource above 150C, suitable for flash steam power generation.', 'annotations': {'temperature_min_c': 150}}, + "SUPERCRITICAL": {'description': 'Very high temperature resource above 374C where water exists in supercritical state.', 'annotations': {'temperature_min_c': 374}}, +} + +__all__ = [ + "GeothermalSystemType", + "GeothermalReservoirType", + "GeothermalWellType", + "GeothermalApplication", + "GeothermalResourceTemperature", +] \ No newline at end of file diff --git a/src/valuesets/enums/energy/renewable/hydrogen.py b/src/valuesets/enums/energy/renewable/hydrogen.py new file mode 100644 index 00000000..aa7d3eaf --- /dev/null +++ b/src/valuesets/enums/energy/renewable/hydrogen.py @@ -0,0 +1,134 @@ +""" +Hydrogen Energy Value Sets + +Value sets for hydrogen production, storage, and utilization. Includes the color-coded hydrogen classification system used by industry. Based on DOE Hydrogen and Fuel Cell Technologies Office terminology. + +Generated from: energy/renewable/hydrogen.yaml +""" + +from __future__ import annotations + +from valuesets.generators.rich_enum import RichEnum + +class HydrogenType(RichEnum): + """ + Color-coded classification of hydrogen based on production method and carbon intensity. This informal industry taxonomy differentiates hydrogen by its carbon footprint and energy source. + """ + # Enum members + GREEN_HYDROGEN = "GREEN_HYDROGEN" + BLUE_HYDROGEN = "BLUE_HYDROGEN" + GREY_HYDROGEN = "GREY_HYDROGEN" + BROWN_HYDROGEN = "BROWN_HYDROGEN" + BLACK_HYDROGEN = "BLACK_HYDROGEN" + PINK_HYDROGEN = "PINK_HYDROGEN" + TURQUOISE_HYDROGEN = "TURQUOISE_HYDROGEN" + WHITE_HYDROGEN = "WHITE_HYDROGEN" + YELLOW_HYDROGEN = "YELLOW_HYDROGEN" + ORANGE_HYDROGEN = "ORANGE_HYDROGEN" + +# Set metadata after class creation +HydrogenType._metadata = { + "GREEN_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by renewable energy sources (solar, wind, hydro). Zero carbon emissions during production.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'renewable', 'carbon_intensity': 'zero'}, 'aliases': ['Renewable Hydrogen']}, + "BLUE_HYDROGEN": {'description': 'Hydrogen produced from natural gas via steam methane reforming (SMR) with carbon capture and storage (CCS). Low carbon intensity.', 'annotations': {'production_method': 'steam_methane_reforming', 'energy_source': 'natural_gas', 'carbon_intensity': 'low', 'requires_ccs': True}}, + "GREY_HYDROGEN": {'description': 'Hydrogen produced from natural gas via steam methane reforming without carbon capture. Most common production method currently.', 'annotations': {'production_method': 'steam_methane_reforming', 'energy_source': 'natural_gas', 'carbon_intensity': 'high', 'co2_per_kg_h2': '9-12'}, 'aliases': ['Gray Hydrogen']}, + "BROWN_HYDROGEN": {'description': 'Hydrogen produced from brown coal (lignite) gasification without carbon capture. High carbon intensity.', 'annotations': {'production_method': 'coal_gasification', 'energy_source': 'lignite', 'carbon_intensity': 'very_high'}}, + "BLACK_HYDROGEN": {'description': 'Hydrogen produced from black coal (bituminous) gasification without carbon capture. High carbon intensity.', 'annotations': {'production_method': 'coal_gasification', 'energy_source': 'bituminous_coal', 'carbon_intensity': 'very_high'}}, + "PINK_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by nuclear energy. Zero carbon emissions during production.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'nuclear', 'carbon_intensity': 'zero'}, 'aliases': ['Purple Hydrogen', 'Red Hydrogen']}, + "TURQUOISE_HYDROGEN": {'description': 'Hydrogen produced via methane pyrolysis, producing solid carbon instead of CO2. Lower carbon intensity than grey hydrogen.', 'annotations': {'production_method': 'methane_pyrolysis', 'energy_source': 'natural_gas', 'carbon_intensity': 'low', 'byproduct': 'solid_carbon'}}, + "WHITE_HYDROGEN": {'description': 'Naturally occurring geological hydrogen found in underground deposits. Zero production emissions.', 'annotations': {'production_method': 'geological_extraction', 'energy_source': 'natural', 'carbon_intensity': 'zero'}, 'aliases': ['Natural Hydrogen', 'Geological Hydrogen', 'Gold Hydrogen']}, + "YELLOW_HYDROGEN": {'description': 'Hydrogen produced via electrolysis powered by solar energy specifically. A subset of green hydrogen.', 'annotations': {'production_method': 'electrolysis', 'energy_source': 'solar', 'carbon_intensity': 'zero'}}, + "ORANGE_HYDROGEN": {'description': 'Hydrogen produced from plastic waste gasification or pyrolysis. Emerging technology addressing both energy and waste challenges.', 'annotations': {'production_method': 'waste_gasification', 'energy_source': 'plastic_waste', 'carbon_intensity': 'varies'}}, +} + +class HydrogenProductionMethod(RichEnum): + """ + Methods and processes for producing hydrogen. + """ + # Enum members + STEAM_METHANE_REFORMING = "STEAM_METHANE_REFORMING" + AUTOTHERMAL_REFORMING = "AUTOTHERMAL_REFORMING" + PARTIAL_OXIDATION = "PARTIAL_OXIDATION" + COAL_GASIFICATION = "COAL_GASIFICATION" + WATER_ELECTROLYSIS = "WATER_ELECTROLYSIS" + ALKALINE_ELECTROLYSIS = "ALKALINE_ELECTROLYSIS" + PEM_ELECTROLYSIS = "PEM_ELECTROLYSIS" + SOLID_OXIDE_ELECTROLYSIS = "SOLID_OXIDE_ELECTROLYSIS" + METHANE_PYROLYSIS = "METHANE_PYROLYSIS" + BIOMASS_GASIFICATION = "BIOMASS_GASIFICATION" + BIOLOGICAL_PRODUCTION = "BIOLOGICAL_PRODUCTION" + THERMOCHEMICAL_WATER_SPLITTING = "THERMOCHEMICAL_WATER_SPLITTING" + PHOTOELECTROCHEMICAL = "PHOTOELECTROCHEMICAL" + +# Set metadata after class creation +HydrogenProductionMethod._metadata = { + "STEAM_METHANE_REFORMING": {'description': 'High temperature steam reacts with methane to produce hydrogen, carbon monoxide, and carbon dioxide.', 'annotations': {'feedstock': 'natural_gas', 'temperature_c': '700-1000', 'dominant_method': True}, 'aliases': ['SMR']}, + "AUTOTHERMAL_REFORMING": {'description': 'Combines steam reforming and partial oxidation using oxygen and steam to produce hydrogen from hydrocarbons.', 'aliases': ['ATR']}, + "PARTIAL_OXIDATION": {'description': 'Exothermic process reacting hydrocarbons with limited oxygen to produce hydrogen and carbon monoxide.', 'aliases': ['POX']}, + "COAL_GASIFICATION": {'description': 'Conversion of coal to syngas (hydrogen and carbon monoxide) using high temperature and steam.', 'meaning': 'CHMO:0001501'}, + "WATER_ELECTROLYSIS": {'description': 'Splitting water into hydrogen and oxygen using electrical current. Can be powered by various energy sources.', 'aliases': ['Electrolysis']}, + "ALKALINE_ELECTROLYSIS": {'description': 'Electrolysis using alkaline solution (typically KOH) as electrolyte. Mature commercial technology.', 'annotations': {'electrolyte': 'alkaline', 'maturity': 'commercial'}, 'aliases': ['AEL']}, + "PEM_ELECTROLYSIS": {'description': 'Proton Exchange Membrane electrolysis using solid polymer electrolyte. Higher efficiency, faster response.', 'annotations': {'electrolyte': 'polymer_membrane', 'maturity': 'commercial'}, 'aliases': ['PEMEC', 'Polymer Electrolyte Membrane Electrolysis']}, + "SOLID_OXIDE_ELECTROLYSIS": {'description': 'High temperature electrolysis using solid ceramic electrolyte. Higher efficiency when waste heat is available.', 'annotations': {'electrolyte': 'solid_oxide', 'temperature_c': '700-850', 'maturity': 'emerging'}, 'aliases': ['SOEC']}, + "METHANE_PYROLYSIS": {'description': 'Thermal decomposition of methane into hydrogen and solid carbon without oxygen. Produces no direct CO2.', 'annotations': {'feedstock': 'natural_gas', 'byproduct': 'solid_carbon'}, 'aliases': ['Thermal Cracking']}, + "BIOMASS_GASIFICATION": {'description': 'Thermochemical conversion of biomass to hydrogen-rich syngas at high temperatures.', 'annotations': {'feedstock': 'biomass', 'renewable': True}}, + "BIOLOGICAL_PRODUCTION": {'description': 'Production of hydrogen by microorganisms through photosynthesis, fermentation, or other biological processes.', 'annotations': {'renewable': True, 'maturity': 'research'}, 'aliases': ['Biohydrogen']}, + "THERMOCHEMICAL_WATER_SPLITTING": {'description': 'Using high temperatures from concentrated solar or nuclear to drive chemical cycles that split water.', 'annotations': {'temperature_c': '500-2000', 'maturity': 'research'}}, + "PHOTOELECTROCHEMICAL": {'description': 'Direct conversion of sunlight to hydrogen using specialized semiconductor materials in contact with water.', 'annotations': {'maturity': 'research'}, 'aliases': ['PEC']}, +} + +class HydrogenStorageMethod(RichEnum): + """ + Methods for storing hydrogen for later use or transport. + """ + # Enum members + COMPRESSED_GAS = "COMPRESSED_GAS" + LIQUID_HYDROGEN = "LIQUID_HYDROGEN" + METAL_HYDRIDE = "METAL_HYDRIDE" + CHEMICAL_HYDRIDE = "CHEMICAL_HYDRIDE" + UNDERGROUND_STORAGE = "UNDERGROUND_STORAGE" + CRYO_COMPRESSED = "CRYO_COMPRESSED" + +# Set metadata after class creation +HydrogenStorageMethod._metadata = { + "COMPRESSED_GAS": {'description': 'Storage of hydrogen as compressed gas at high pressure (350-700 bar) in pressure vessels.', 'annotations': {'pressure_bar': '350-700', 'maturity': 'commercial'}, 'aliases': ['CGH2']}, + "LIQUID_HYDROGEN": {'description': 'Storage of hydrogen in liquid form at cryogenic temperatures (-253C). Higher energy density but requires insulation.', 'annotations': {'temperature_c': -253, 'maturity': 'commercial'}, 'aliases': ['LH2']}, + "METAL_HYDRIDE": {'description': 'Storage of hydrogen absorbed into metal alloys forming metal hydrides. Safer but heavier than compressed gas.', 'annotations': {'maturity': 'commercial'}}, + "CHEMICAL_HYDRIDE": {'description': 'Storage as chemical compounds (ammonia, methanol, LOHC) that release hydrogen when processed.', 'aliases': ['LOHC', 'Liquid Organic Hydrogen Carrier']}, + "UNDERGROUND_STORAGE": {'description': 'Large-scale storage in salt caverns, depleted gas fields, or aquifers for grid-scale applications.', 'annotations': {'scale': 'utility'}, 'aliases': ['Geological Storage']}, + "CRYO_COMPRESSED": {'description': 'Hybrid approach combining cryogenic cooling with high pressure for improved density.', 'annotations': {'maturity': 'emerging'}, 'aliases': ['CcH2']}, +} + +class HydrogenApplication(RichEnum): + """ + End-use applications for hydrogen. + """ + # Enum members + FUEL_CELL_VEHICLE = "FUEL_CELL_VEHICLE" + FUEL_CELL_STATIONARY = "FUEL_CELL_STATIONARY" + INDUSTRIAL_FEEDSTOCK = "INDUSTRIAL_FEEDSTOCK" + STEEL_PRODUCTION = "STEEL_PRODUCTION" + AMMONIA_SYNTHESIS = "AMMONIA_SYNTHESIS" + METHANOL_SYNTHESIS = "METHANOL_SYNTHESIS" + POWER_TO_GAS = "POWER_TO_GAS" + BLENDING_NATURAL_GAS = "BLENDING_NATURAL_GAS" + SYNTHETIC_FUELS = "SYNTHETIC_FUELS" + +# Set metadata after class creation +HydrogenApplication._metadata = { + "FUEL_CELL_VEHICLE": {'description': 'Use of hydrogen in fuel cells for transportation (cars, trucks, buses).', 'aliases': ['FCEV']}, + "FUEL_CELL_STATIONARY": {'description': 'Use of hydrogen in stationary fuel cells for power generation.'}, + "INDUSTRIAL_FEEDSTOCK": {'description': 'Use of hydrogen as chemical feedstock for ammonia production, petroleum refining, and chemical synthesis.', 'meaning': 'CHEBI:18276'}, + "STEEL_PRODUCTION": {'description': 'Use of hydrogen to reduce iron ore in steelmaking, replacing coal.', 'aliases': ['Green Steel']}, + "AMMONIA_SYNTHESIS": {'description': 'Use of hydrogen with nitrogen to produce ammonia for fertilizers.'}, + "METHANOL_SYNTHESIS": {'description': 'Use of hydrogen with CO2 to produce methanol.'}, + "POWER_TO_GAS": {'description': 'Conversion of excess renewable electricity to hydrogen for grid balancing and energy storage.', 'aliases': ['P2G']}, + "BLENDING_NATURAL_GAS": {'description': 'Blending hydrogen into natural gas pipelines for decarbonization of heating.'}, + "SYNTHETIC_FUELS": {'description': 'Use of hydrogen with captured CO2 to produce synthetic hydrocarbons (e-fuels, SAF).', 'aliases': ['E-Fuels', 'Power-to-Liquid']}, +} + +__all__ = [ + "HydrogenType", + "HydrogenProductionMethod", + "HydrogenStorageMethod", + "HydrogenApplication", +] \ No newline at end of file diff --git a/src/valuesets/schema/bio/structural_biology.yaml b/src/valuesets/schema/bio/structural_biology.yaml index f3cfc66d..1f89ac19 100644 --- a/src/valuesets/schema/bio/structural_biology.yaml +++ b/src/valuesets/schema/bio/structural_biology.yaml @@ -14,6 +14,11 @@ prefixes: CHMO: http://purl.obolibrary.org/obo/CHMO_ NCIT: http://purl.obolibrary.org/obo/NCIT_ MOP: http://purl.obolibrary.org/obo/MOP_ + MOD: http://purl.obolibrary.org/obo/MOD_ + MI: http://purl.obolibrary.org/obo/MI_ + FBbi: http://purl.obolibrary.org/obo/FBbi_ + GO: http://purl.obolibrary.org/obo/GO_ + ECO: http://purl.obolibrary.org/obo/ECO_ valuesets: https://w3id.org/valuesets/ orcid: https://orcid.org/ valuesets_meta: https://w3id.org/valuesets/meta/ @@ -77,20 +82,28 @@ enums: permissible_values: PROTEIN: description: Purified protein sample + meaning: NCIT:C17021 NUCLEIC_ACID: description: Nucleic acid sample (DNA or RNA) + meaning: NCIT:C813 PROTEIN_COMPLEX: description: Protein-protein or protein-nucleic acid complex + meaning: GO:0032991 MEMBRANE_PROTEIN: description: Membrane-associated protein sample + meaning: NCIT:C16837 VIRUS: description: Viral particle or capsid + meaning: NCIT:C14283 ORGANELLE: description: Cellular organelle (mitochondria, chloroplast, etc.) + meaning: GO:0043226 CELL: description: Whole cell sample + meaning: NCIT:C12508 TISSUE: description: Tissue sample + meaning: NCIT:C12801 StructuralBiologyTechnique: title: Structural Biology Technique description: Structural biology experimental techniques @@ -109,7 +122,9 @@ enums: resolution_range: 2-30 Å typical aliases: cryoEM, electron cryo-microscopy CRYO_ET: + title: electron tomography description: Cryo-electron tomography + meaning: MI:2338 annotations: resolution_range: 20-100 Å typical aliases: cryoET, electron cryo-tomography @@ -121,7 +136,9 @@ enums: resolution_range: 1-4 Å typical aliases: XRC, macromolecular crystallography NEUTRON_CRYSTALLOGRAPHY: + title: neutron diffraction description: Neutron crystallography + meaning: CHMO:0000175 annotations: advantages: hydrogen positions, deuteration studies SAXS: @@ -131,11 +148,15 @@ enums: annotations: information: low-resolution structure, conformational changes SANS: + title: small-angle neutron scattering description: Small-angle neutron scattering + meaning: CHMO:0000184 annotations: advantages: contrast variation with deuteration WAXS: + title: wide-angle X-ray scattering description: Wide-angle X-ray scattering + meaning: CHMO:0000213 NMR: title: nuclear magnetic resonance spectroscopy description: Nuclear magnetic resonance spectroscopy @@ -148,7 +169,9 @@ enums: annotations: applications: native MS, crosslinking, HDX NEGATIVE_STAIN_EM: + title: negative staining electron microscopy description: Negative stain electron microscopy + meaning: FBbi:00000568 annotations: resolution_range: 15-30 Å typical CryoEMPreparationType: @@ -282,11 +305,15 @@ enums: permissible_values: SYNCHROTRON: description: Synchrotron radiation source + meaning: CHMO:0001810 + exact_mappings: + - NCIT:C48205 annotations: advantages: high intensity, tunable wavelength brightness: 10^15-10^18 photons/s/mm²/mrad² ROTATING_ANODE: description: Rotating anode generator + meaning: CHMO:0001107 annotations: power: 3-18 kW typical target: copper, molybdenum common @@ -312,15 +339,18 @@ enums: permissible_values: DIRECT_ELECTRON: description: Direct electron detector (DED) + meaning: CHMO:0002837 annotations: examples: K2, K3, Falcon, DE-series advantages: high DQE, fast readout CCD: description: Charge-coupled device camera + meaning: CHMO:0002171 annotations: applications: legacy EM, some crystallography CMOS: description: Complementary metal-oxide semiconductor detector + meaning: CHMO:0002836 annotations: advantages: fast readout, low noise HYBRID_PIXEL: @@ -330,6 +360,7 @@ enums: advantages: photon counting, zero noise PHOTOSTIMULABLE_PHOSPHOR: description: Photostimulable phosphor (image plate) + meaning: CHMO:0001069 annotations: applications: legacy crystallography WorkflowType: @@ -403,41 +434,53 @@ enums: permissible_values: MRC: description: MRC format for EM density maps + meaning: EDAM:3842 annotations: extension: .mrc, .map applications: EM volumes, tomograms TIFF: description: Tagged Image File Format + meaning: EDAM:3591 annotations: extension: .tif, .tiff applications: micrographs, general imaging HDF5: description: Hierarchical Data Format 5 + meaning: EDAM:3590 annotations: extension: .h5, .hdf5 applications: large datasets, metadata storage STAR: description: Self-defining Text Archival and Retrieval format + meaning: EDAM:3906 annotations: extension: .star applications: RELION metadata, particle parameters PDB: description: Protein Data Bank coordinate format + meaning: EDAM:1476 + exact_mappings: + - OBI:0001525 annotations: extension: .pdb applications: atomic coordinates, legacy format MMCIF: description: Macromolecular Crystallographic Information File + meaning: EDAM:1477 + exact_mappings: + - NCIT:C133997 annotations: extension: .cif applications: atomic coordinates, modern PDB format MTZ: description: MTZ reflection data format + meaning: EDAM:3816 annotations: extension: .mtz applications: crystallographic reflections, phases CBF: description: Crystallographic Binary Format + meaning: EDAM:3874 annotations: extension: .cbf applications: detector images, diffraction data @@ -558,9 +601,9 @@ enums: SQUARE_PLANAR: title: square planar molecular geometry description: Square planar coordination geometry (4 ligands in plane) + meaning: NCIT:C103211 annotations: coordination_number: '4' - ncit_variants: NCIT:C103211, NCIT:C103212, NCIT:C103213, NCIT:C103214 TRIGONAL_BIPYRAMIDAL: description: Trigonal bipyramidal coordination geometry (5 ligands) annotations: @@ -576,9 +619,9 @@ enums: OCTAHEDRAL: title: octahedral molecular geometry description: Octahedral coordination geometry (6 ligands) + meaning: NCIT:C103216 annotations: coordination_number: '6' - ncit_variants: NCIT:C103216, NCIT:C103217, NCIT:C103218 TRIGONAL_PRISMATIC: description: Trigonal prismatic coordination geometry (6 ligands) annotations: @@ -641,25 +684,36 @@ enums: permissible_values: METAL_COORDINATION: description: Metal coordination modification + meaning: MOD:00739 annotations: examples: zinc finger, iron-sulfur cluster binding PHOSPHORYLATION: description: Phosphorylation modification + meaning: MOD:00696 GLYCOSYLATION: description: Glycosylation modification + meaning: MOD:00725 ACETYLATION: description: Acetylation modification + meaning: MOD:00394 METHYLATION: description: Methylation modification + meaning: MOD:00599 UBIQUITINATION: description: Ubiquitination modification + meaning: MOD:01240 SUMOYLATION: description: SUMOylation modification + meaning: MOD:01149 HYDROXYLATION: description: Hydroxylation modification + meaning: MOD:00677 LIPIDATION: description: Lipidation modification + meaning: MOD:00435 PROTEOLYTIC_CLEAVAGE: description: Proteolytic cleavage + meaning: GO:0006508 CROSSLINKING: description: Crosslinking modification + meaning: MOD:00276 diff --git a/src/valuesets/schema/energy/energy.yaml b/src/valuesets/schema/energy/energy.yaml index e65b0584..660f5981 100644 --- a/src/valuesets/schema/energy/energy.yaml +++ b/src/valuesets/schema/energy/energy.yaml @@ -10,8 +10,13 @@ prefixes: QUDT: http://qudt.org/vocab/unit/ ENVO: http://purl.obolibrary.org/obo/ENVO_ CHEBI: http://purl.obolibrary.org/obo/CHEBI_ + OEO: http://openenergy-platform.org/ontology/oeo/OEO_ + brick: https://brickschema.org/schema/Brick# + sweet: http://sweetontology.net/ orcid: https://orcid.org/ valuesets_meta: https://w3id.org/valuesets/meta/ + wikidata: http://www.wikidata.org/entity/ + schema: http://schema.org/ default_prefix: valuesets slots: energy_source: @@ -35,6 +40,15 @@ slots: energy_storage: description: Types of energy storage systems range: EnergyStorageType + battery_type: + description: Types of battery technologies + range: BatteryType + pv_cell_type: + description: Types of photovoltaic cell technologies + range: PVCellType + pv_system_type: + description: Types of photovoltaic system installations + range: PVSystemType emission_scope: description: Greenhouse gas emission scopes (GHG Protocol) range: EmissionScope @@ -44,6 +58,9 @@ slots: electricity_market: description: Types of electricity markets and pricing range: ElectricityMarket + capability_status: + description: Operational status of a capability or facility + range: CapabilityStatus enums: EnergySource: title: Energy Source @@ -60,102 +77,160 @@ enums: aliases: - Solar radiation meaning: ENVO:01001862 + exact_mappings: + - OEO:00000384 + related_mappings: + - brick:Solar_Thermal_Collector annotations: renewable: true emission_free: true + oeo_label: solar energy + brick_label: Solar Thermal Collector WIND: title: Wind power aliases: - wind wave energy related_mappings: - ENVO:2000033 + broad_mappings: + - sweet:phenAtmoWind/Wind + exact_mappings: + - OEO:00000446 annotations: renewable: true emission_free: true + oeo_label: wind energy HYDROELECTRIC: title: Hydroelectric power aliases: - hydroelectric dam related_mappings: - ENVO:00000468 + exact_mappings: + - OEO:00000218 annotations: renewable: true emission_free: true + oeo_label: hydro energy GEOTHERMAL: title: Geothermal energy aliases: - geothermal energy meaning: ENVO:2000034 + close_mappings: + - sweet:phenEnergy/Geothermal + exact_mappings: + - OEO:00000191 annotations: renewable: true emission_free: true + oeo_label: geothermal energy BIOMASS: title: Biomass and bioenergy aliases: - organic material related_mappings: - ENVO:01000155 + close_mappings: + - sweet:matrBiomass/Biomass + exact_mappings: + - OEO:00010258 annotations: renewable: true emission_free: false + oeo_label: bioenergy BIOFUEL: title: Biofuels (ethanol, biodiesel) + close_mappings: + - sweet:matrEnergy/Biofuel + exact_mappings: + - OEO:00000072 annotations: renewable: true emission_free: false + oeo_label: biofuel TIDAL: title: Tidal and wave energy + close_mappings: + - OEO:00010100 + - OEO:00010102 annotations: renewable: true emission_free: true + oeo_label: marine tidal energy, marine wave energy HYDROGEN: title: Hydrogen fuel aliases: - dihydrogen meaning: CHEBI:18276 + broad_mappings: + - sweet:matrElement/Hydrogen + exact_mappings: + - OEO:00000220 annotations: renewable: depends emission_free: true + oeo_label: hydrogen COAL: title: Coal meaning: ENVO:02000091 + close_mappings: + - sweet:matrNaturalResource/Coal + exact_mappings: + - OEO:00000088 annotations: renewable: false emission_free: false fossil_fuel: true + oeo_label: coal NATURAL_GAS: title: Natural gas meaning: ENVO:01000552 + close_mappings: + - sweet:matrNaturalResource/NaturalGas + exact_mappings: + - OEO:00000292 annotations: renewable: false emission_free: false fossil_fuel: true + oeo_label: natural gas PETROLEUM: title: Petroleum/oil meaning: ENVO:00002984 + close_mappings: + - sweet:matrNaturalResource/Petroleum + - OEO:00000115 annotations: renewable: false emission_free: false fossil_fuel: true + oeo_label: crude oil DIESEL: title: Diesel fuel aliases: - diesel fuel meaning: ENVO:03510006 + exact_mappings: + - OEO:00010242 annotations: renewable: false emission_free: false fossil_fuel: true + oeo_label: diesel fuel GASOLINE: title: Gasoline/petrol aliases: - fuel oil related_mappings: - ENVO:00002983 + exact_mappings: + - OEO:00010241 annotations: renewable: false emission_free: false fossil_fuel: true + oeo_label: gasoline fuel PROPANE: title: Propane/LPG aliases: @@ -173,9 +248,12 @@ enums: - ENVO:2000025 exact_mappings: - CHEBI:35231 + close_mappings: + - OEO:00000302 annotations: renewable: false emission_free: true + oeo_label: nuclear fuel NUCLEAR_FUSION: title: Nuclear fusion (experimental) aliases: @@ -187,12 +265,18 @@ enums: emission_free: true GRID_MIX: title: Grid electricity (mixed sources) + close_mappings: + - OEO:00000200 annotations: renewable: partial + oeo_label: supply grid BATTERY_STORAGE: description: Battery storage systems + close_mappings: + - OEO:00000068 annotations: storage: true + oeo_label: battery EnergyUnit: title: Energy Unit description: Units for measuring energy @@ -488,6 +572,10 @@ enums: permissible_values: MAIN_GRID: description: Main utility grid + exact_mappings: + - OEO:00000200 + annotations: + oeo_label: supply grid MICROGRID: description: Microgrid OFF_GRID: @@ -498,44 +586,314 @@ enums: description: Mini-grid VIRTUAL_POWER_PLANT: description: Virtual power plant - EnergyStorageType: - title: Energy Storage Type - description: Types of energy storage systems + BatteryType: + title: Battery Type + description: Types of battery technologies for energy storage status: DRAFT contributors: - orcid:0000-0002-6601-2165 - https://github.com/anthropics/claude-code instantiates: - valuesets_meta:ValueSetEnumDefinition + exact_mappings: + - OEO:00000068 + - brick:Battery permissible_values: - LITHIUM_ION_BATTERY: + LITHIUM_ION: description: Lithium-ion battery + aliases: + - Li-ion + - LIB annotations: - category: electrochemical - LEAD_ACID_BATTERY: + chemistry: lithium + LITHIUM_IRON_PHOSPHATE: + description: Lithium iron phosphate (LFP) battery + aliases: + - LFP + - LiFePO4 + annotations: + chemistry: lithium + LITHIUM_POLYMER: + description: Lithium polymer battery + aliases: + - LiPo + annotations: + chemistry: lithium + LEAD_ACID: description: Lead-acid battery + aliases: + - Pb-acid annotations: - category: electrochemical - FLOW_BATTERY: - description: Flow battery (e.g., vanadium redox) + chemistry: lead + NICKEL_METAL_HYDRIDE: + description: Nickel-metal hydride battery + aliases: + - NiMH annotations: - category: electrochemical - SOLID_STATE_BATTERY: - description: Solid-state battery + chemistry: nickel + NICKEL_CADMIUM: + description: Nickel-cadmium battery + aliases: + - NiCd annotations: - category: electrochemical - SODIUM_ION_BATTERY: + chemistry: nickel + SODIUM_ION: description: Sodium-ion battery + aliases: + - Na-ion + annotations: + chemistry: sodium + SOLID_STATE: + description: Solid-state battery + annotations: + chemistry: various + VANADIUM_REDOX_FLOW: + description: Vanadium redox flow battery + aliases: + - VRB + - VRFB + annotations: + chemistry: vanadium + type: flow + ZINC_BROMINE_FLOW: + description: Zinc-bromine flow battery + aliases: + - ZnBr + annotations: + chemistry: zinc + type: flow + IRON_AIR: + description: Iron-air battery + annotations: + chemistry: iron + ZINC_AIR: + description: Zinc-air battery + annotations: + chemistry: zinc + PVCellType: + title: Photovoltaic Cell Type + description: Types of photovoltaic cell technologies + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - OEO:00000348 + permissible_values: + MONOCRYSTALLINE_SILICON: + description: Monocrystalline silicon (mono-Si) cells + aliases: + - mono-Si + - single-crystal silicon + related_mappings: + - CHEBI:27573 + annotations: + material: silicon + efficiency_range: 17-22% + POLYCRYSTALLINE_SILICON: + description: Polycrystalline silicon (poly-Si) cells + aliases: + - poly-Si + - multi-crystalline silicon + related_mappings: + - CHEBI:27573 + annotations: + material: silicon + efficiency_range: 15-17% + PASSIVATED_EMITTER_REAR_CELL: + description: Passivated Emitter and Rear Cell (PERC) + aliases: + - PERC + annotations: + material: silicon + efficiency_range: 19-22% + HETEROJUNCTION: + description: Heterojunction (HJT) cells + aliases: + - HJT + - HIT + annotations: + material: silicon + efficiency_range: 21-24% + TUNNEL_OXIDE_PASSIVATED_CONTACT: + description: Tunnel Oxide Passivated Contact (TOPCon) cells + aliases: + - TOPCon + annotations: + material: silicon + efficiency_range: 22-24% + INTERDIGITATED_BACK_CONTACT: + description: Interdigitated Back Contact (IBC) cells + aliases: + - IBC + annotations: + material: silicon + efficiency_range: 22-24% + CADMIUM_TELLURIDE: + description: Cadmium telluride (CdTe) thin-film cells + aliases: + - CdTe + exact_mappings: + - CHEBI:232800 + annotations: + material: cadmium_telluride + type: thin-film + efficiency_range: 16-18% + COPPER_INDIUM_GALLIUM_SELENIDE: + description: Copper indium gallium selenide (CIGS) thin-film cells + aliases: + - CIGS + - CIS + annotations: + material: CIGS + type: thin-film + efficiency_range: 15-20% + AMORPHOUS_SILICON: + description: Amorphous silicon (a-Si) thin-film cells + aliases: + - a-Si + related_mappings: + - CHEBI:27573 + annotations: + material: silicon + type: thin-film + efficiency_range: 6-8% + GALLIUM_ARSENIDE: + description: Gallium arsenide (GaAs) cells + aliases: + - GaAs + annotations: + material: gallium_arsenide + efficiency_range: 25-30% + application: space, concentrator + PEROVSKITE: + description: Perovskite solar cells + annotations: + material: perovskite + efficiency_range: 20-25% + status: emerging + ORGANIC: + description: Organic photovoltaic (OPV) cells + aliases: + - OPV + annotations: + material: organic + type: thin-film + efficiency_range: 10-15% + status: emerging + TANDEM: + description: Tandem/multi-junction cells + aliases: + - multi-junction + annotations: + efficiency_range: 25-35% + PVSystemType: + title: Photovoltaic System Type + description: Types of photovoltaic system installations + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + exact_mappings: + - OEO:00000324 + permissible_values: + ROOFTOP_RESIDENTIAL: + description: Residential rooftop PV system + broad_mappings: + - OEO:00000361 + annotations: + scale: residential + mounting: rooftop + ROOFTOP_COMMERCIAL: + description: Commercial/industrial rooftop PV system + broad_mappings: + - OEO:00000361 + annotations: + scale: commercial + mounting: rooftop + GROUND_MOUNTED: + description: Ground-mounted utility-scale PV system + exact_mappings: + - OEO:00000165 + annotations: + scale: utility + mounting: ground + FLOATING: + description: Floating PV system (floatovoltaics) + aliases: + - floatovoltaics + - FPV + annotations: + scale: utility + mounting: floating + BUILDING_INTEGRATED: + description: Building-integrated PV (BIPV) + aliases: + - BIPV + annotations: + mounting: integrated + AGRIVOLTAICS: + description: Agrivoltaic system (dual-use with agriculture) + aliases: + - agrophotovoltaics + - APV + annotations: + scale: utility + dual_use: agriculture + CARPORT: + description: Solar carport/parking canopy + annotations: + mounting: canopy + dual_use: parking + TRACKER_SINGLE_AXIS: + description: Single-axis tracking system + annotations: + tracking: single_axis + TRACKER_DUAL_AXIS: + description: Dual-axis tracking system + annotations: + tracking: dual_axis + CONCENTRATING: + description: Concentrating PV (CPV) system + aliases: + - CPV + annotations: + type: concentrating + EnergyStorageType: + title: Energy Storage Type + description: Types of energy storage systems (categories) + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + BATTERY: + description: Battery storage (see BatteryType for specific chemistries) + exact_mappings: + - OEO:00000068 + - brick:Battery annotations: category: electrochemical PUMPED_HYDRO: description: Pumped hydroelectric storage + exact_mappings: + - OEO:00010089 annotations: category: mechanical + oeo_label: pumped hydro storage power plant COMPRESSED_AIR: description: Compressed air energy storage (CAES) + close_mappings: + - OEO:00000102 annotations: category: mechanical + oeo_label: compressed air FLYWHEEL: description: Flywheel energy storage annotations: @@ -558,12 +916,18 @@ enums: category: thermal HYDROGEN_STORAGE: description: Hydrogen storage + close_mappings: + - OEO:00000220 annotations: category: chemical + oeo_label: hydrogen SYNTHETIC_FUEL: description: Synthetic fuel storage + close_mappings: + - OEO:00010017 annotations: category: chemical + oeo_label: synthetic fuel SUPERCAPACITOR: description: Supercapacitor annotations: @@ -581,27 +945,45 @@ enums: - https://github.com/anthropics/claude-code instantiates: - valuesets_meta:ValueSetEnumDefinition + see_also: + - OEO:00000147 + - OEO:00000020 permissible_values: SCOPE_1: description: Direct emissions from owned or controlled sources + related_mappings: + - OEO:00000199 annotations: ghg_protocol: Scope 1 + oeo_label: greenhouse gas emission SCOPE_2: description: Indirect emissions from purchased energy + related_mappings: + - OEO:00000199 annotations: ghg_protocol: Scope 2 + oeo_label: greenhouse gas emission SCOPE_3: description: All other indirect emissions in value chain + related_mappings: + - OEO:00000199 annotations: ghg_protocol: Scope 3 + oeo_label: greenhouse gas emission SCOPE_3_UPSTREAM: description: Upstream Scope 3 emissions + related_mappings: + - OEO:00000199 annotations: ghg_protocol: Scope 3 + oeo_label: greenhouse gas emission SCOPE_3_DOWNSTREAM: description: Downstream Scope 3 emissions + related_mappings: + - OEO:00000199 annotations: ghg_protocol: Scope 3 + oeo_label: greenhouse gas emission CarbonIntensity: title: Carbon Intensity description: Carbon intensity levels for energy sources @@ -666,3 +1048,62 @@ enums: description: Net metering POWER_PURCHASE_AGREEMENT: description: Power purchase agreement (PPA) + CapabilityStatus: + title: Capability Status + description: >- + Operational status of a capability, facility, or infrastructure. + Applicable to energy facilities, research capabilities, and other + infrastructure throughout their lifecycle. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - https://www.wikidata.org/wiki/Property:P5817 + - https://www.iaea.org/topics/nuclear-power-plant-life-cycle + - https://schema.org/ItemAvailability + - https://www.iso.org/standard/83053.html + permissible_values: + OPERATIONAL: + title: Operational + description: Fully operational and available to users + exact_mappings: + - wikidata:Q55654238 + annotations: + wikidata_label: in use + lifecycle_phase: operation + COMING_ONLINE: + title: Coming Online + description: Being commissioned, coming online soon + related_mappings: + - wikidata:Q811686 + annotations: + wikidata_label: building process + lifecycle_phase: commissioning + iaea_equivalent: commissioning + PILOT: + title: Pilot + description: In pilot phase with limited access + related_mappings: + - schema:LimitedAvailability + annotations: + availability: limited + lifecycle_phase: testing + UNDER_DEVELOPMENT: + title: Under Development + description: Under development, not yet available + exact_mappings: + - wikidata:Q811683 + annotations: + wikidata_label: proposed building or structure + lifecycle_phase: planning/construction + DECOMMISSIONED: + title: Decommissioned + description: No longer available, permanently shut down + related_mappings: + - schema:Discontinued + annotations: + lifecycle_phase: end-of-life + iaea_equivalent: decommissioned diff --git a/src/valuesets/schema/energy/renewable/bioenergy.yaml b/src/valuesets/schema/energy/renewable/bioenergy.yaml new file mode 100644 index 00000000..b62890a2 --- /dev/null +++ b/src/valuesets/schema/energy/renewable/bioenergy.yaml @@ -0,0 +1,502 @@ +name: bioenergy +title: Bioenergy and Biofuels Value Sets +description: >- + Value sets for bioenergy feedstocks, biofuels, and conversion processes. + Based on DOE Bioenergy Technologies Office terminology and glossary. +id: https://w3id.org/linkml/valuesets/energy/renewable/bioenergy +imports: +- linkml:types +prefixes: + linkml: https://w3id.org/linkml/ + valuesets: https://w3id.org/valuesets/ + CHEBI: http://purl.obolibrary.org/obo/CHEBI_ + ENVO: http://purl.obolibrary.org/obo/ENVO_ + AGRO: http://purl.obolibrary.org/obo/AGRO_ + CHMO: http://purl.obolibrary.org/obo/CHMO_ + NCIT: http://purl.obolibrary.org/obo/NCIT_ + TO: http://purl.obolibrary.org/obo/TO_ + MESH: http://id.nlm.nih.gov/mesh/ + sweet: http://sweetontology.net/ + orcid: https://orcid.org/ + valuesets_meta: https://w3id.org/valuesets/meta/ +default_prefix: valuesets +slots: + biomass_feedstock_type: + description: Type of biomass feedstock for bioenergy production + range: BiomassFeedstockType + biofuel_type: + description: Type of biofuel product + range: BiofuelType + biofuel_generation: + description: Generation classification of biofuel + range: BiofuelGeneration + bioconversion_process: + description: Process for converting biomass to biofuel + range: BioconversionProcess +enums: + BiomassFeedstockType: + title: Biomass Feedstock Type + description: >- + Types of biomass materials used as feedstocks for bioenergy production. + Includes dedicated energy crops, agricultural residues, forest residues, + and waste streams. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - https://www.energy.gov/eere/bioenergy/feedstock-technologies + - https://www.energy.gov/eere/bioenergy/biomass-resources + permissible_values: + CORN_STOVER: + title: Corn Stover + description: >- + Agricultural residue consisting of leaves, stalks, and cobs + remaining after corn grain harvest. + aliases: + - Corn Residue + annotations: + category: agricultural_residue + lignocellulosic: true + WHEAT_STRAW: + title: Wheat Straw + description: Agricultural residue remaining after wheat grain harvest. + annotations: + category: agricultural_residue + lignocellulosic: true + RICE_STRAW: + title: Rice Straw + description: Agricultural residue remaining after rice grain harvest. + annotations: + category: agricultural_residue + lignocellulosic: true + SWITCHGRASS: + title: Switchgrass + description: >- + Perennial warm-season grass native to North America, cultivated + as dedicated energy crop for cellulosic biofuel production. + related_mappings: + - AGRO:00000325 + annotations: + category: energy_crop + lignocellulosic: true + perennial: true + MISCANTHUS: + title: Miscanthus + description: >- + High-yielding perennial grass cultivated as dedicated energy crop. + aliases: + - Elephant Grass + annotations: + category: energy_crop + lignocellulosic: true + perennial: true + ENERGY_CANE: + title: Energy Cane + description: >- + High-fiber sugarcane varieties bred for biomass production + rather than sugar content. + annotations: + category: energy_crop + lignocellulosic: true + SWEET_SORGHUM: + title: Sweet Sorghum + description: >- + Sorghum variety with high sugar content in stalks, suitable + for both sugar and lignocellulosic conversion. + annotations: + category: energy_crop + sugar_crop: true + POPLAR: + title: Poplar + description: >- + Fast-growing hardwood tree cultivated as short-rotation + woody crop for biomass. + aliases: + - Hybrid Poplar + annotations: + category: woody_crop + lignocellulosic: true + WILLOW: + title: Willow + description: >- + Fast-growing shrub cultivated as short-rotation woody crop. + aliases: + - Shrub Willow + annotations: + category: woody_crop + lignocellulosic: true + FOREST_RESIDUE: + title: Forest Residue + description: >- + Biomass from forest operations including logging residues, + thinning material, and salvage timber. + aliases: + - Logging Residue + related_mappings: + - AGRO:00000546 + broad_mappings: + - sweet:matrBiomass/Biomass + annotations: + category: forestry_residue + lignocellulosic: true + WOOD_PROCESSING_RESIDUE: + title: Wood Processing Residue + description: >- + Byproducts from wood processing including sawdust, bark, + shavings, and wood chips. + aliases: + - Mill Residue + annotations: + category: processing_residue + lignocellulosic: true + MUNICIPAL_SOLID_WASTE: + title: Municipal Solid Waste (Organic Fraction) + description: >- + Organic portion of municipal solid waste suitable for + bioenergy conversion. + aliases: + - MSW + related_mappings: + - ENVO:00002273 + annotations: + category: waste + FOOD_WASTE: + title: Food Waste + description: Waste food from residential, commercial, and industrial sources. + annotations: + category: wet_waste + ANIMAL_MANURE: + title: Animal Manure + description: >- + Livestock waste including cattle, swine, and poultry manure. + related_mappings: + - ENVO:00003031 + annotations: + category: wet_waste + biogas_suitable: true + ALGAE: + title: Algae + description: >- + Microalgae or macroalgae cultivated for lipid or carbohydrate + content for biofuel production. + aliases: + - Microalgae + annotations: + category: aquatic_biomass + lipid_rich: true + USED_COOKING_OIL: + title: Used Cooking Oil + description: Waste vegetable oils from food preparation. + aliases: + - UCO + - Waste Vegetable Oil + annotations: + category: waste + lipid_rich: true + SOYBEAN_OIL: + title: Soybean Oil + description: Vegetable oil from soybean seeds, used for biodiesel. + meaning: CHEBI:166975 + annotations: + category: oil_crop + lipid_rich: true + CORN_GRAIN: + title: Corn Grain + description: Corn kernels used for starch-based ethanol production. + annotations: + category: grain + starch_crop: true + SUGARCANE: + title: Sugarcane + description: Sugar-rich crop used for first-generation ethanol production. + annotations: + category: sugar_crop + BiofuelType: + title: Biofuel Type + description: Types of fuels produced from biomass feedstocks. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - https://www.energy.gov/eere/bioenergy/full-text-glossary + permissible_values: + ETHANOL: + title: Ethanol + description: >- + Alcohol biofuel (C2H5OH) produced by fermentation of sugars + or starches, or from cellulosic biomass. + meaning: CHEBI:16236 + aliases: + - Fuel Ethanol + - Bioethanol + close_mappings: + - sweet:matrEnergy/Ethanol + annotations: + chemical_formula: C2H5OH + BIODIESEL: + title: Biodiesel + description: >- + Fatty acid methyl esters (FAME) produced by transesterification + of vegetable oils or animal fats. + meaning: MESH:D056804 + aliases: + - FAME + close_mappings: + - sweet:matrEnergy/Biodiesel + annotations: + production_method: transesterification + RENEWABLE_DIESEL: + title: Renewable Diesel + description: >- + Hydrocarbon diesel produced by hydrotreating lipids. Chemically + identical to petroleum diesel. + aliases: + - Green Diesel + - HVO + - Hydrotreated Vegetable Oil + annotations: + drop_in_fuel: true + SUSTAINABLE_AVIATION_FUEL: + title: Sustainable Aviation Fuel (SAF) + description: >- + Jet fuel produced from biomass or waste, meeting aviation + fuel specifications. + aliases: + - SAF + - Biojet + annotations: + drop_in_fuel: true + BIOGAS: + title: Biogas + description: >- + Gaseous mixture of methane and CO2 produced by anaerobic + digestion of organic matter. + aliases: + - Raw Biogas + annotations: + methane_content_percent: 50-70 + BIOMETHANE: + title: Biomethane + description: >- + Purified biogas upgraded to natural gas quality (>95% methane). + aliases: + - Renewable Natural Gas + - RNG + broad_mappings: + - sweet:matrOrganicCompound/Methane + annotations: + methane_content_percent: 95+ + pipeline_quality: true + BIO_OIL: + title: Bio-Oil + description: >- + Liquid intermediate produced by pyrolysis or hydrothermal + liquefaction of biomass. + aliases: + - Pyrolysis Oil + annotations: + intermediate: true + SYNGAS: + title: Syngas (Bio-Based) + description: >- + Synthesis gas (CO + H2) produced by gasification of biomass. + meaning: CHMO:0001501 + aliases: + - Synthesis Gas + close_mappings: + - sweet:matrEnergy/Syngas + annotations: + intermediate: true + BUTANOL: + title: Biobutanol + description: >- + Four-carbon alcohol biofuel with higher energy density than ethanol. + meaning: CHEBI:28885 + annotations: + chemical_formula: C4H9OH + METHANOL: + title: Biomethanol + description: >- + Methanol produced from biomass-derived syngas. + meaning: CHEBI:17790 + annotations: + chemical_formula: CH3OH + DIMETHYL_ETHER: + title: Bio-DME + description: >- + Dimethyl ether produced from biomass, usable as diesel substitute. + aliases: + - DME + meaning: CHEBI:28887 + BiofuelGeneration: + title: Biofuel Generation + description: >- + Classification of biofuels by feedstock source and technology generation. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + FIRST_GENERATION: + title: First Generation Biofuel + description: >- + Biofuels produced from food crops (sugar, starch, vegetable oils) + using conventional conversion technologies. + aliases: + - 1G Biofuel + - Conventional Biofuel + annotations: + feedstock: food_crops + examples: corn_ethanol,soy_biodiesel + SECOND_GENERATION: + title: Second Generation Biofuel + description: >- + Biofuels produced from lignocellulosic biomass (non-food) + using advanced conversion technologies. + aliases: + - 2G Biofuel + - Cellulosic Biofuel + - Advanced Biofuel + annotations: + feedstock: lignocellulosic + examples: cellulosic_ethanol,wood_diesel + THIRD_GENERATION: + title: Third Generation Biofuel + description: >- + Biofuels produced from algae or other photosynthetic microorganisms. + aliases: + - 3G Biofuel + - Algal Biofuel + annotations: + feedstock: algae + FOURTH_GENERATION: + title: Fourth Generation Biofuel + description: >- + Biofuels from genetically engineered organisms designed for + carbon capture and enhanced fuel production. + aliases: + - 4G Biofuel + annotations: + feedstock: engineered_organisms + carbon_negative: true + BioconversionProcess: + title: Bioconversion Process + description: >- + Processes for converting biomass feedstocks into biofuels + and bioproducts. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + FERMENTATION: + title: Fermentation + description: >- + Biological conversion of sugars to alcohols using yeast + or bacteria. + annotations: + category: biochemical + products: ethanol,butanol + ANAEROBIC_DIGESTION: + title: Anaerobic Digestion + description: >- + Biological breakdown of organic matter by microorganisms + in the absence of oxygen, producing biogas. + annotations: + category: biochemical + products: biogas + TRANSESTERIFICATION: + title: Transesterification + description: >- + Chemical reaction of triglycerides with alcohol to produce + fatty acid esters (biodiesel) and glycerol. + annotations: + category: chemical + products: biodiesel + HYDROTREATING: + title: Hydrotreating/Hydroprocessing + description: >- + Catalytic reaction of lipids with hydrogen to produce + hydrocarbon fuels. + aliases: + - Hydroprocessing + annotations: + category: thermochemical + products: renewable_diesel,SAF + PYROLYSIS: + title: Pyrolysis + description: >- + Thermal decomposition of biomass in the absence of oxygen + to produce bio-oil, syngas, and biochar. + annotations: + category: thermochemical + temperature_c: 400-600 + products: bio_oil,syngas,biochar + GASIFICATION: + title: Gasification + description: >- + High-temperature conversion of carbonaceous materials to + syngas using controlled oxygen and/or steam. + meaning: CHMO:0001501 + annotations: + category: thermochemical + temperature_c: 700-1500 + products: syngas + HYDROTHERMAL_LIQUEFACTION: + title: Hydrothermal Liquefaction (HTL) + description: >- + Conversion of wet biomass to bio-crude using high temperature + and pressure water. + aliases: + - HTL + annotations: + category: thermochemical + temperature_c: 250-400 + pressure_bar: 100-200 + wet_feedstock: true + ENZYMATIC_HYDROLYSIS: + title: Enzymatic Hydrolysis + description: >- + Breakdown of cellulose and hemicellulose to fermentable + sugars using enzymes. + annotations: + category: biochemical + pretreatment_step: true + ACID_HYDROLYSIS: + title: Acid Hydrolysis + description: >- + Chemical breakdown of cellulose to sugars using dilute + or concentrated acid. + annotations: + category: chemical + pretreatment_step: true + FISCHER_TROPSCH: + title: Fischer-Tropsch Synthesis + description: >- + Catalytic conversion of syngas to liquid hydrocarbons. + aliases: + - FT Synthesis + annotations: + category: thermochemical + feedstock: syngas + products: FT_diesel,FT_jet + ALCOHOL_TO_JET: + title: Alcohol-to-Jet (ATJ) + description: >- + Conversion of alcohols (ethanol, isobutanol) to jet fuel + through dehydration, oligomerization, and hydrogenation. + aliases: + - ATJ + annotations: + category: chemical + products: SAF diff --git a/src/valuesets/schema/energy/renewable/geothermal.yaml b/src/valuesets/schema/energy/renewable/geothermal.yaml new file mode 100644 index 00000000..9c507a58 --- /dev/null +++ b/src/valuesets/schema/energy/renewable/geothermal.yaml @@ -0,0 +1,278 @@ +name: geothermal +title: Geothermal Energy Value Sets +description: >- + Value sets for geothermal energy systems, reservoir types, well types, and technologies. + Based on DOE Geothermal Technologies Office terminology and the Geothermal Data Repository standards. +id: https://w3id.org/linkml/valuesets/energy/renewable/geothermal +imports: +- linkml:types +prefixes: + linkml: https://w3id.org/linkml/ + valuesets: https://w3id.org/valuesets/ + ENVO: http://purl.obolibrary.org/obo/ENVO_ + NCIT: http://purl.obolibrary.org/obo/NCIT_ + sweet: http://sweetontology.net/ + orcid: https://orcid.org/ + valuesets_meta: https://w3id.org/valuesets/meta/ +default_prefix: valuesets +slots: + geothermal_system_type: + description: Type of geothermal system + range: GeothermalSystemType + geothermal_reservoir_type: + description: Type of geothermal reservoir + range: GeothermalReservoirType + geothermal_well_type: + description: Type of geothermal well + range: GeothermalWellType + geothermal_application: + description: Application of geothermal energy + range: GeothermalApplication + geothermal_resource_temperature: + description: Temperature classification of geothermal resources + range: GeothermalResourceTemperature +enums: + GeothermalSystemType: + title: Geothermal System Type + description: >- + Types of geothermal energy systems, including conventional hydrothermal + and enhanced/engineered geothermal systems. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - https://www.energy.gov/eere/geothermal/enhanced-geothermal-systems + - https://gdr.openei.org/ + permissible_values: + HYDROTHERMAL: + title: Conventional Hydrothermal System + description: >- + Naturally occurring geothermal system with heat, fluid, and permeability + sufficient for energy extraction without stimulation. + broad_mappings: + - sweet:phenEnergy/Geothermal + annotations: + conventional: true + ENHANCED_GEOTHERMAL_SYSTEM: + title: Enhanced Geothermal System (EGS) + description: >- + Engineered reservoirs created to extract heat from low permeability + geothermal resources through stimulation methods. + aliases: + - EGS + - Engineered Geothermal System + annotations: + requires_stimulation: true + ADVANCED_GEOTHERMAL_SYSTEM: + title: Advanced Geothermal System (AGS) + description: >- + Closed-loop geothermal systems that circulate working fluid through + wellbores to extract heat conductively without reservoir stimulation. + aliases: + - AGS + - Closed-Loop Geothermal + annotations: + closed_loop: true + HOT_DRY_ROCK: + title: Hot Dry Rock (HDR) + description: >- + Geothermal system targeting hot basement rock lacking natural fluid + or permeability, requiring artificial reservoir creation. + aliases: + - HDR + GEOPRESSURED: + title: Geopressured System + description: >- + Deep sedimentary formations with abnormally high fluid pressure + containing hot brine and dissolved methane. + annotations: + methane_recovery: true + SUPERCRITICAL: + title: Supercritical Geothermal System + description: >- + Very high temperature systems (>374C) where water exists above + its critical point, offering higher energy density. + annotations: + temperature_min_c: 374 + GROUND_SOURCE_HEAT_PUMP: + title: Ground Source Heat Pump (GSHP) + description: >- + Shallow geothermal system using stable ground temperatures for + heating and cooling buildings. + aliases: + - GSHP + - Geothermal Heat Pump + annotations: + direct_use: true + GeothermalReservoirType: + title: Geothermal Reservoir Type + description: Classification of geothermal reservoirs by geological setting and characteristics. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + VOLCANIC: + title: Volcanic Reservoir + description: >- + Reservoir associated with volcanic activity, typically in active + volcanic regions with magma heat sources. + related_mappings: + - ENVO:00000247 + broad_mappings: + - sweet:realmLandVolcanic/VolcanicField + SEDIMENTARY: + title: Sedimentary Basin Reservoir + description: >- + Reservoir in sedimentary formations with elevated temperatures + due to depth or regional heat flow. + broad_mappings: + - sweet:realmGeolBasin/SedimentaryBasin + FRACTURED_BASEMENT: + title: Fractured Basement Reservoir + description: >- + Reservoir in fractured crystalline basement rocks, typically + granitic or metamorphic. + aliases: + - Hot Fractured Rock + FAULT_CONTROLLED: + title: Fault-Controlled Reservoir + description: >- + Reservoir where fluid flow is controlled by fault systems + providing permeability pathways. + MAGMATIC: + title: Magmatic/Near-Magmatic Reservoir + description: >- + Very high temperature reservoir near or in contact with + magma bodies or recent intrusions. + related_mappings: + - sweet:matrRockIgneous/Magma + CONDUCTION_DOMINATED: + title: Conduction-Dominated Reservoir + description: >- + Low permeability reservoir where heat transfer is primarily + through conduction rather than convection. + GeothermalWellType: + title: Geothermal Well Type + description: Types of wells used in geothermal energy development and production. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + PRODUCTION_WELL: + title: Production Well + description: Well used to extract geothermal fluids or steam from the reservoir. + INJECTION_WELL: + title: Injection Well + description: >- + Well used to return cooled geothermal fluids to the reservoir + to maintain pressure and sustainability. + aliases: + - Reinjection Well + EXPLORATION_WELL: + title: Exploration Well + description: Well drilled to evaluate geothermal resource characteristics. + aliases: + - Wildcat Well + OBSERVATION_WELL: + title: Observation/Monitoring Well + description: Well used to monitor reservoir conditions and pressure. + aliases: + - Monitoring Well + SLIM_HOLE: + title: Slim Hole + description: >- + Smaller diameter well used for initial exploration and + temperature gradient measurement. + DIRECTIONAL_WELL: + title: Directional/Deviated Well + description: >- + Well drilled at an angle to access reservoir from offset + surface location or increase reservoir contact. + GeothermalApplication: + title: Geothermal Application + description: Applications and uses of geothermal energy. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + ELECTRICITY_GENERATION: + title: Electricity Generation + description: >- + Use of geothermal resources for power generation through + steam turbines or binary cycle plants. + meaning: ENVO:2000034 + close_mappings: + - sweet:humanTechEnergy/ElectricalGeneration + DIRECT_USE_HEATING: + title: Direct Use Heating + description: >- + Direct use of geothermal heat for space heating, district + heating, or industrial processes. + GREENHOUSE_HEATING: + title: Greenhouse Heating + description: Use of geothermal heat for agricultural greenhouses. + AQUACULTURE: + title: Aquaculture Heating + description: Use of geothermal heat for fish farming and aquaculture. + INDUSTRIAL_PROCESS_HEAT: + title: Industrial Process Heat + description: Use of geothermal heat for industrial manufacturing processes. + FOOD_PROCESSING: + title: Food Processing + description: >- + Use of geothermal heat for food drying, pasteurization, and processing. + BATHING_RECREATION: + title: Bathing and Recreation + description: Use of geothermal waters for spas, pools, and recreation. + LITHIUM_EXTRACTION: + title: Lithium Extraction + description: >- + Extraction of lithium and other minerals from geothermal brines + as a co-product of energy production. + annotations: + co_production: true + GeothermalResourceTemperature: + title: Geothermal Resource Temperature Classification + description: Classification of geothermal resources by temperature range. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + LOW_TEMPERATURE: + title: Low Temperature Resource + description: Geothermal resource below 90C, suitable for direct use applications. + annotations: + temperature_max_c: 90 + MODERATE_TEMPERATURE: + title: Moderate Temperature Resource + description: Geothermal resource 90-150C, suitable for binary power generation. + annotations: + temperature_min_c: 90 + temperature_max_c: 150 + HIGH_TEMPERATURE: + title: High Temperature Resource + description: Geothermal resource above 150C, suitable for flash steam power generation. + annotations: + temperature_min_c: 150 + SUPERCRITICAL: + title: Supercritical Resource + description: >- + Very high temperature resource above 374C where water exists + in supercritical state. + annotations: + temperature_min_c: 374 diff --git a/src/valuesets/schema/energy/renewable/hydrogen.yaml b/src/valuesets/schema/energy/renewable/hydrogen.yaml new file mode 100644 index 00000000..85c75553 --- /dev/null +++ b/src/valuesets/schema/energy/renewable/hydrogen.yaml @@ -0,0 +1,408 @@ +name: hydrogen +title: Hydrogen Energy Value Sets +description: >- + Value sets for hydrogen production, storage, and utilization. + Includes the color-coded hydrogen classification system used by industry. + Based on DOE Hydrogen and Fuel Cell Technologies Office terminology. +id: https://w3id.org/linkml/valuesets/energy/renewable/hydrogen +imports: +- linkml:types +prefixes: + linkml: https://w3id.org/linkml/ + valuesets: https://w3id.org/valuesets/ + CHEBI: http://purl.obolibrary.org/obo/CHEBI_ + NCIT: http://purl.obolibrary.org/obo/NCIT_ + CHMO: http://purl.obolibrary.org/obo/CHMO_ + sweet: http://sweetontology.net/ + orcid: https://orcid.org/ + valuesets_meta: https://w3id.org/valuesets/meta/ +default_prefix: valuesets +slots: + hydrogen_type: + description: Type of hydrogen classified by production method and carbon intensity + range: HydrogenType + hydrogen_production_method: + description: Method used to produce hydrogen + range: HydrogenProductionMethod + hydrogen_storage_method: + description: Method used to store hydrogen + range: HydrogenStorageMethod + hydrogen_application: + description: Application or end use of hydrogen + range: HydrogenApplication +enums: + HydrogenType: + title: Hydrogen Type (Color Classification) + description: >- + Color-coded classification of hydrogen based on production method + and carbon intensity. This informal industry taxonomy differentiates + hydrogen by its carbon footprint and energy source. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - https://www.energy.gov/eere/fuelcells/hydrogen-production + - https://www.nationalgrid.com/stories/energy-explained/hydrogen-colour-spectrum + permissible_values: + GREEN_HYDROGEN: + title: Green Hydrogen + description: >- + Hydrogen produced via electrolysis powered by renewable energy + sources (solar, wind, hydro). Zero carbon emissions during production. + aliases: + - Renewable Hydrogen + broad_mappings: + - sweet:matrElement/Hydrogen + annotations: + production_method: electrolysis + energy_source: renewable + carbon_intensity: zero + BLUE_HYDROGEN: + title: Blue Hydrogen + description: >- + Hydrogen produced from natural gas via steam methane reforming (SMR) + with carbon capture and storage (CCS). Low carbon intensity. + annotations: + production_method: steam_methane_reforming + energy_source: natural_gas + carbon_intensity: low + requires_ccs: true + GREY_HYDROGEN: + title: Grey Hydrogen + description: >- + Hydrogen produced from natural gas via steam methane reforming + without carbon capture. Most common production method currently. + aliases: + - Gray Hydrogen + annotations: + production_method: steam_methane_reforming + energy_source: natural_gas + carbon_intensity: high + co2_per_kg_h2: 9-12 + BROWN_HYDROGEN: + title: Brown Hydrogen + description: >- + Hydrogen produced from brown coal (lignite) gasification + without carbon capture. High carbon intensity. + annotations: + production_method: coal_gasification + energy_source: lignite + carbon_intensity: very_high + BLACK_HYDROGEN: + title: Black Hydrogen + description: >- + Hydrogen produced from black coal (bituminous) gasification + without carbon capture. High carbon intensity. + annotations: + production_method: coal_gasification + energy_source: bituminous_coal + carbon_intensity: very_high + PINK_HYDROGEN: + title: Pink Hydrogen + description: >- + Hydrogen produced via electrolysis powered by nuclear energy. + Zero carbon emissions during production. + aliases: + - Purple Hydrogen + - Red Hydrogen + annotations: + production_method: electrolysis + energy_source: nuclear + carbon_intensity: zero + TURQUOISE_HYDROGEN: + title: Turquoise Hydrogen + description: >- + Hydrogen produced via methane pyrolysis, producing solid carbon + instead of CO2. Lower carbon intensity than grey hydrogen. + annotations: + production_method: methane_pyrolysis + energy_source: natural_gas + carbon_intensity: low + byproduct: solid_carbon + WHITE_HYDROGEN: + title: White Hydrogen + description: >- + Naturally occurring geological hydrogen found in underground + deposits. Zero production emissions. + aliases: + - Natural Hydrogen + - Geological Hydrogen + - Gold Hydrogen + annotations: + production_method: geological_extraction + energy_source: natural + carbon_intensity: zero + YELLOW_HYDROGEN: + title: Yellow Hydrogen + description: >- + Hydrogen produced via electrolysis powered by solar energy + specifically. A subset of green hydrogen. + annotations: + production_method: electrolysis + energy_source: solar + carbon_intensity: zero + ORANGE_HYDROGEN: + title: Orange Hydrogen + description: >- + Hydrogen produced from plastic waste gasification or pyrolysis. + Emerging technology addressing both energy and waste challenges. + annotations: + production_method: waste_gasification + energy_source: plastic_waste + carbon_intensity: varies + HydrogenProductionMethod: + title: Hydrogen Production Method + description: Methods and processes for producing hydrogen. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + see_also: + - https://www.energy.gov/eere/fuelcells/hydrogen-production + permissible_values: + STEAM_METHANE_REFORMING: + title: Steam Methane Reforming (SMR) + description: >- + High temperature steam reacts with methane to produce hydrogen, + carbon monoxide, and carbon dioxide. + aliases: + - SMR + annotations: + feedstock: natural_gas + temperature_c: 700-1000 + dominant_method: true + AUTOTHERMAL_REFORMING: + title: Autothermal Reforming (ATR) + description: >- + Combines steam reforming and partial oxidation using oxygen + and steam to produce hydrogen from hydrocarbons. + aliases: + - ATR + PARTIAL_OXIDATION: + title: Partial Oxidation (POX) + description: >- + Exothermic process reacting hydrocarbons with limited oxygen + to produce hydrogen and carbon monoxide. + aliases: + - POX + COAL_GASIFICATION: + title: Coal Gasification + description: >- + Conversion of coal to syngas (hydrogen and carbon monoxide) + using high temperature and steam. + meaning: CHMO:0001501 + WATER_ELECTROLYSIS: + title: Water Electrolysis + description: >- + Splitting water into hydrogen and oxygen using electrical current. + Can be powered by various energy sources. + aliases: + - Electrolysis + close_mappings: + - sweet:procChemical/Electrolysis + ALKALINE_ELECTROLYSIS: + title: Alkaline Electrolysis (AEL) + description: >- + Electrolysis using alkaline solution (typically KOH) as + electrolyte. Mature commercial technology. + aliases: + - AEL + annotations: + electrolyte: alkaline + maturity: commercial + PEM_ELECTROLYSIS: + title: PEM Electrolysis + description: >- + Proton Exchange Membrane electrolysis using solid polymer + electrolyte. Higher efficiency, faster response. + aliases: + - PEMEC + - Polymer Electrolyte Membrane Electrolysis + annotations: + electrolyte: polymer_membrane + maturity: commercial + SOLID_OXIDE_ELECTROLYSIS: + title: Solid Oxide Electrolysis (SOEC) + description: >- + High temperature electrolysis using solid ceramic electrolyte. + Higher efficiency when waste heat is available. + aliases: + - SOEC + annotations: + electrolyte: solid_oxide + temperature_c: 700-850 + maturity: emerging + METHANE_PYROLYSIS: + title: Methane Pyrolysis + description: >- + Thermal decomposition of methane into hydrogen and solid carbon + without oxygen. Produces no direct CO2. + aliases: + - Thermal Cracking + annotations: + feedstock: natural_gas + byproduct: solid_carbon + BIOMASS_GASIFICATION: + title: Biomass Gasification + description: >- + Thermochemical conversion of biomass to hydrogen-rich syngas + at high temperatures. + narrow_mappings: + - sweet:procPhysical/Gasification + annotations: + feedstock: biomass + renewable: true + BIOLOGICAL_PRODUCTION: + title: Biological Hydrogen Production + description: >- + Production of hydrogen by microorganisms through photosynthesis, + fermentation, or other biological processes. + aliases: + - Biohydrogen + annotations: + renewable: true + maturity: research + THERMOCHEMICAL_WATER_SPLITTING: + title: Thermochemical Water Splitting + description: >- + Using high temperatures from concentrated solar or nuclear + to drive chemical cycles that split water. + annotations: + temperature_c: 500-2000 + maturity: research + PHOTOELECTROCHEMICAL: + title: Photoelectrochemical Water Splitting + description: >- + Direct conversion of sunlight to hydrogen using specialized + semiconductor materials in contact with water. + aliases: + - PEC + annotations: + maturity: research + HydrogenStorageMethod: + title: Hydrogen Storage Method + description: Methods for storing hydrogen for later use or transport. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + COMPRESSED_GAS: + title: Compressed Gas Storage + description: >- + Storage of hydrogen as compressed gas at high pressure + (350-700 bar) in pressure vessels. + aliases: + - CGH2 + annotations: + pressure_bar: 350-700 + maturity: commercial + LIQUID_HYDROGEN: + title: Liquid Hydrogen Storage + description: >- + Storage of hydrogen in liquid form at cryogenic temperatures + (-253C). Higher energy density but requires insulation. + aliases: + - LH2 + annotations: + temperature_c: -253 + maturity: commercial + METAL_HYDRIDE: + title: Metal Hydride Storage + description: >- + Storage of hydrogen absorbed into metal alloys forming + metal hydrides. Safer but heavier than compressed gas. + annotations: + maturity: commercial + CHEMICAL_HYDRIDE: + title: Chemical Hydride Storage + description: >- + Storage as chemical compounds (ammonia, methanol, LOHC) + that release hydrogen when processed. + aliases: + - LOHC + - Liquid Organic Hydrogen Carrier + UNDERGROUND_STORAGE: + title: Underground Storage + description: >- + Large-scale storage in salt caverns, depleted gas fields, + or aquifers for grid-scale applications. + aliases: + - Geological Storage + annotations: + scale: utility + CRYO_COMPRESSED: + title: Cryo-Compressed Storage + description: >- + Hybrid approach combining cryogenic cooling with high pressure + for improved density. + aliases: + - CcH2 + annotations: + maturity: emerging + HydrogenApplication: + title: Hydrogen Application + description: End-use applications for hydrogen. + status: DRAFT + contributors: + - orcid:0000-0002-6601-2165 + - https://github.com/anthropics/claude-code + instantiates: + - valuesets_meta:ValueSetEnumDefinition + permissible_values: + FUEL_CELL_VEHICLE: + title: Fuel Cell Electric Vehicle + description: Use of hydrogen in fuel cells for transportation (cars, trucks, buses). + aliases: + - FCEV + FUEL_CELL_STATIONARY: + title: Stationary Fuel Cell + description: Use of hydrogen in stationary fuel cells for power generation. + INDUSTRIAL_FEEDSTOCK: + title: Industrial Feedstock + description: >- + Use of hydrogen as chemical feedstock for ammonia production, + petroleum refining, and chemical synthesis. + meaning: CHEBI:18276 + STEEL_PRODUCTION: + title: Steel Production (Direct Reduction) + description: Use of hydrogen to reduce iron ore in steelmaking, replacing coal. + aliases: + - Green Steel + AMMONIA_SYNTHESIS: + title: Ammonia Synthesis + description: Use of hydrogen with nitrogen to produce ammonia for fertilizers. + related_mappings: + - sweet:matrCompound/Ammonia + METHANOL_SYNTHESIS: + title: Methanol Synthesis + description: Use of hydrogen with CO2 to produce methanol. + related_mappings: + - sweet:matrOrganicCompound/Methanol + POWER_TO_GAS: + title: Power-to-Gas + description: >- + Conversion of excess renewable electricity to hydrogen for + grid balancing and energy storage. + aliases: + - P2G + BLENDING_NATURAL_GAS: + title: Natural Gas Blending + description: >- + Blending hydrogen into natural gas pipelines for + decarbonization of heating. + SYNTHETIC_FUELS: + title: Synthetic Fuel Production + description: >- + Use of hydrogen with captured CO2 to produce synthetic + hydrocarbons (e-fuels, SAF). + aliases: + - E-Fuels + - Power-to-Liquid diff --git a/src/valuesets/schema/valuesets.yaml b/src/valuesets/schema/valuesets.yaml index c04aaaa3..7f920d62 100644 --- a/src/valuesets/schema/valuesets.yaml +++ b/src/valuesets/schema/valuesets.yaml @@ -37,6 +37,9 @@ imports: - energy/nuclear/nuclear_safety - energy/nuclear/nuclear_facilities - energy/nuclear/nuclear_operations +- energy/renewable/geothermal +- energy/renewable/hydrogen +- energy/renewable/bioenergy - industry/mining - industry/extractive_industry - statistics/prediction_outcomes diff --git a/tests/test_rich_enums.py b/tests/test_rich_enums.py index a01a3d08..b523a0f1 100644 --- a/tests/test_rich_enums.py +++ b/tests/test_rich_enums.py @@ -188,8 +188,8 @@ def test_structural_biology_enums(self): """Test structural biology specific enums""" protein = SampleType.PROTEIN assert protein.get_description() == "Purified protein sample" - # SampleType.PROTEIN doesn't have a meaning in metadata - assert protein.get_meaning() is None + # SampleType.PROTEIN has NCIT mapping + assert protein.get_meaning() == "NCIT:C17021" cryo_em = StructuralBiologyTechnique.CRYO_EM annotations = cryo_em.get_annotations()