{"sections":[{"heading":"Before starting","paragraphs":["Use the matching JoSIM-Pro release and its installed examples. Simulation requires the SUN Magnetics License Manager, a reachable smlicensed daemon and a valid licensing setup. Continue degraded is an inspection/recovery path, not a licensed simulation path."]},{"figures":[{"asset_id":"josim-jtl-editor","caption":"Open JTL_Example.cir as a source tab, then use the Run triangle in the toolbar."},{"asset_id":"josim-run-settings","caption":"For the documented starting path, keep Phase analysis, BDF integration and variable-step mode off."}],"heading":"Run the example","steps":["Launch JoSIM-Pro using the installed application launcher. On Linux, use the provided josim-pro-gui wrapper so the runtime library path is prepared.","Use File > Open Folder... to open the installed examples directory, then open JTL_Example.cir. Work on a copy if you intend to edit it.","Keep the supplied run settings for the first simulation. With the source netlist active, press the Run toolbar button.","Wait for completion and inspect the requested traces in Results. An imported CSV/TSV result tab is for inspection; open the .cir source to run a simulation."]},{"code":"josim-pro-cli -o JTL_Example.csv JTL_Example.cir","heading":"Command-line alternative","paragraphs":["From a writable copy of the example directory, the manual gives:"]},{"figures":[{"asset_id":"josim-jtl-current-waveforms","caption":"The current licensed JTL run: input pulses, two phase traces and output pulses. Compare trace identity and units before comparing values."}],"heading":"Check the result","paragraphs":["The recorded licensed Windows GUI candidate produced 1,001 finite samples across four named traces from 0 to 250 ps: V(VIN), P(BJJ|X1|XJTL), P(BJJ|X3|XJTL) and V(ROUT). The earlier 2.9 CLI check also produced this sample count and time span.","Check the trace names, time coverage and units in your own current result. The displayed voltage axes use microvolts and time uses picoseconds; the numerical CSV uses volts and seconds, while phase is in radians.","This establishes scoped execution and output integrity for the recorded inputs and runtime. It does not establish physical accuracy, a solver regression tolerance, the complete walkthrough or final distributed-package applicability."]},{"heading":"Reopen the saved source after exit","paragraphs":["Save the netlist and record its location before closing. In the checked Windows source candidate, normal exit cleared the saved tab session and the next process restored no active document. This is tracked as KB-GUI-007; do not rely on automatic restoration for that candidate.","If no document returns, explicitly open your saved JTL_Example.cir source, verify its path and run again. This manual reopen-and-run route passed in a separate process before CSV export. It does not repair automatic restoration or establish that previous in-memory results survived exit."]}],"canonical_url":"https://www.sun-magnetics.com/knowledge-base/josim-first-jtl","url":"/knowledge-base/josim-first-jtl","known_issues":[{"disposition":"verified_workaround","id":"KB-GUI-007","title":"JoSIM normal exit clears the saved session after closing tabs","public_notice":"Save the intended source, record its location and explicitly reopen and run it after relaunch. Automatic normal-exit tab restoration is not accepted on the checked JoSIM candidate.","claim_scope":"Only the affected claim and recorded build/input; not whole-guide or final-release acceptance"}],"search_record":{"execution":true,"relatedProducts":[],"version_tags":["JoSIM-Pro 2.9 target"],"text":"Run the installed JTL example in JoSIM-Pro Open the installed JTL_Example.cir netlist, run it and inspect the resulting traces. The manual recommends this self-contained example for a first simulation. JoSIM-Pro 2.9.0 release target; current-source Windows candidate evidence Get started Before starting Use the matching JoSIM-Pro release and its installed examples. Simulation requires the SUN Magnetics License Manager, a reachable smlicensed daemon and a valid licensing setup. Continue degraded is an inspection/recovery path, not a licensed simulation path.  Run the example Launch JoSIM-Pro using the installed application launcher. On Linux, use the provided josim-pro-gui wrapper so the runtime library path is prepared. Use File > Open Folder... to open the installed examples directory, then open JTL_Example.cir. Work on a copy if you intend to edit it. Keep the supplied run settings for the first simulation. With the source netlist active, press the Run toolbar button. Wait for completion and inspect the requested traces in Results. An imported CSV/TSV result tab is for inspection; open the .cir source to run a simulation.  Open JTL_Example.cir as a source tab, then use the Run triangle in the toolbar. JoSIM source editor with JTL_Example.cir open, source breadcrumbs, line numbers and the Run triangle in the toolbar. For the documented starting path, keep Phase analysis, BDF integration and variable-step mode off. Run settings showing Phase analysis, BDF integration, variable-step mode off, deterministic-seed controls and output precision. Command-line alternative From a writable copy of the example directory, the manual gives: josim-pro-cli -o JTL_Example.csv JTL_Example.cir Check the result The recorded licensed Windows GUI candidate produced 1,001 finite samples across four named traces from 0 to 250 ps: V(VIN), P(BJJ|X1|XJTL), P(BJJ|X3|XJTL) and V(ROUT). The earlier 2.9 CLI check also produced this sample count and time span. Check the trace names, time coverage and units in your own current result. The displayed voltage axes use microvolts and time uses picoseconds; the numerical CSV uses volts and seconds, while phase is in radians. This establishes scoped execution and output integrity for the recorded inputs and runtime. It does not establish physical accuracy, a solver regression tolerance, the complete walkthrough or final distributed-package applicability.  The current licensed JTL run: input pulses, two phase traces and output pulses. Compare trace identity and units before comparing values. Current JTL simulation with four plots: input and output voltage pulses in microvolts and two junction phase traces in radians, over 0 to 250 picoseconds. Reopen the saved source after exit Save the netlist and record its location before closing. In the checked Windows source candidate, normal exit cleared the saved tab session and the next process restored no active document. This is tracked as KB-GUI-007; do not rely on automatic restoration for that candidate. If no document returns, explicitly open your saved JTL_Example.cir source, verify its path and run again. This manual reopen-and-run route passed in a separate process before CSV export. It does not repair automatic restoration or establish that previous in-memory results survived exit. ","id":"josim-first-jtl","keywords":"","kind":"Get started","title":"Run the installed JTL example in JoSIM-Pro","product":"JoSIM-Pro"},"version":"2.9.0 release target; current-source Windows candidate evidence","id":"josim-first-jtl","related":["/knowledge-base/josim-licensing-unavailable","/knowledge-base/josim-missing-include","/knowledge-base/josim-export-results","/knowledge-base/josim-run-current-source"],"downloads":[],"publication_status":"published","numerical_output":null,"provenance":{"execution_checks":[{"scope":"CLI transient and output integrity","result":"passed","articles":["josim-first-jtl"],"version":"JoSIM-Pro 2.9.0 Windows review build; release target","id":"VAL-003","records":["josim-jtl-cli"],"limit":"This earlier CLI check verifies finite traces and time coverage on the 2.9 review build. Later scoped native candidate evidence is VAL-016; complete GUI and final-package checks remain pending.","observed":{"all_values_finite":true,"samples":1001,"time_start_seconds":0,"traces":4,"time_stop_seconds":2.5e-10,"columns":["time","V(VIN)","P(BJJ|X1|XJTL)","P(BJJ|X3|XJTL)","V(ROUT)"]}},{"routes":["cli","python-api"],"scope":"Packaged JTL through Python Input/Matrix/Simulation, raw and named arrays, formatted output axis and CSV writer; the same current CLI produced exactly matching parsed CSV","result":"passed","articles":["josim-first-jtl","josim-cli-output","josim-python-first-run","josim-api-output"],"purpose":"python-first-run-and-output","version":"JoSIM-Pro 2.9.0 Windows review runtime; CPython 3.13.11 and NumPy 2.5.4 in an isolated environment","id":"VAL-012","records":["python-jtl-first-run","python-parity-cli"],"limit":"Execution, finite data, shape/time coverage and same-engine interface agreement. No independent physical reference, convergence, GUI, other interpreter/platform or final-release qualification.","observed":{"named_csv_shape_and_time_coverage":true,"samples":1001,"time_start_seconds":0,"named_traces":4,"documented_first_run_completed":true,"raw_state_shape":[12,1001],"accepted_steps_reported":true,"installed_inputs_module_and_core_unchanged":true,"time_end_seconds":2.5e-10,"four_finite_named_trace_arrays":true,"formatted_axis_matches_named_trace_lengths":true,"cli_and_python_csv_exactly_agree":true,"raw_time_and_state_arrays":true,"intended_loaded_core":true,"intended_python_module":true}},{"routes":["gui-native-scenario","operator-assisted-save"],"scope":"Production GUI controls, normal licensed JTL and AND runs, missing-include restoration, exact input/output collision rejection and operator-assisted CSV/All traces export. Explicitly reopening saved JTL and rerunning also passed","result":"passed","articles":["josim-first-jtl","josim-missing-include","josim-output-path-collision","josim-export-results","josim-run-current-source"],"purpose":"josim-native-run-recovery-operator-csv-export","operator_step":"Owner explicitly reported an invalid path in the Save dialog, rather than a path-length problem, and confirmed saving successfully to the supplied existing destination. The erroneous starting filename was not retained for an independent path diagnosis. The native helper only proves its own production actions; the Save dialog was handled by the owner.","version":"JoSIM-Pro 2.9 current-source Windows candidate with matching freshly built runtime; not the final distributed package","id":"VAL-016","records":["josim-native-run","josim-native-export","independent-review","owner-save-confirmation"],"restart":{"tabs_after_process_exit":0,"tabs_before_close":2,"native_restart_status":"failed","issue":"KB-GUI-007","automatic_restoration_passed":false,"tabs_after_close":2},"limit":"Automatic session restoration failed (KB-GUI-007). File opening was supplied at the production OpenFile boundary; folder-picker input, cancellation, retry, other export formats, physical accuracy and final-package acceptance remain unverified. CSV/CLI differences were at most one ULP in this example, not an accuracy or regression tolerance. The Clang-built runtime does not close the separate MSVC/OpenMP finding KB-BUILD-001. External Computer Use capture remains unqualified.","observed":{"csv_vs_fresh_cli_max_ulp_by_column":[1,1,1,1,1],"and_samples":2001,"traces":["V(VIN)","P(BJJ|X1|XJTL)","P(BJJ|X3|XJTL)","V(ROUT)"],"time_stop_s":2.5e-10,"units":{"V(ROUT)":"V","time":"s","P(BJJ|X3|XJTL)":"rad","V(VIN)":"V","P(BJJ|X1|XJTL)":"rad"},"csv_vs_fresh_cli_max_abs_by_column":[2.5849394142282115e-26,1.0842021724855044e-19,3.552713678800501e-15,3.552713678800501e-15,1.0842021724855044e-19],"jtl_samples":1001,"time_start_s":0}}],"figure_evidence":[{"evidence_limit":"A maintained manual UI reference, not a fresh calculation or a completed walkthrough. Final distributed-package applicability remains to be checked.","id":"josim-jtl-editor","reference_label":"JoSIM-Pro 2.9 manual UI reference"},{"evidence_limit":"A maintained manual UI reference, not a fresh calculation or a completed walkthrough. Final distributed-package applicability remains to be checked.","id":"josim-run-settings","reference_label":"JoSIM-Pro 2.9 manual UI reference"},{"evidence_limit":"Illustrates the recorded candidate state. The Save dialog was completed by the owner. Full article acceptance, automatic session restoration and final distributed-package applicability remain pending.","id":"josim-jtl-current-waveforms","reference_label":"Windows JoSIM-Pro 2.9 current-source native scenario, 3 November 2026"}],"review_notes":["The owner selected 2.9 for the public starting path. Historical 2.7 control runs remain internal; the website shunted-junction bundle is a separate example.","VAL-016 adds normal licensed native run and explicitly reopened-source checks. Folder-picker interaction, complete walkthrough, physical validation and final release-package checks remain pending. Automatic restoration failed (KB-GUI-007)."],"scope":"Recorded inputs/builds only. Complete walkthrough and final-package acceptance remain separate.","verification_requirements":{"gui_method":"product-native scenario or recorded operator walkthrough; screenshots required for GUI guidance","status":"review-incomplete","illustrations":"required","required":["technical-review","release-applicability","gui-workflow","execution","numerical-interpretation","illustrations"],"legacy_walkthrough_field":"pending retained; not evidence of a complete scenario"},"sources":[{"id":"josim-pro:docs/manual_source/sections/gui_quick_start.tex","section":"GUI Quick Start: First Simulation"},{"id":"validation:windows-cli-20261102","section":"VAL-003; scope and limits recorded"},{"id":"owner:technical-review-20261102","section":"JoSIM-Pro 2.9 chosen as the public starting path; release availability must be checked before publication"},{"id":"validation:windows-workflows-20261103","section":"VAL-011/VAL-012; exact route, runtime and evidence limits"},{"id":"validation:josim-native-windows-20261103","section":"VAL-016; exact native actions, independent output checks, operator Save and failed automatic-restoration boundary"}]},"title":"Run the installed JTL example in JoSIM®-Pro","type":"Get started","markdown_url":"/_functions/kbResource?path=markdown%2Fjosim-first-jtl.md","summary":"Open the installed JTL_Example.cir netlist, run it and inspect the resulting traces. The manual recommends this self-contained example for a first simulation.","product":"JoSIM-Pro"}