Run a study
Start with the trainer, then use the same commands with a compatible project.
Run the included trainer project
- Download the verified ElectraNalis solver and extract it. The download manifest lists the SHA-256 checksum for this exact solver archive.
- Open a terminal in the extracted folder. Run these commands with Python 3.10 or later.
python project.py validate trainer-project.json
python project.py ac trainer-project.json
python project.py drawing trainer-project.json --output terminal.html
python project.py time-duty trainer-project.json
python project.py arc-handoff trainer-project.json --output handoff.json
Validation should report a valid project. The AC example returns 14 bus results. Open terminal.html in your browser. Equipment duty prints to the terminal. Use a fresh output name if a report already exists.
The handoff JSON records inputs for an incident-energy review. See the incident-energy guide for the review sequence.
Run the data center example
Download data-center-example.json into the extracted release folder.
python project.py validate data-center-example.json
python project.py ac data-center-example.json
python project.py n-1 data-center-example.json
The five-bus load flow should converge. The N-1 study tests all four branch outages individually. Each outage creates an island. Read the outage equipment ID and the island AC status to see which portion of the network can still be solved.
Review equipment duty and arc flash together
Download the solver above and extract it. Open a terminal in the extracted folder and run these three commands in order.
python project.py arc-handoff duty-review-example.json --output review-handoff.json
python project.py time-duty-cases duty-review-example.json --output review-duty.csv
python review-duty-handoff.py review-handoff.json review-duty.csv
The reviewer identifies the matching duty row and checks the clearing, thermal, and interrupting results.
Download the handoff, equipment-duty CSV, and verification receipt from the same run.
Verify a drawing package
Download and extract the solver above. In the extracted folder, run both commands to generate the trainer package and check its terminal sheet, one-line, and schematic.
python project.py one-line-drawing trainer-project.json --drawing-package --include-project --output review-drawing.zip
python verify-drawing-package.py review-drawing.zip --project trainer-project.json --check-terminal-render --check-one-line-render --check-schematic-render
Verify an imported QElectroTech drawing
Use the archived QElectroTech example included with the solver. Generate the drawing package, then check its source file and rendered sheets.
python project.py one-line-drawing ElectraGrid-qetz-mapped-protection-project.json --derive-one-line --drawing-package --include-project --output cad-review.zip
python verify-drawing-package.py cad-review.zip --project ElectraGrid-qetz-mapped-protection-project.json --cad-source qetz-native-save.qetz --check-terminal-render --check-one-line-render
Replay restoration from recorded switch positions
Download and extract the solver above. In the extracted folder, run the command to see which customers remain without service at the end of the recorded outage.
python project.py topology-restoration recorded-case.json --historian-csv recorded-switch-feedback.csv
Check DC backup transfer
Download both example projects into the extracted solver folder. Run these commands to compare the same feeder halfway through transfer and when transfer completes.
python project.py dc-load-flow dc-transfer-pending.json
python project.py dc-fault dc-transfer-pending.json
python project.py dc-load-flow dc-transfer-complete.json
python project.py dc-fault dc-transfer-complete.json
While transfer is pending, the report shows no active source and 0.125 s remaining. The fault command returns an error because the feeder has no active source. At transfer completion, the backup supplies 80 V at 10 A and the fault report references the same load-flow input.
Screen cable sizes for a 300-foot feeder
Download the example project into the extracted solver folder.
python project.py cable-size feeder-sizing-project.json
Compare the continuous sizing result with the overall result. The 25 mm² candidate fails corrected ampacity. The 35 mm² candidate passes the continuous checks but fails a voltage-drop case. The 50 mm² candidate passes all cases in this synthetic example.
Export the running and starting voltage-drop checks for each candidate, or download the verified example CSV.
python project.py cable-size feeder-sizing-project.json --voltage-drop-cases --output feeder-review.csv
Use the margin column to identify candidates that exceed a case limit. The study input checksum ties every CSV row to the sizing result.
Study a control response to a ramp
Download the example project into the extracted solver folder. The output starts at 6, holds steady for the first second, and reaches approximately 6.736 at 2 seconds.
python project.py dynamic-block dynamic-equilibrium.json
python project.py dynamic-block dynamic-equilibrium.json --output dynamic-samples.csv
Download the verified sample CSV