valuesets 0.3.1__py3-none-any.whl

valuesets/enums/energy/nuclear/nuclear_operations.py

@@ -0,0 +1,191 @@
+"""
+Nuclear Operations and Reactor States
+
+Classifications for nuclear reactor operational states, maintenance activities, licensing stages, and operational procedures. Based on nuclear industry standards and regulatory frameworks.
+
+Generated from: energy/nuclear/nuclear_operations.yaml
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Any, Optional
+from valuesets.generators.rich_enum import RichEnum
+
+class ReactorOperatingStateEnum(RichEnum):
+    """
+    Operational states of nuclear reactors
+    """
+    # Enum members
+    STARTUP = "STARTUP"
+    CRITICAL = "CRITICAL"
+    POWER_ESCALATION = "POWER_ESCALATION"
+    FULL_POWER_OPERATION = "FULL_POWER_OPERATION"
+    LOAD_FOLLOWING = "LOAD_FOLLOWING"
+    REDUCED_POWER = "REDUCED_POWER"
+    HOT_STANDBY = "HOT_STANDBY"
+    COLD_SHUTDOWN = "COLD_SHUTDOWN"
+    REFUELING = "REFUELING"
+    REACTOR_TRIP = "REACTOR_TRIP"
+    SCRAM = "SCRAM"
+    EMERGENCY_SHUTDOWN = "EMERGENCY_SHUTDOWN"
+
+# Set metadata after class creation
+ReactorOperatingStateEnum._metadata = {
+    "STARTUP": {'description': 'Reactor transitioning from shutdown to power operation', 'annotations': {'neutron_level': 'increasing', 'control_rod_position': 'withdrawing', 'power_level': 'rising from zero', 'duration': 'hours to days', 'operator_attention': 'high'}},
+    "CRITICAL": {'description': 'Reactor achieving self-sustaining chain reaction', 'annotations': {'neutron_multiplication': 'k-effective = 1.0', 'power_level': 'minimal but self-sustaining', 'control_rod_position': 'critical position', 'milestone': 'first criticality achievement'}},
+    "POWER_ESCALATION": {'description': 'Reactor increasing power toward full power operation', 'annotations': {'power_level': 'increasing incrementally', 'testing': 'ongoing at each power level', 'duration': 'days to weeks', 'procedures': 'systematic power increases'}},
+    "FULL_POWER_OPERATION": {'description': 'Reactor operating at rated thermal power', 'annotations': {'power_level': '100% rated power', 'operation_mode': 'commercial electricity generation', 'duration': 'typically 12-24 months', 'fuel_burnup': 'accumulating'}},
+    "LOAD_FOLLOWING": {'description': 'Reactor adjusting power to match electrical demand', 'annotations': {'power_level': 'variable based on demand', 'control_mode': 'automatic load following', 'flexibility': 'grid demand responsive', 'frequency': 'daily power variations'}},
+    "REDUCED_POWER": {'description': 'Reactor operating below rated power', 'annotations': {'power_level': '<100% rated power', 'reasons': 'maintenance, grid demand, testing', 'control_rod_position': 'partially inserted'}},
+    "HOT_STANDBY": {'description': 'Reactor subcritical but at operating temperature', 'annotations': {'criticality': 'subcritical', 'temperature': 'operating temperature maintained', 'pressure': 'operating pressure maintained', 'ready_time': 'rapid return to power possible'}},
+    "COLD_SHUTDOWN": {'description': 'Reactor subcritical and cooled below operating temperature', 'annotations': {'criticality': 'subcritical with margin', 'temperature': '<200°F (93°C) typically', 'refueling': 'possible in this state', 'maintenance': 'major maintenance possible'}},
+    "REFUELING": {'description': 'Reactor shut down for fuel replacement', 'annotations': {'reactor_head': 'removed', 'fuel_handling': 'active fuel movement', 'criticality_control': 'strict procedures', 'duration': 'typically 30-60 days'}},
+    "REACTOR_TRIP": {'description': 'Rapid automatic shutdown due to safety system actuation', 'annotations': {'shutdown_speed': 'seconds', 'cause': 'safety system activation', 'control_rods': 'fully inserted rapidly', 'investigation': 'cause determination required'}},
+    "SCRAM": {'description': 'Emergency rapid shutdown of reactor', 'annotations': {'shutdown_type': 'emergency shutdown', 'control_rod_insertion': 'fastest possible', 'operator_action': 'manual or automatic', 'follow_up': 'immediate safety assessment'}},
+    "EMERGENCY_SHUTDOWN": {'description': 'Shutdown due to emergency conditions', 'annotations': {'urgency': 'immediate shutdown required', 'safety_systems': 'may be activated', 'investigation': 'extensive post-event analysis', 'recovery': 'detailed restart procedures'}},
+}
+
+class MaintenanceTypeEnum(RichEnum):
+    """
+    Types of nuclear facility maintenance activities
+    """
+    # Enum members
+    PREVENTIVE_MAINTENANCE = "PREVENTIVE_MAINTENANCE"
+    CORRECTIVE_MAINTENANCE = "CORRECTIVE_MAINTENANCE"
+    PREDICTIVE_MAINTENANCE = "PREDICTIVE_MAINTENANCE"
+    CONDITION_BASED_MAINTENANCE = "CONDITION_BASED_MAINTENANCE"
+    REFUELING_OUTAGE_MAINTENANCE = "REFUELING_OUTAGE_MAINTENANCE"
+    FORCED_OUTAGE_MAINTENANCE = "FORCED_OUTAGE_MAINTENANCE"
+    IN_SERVICE_INSPECTION = "IN_SERVICE_INSPECTION"
+    MODIFICATION_WORK = "MODIFICATION_WORK"
+
+# Set metadata after class creation
+MaintenanceTypeEnum._metadata = {
+    "PREVENTIVE_MAINTENANCE": {'description': 'Scheduled maintenance to prevent equipment failure', 'annotations': {'schedule': 'predetermined intervals', 'purpose': 'prevent failures', 'planning': 'extensive advance planning', 'outage_type': 'planned outage'}},
+    "CORRECTIVE_MAINTENANCE": {'description': 'Maintenance to repair failed or degraded equipment', 'annotations': {'trigger': 'equipment failure or degradation', 'urgency': 'varies by safety significance', 'planning': 'may be immediate', 'schedule': 'unplanned'}},
+    "PREDICTIVE_MAINTENANCE": {'description': 'Maintenance based on condition monitoring', 'annotations': {'basis': 'condition monitoring data', 'timing': 'based on predicted failure', 'efficiency': 'optimized maintenance timing', 'technology': 'condition monitoring systems'}},
+    "CONDITION_BASED_MAINTENANCE": {'description': 'Maintenance triggered by equipment condition assessment', 'annotations': {'assessment': 'continuous condition monitoring', 'trigger': 'condition degradation', 'optimization': 'resource optimization', 'safety': 'maintains safety margins'}},
+    "REFUELING_OUTAGE_MAINTENANCE": {'description': 'Major maintenance during scheduled refueling', 'annotations': {'frequency': 'every 12-24 months', 'scope': 'major equipment inspection and repair', 'duration': '30-60 days typical', 'access': 'full plant access available'}},
+    "FORCED_OUTAGE_MAINTENANCE": {'description': 'Unplanned maintenance due to equipment failure', 'annotations': {'cause': 'unexpected equipment failure', 'urgency': 'immediate attention required', 'duration': 'variable', 'safety_significance': 'may affect safety systems'}},
+    "IN_SERVICE_INSPECTION": {'description': 'Required inspection of safety-related components', 'annotations': {'regulatory_requirement': 'mandated by regulations', 'frequency': 'specified intervals (typically 10 years)', 'scope': 'pressure vessels, piping, supports', 'techniques': 'non-destructive testing'}},
+    "MODIFICATION_WORK": {'description': 'Changes to plant design or configuration', 'annotations': {'purpose': 'plant improvement or regulatory compliance', 'approval': 'requires design change approval', 'testing': 'extensive post-modification testing', 'documentation': 'comprehensive documentation updates'}},
+}
+
+class LicensingStageEnum(RichEnum):
+    """
+    Nuclear facility licensing stages
+    """
+    # Enum members
+    SITE_PERMIT = "SITE_PERMIT"
+    DESIGN_CERTIFICATION = "DESIGN_CERTIFICATION"
+    CONSTRUCTION_PERMIT = "CONSTRUCTION_PERMIT"
+    OPERATING_LICENSE = "OPERATING_LICENSE"
+    LICENSE_RENEWAL = "LICENSE_RENEWAL"
+    COMBINED_LICENSE = "COMBINED_LICENSE"
+    DECOMMISSIONING_PLAN = "DECOMMISSIONING_PLAN"
+    LICENSE_TERMINATION = "LICENSE_TERMINATION"
+
+# Set metadata after class creation
+LicensingStageEnum._metadata = {
+    "SITE_PERMIT": {'description': 'Early site permit for nuclear facility', 'annotations': {'scope': 'site suitability evaluation', 'duration': '10-20 years typically', 'flexibility': 'technology-neutral', 'advantage': 'reduced licensing risk'}},
+    "DESIGN_CERTIFICATION": {'description': 'Certification of standardized reactor design', 'annotations': {'scope': 'reactor design approval', 'duration': '15-20 years typically', 'advantage': 'reduced construction licensing time', 'standardization': 'enables multiple deployments'}},
+    "CONSTRUCTION_PERMIT": {'description': 'Authorization to begin nuclear facility construction', 'annotations': {'authorization': 'construction activities', 'requirements': 'detailed design and safety analysis', 'oversight': 'construction inspection program', 'milestone': 'major licensing milestone'}},
+    "OPERATING_LICENSE": {'description': 'Authorization for commercial reactor operation', 'annotations': {'authorization': 'power operation and fuel loading', 'duration': 'initially 40 years', 'renewal': 'possible for additional 20 years', 'testing': 'extensive pre-operational testing'}},
+    "LICENSE_RENEWAL": {'description': 'Extension of operating license beyond initial term', 'annotations': {'extension': 'additional 20 years typical', 'review': 'aging management program review', 'basis': 'demonstrated safe operation', 'economics': 'enables continued operation'}},
+    "COMBINED_LICENSE": {'description': 'Combined construction and operating license', 'annotations': {'scope': 'construction and operation authorization', 'advantage': 'single licensing process', 'requirements': 'complete design and safety analysis', 'efficiency': 'streamlined licensing approach'}},
+    "DECOMMISSIONING_PLAN": {'description': 'Approval of facility decommissioning plan', 'annotations': {'scope': 'facility dismantlement plan', 'funding': 'decommissioning funding assurance', 'schedule': 'decommissioning timeline', 'end_state': 'final site condition'}},
+    "LICENSE_TERMINATION": {'description': 'Final termination of nuclear facility license', 'annotations': {'completion': 'decommissioning completion', 'survey': 'final radiological survey', 'release': 'site release for unrestricted use', 'finality': 'end of regulatory oversight'}},
+}
+
+class FuelCycleOperationEnum(RichEnum):
+    """
+    Nuclear fuel cycle operational activities
+    """
+    # Enum members
+    URANIUM_EXPLORATION = "URANIUM_EXPLORATION"
+    URANIUM_EXTRACTION = "URANIUM_EXTRACTION"
+    URANIUM_MILLING = "URANIUM_MILLING"
+    URANIUM_CONVERSION = "URANIUM_CONVERSION"
+    URANIUM_ENRICHMENT = "URANIUM_ENRICHMENT"
+    FUEL_FABRICATION = "FUEL_FABRICATION"
+    REACTOR_FUEL_LOADING = "REACTOR_FUEL_LOADING"
+    REACTOR_OPERATION = "REACTOR_OPERATION"
+    SPENT_FUEL_DISCHARGE = "SPENT_FUEL_DISCHARGE"
+    SPENT_FUEL_STORAGE = "SPENT_FUEL_STORAGE"
+    SPENT_FUEL_REPROCESSING = "SPENT_FUEL_REPROCESSING"
+    WASTE_CONDITIONING = "WASTE_CONDITIONING"
+    WASTE_DISPOSAL = "WASTE_DISPOSAL"
+
+# Set metadata after class creation
+FuelCycleOperationEnum._metadata = {
+    "URANIUM_EXPLORATION": {'description': 'Search and evaluation of uranium deposits', 'annotations': {'activities': 'geological surveys, drilling, sampling', 'purpose': 'locate economically viable deposits', 'methods': 'airborne surveys, ground exploration'}},
+    "URANIUM_EXTRACTION": {'description': 'Mining and extraction of uranium ore', 'annotations': {'methods': 'open pit, underground, in-situ leaching', 'output': 'uranium ore', 'processing': 'crushing and grinding'}},
+    "URANIUM_MILLING": {'description': 'Processing of uranium ore to produce yellowcake', 'annotations': {'input': 'uranium ore', 'output': 'uranium concentrate (U3O8)', 'process': 'acid or alkaline leaching'}},
+    "URANIUM_CONVERSION": {'description': 'Conversion of yellowcake to uranium hexafluoride', 'annotations': {'input': 'uranium concentrate (U3O8)', 'output': 'uranium hexafluoride (UF6)', 'purpose': 'prepare for enrichment'}},
+    "URANIUM_ENRICHMENT": {'description': 'Increase U-235 concentration in uranium', 'annotations': {'input': 'natural uranium (0.711% U-235)', 'output': 'enriched uranium (3-5% typical)', 'waste': 'depleted uranium tails', 'methods': 'gas centrifuge, gaseous diffusion'}},
+    "FUEL_FABRICATION": {'description': 'Manufacturing of nuclear fuel assemblies', 'annotations': {'input': 'enriched uranium', 'output': 'fuel assemblies', 'process': 'pellet production, rod assembly'}},
+    "REACTOR_FUEL_LOADING": {'description': 'Installation of fresh fuel in reactor', 'annotations': {'frequency': 'every 12-24 months', 'procedure': 'careful criticality control', 'configuration': 'specific loading pattern'}},
+    "REACTOR_OPERATION": {'description': 'Power generation and fuel burnup', 'annotations': {'duration': '12-24 months typical cycle', 'burnup': 'fuel depletion over time', 'output': 'electricity and fission products'}},
+    "SPENT_FUEL_DISCHARGE": {'description': 'Removal of used fuel from reactor', 'annotations': {'timing': 'end of fuel cycle', 'handling': 'underwater fuel handling', 'destination': 'spent fuel pool storage'}},
+    "SPENT_FUEL_STORAGE": {'description': 'Interim storage of discharged fuel', 'annotations': {'cooling': 'decay heat removal', 'duration': '5-100+ years', 'methods': 'pools, dry casks'}},
+    "SPENT_FUEL_REPROCESSING": {'description': 'Chemical separation of spent fuel components', 'annotations': {'separation': 'uranium, plutonium, waste', 'recovery': 'recovers usable materials', 'waste': 'high-level waste production'}},
+    "WASTE_CONDITIONING": {'description': 'Preparation of waste for storage or disposal', 'annotations': {'treatment': 'solidification, encapsulation', 'purpose': 'stable waste form', 'standards': 'waste acceptance criteria'}},
+    "WASTE_DISPOSAL": {'description': 'Permanent disposal of nuclear waste', 'annotations': {'method': 'geological repository', 'isolation': 'long-term containment', 'safety': 'protect public and environment'}},
+}
+
+class ReactorControlModeEnum(RichEnum):
+    """
+    Reactor control and safety system operational modes
+    """
+    # Enum members
+    MANUAL_CONTROL = "MANUAL_CONTROL"
+    AUTOMATIC_CONTROL = "AUTOMATIC_CONTROL"
+    REACTOR_PROTECTION_SYSTEM = "REACTOR_PROTECTION_SYSTEM"
+    ENGINEERED_SAFEGUARDS = "ENGINEERED_SAFEGUARDS"
+    EMERGENCY_OPERATING_PROCEDURES = "EMERGENCY_OPERATING_PROCEDURES"
+    SEVERE_ACCIDENT_MANAGEMENT = "SEVERE_ACCIDENT_MANAGEMENT"
+
+# Set metadata after class creation
+ReactorControlModeEnum._metadata = {
+    "MANUAL_CONTROL": {'description': 'Direct operator control of reactor systems', 'annotations': {'operator_role': 'direct manual operation', 'automation': 'minimal automation', 'response_time': 'depends on operator', 'application': 'startup, shutdown, testing'}},
+    "AUTOMATIC_CONTROL": {'description': 'Automated reactor control systems', 'annotations': {'automation': 'high level automation', 'operator_role': 'supervisory', 'response_time': 'rapid automatic response', 'application': 'normal power operation'}},
+    "REACTOR_PROTECTION_SYSTEM": {'description': 'Safety system monitoring for trip conditions', 'annotations': {'function': 'automatic reactor trip on unsafe conditions', 'redundancy': 'multiple independent channels', 'response_time': 'milliseconds to seconds', 'priority': 'overrides operator actions'}},
+    "ENGINEERED_SAFEGUARDS": {'description': 'Safety systems for accident mitigation', 'annotations': {'function': 'mitigate consequences of accidents', 'activation': 'automatic on accident conditions', 'systems': 'emergency core cooling, containment', 'redundancy': 'multiple trains'}},
+    "EMERGENCY_OPERATING_PROCEDURES": {'description': 'Operator actions for emergency conditions', 'annotations': {'guidance': 'symptom-based procedures', 'training': 'extensive operator training', 'decision_making': 'structured approach', 'coordination': 'with emergency response'}},
+    "SEVERE_ACCIDENT_MANAGEMENT": {'description': 'Procedures for beyond design basis accidents', 'annotations': {'scope': 'core damage mitigation', 'guidance': 'severe accident management guidelines', 'equipment': 'portable emergency equipment', 'coordination': 'multi-unit considerations'}},
+}
+
+class OperationalProcedureEnum(RichEnum):
+    """
+    Standard nuclear facility operational procedures
+    """
+    # Enum members
+    STARTUP_PROCEDURE = "STARTUP_PROCEDURE"
+    SHUTDOWN_PROCEDURE = "SHUTDOWN_PROCEDURE"
+    REFUELING_PROCEDURE = "REFUELING_PROCEDURE"
+    SURVEILLANCE_TESTING = "SURVEILLANCE_TESTING"
+    MAINTENANCE_PROCEDURE = "MAINTENANCE_PROCEDURE"
+    EMERGENCY_RESPONSE = "EMERGENCY_RESPONSE"
+    RADIOLOGICAL_PROTECTION = "RADIOLOGICAL_PROTECTION"
+    SECURITY_PROCEDURE = "SECURITY_PROCEDURE"
+
+# Set metadata after class creation
+OperationalProcedureEnum._metadata = {
+    "STARTUP_PROCEDURE": {'description': 'Systematic procedure for bringing reactor to power', 'annotations': {'phases': 'multiple phases with hold points', 'testing': 'system testing at each phase', 'authorization': 'management authorization required', 'duration': 'hours to days'}},
+    "SHUTDOWN_PROCEDURE": {'description': 'Systematic procedure for shutting down reactor', 'annotations': {'control_rod_insertion': 'gradual or rapid', 'cooling': 'controlled cooldown', 'systems': 'systematic system shutdown', 'verification': 'shutdown margin verification'}},
+    "REFUELING_PROCEDURE": {'description': 'Procedure for fuel handling and replacement', 'annotations': {'criticality_control': 'strict criticality prevention', 'handling': 'underwater fuel handling', 'documentation': 'detailed records', 'verification': 'independent verification'}},
+    "SURVEILLANCE_TESTING": {'description': 'Regular testing of safety systems', 'annotations': {'frequency': 'specified by technical specifications', 'scope': 'functionality verification', 'documentation': 'test result documentation', 'corrective_action': 'if performance degraded'}},
+    "MAINTENANCE_PROCEDURE": {'description': 'Systematic approach to equipment maintenance', 'annotations': {'work_control': 'work order control process', 'safety_tagging': 'equipment isolation', 'testing': 'post-maintenance testing', 'documentation': 'maintenance records'}},
+    "EMERGENCY_RESPONSE": {'description': 'Response to emergency conditions', 'annotations': {'classification': 'event classification', 'notification': 'offsite notification', 'mitigation': 'protective action implementation', 'coordination': 'with offsite authorities'}},
+    "RADIOLOGICAL_PROTECTION": {'description': 'Procedures for radiation protection', 'annotations': {'monitoring': 'radiation monitoring', 'contamination_control': 'contamination prevention', 'dose_control': 'personnel dose limits', 'emergency': 'radiological emergency response'}},
+    "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'}},
+}
+
+__all__ = [
+    "ReactorOperatingStateEnum",
+    "MaintenanceTypeEnum",
+    "LicensingStageEnum",
+    "FuelCycleOperationEnum",
+    "ReactorControlModeEnum",
+    "OperationalProcedureEnum",
+]

valuesets/enums/energy/nuclear/nuclear_regulatory.py

@@ -0,0 +1,188 @@
+"""
+Nuclear Regulatory Frameworks Value Sets
+
+Value sets for nuclear regulatory bodies, frameworks, and compliance standards
+
+Generated from: energy/nuclear/nuclear_regulatory.yaml
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Any, Optional
+from valuesets.generators.rich_enum import RichEnum
+
+class NuclearRegulatoryBodyEnum(RichEnum):
+    """
+    Nuclear regulatory authorities and international organizations
+    """
+    # Enum members
+    IAEA = "IAEA"
+    NRC = "NRC"
+    ONR = "ONR"
+    ASN = "ASN"
+    NISA = "NISA"
+    CNSC = "CNSC"
+    STUK = "STUK"
+    SKI = "SKI"
+    ENSI = "ENSI"
+    ROSATOM = "ROSATOM"
+    CNNC = "CNNC"
+    KAERI = "KAERI"
+    AERB = "AERB"
+
+# Set metadata after class creation
+NuclearRegulatoryBodyEnum._metadata = {
+    "IAEA": {'description': 'International Atomic Energy Agency'},
+    "NRC": {'description': 'US Nuclear Regulatory Commission'},
+    "ONR": {'description': 'Office for Nuclear Regulation (UK)'},
+    "ASN": {'description': 'Autorité de sûreté nucléaire (France)'},
+    "NISA": {'description': 'Nuclear and Industrial Safety Agency (Japan)'},
+    "CNSC": {'description': 'Canadian Nuclear Safety Commission'},
+    "STUK": {'description': 'Radiation and Nuclear Safety Authority (Finland)'},
+    "SKI": {'description': 'Swedish Nuclear Power Inspectorate'},
+    "ENSI": {'description': 'Swiss Federal Nuclear Safety Inspectorate'},
+    "ROSATOM": {'description': 'State Atomic Energy Corporation (Russia)'},
+    "CNNC": {'description': 'China National Nuclear Corporation'},
+    "KAERI": {'description': 'Korea Atomic Energy Research Institute'},
+    "AERB": {'description': 'Atomic Energy Regulatory Board (India)'},
+}
+
+class RegulatoryFrameworkEnum(RichEnum):
+    """
+    Nuclear regulatory frameworks and international conventions
+    """
+    # Enum members
+    NPT = "NPT"
+    COMPREHENSIVE_SAFEGUARDS = "COMPREHENSIVE_SAFEGUARDS"
+    ADDITIONAL_PROTOCOL = "ADDITIONAL_PROTOCOL"
+    CONVENTION_NUCLEAR_SAFETY = "CONVENTION_NUCLEAR_SAFETY"
+    JOINT_CONVENTION = "JOINT_CONVENTION"
+    PARIS_CONVENTION = "PARIS_CONVENTION"
+    VIENNA_CONVENTION = "VIENNA_CONVENTION"
+    CPPNM = "CPPNM"
+    ICSANT = "ICSANT"
+    SAFETY_STANDARDS = "SAFETY_STANDARDS"
+    SECURITY_SERIES = "SECURITY_SERIES"
+
+# Set metadata after class creation
+RegulatoryFrameworkEnum._metadata = {
+    "NPT": {'description': 'Nuclear Non-Proliferation Treaty'},
+    "COMPREHENSIVE_SAFEGUARDS": {'description': 'IAEA Comprehensive Safeguards Agreements'},
+    "ADDITIONAL_PROTOCOL": {'description': 'IAEA Additional Protocol'},
+    "CONVENTION_NUCLEAR_SAFETY": {'description': 'Convention on Nuclear Safety'},
+    "JOINT_CONVENTION": {'description': 'Joint Convention on the Safety of Spent Fuel Management and Radioactive Waste'},
+    "PARIS_CONVENTION": {'description': 'Paris Convention on Third Party Liability in the Field of Nuclear Energy'},
+    "VIENNA_CONVENTION": {'description': 'Vienna Convention on Civil Liability for Nuclear Damage'},
+    "CPPNM": {'description': 'Convention on the Physical Protection of Nuclear Material'},
+    "ICSANT": {'description': 'International Convention for the Suppression of Acts of Nuclear Terrorism'},
+    "SAFETY_STANDARDS": {'description': 'IAEA Safety Standards Series'},
+    "SECURITY_SERIES": {'description': 'IAEA Nuclear Security Series'},
+}
+
+class LicensingStageEnum(RichEnum):
+    """
+    Stages in nuclear facility licensing process
+    """
+    # Enum members
+    PRE_APPLICATION = "PRE_APPLICATION"
+    CONSTRUCTION_PERMIT = "CONSTRUCTION_PERMIT"
+    OPERATING_LICENSE = "OPERATING_LICENSE"
+    LICENSE_RENEWAL = "LICENSE_RENEWAL"
+    POWER_UPRATE = "POWER_UPRATE"
+    DECOMMISSIONING_PLAN = "DECOMMISSIONING_PLAN"
+    LICENSE_TERMINATION = "LICENSE_TERMINATION"
+    DESIGN_CERTIFICATION = "DESIGN_CERTIFICATION"
+    EARLY_SITE_PERMIT = "EARLY_SITE_PERMIT"
+    COMBINED_LICENSE = "COMBINED_LICENSE"
+
+# Set metadata after class creation
+LicensingStageEnum._metadata = {
+    "PRE_APPLICATION": {'description': 'Pre-application consultation and preparation'},
+    "CONSTRUCTION_PERMIT": {'description': 'Construction permit application and review'},
+    "OPERATING_LICENSE": {'description': 'Operating license application and review'},
+    "LICENSE_RENEWAL": {'description': 'License renewal application and review'},
+    "POWER_UPRATE": {'description': 'Power uprate license amendment'},
+    "DECOMMISSIONING_PLAN": {'description': 'Decommissioning plan approval'},
+    "LICENSE_TERMINATION": {'description': 'License termination and site release'},
+    "DESIGN_CERTIFICATION": {'description': 'Standard design certification'},
+    "EARLY_SITE_PERMIT": {'description': 'Early site permit for future construction'},
+    "COMBINED_LICENSE": {'description': 'Combined construction and operating license'},
+}
+
+class ComplianceStandardEnum(RichEnum):
+    """
+    Nuclear safety and security compliance standards
+    """
+    # Enum members
+    ISO_14001 = "ISO_14001"
+    ISO_9001 = "ISO_9001"
+    ASME_NQA_1 = "ASME_NQA_1"
+    IEEE_603 = "IEEE_603"
+    IEC_61513 = "IEC_61513"
+    ANSI_N45_2 = "ANSI_N45_2"
+    NUREG_0800 = "NUREG_0800"
+    IAEA_GSR = "IAEA_GSR"
+    IAEA_NSS = "IAEA_NSS"
+    WENRA_RL = "WENRA_RL"
+
+# Set metadata after class creation
+ComplianceStandardEnum._metadata = {
+    "ISO_14001": {'description': 'Environmental Management Systems'},
+    "ISO_9001": {'description': 'Quality Management Systems'},
+    "ASME_NQA_1": {'description': 'Quality Assurance Requirements for Nuclear Facility Applications'},
+    "IEEE_603": {'description': 'IEEE Standard Criteria for Safety Systems for Nuclear Power Generating Stations'},
+    "IEC_61513": {'description': 'Nuclear power plants - Instrumentation and control systems'},
+    "ANSI_N45_2": {'description': 'Quality Assurance Program Requirements for Nuclear Power Plants'},
+    "NUREG_0800": {'description': 'Standard Review Plan for the Review of Safety Analysis Reports'},
+    "IAEA_GSR": {'description': 'IAEA General Safety Requirements'},
+    "IAEA_NSS": {'description': 'IAEA Nuclear Security Series'},
+    "WENRA_RL": {'description': 'Western European Nuclear Regulators Association Reference Levels'},
+}
+
+class InspectionTypeEnum(RichEnum):
+    """
+    Types of nuclear regulatory inspections and assessments
+    """
+    # Enum members
+    ROUTINE_INSPECTION = "ROUTINE_INSPECTION"
+    REACTIVE_INSPECTION = "REACTIVE_INSPECTION"
+    TEAM_INSPECTION = "TEAM_INSPECTION"
+    TRIENNIAL_INSPECTION = "TRIENNIAL_INSPECTION"
+    CONSTRUCTION_INSPECTION = "CONSTRUCTION_INSPECTION"
+    PRE_OPERATIONAL_TESTING = "PRE_OPERATIONAL_TESTING"
+    STARTUP_TESTING = "STARTUP_TESTING"
+    PERIODIC_SAFETY_REVIEW = "PERIODIC_SAFETY_REVIEW"
+    INTEGRATED_INSPECTION = "INTEGRATED_INSPECTION"
+    FORCE_ON_FORCE = "FORCE_ON_FORCE"
+    EMERGENCY_PREPAREDNESS = "EMERGENCY_PREPAREDNESS"
+    SPECIAL_INSPECTION = "SPECIAL_INSPECTION"
+    VENDOR_INSPECTION = "VENDOR_INSPECTION"
+    CYBER_SECURITY = "CYBER_SECURITY"
+    DECOMMISSIONING_INSPECTION = "DECOMMISSIONING_INSPECTION"
+
+# Set metadata after class creation
+InspectionTypeEnum._metadata = {
+    "ROUTINE_INSPECTION": {'description': 'Regularly scheduled inspection activities'},
+    "REACTIVE_INSPECTION": {'description': 'Event-driven or follow-up inspections'},
+    "TEAM_INSPECTION": {'description': 'Multi-disciplinary team inspections'},
+    "TRIENNIAL_INSPECTION": {'description': 'Three-year cycle comprehensive inspections'},
+    "CONSTRUCTION_INSPECTION": {'description': 'Construction phase inspections'},
+    "PRE_OPERATIONAL_TESTING": {'description': 'Pre-operational testing and commissioning inspections'},
+    "STARTUP_TESTING": {'description': 'Initial startup and power ascension inspections'},
+    "PERIODIC_SAFETY_REVIEW": {'description': 'Comprehensive periodic safety reviews'},
+    "INTEGRATED_INSPECTION": {'description': 'Integrated inspection program'},
+    "FORCE_ON_FORCE": {'description': 'Security force-on-force exercises'},
+    "EMERGENCY_PREPAREDNESS": {'description': 'Emergency preparedness and response inspections'},
+    "SPECIAL_INSPECTION": {'description': 'Special inspections for significant events'},
+    "VENDOR_INSPECTION": {'description': 'Nuclear vendor and supplier inspections'},
+    "CYBER_SECURITY": {'description': 'Cybersecurity program inspections'},
+    "DECOMMISSIONING_INSPECTION": {'description': 'Decommissioning activities inspections'},
+}
+
+__all__ = [
+    "NuclearRegulatoryBodyEnum",
+    "RegulatoryFrameworkEnum",
+    "LicensingStageEnum",
+    "ComplianceStandardEnum",
+    "InspectionTypeEnum",
+]

