Skip to main content
Ctrl+K

paroto 0.1.dev1+g57680cbf6 documentation

  • Examples Gallery
  • API Reference
  • Examples Gallery
  • API Reference

Section Navigation

  • Setup: Import Required Modules
  • VDEF MDAO Optimization Example
  • VedEf Operating Window - 5D Parameter Space Exploration
  • Paroto Model Gallery
    • Arc Density Constraint Model
    • Arc Coverage Model (Basic)
    • Arc Coverage Model
    • Energy to Temperature Conversion
    • High Voltage Generator System
    • Initial Temperature Model
    • Arc Mobility Model
    • Pulsed Breakdown Model
    • Torch Flow System
  • Paroto Examples
  • Paroto Model Gallery

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.

Related Resources#

Full Validation Scripts#

For detailed temporal behavior and comprehensive validation:

  • paroto/validation/validate_initial_temperature.py - 4 plots showing T(t) evolution

  • paroto/validation/validate_pulsed_breakdown.py - Memory effects and transitions

  • paroto/validation/validate_coverage.py - Coverage vs frequency analysis

  • paroto/validation/validate_mobility.py - Displacement and lensing risk

Complete Examples#

For integrated system examples:

  • examples/VedEf_optim/example_operating_window_5d.py - 5D parameter sweep

  • examples/VedEf_optim/dashboard_operating_window.py - Interactive dashboard

  • examples/VDEF_optim/example_vdef_mdao.py - MDAO optimization

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:

  1. Create a minimal 20-30 line script

  2. Include clear comments and output

  3. Add entry to this README

  4. Reference the gallery example in the model’s docstring

Arc Density Constraint Model

Arc Density Constraint Model

Arc Coverage Model (Basic)

Arc Coverage Model (Basic)

Arc Coverage Model

Arc Coverage Model

Energy to Temperature Conversion

Energy to Temperature Conversion

High Voltage Generator System

High Voltage Generator System

Initial Temperature Model

Initial Temperature Model

Arc Mobility Model

Arc Mobility Model

Pulsed Breakdown Model

Pulsed Breakdown Model

Torch Flow System

Torch Flow System

previous

<no title>

next

Arc Density Constraint Model

On this page
  • Quick Start
  • Gallery Index
    • 1. Initial Temperature Model
    • 1b. Energy to Temperature Conversion
    • 2. Coverage Model
    • 3. Arc Density Constraint Model
    • 4. Pulsed Breakdown Model
    • 5. Arc Mobility Model
    • 6. High Voltage Generator System
    • 7. Torch Flow System
  • Related Resources
    • Full Validation Scripts
    • Complete Examples
  • Model Documentation
  • Requirements
  • Notes
  • Contributing

This Page

  • Show Source

© Copyright 2025, Copyright (C) Spark Cleantech SAS (SIREN 909736068).

Created using Sphinx 8.2.3.

Built with the PyData Sphinx Theme 0.16.1.