{"sections":[{"heading":"Isolate the cause","steps":["Read the first diagnostic and reduce the netlist to the smallest circuit that reproduces it.","Check the intended reference node and floating subcircuits or inconsistent ideal-source constraints.","Verify units, model parameters, coupled-inductor validity, bias and initial conditions.","Restore parts of the circuit in small steps and compare against a supplied working example."]},{"heading":"Preserve the physical circuit","paragraphs":["Do not add an arbitrary resistor solely to suppress the message. A corrected circuit resolved a historical zero-resistance-loop report without the proposed artificial resistance.","A weak reference or finite impedance may be physically appropriate for some models, but it changes the circuit. Document and validate that choice rather than treating it as a universal solver repair."]}],"canonical_url":"https://www.sun-magnetics.com/knowledge-base/josim-singular-circuit","url":"/knowledge-base/josim-singular-circuit","known_issues":[],"search_record":{"execution":false,"relatedProducts":[],"version_tags":["JoSIM-Pro 2.9 target"],"text":"JoSIM-Pro reports that the matrix has no solution Reduce the circuit and check its reference, topology, model values and initial conditions before treating the error as a numerical tuning problem. JoSIM-Pro 2.9.0 release target; review-build/source evidence Troubleshooting Isolate the cause Read the first diagnostic and reduce the netlist to the smallest circuit that reproduces it. Check the intended reference node and floating subcircuits or inconsistent ideal-source constraints. Verify units, model parameters, coupled-inductor validity, bias and initial conditions. Restore parts of the circuit in small steps and compare against a supplied working example.  Preserve the physical circuit Do not add an arbitrary resistor solely to suppress the message. A corrected circuit resolved a historical zero-resistance-loop report without the proposed artificial resistance. A weak reference or finite impedance may be physically appropriate for some models, but it changes the circuit. Document and validate that choice rather than treating it as a universal solver repair. ","id":"josim-singular-circuit","keywords":"","kind":"Troubleshooting","title":"JoSIM-Pro reports that the matrix has no solution","product":"JoSIM-Pro"},"version":"2.9.0 release target; review-build/source evidence","id":"josim-singular-circuit","related":["/knowledge-base/josim-coupling-validity","/knowledge-base/josim-model-syntax","/knowledge-base/support-effective-report"],"downloads":[],"publication_status":"published","numerical_output":null,"provenance":{"execution_checks":[],"figure_evidence":[],"review_notes":["Support history informed this draft. Current-source guidance has been checked; a fresh walkthrough on the intended distributed release and product-owner review remain pending."],"scope":"Recorded inputs/builds only. Complete walkthrough and final-package acceptance remain separate.","verification_requirements":{"gui_method":"not-required-for-this-answer","status":"review-incomplete","illustrations":"not-required-for-this-answer","required":["technical-review","release-applicability","recovery"],"legacy_walkthrough_field":"pending retained; not evidence of a complete scenario"},"sources":[{"id":"support:SUP-013","section":"Generalised editorial finding; outcome qualification retained"},{"id":"josim-pro:docs/manual_source/sections/troubleshooting.tex","section":"The simulation starts but fails, diverges, or produces no useful result"},{"id":"josim-pro:docs/manual_source/sections/syntax.tex","section":"Node and component syntax; mutual coupling"},{"id":"owner:technical-review-20261102","section":"JoSIM-Pro 2.9 chosen as the public starting path; release availability must be checked before publication"}]},"title":"JoSIM®-Pro reports that the matrix has no solution","type":"Troubleshooting","markdown_url":"/_functions/kbResource?path=markdown%2Fjosim-singular-circuit.md","summary":"Reduce the circuit and check its reference, topology, model values and initial conditions before treating the error as a numerical tuning problem.","product":"JoSIM-Pro"}