Paroto Model Gallery#
This gallery contains minimal, standalone examples demonstrating individual models from the paroto library. Each example is self-contained (20-30 lines) and can be run independently.
Quick Start#
Each example can be run directly:
python plot_initial_temperature_model_example.py
python plot_coverage_model_example.py
python plot_arc_density_model_example.py
python plot_pulsed_breakdown_example.py
python plot_mobility_model_example.py
python plot_generator_system_example.py
python plot_torch_flow_system_example.py
Gallery Index#
1. Initial Temperature Model#
File: plot_initial_temperature_model_example.py
Demonstrates the PulseInitialTemperatureModel which computes initial gas temperature
accounting for:
Energy-to-temperature conversion (via sub-model)
Cylindrical thermal diffusion
Relaxation between pulses
Output: Temperature evolution plot showing instantaneous jump and exponential decay.
1b. Energy to Temperature Conversion#
File: plot_energy_to_temperature_example.py
Demonstrates both energy conversion models:
ConstantCpEnergyModel- Simple, constant specific heat (low fidelity)CanteraEnergyModel- Temperature-dependent properties (high fidelity)
Output: Comparison of both models showing temperature rise differences.
2. Coverage Model#
File: plot_coverage_model_example.py
Demonstrates the ArcCoverageModel which ensures complete gas treatment by the arc:
Coverage fraction calculation
Constraint satisfaction check
Recommendations for incomplete coverage
Output: Text summary of coverage analysis.
3. Arc Density Constraint Model#
File: plot_arc_density_model_example.py
Demonstrates the ArcDensityConstraintModel which limits energy density in the arc:
Energy density calculation
Constraint margin
Safety assessment
Output: Text summary of energy density check.
4. Pulsed Breakdown Model#
File: plot_pulsed_breakdown_example.py
Demonstrates the RepetitivePulseBreakdownModel showing memory effects:
Breakdown voltage for 1, 10, 100 pulses
Transition from single-pulse to DC breakdown
Memory effect from repetitive pulsing
Output: Text summary showing voltage reduction with pulse number.
5. Arc Mobility Model#
File: plot_mobility_model_example.py
Demonstrates the BrownianArcMobilityModel for arc displacement:
RMS displacement calculation
Mobility factor
Thermal load spreading
Output: Text summary of arc movement characteristics.
6. High Voltage Generator System#
File: plot_generator_system_example.py
Demonstrates the HighVoltageGeneratorSystem for operating window constraints:
Operating window power calculation
Constraint satisfaction check
Generator capability assessment
Output: Text summary of generator operating point.
7. Torch Flow System#
File: plot_torch_flow_system_example.py
Demonstrates the TorchFlowSystem for flow calculations:
Flow velocity computation
Residence time calculation
Pressure drop estimation
Output: Text summary of flow characteristics.
Model Documentation#
Each model class includes comprehensive docstrings with:
Physics equations in LaTeX format
Input/output descriptions
Usage examples
References to gallery and validation scripts
Requirements#
Python 3.11+
OpenMDAO >= 3.27
NumPy
Matplotlib (for examples with plots)
paroto library installed (
pip install -e .from repo root)
Notes#
⚠️ AI-Generated Equations Warning: The physics equations in these models are AI-generated and not yet validated for production use. They serve as demonstrations of the model framework and should be validated against experimental data before use in real applications.
Contributing#
To add a new gallery example:
Create a minimal 20-30 line script
Include clear comments and output
Add entry to this README
Reference the gallery example in the model’s docstring