{"sections":[{"heading":"Check the missing file","steps":["Read the exact file or .include diagnostic and inspect the reference as written in the netlist.","Confirm that the included file exists at the intended location. Preserve nearby files when copying a project; use stable explicit relative references where appropriate.","In the GUI, use File > Open Folder... for a project that depends on nearby include files.","For AND_Example.cir, keep the installed base_cells.cir in the same example directory. Save a writable working copy and rerun after correcting the missing dependency."]},{"heading":"If the file can be found but the error remains","paragraphs":["Distinguish a missing include from a subcircuit problem. Check matching .subckt/.ends boundaries, subcircuit names, the number of connection nodes and cyclic include/subcircuit relationships. Use the specific diagnostic rather than assuming all these errors have the same cause."]},{"heading":"A smaller starting point","paragraphs":["Use JTL_Example.cir for the first simulation if you are still checking installation and licensing. The manual identifies it as self-contained."]},{"code":"josim-pro-cli -o recovered.csv AND_Example.cir","heading":"Checked command-line recovery","paragraphs":["On a disposable working copy, omitting base_cells.cir caused an exit with a missing-file diagnostic and no CSV. Restoring the unchanged library recovered the run: 2,001 finite samples, four traces, 0–250 ps."]},{"heading":"Checked native GUI recovery","paragraphs":["On a disposable AND example, the normal licensed GUI Run action rejected the missing base_cells.cir with a specific include diagnostic. Restoring the unchanged library beside AND_Example.cir and rerunning produced 2,001 finite samples across four traces over 0–250 ps. The source and library hashes were preserved.","This verifies the recorded production run/recovery actions on the Windows candidate. File > Open Folder picker interaction and the final package remain unchecked. The diagnostic screenshot was withheld because it contained a personal workspace path; useful path-free recovery imagery is still needed."]}],"canonical_url":"https://www.sun-magnetics.com/knowledge-base/josim-missing-include","url":"/knowledge-base/josim-missing-include","known_issues":[],"search_record":{"execution":true,"relatedProducts":[],"version_tags":["JoSIM-Pro 2.9 target"],"text":"A JoSIM-Pro netlist cannot find an included file Check the .include reference and preserve the files used by the project. The installed AND example requires base_cells.cir alongside the main example. JoSIM-Pro 2.9.0 release target; current-source Windows candidate evidence Troubleshooting Check the missing file Read the exact file or .include diagnostic and inspect the reference as written in the netlist. Confirm that the included file exists at the intended location. Preserve nearby files when copying a project; use stable explicit relative references where appropriate. In the GUI, use File > Open Folder... for a project that depends on nearby include files. For AND_Example.cir, keep the installed base_cells.cir in the same example directory. Save a writable working copy and rerun after correcting the missing dependency.  If the file can be found but the error remains Distinguish a missing include from a subcircuit problem. Check matching .subckt/.ends boundaries, subcircuit names, the number of connection nodes and cyclic include/subcircuit relationships. Use the specific diagnostic rather than assuming all these errors have the same cause.  A smaller starting point Use JTL_Example.cir for the first simulation if you are still checking installation and licensing. The manual identifies it as self-contained.  Checked command-line recovery On a disposable working copy, omitting base_cells.cir caused an exit with a missing-file diagnostic and no CSV. Restoring the unchanged library recovered the run: 2,001 finite samples, four traces, 0–250 ps. josim-pro-cli -o recovered.csv AND_Example.cir Checked native GUI recovery On a disposable AND example, the normal licensed GUI Run action rejected the missing base_cells.cir with a specific include diagnostic. Restoring the unchanged library beside AND_Example.cir and rerunning produced 2,001 finite samples across four traces over 0–250 ps. The source and library hashes were preserved. This verifies the recorded production run/recovery actions on the Windows candidate. File > Open Folder picker interaction and the final package remain unchecked. The diagnostic screenshot was withheld because it contained a personal workspace path; useful path-free recovery imagery is still needed. ","id":"josim-missing-include","keywords":"","kind":"Troubleshooting","title":"A JoSIM-Pro netlist cannot find an included file","product":"JoSIM-Pro"},"version":"2.9.0 release target; current-source Windows candidate evidence","id":"josim-missing-include","related":["/knowledge-base/josim-first-jtl","/knowledge-base/josim-licensing-unavailable","/knowledge-base/josim-editor-navigation","/knowledge-base/josim-editor-completion","/knowledge-base/sparameter-model-handoff"],"downloads":[],"publication_status":"published","numerical_output":null,"provenance":{"execution_checks":[{"routes":["cli"],"scope":"Packaged AND/base_cells CLI run, missing-include rejection/restoration, main/include output-collision rejection and absolute-input resolution from another working directory","result":"passed","articles":["josim-missing-include","josim-output-path-collision"],"purpose":"include-recovery","version":"JoSIM-Pro 2.9.0 Windows review CLI, built 3 November 2026","id":"VAL-011","records":["recovery-29-version","recovery-29-baseline","recovery-29-missing-include","recovery-29-restored-include","recovery-29-main-output-alias","recovery-29-include-output-alias","recovery-29-different-cwd"],"limit":"CLI recovery and input/output integrity only. GUI recovery, numerical accuracy/convergence and final-package checks remain pending.","observed":{"main_alias_rejected_without_input_change":true,"baseline":true,"installed_examples_unchanged":true,"installed_binary_unchanged":true,"named_traces":4,"include_alias_rejected_without_input_change":true,"absolute_input_from_different_cwd":true,"time_end_seconds":2.5e-10,"restoring_include_recovers":true,"baseline_and_recovered_samples":2001,"missing_include_rejected_without_output":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":[],"review_notes":["The earlier baseline timeout and later successful CLI recovery remain separately recorded; the original wait has no established cause.","VAL-016 verifies scoped native missing-include rejection and restoration. Complete illustrated GUI guidance and final distributed-package checks remain pending."],"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","recovery","gui-workflow","illustrations"],"legacy_walkthrough_field":"pending retained; not evidence of a complete scenario"},"sources":[{"id":"josim-pro:docs/manual_source/sections/troubleshooting.tex","section":"Input files, .include paths, and subcircuit boundaries"},{"id":"josim-pro:docs/manual_source/sections/gui_quick_start.tex","section":"Before starting"},{"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":"A JoSIM®-Pro netlist cannot find an included file","type":"Troubleshooting","markdown_url":"/_functions/kbResource?path=markdown%2Fjosim-missing-include.md","summary":"Check the .include reference and preserve the files used by the project. The installed AND example requires base_cells.cir alongside the main example.","product":"JoSIM-Pro"}