{"sections":[{"figures":[{"asset_id":"josim-streamed-files-settings","caption":"Files only — streamed text is selected with Serial execution. The guide’s data checks exercise the CLI, not GUI retention or memory limits."}],"heading":"Choose the result-storage mode","steps":["Open a saved source netlist and Run settings. Keep Serial execution for streamed output.","Choose Keep interactive plots when you need retained waveform arrays, Files only — buffered for native files without retained arrays, or Files only — streamed text for queued CSV/DAT output.","For a file-only route, provide an explicit native output destination and .PRINT selectors for every case. Streamed text supports CSV/DAT, optionally gzip, and excludes transient measurements. Save and preview the actual plan before running.","After success, open a committed numerical file to plot file-only results. A planned destination or an old file does not prove that the new run completed."]},{"code":"* RC output example: 50 ohm, 0.2 pF, 10 ps time constant\nV1 IN 0 PWL(0 0 10p 0 20p 1m 100p 1m)\nR1 IN OUT 50\nC1 OUT 0 0.2p\n.OPTION ANALYSIS=VOLTAGE INTEGRATION=BDF SEED=321\n.TRAN 0.5p 100p 0 0.5p\n.PRINT V(IN) V(OUT) I(R1)\n.END\n","heading":"Save output_rc.cir"},{"code":"josim-pro-cli -P 17 -o buffered.csv output_rc.cir\njosim-pro-cli --stream -P 17 -o streamed.csv output_rc.cir\njosim-pro-cli --compressed -P 17 -o compressed.csv output_rc.cir\njosim-pro-cli --stream --compressed -P 17 -o streamed-compressed.csv.gz output_rc.cir","heading":"Run buffered, streamed and compressed variants","paragraphs":["The compressed.csv request writes compressed.csv.gz. A .gz suffix is a compression suffix; the preceding .csv or .dat selects the logical text format. Read the actual reported path.","Use buffered output when a downstream reader requires BIN or RAW. Streamed RAW falls back to CSV with a warning in the checked candidate. Compression is not applied to BIN, RAW or STDOUT."]},{"code":"import csv, gzip, math\nwith gzip.open(\"compressed.csv.gz\", \"rt\", encoding=\"utf-8-sig\", newline=\"\") as f:\n    rows = list(csv.reader(f))\nvalues = [[float(v) for v in row] for row in rows[1:] if row]\nassert len(values) == 201\nassert all(len(row) == 4 and all(math.isfinite(v) for v in row) for row in values)\nprint(rows[0], values[0][0], values[-1][0])","heading":"Check numerical data inside gzip","paragraphs":["The checked RC outputs contain time in seconds, V(IN)/V(OUT) in volts and I(R1) in amperes: 201 finite rows over 0–100 ps. Parsed streamed and decompressed samples exactly matched the buffered output in this example. This does not measure peak memory or prove physical accuracy."]},{"code":"* RC output example: 50 ohm, 0.2 pF, 10 ps time constant\nV1 IN 0 PWL(0 0 10p 0 20p 1m 100p 1m)\nR1 IN OUT 50\nC1 OUT 0 0.2p\n.OPTION ANALYSIS=VOLTAGE INTEGRATION=BDF SEED=321\n.TRAN 0.5p 100p 0 0.5p\n.PRINT V(IN) V(OUT) I(R1)\n.MEASURE TRAN peak MAX V(OUT)\n.END\n","heading":"Save the measurement variant as measured_output.cir"},{"code":"josim-pro-cli -P 17 -o measured.csv measured_output.cir","heading":"Recover when a measurement needs buffered output","paragraphs":["A .MEASURE TRAN request with --stream was rejected with “buffered output is required” before replacing a pre-existing result. Remove --stream, or choose a buffered GUI mode, and rerun to a new filename. The checked buffered recovery completed with finite traces and a peak measurement.","File-only mode reduces retained waveform memory; the matrix, solver state and buffered output still use memory. Writer queue capacity is not a cap on total process memory."]}],"canonical_url":"https://www.sun-magnetics.com/knowledge-base/josim-stream-compressed","url":"/knowledge-base/josim-stream-compressed","known_issues":[],"search_record":{"execution":true,"relatedProducts":[],"version_tags":["JoSIM-Pro 2.9 target"],"text":"Stream, compress or keep simulation results in files Choose explicit CSV/DAT destinations for streamed text, use gzip for supported text output, and distinguish file output from retaining interactive GUI arrays. JoSIM-Pro 2.9.0 release target; frozen Windows candidate CLI and maintained-source evidence How to stream output gzip compressed csv files only buffered output required large result memory raw streaming fallback Choose the result-storage mode Open a saved source netlist and Run settings. Keep Serial execution for streamed output. Choose Keep interactive plots when you need retained waveform arrays, Files only — buffered for native files without retained arrays, or Files only — streamed text for queued CSV/DAT output. For a file-only route, provide an explicit native output destination and .PRINT selectors for every case. Streamed text supports CSV/DAT, optionally gzip, and excludes transient measurements. Save and preview the actual plan before running. After success, open a committed numerical file to plot file-only results. A planned destination or an old file does not prove that the new run completed.  Files only — streamed text is selected with Serial execution. The guide’s data checks exercise the CLI, not GUI retention or memory limits. Native JoSIM Run settings with Serial execution and Files only — streamed text selected, plus the memory and queue controls. Save output_rc.cir * RC output example: 50 ohm, 0.2 pF, 10 ps time constant\nV1 IN 0 PWL(0 0 10p 0 20p 1m 100p 1m)\nR1 IN OUT 50\nC1 OUT 0 0.2p\n.OPTION ANALYSIS=VOLTAGE INTEGRATION=BDF SEED=321\n.TRAN 0.5p 100p 0 0.5p\n.PRINT V(IN) V(OUT) I(R1)\n.END\n Run buffered, streamed and compressed variants The compressed.csv request writes compressed.csv.gz. A .gz suffix is a compression suffix; the preceding .csv or .dat selects the logical text format. Read the actual reported path. Use buffered output when a downstream reader requires BIN or RAW. Streamed RAW falls back to CSV with a warning in the checked candidate. Compression is not applied to BIN, RAW or STDOUT. josim-pro-cli -P 17 -o buffered.csv output_rc.cir\njosim-pro-cli --stream -P 17 -o streamed.csv output_rc.cir\njosim-pro-cli --compressed -P 17 -o compressed.csv output_rc.cir\njosim-pro-cli --stream --compressed -P 17 -o streamed-compressed.csv.gz output_rc.cir Check numerical data inside gzip The checked RC outputs contain time in seconds, V(IN)/V(OUT) in volts and I(R1) in amperes: 201 finite rows over 0–100 ps. Parsed streamed and decompressed samples exactly matched the buffered output in this example. This does not measure peak memory or prove physical accuracy. import csv, gzip, math\nwith gzip.open(\"compressed.csv.gz\", \"rt\", encoding=\"utf-8-sig\", newline=\"\") as f:\n    rows = list(csv.reader(f))\nvalues = [[float(v) for v in row] for row in rows[1:] if row]\nassert len(values) == 201\nassert all(len(row) == 4 and all(math.isfinite(v) for v in row) for row in values)\nprint(rows[0], values[0][0], values[-1][0]) Save the measurement variant as measured_output.cir * RC output example: 50 ohm, 0.2 pF, 10 ps time constant\nV1 IN 0 PWL(0 0 10p 0 20p 1m 100p 1m)\nR1 IN OUT 50\nC1 OUT 0 0.2p\n.OPTION ANALYSIS=VOLTAGE INTEGRATION=BDF SEED=321\n.TRAN 0.5p 100p 0 0.5p\n.PRINT V(IN) V(OUT) I(R1)\n.MEASURE TRAN peak MAX V(OUT)\n.END\n Recover when a measurement needs buffered output A .MEASURE TRAN request with --stream was rejected with “buffered output is required” before replacing a pre-existing result. Remove --stream, or choose a buffered GUI mode, and rerun to a new filename. The checked buffered recovery completed with finite traces and a peak measurement. File-only mode reduces retained waveform memory; the matrix, solver state and buffered output still use memory. Writer queue capacity is not a cap on total process memory. josim-pro-cli -P 17 -o measured.csv measured_output.cir","id":"josim-stream-compressed","keywords":"stream output gzip compressed csv files only buffered output required large result memory raw streaming fallback","kind":"How to","title":"Stream, compress or keep simulation results in files","product":"JoSIM-Pro"},"version":"2.9.0 release target; frozen Windows candidate CLI and maintained-source evidence","id":"josim-stream-compressed","related":["/knowledge-base/josim-export-results","/knowledge-base/josim-measurements","/knowledge-base/josim-cli-output"],"downloads":[{"url":"/_functions/kbExample?name=output-modes.zip","scope":"Exact checked input files plus instructions; final-release/platform applicability remains pending.","files":["output_rc.cir","measured_output.cir","README.txt"],"id":"output-modes","requires":["Matching licensed JoSIM-Pro 2.9 CLI","New writable folder; preserve all supplied files together"],"title":"Stream, compress or keep simulation results in files"}],"publication_status":"published","numerical_output":null,"provenance":{"execution_checks":[{"routes":["cli"],"scope":"Fixed-seed noise/spread repetition and CLI precedence; buffered/streamed/gzip data; six Cartesian sweep cases; saved testbench verdicts, provenance hashes, generation protection and recovery","result":"passed","articles":["josim-seed-repeatability","josim-stream-compressed","josim-parameter-sweeps","josim-testbench"],"purpose":"josim-reproducibility-output-sweeps-testbench","version":"JoSIM-Pro 2.9 frozen Windows source candidate built 3 November 2026; not the final distributed package","id":"VAL-017","records":["josim-jobs-independent-cli-review"],"limit":"Twenty-two checks cover these CLI inputs and runtime only. Native screenshots illustrate authoring/settings controls without a GUI calculation, preview or saved-bench run. Cross-platform repeatability, peak memory, cancellation, other analysis families and final-package acceptance remain unverified. The constant-circuit numerical bounds are example-specific, not universal solver tolerances.","observed":{"rc_output":{"rows":201,"stop_s":1e-10,"traces":3},"seeded_noise":{"stop_s":2e-11,"traces":2,"rows":41,"deck_seed":77,"fixed_seed":12345},"sweep":{"rows_per_case":6,"comparison_relative_tolerance":1e-12,"comparison_absolute_tolerance_V":1e-15,"cases":6,"voltage_V_in_source_order":[0.003,0.002,0.001,0.006,0.004,0.002]},"testbench":{"seed":321,"spec_failure_check_states":["pass","fail","pass"],"spec_failure_exit":2,"missing_or_unit_mismatch_exit":3,"pass_exit":0,"cases":3}}}],"figure_evidence":[{"evidence_limit":"A native control illustration. The separately recorded CLI examples do not qualify this GUI route or the final distributed package.","id":"josim-streamed-files-settings","reference_label":"JoSIM-Pro 2.9 frozen Windows candidate, native controls, 3 November 2026"}],"review_notes":["VAL-017 checks the supplied CLI recipe on the frozen Windows candidate. The source manuals still match their reviewed hashes.","Native images illustrate actual controls; the settings/workbench were cancelled and the testbench view hidden. Complete GUI, technical and final-package acceptance 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","execution","recovery","gui-workflow","illustrations"],"legacy_walkthrough_field":"pending retained; not a completed GUI task"},"sources":[{"id":"josim-pro:docs/manual_source/sections/usage.tex","section":"Output targets and file formats; Streaming output; Compression"},{"id":"josim-pro:docs/manual_source/sections/gui_simulation_results.tex","section":"Run settings: Execution and memory; Result storage"},{"id":"validation:josim-jobs-windows-20261103","section":"VAL-017; exact complete inputs, checked CLI outcomes and limits"},{"id":"capture:josim-jobs-ui-20261103T145751","section":"Production control illustrations only; no GUI solve, preview or bench run"},{"id":"owner:technical-review-20261102","section":"2.9 public target; final distributed-package checks required"}]},"title":"Stream, compress or keep simulation results in files","type":"How to","markdown_url":"/_functions/kbResource?path=markdown%2Fjosim-stream-compressed.md","summary":"Choose explicit CSV/DAT destinations for streamed text, use gzip for supported text output, and distinguish file output from retaining interactive GUI arrays.","product":"JoSIM-Pro"}