ElectraNalis

Run a study

Start with the trainer, then use the same commands with a compatible project.

Run the included trainer project

  1. Download the verified ElectraNalis solver and extract it. The download manifest lists the SHA-256 checksum for this exact solver archive.
  2. 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.

  1. python project.py arc-handoff duty-review-example.json --output review-handoff.json
  2. python project.py time-duty-cases duty-review-example.json --output review-duty.csv
  3. 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.

  1. python project.py one-line-drawing trainer-project.json --drawing-package --include-project --output review-drawing.zip
  2. 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.

  1. python project.py one-line-drawing ElectraGrid-qetz-mapped-protection-project.json --derive-one-line --drawing-package --include-project --output cad-review.zip
  2. 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