valuesets/enums/energy/nuclear/nuclear_safety.py

@@ -0,0 +1,164 @@
+"""
+Nuclear Safety Classifications and Emergency Levels
+
+Nuclear safety classifications including INES scale, emergency action levels, nuclear security categories, and safety system classifications. Based on IAEA standards, NRC regulations, and international nuclear safety frameworks.
+
+Generated from: energy/nuclear/nuclear_safety.yaml
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Any, Optional
+from valuesets.generators.rich_enum import RichEnum
+
+class INESLevelEnum(RichEnum):
+    """
+    International Nuclear and Radiological Event Scale (INES) levels
+    """
+    # Enum members
+    LEVEL_0 = "LEVEL_0"
+    LEVEL_1 = "LEVEL_1"
+    LEVEL_2 = "LEVEL_2"
+    LEVEL_3 = "LEVEL_3"
+    LEVEL_4 = "LEVEL_4"
+    LEVEL_5 = "LEVEL_5"
+    LEVEL_6 = "LEVEL_6"
+    LEVEL_7 = "LEVEL_7"
+
+# Set metadata after class creation
+INESLevelEnum._metadata = {
+    "LEVEL_0": {'description': 'Events without safety significance', 'annotations': {'scale_position': 'below scale', 'safety_significance': 'no safety significance', 'public_impact': 'none', 'examples': 'minor technical issues'}},
+    "LEVEL_1": {'description': 'Anomaly beyond authorized operating regime', 'annotations': {'scale_position': 'incidents', 'safety_significance': 'minor', 'public_impact': 'none', 'examples': 'minor contamination, minor safety system failure'}},
+    "LEVEL_2": {'description': 'Incident with significant defenses remaining', 'annotations': {'scale_position': 'incidents', 'safety_significance': 'minor', 'public_impact': 'none', 'radiation_dose': '<10 mSv to workers'}},
+    "LEVEL_3": {'description': 'Serious incident with some defense degradation', 'annotations': {'scale_position': 'incidents', 'safety_significance': 'minor', 'public_impact': 'very minor', 'radiation_dose': '<100 mSv to workers', 'examples': 'near accident, serious contamination'}},
+    "LEVEL_4": {'description': 'Accident with minor off-site releases', 'annotations': {'scale_position': 'accidents', 'safety_significance': 'moderate', 'public_impact': 'minor local impact', 'evacuation': 'not required', 'examples': 'partial core damage'}},
+    "LEVEL_5": {'description': 'Accident with limited off-site releases', 'annotations': {'scale_position': 'accidents', 'safety_significance': 'moderate to major', 'public_impact': 'limited wider impact', 'protective_actions': 'limited evacuation', 'examples': 'Three Mile Island (1979)'}},
+    "LEVEL_6": {'description': 'Serious accident with significant releases', 'annotations': {'scale_position': 'accidents', 'safety_significance': 'major', 'public_impact': 'significant', 'protective_actions': 'extensive evacuation and countermeasures'}},
+    "LEVEL_7": {'description': 'Major accident with widespread health and environmental effects', 'annotations': {'scale_position': 'accidents', 'safety_significance': 'major', 'public_impact': 'widespread', 'examples': 'Chernobyl (1986), Fukushima (2011)', 'consequences': 'long-term environmental contamination'}},
+}
+
+class EmergencyClassificationEnum(RichEnum):
+    """
+    Nuclear emergency action levels and classifications
+    """
+    # Enum members
+    NOTIFICATION_UNUSUAL_EVENT = "NOTIFICATION_UNUSUAL_EVENT"
+    ALERT = "ALERT"
+    SITE_AREA_EMERGENCY = "SITE_AREA_EMERGENCY"
+    GENERAL_EMERGENCY = "GENERAL_EMERGENCY"
+
+# Set metadata after class creation
+EmergencyClassificationEnum._metadata = {
+    "NOTIFICATION_UNUSUAL_EVENT": {'description': 'Events that are in process or have occurred which indicate potential degradation', 'annotations': {'severity': 'lowest emergency level', 'off_site_response': 'notification only', 'public_protective_actions': 'none required', 'emergency_response': 'minimal activation'}, 'aliases': ['NOUE', 'Unusual Event']},
+    "ALERT": {'description': 'Events involving actual or potential substantial degradation of plant safety', 'annotations': {'severity': 'second emergency level', 'off_site_response': 'notification and standby', 'public_protective_actions': 'none required, but preparation', 'emergency_response': 'partial activation', 'plant_status': 'substantial safety degradation possible'}},
+    "SITE_AREA_EMERGENCY": {'description': 'Events with actual or likely major failures of plant protective systems', 'annotations': {'severity': 'third emergency level', 'off_site_response': 'offsite centers activated', 'public_protective_actions': 'may be required near site', 'emergency_response': 'full activation', 'plant_status': 'major plant safety systems failure'}, 'aliases': ['SAE']},
+    "GENERAL_EMERGENCY": {'description': 'Events involving actual or imminent substantial core degradation', 'annotations': {'severity': 'highest emergency level', 'off_site_response': 'full activation', 'public_protective_actions': 'implementation likely', 'emergency_response': 'maximum response', 'plant_status': 'core degradation or containment failure'}},
+}
+
+class NuclearSecurityCategoryEnum(RichEnum):
+    """
+    IAEA nuclear material security categories (INFCIRC/225)
+    """
+    # Enum members
+    CATEGORY_I = "CATEGORY_I"
+    CATEGORY_II = "CATEGORY_II"
+    CATEGORY_III = "CATEGORY_III"
+    CATEGORY_IV = "CATEGORY_IV"
+
+# Set metadata after class creation
+NuclearSecurityCategoryEnum._metadata = {
+    "CATEGORY_I": {'description': 'Material that can be used directly to manufacture nuclear explosive devices', 'annotations': {'direct_use': True, 'proliferation_risk': 'highest', 'protection_requirements': 'maximum', 'examples': 'HEU ≥20%, Pu ≥2kg, U-233 ≥2kg', 'physical_protection': 'multiple independent physical barriers'}},
+    "CATEGORY_II": {'description': 'Material requiring further processing to manufacture nuclear explosive devices', 'annotations': {'direct_use': 'requires processing', 'proliferation_risk': 'moderate', 'protection_requirements': 'substantial', 'examples': 'HEU <20% but >5%, natural uranium >500kg', 'physical_protection': 'significant barriers required'}},
+    "CATEGORY_III": {'description': 'Material posing radiation hazard but minimal proliferation risk', 'annotations': {'direct_use': False, 'proliferation_risk': 'low', 'protection_requirements': 'basic', 'examples': 'natural uranium 10-500kg, depleted uranium', 'physical_protection': 'basic measures sufficient'}},
+    "CATEGORY_IV": {'description': 'Material with minimal security significance', 'annotations': {'direct_use': False, 'proliferation_risk': 'minimal', 'protection_requirements': 'administrative', 'examples': 'small quantities of natural uranium'}},
+}
+
+class SafetySystemClassEnum(RichEnum):
+    """
+    Nuclear safety system classifications (based on IEEE and ASME standards)
+    """
+    # Enum members
+    CLASS_1E = "CLASS_1E"
+    SAFETY_RELATED = "SAFETY_RELATED"
+    SAFETY_SIGNIFICANT = "SAFETY_SIGNIFICANT"
+    NON_SAFETY_RELATED = "NON_SAFETY_RELATED"
+
+# Set metadata after class creation
+SafetySystemClassEnum._metadata = {
+    "CLASS_1E": {'description': 'Safety systems essential to emergency reactor shutdown and core cooling', 'annotations': {'safety_function': 'essential to safety', 'redundancy': 'required', 'independence': 'required', 'power_supply': 'independent emergency power', 'seismic_qualification': 'required', 'examples': 'reactor protection system, emergency core cooling'}},
+    "SAFETY_RELATED": {'description': 'Systems important to safety but not classified as Class 1E', 'annotations': {'safety_function': 'important to safety', 'quality_requirements': 'enhanced', 'testing_requirements': 'extensive', 'examples': 'some support systems, barriers'}},
+    "SAFETY_SIGNIFICANT": {'description': 'Systems with risk significance but not safety-related', 'annotations': {'safety_function': 'risk-significant', 'quality_requirements': 'graded approach', 'risk_informed': 'classification based on risk assessment'}},
+    "NON_SAFETY_RELATED": {'description': 'Systems not required for nuclear safety functions', 'annotations': {'safety_function': 'not required for safety', 'quality_requirements': 'commercial standards', 'failure_impact': 'minimal safety impact'}},
+}
+
+class ReactorSafetyFunctionEnum(RichEnum):
+    """
+    Fundamental nuclear reactor safety functions
+    """
+    # Enum members
+    REACTIVITY_CONTROL = "REACTIVITY_CONTROL"
+    HEAT_REMOVAL = "HEAT_REMOVAL"
+    CONTAINMENT_INTEGRITY = "CONTAINMENT_INTEGRITY"
+    CORE_COOLING = "CORE_COOLING"
+    SHUTDOWN_CAPABILITY = "SHUTDOWN_CAPABILITY"
+
+# Set metadata after class creation
+ReactorSafetyFunctionEnum._metadata = {
+    "REACTIVITY_CONTROL": {'description': 'Control of nuclear chain reaction', 'annotations': {'function': 'maintain reactor subcritical when required', 'systems': 'control rods, neutron absorbers', 'failure_consequence': 'criticality accident', 'defense_category': 'prevent accidents'}},
+    "HEAT_REMOVAL": {'description': 'Removal of decay heat from reactor core', 'annotations': {'function': 'prevent fuel overheating', 'systems': 'cooling systems, heat exchangers', 'failure_consequence': 'core damage, meltdown', 'defense_category': 'mitigate consequences'}},
+    "CONTAINMENT_INTEGRITY": {'description': 'Confinement of radioactive materials', 'annotations': {'function': 'prevent radioactive release', 'systems': 'containment structure, isolation systems', 'failure_consequence': 'environmental contamination', 'defense_category': 'mitigate consequences'}},
+    "CORE_COOLING": {'description': 'Maintenance of adequate core cooling', 'annotations': {'function': 'prevent fuel damage', 'systems': 'primary cooling, emergency cooling', 'failure_consequence': 'fuel damage', 'time_sensitivity': 'immediate to long-term'}},
+    "SHUTDOWN_CAPABILITY": {'description': 'Ability to shut down and maintain shutdown', 'annotations': {'function': 'terminate power operation safely', 'systems': 'control systems, shutdown systems', 'time_requirement': 'rapid response capability'}},
+}
+
+class DefenseInDepthLevelEnum(RichEnum):
+    """
+    Defense in depth barrier levels for nuclear safety
+    """
+    # Enum members
+    LEVEL_1 = "LEVEL_1"
+    LEVEL_2 = "LEVEL_2"
+    LEVEL_3 = "LEVEL_3"
+    LEVEL_4 = "LEVEL_4"
+    LEVEL_5 = "LEVEL_5"
+
+# Set metadata after class creation
+DefenseInDepthLevelEnum._metadata = {
+    "LEVEL_1": {'description': 'Conservative design and high quality in construction and operation', 'annotations': {'objective': 'prevent deviations from normal operation', 'approach': 'conservative design, quality assurance', 'examples': 'design margins, quality construction'}},
+    "LEVEL_2": {'description': 'Control of abnormal operation and detection of failures', 'annotations': {'objective': 'control abnormal operation and failures', 'approach': 'control systems, protection systems', 'examples': 'reactor protection systems, safety systems'}},
+    "LEVEL_3": {'description': 'Control of accidents to prevent progression to severe conditions', 'annotations': {'objective': 'control design basis accidents', 'approach': 'engineered safety features', 'examples': 'emergency core cooling, containment systems'}},
+    "LEVEL_4": {'description': 'Control of severe accidents including prevention of core melt progression', 'annotations': {'objective': 'control severe accidents', 'approach': 'severe accident management', 'examples': 'cavity flooding, filtered venting'}},
+    "LEVEL_5": {'description': 'Mitigation of off-site radiological consequences', 'annotations': {'objective': 'protect public and environment', 'approach': 'emergency planning and response', 'examples': 'evacuation plans, protective actions'}},
+}
+
+class RadiationProtectionZoneEnum(RichEnum):
+    """
+    Radiation protection zone classifications for nuclear facilities
+    """
+    # Enum members
+    EXCLUSION_AREA = "EXCLUSION_AREA"
+    LOW_POPULATION_ZONE = "LOW_POPULATION_ZONE"
+    EMERGENCY_PLANNING_ZONE = "EMERGENCY_PLANNING_ZONE"
+    INGESTION_PATHWAY_ZONE = "INGESTION_PATHWAY_ZONE"
+    CONTROLLED_AREA = "CONTROLLED_AREA"
+    SUPERVISED_AREA = "SUPERVISED_AREA"
+
+# Set metadata after class creation
+RadiationProtectionZoneEnum._metadata = {
+    "EXCLUSION_AREA": {'description': 'Area under control of reactor operator with restricted access', 'annotations': {'control': 'reactor operator', 'public_access': 'restricted', 'size': 'typically few hundred meters radius', 'purpose': 'immediate accident response control'}},
+    "LOW_POPULATION_ZONE": {'description': 'Area with low population density surrounding exclusion area', 'annotations': {'population_density': 'low', 'evacuation': 'feasible if needed', 'size': 'typically few kilometers radius', 'dose_limit': 'design basis for accident consequences'}},
+    "EMERGENCY_PLANNING_ZONE": {'description': 'Area for which emergency planning is conducted', 'annotations': {'planning_required': 'comprehensive emergency plans', 'size': 'typically 10-mile (16 km) radius', 'protective_actions': 'evacuation and sheltering plans'}},
+    "INGESTION_PATHWAY_ZONE": {'description': 'Area for controlling food and water contamination', 'annotations': {'contamination_control': 'food and water supplies', 'size': 'typically 50-mile (80 km) radius', 'monitoring': 'food chain monitoring required'}},
+    "CONTROLLED_AREA": {'description': 'Area within facility boundary with access control', 'annotations': {'access_control': 'personnel monitoring required', 'radiation_monitoring': 'continuous monitoring', 'training_required': 'radiation safety training'}},
+    "SUPERVISED_AREA": {'description': 'Area with potential for radiation exposure but lower than controlled', 'annotations': {'monitoring': 'periodic monitoring', 'access_control': 'limited restrictions', 'training_required': 'basic radiation awareness'}},
+}
+
+__all__ = [
+    "INESLevelEnum",
+    "EmergencyClassificationEnum",
+    "NuclearSecurityCategoryEnum",
+    "SafetySystemClassEnum",
+    "ReactorSafetyFunctionEnum",
+    "DefenseInDepthLevelEnum",
+    "RadiationProtectionZoneEnum",
+]