Skip to content

Output & reporting

Every calibration run documents itself. When DEEM.optimize(...) finishes, numgeo-ACT writes a PDF report, a text log, and a set of comparison plots to the run's output directories, so the result is fully reproducible and easy to share.

PDF calibration report

The headline artifact is a multi-page numgeo-ACT calibration report (PDF). It collects, in one document:

  • a title page with the numgeo-ACT logo, the generation date, the calibrated model, the optimization method and similarity measure, the final objective (error) value, and the result directory;
  • parameter tables listing the initial and final (optimized) parameter sets;
  • comparison figures for every honoured test, showing the simulation against the experiment;
  • an optional Critical-state-line calibration page when ACT.utilities.csl.fit_csl report-data files are present in the result directory;
  • a footer on each page identifying the model and page number.

This single PDF is usually all you need to review or archive a calibration.

Text log

Alongside the PDF, a plain-text log file records the run in detail:

  • a header with the free parameters, the weights, the method, the similarity measure, the iteration limit and population settings, and the experimental database used;
  • the algorithm settings;
  • the initial and final parameter tables;
  • the achieved objective value and timing information (start, end, duration).

A terminal_out.txt capturing the run's console output is written as well.

Dependent parameters

Some model classes may define dependent parameters. For Hypo-IGS, if mR is optimized while mT is not part of Free_parameter, ACT uses mT = 0.7*mR. In this case the log file and the PDF report mark mT as dependent instead of fixed, and the shown value is the effective value used in the numgeo calculations.

Critical-state-line output

The CSL utility ACT.utilities.csl.fit_csl(...) writes a compact plain-text csl_fit_*.dat report-data file and a matching csl_fit_*.png / .pdf figure into the selected result directory. When the calibration report is generated, this text file is picked up automatically and inserted as a dedicated CSL page with the fitted Bauer or Li-Wang parameters and the \(R^2\) value.

Comparison plots

For each test type, numgeo-ACT produces a simulation-vs-experiment figure, saved as both PDF and PNG:

File Content
oedometer.pdf / .png oedometer stress–strain
triaxCD.pdf / .png drained triaxial: \(\varepsilon_1\)–\(q\) and \(\varepsilon_1\)–\(\varepsilon_v\)
triaxCU.pdf / .png undrained triaxial: stress–strain and effective stress path
triaxCUcyc.* undrained cyclic triaxial: stress path, pore-pressure build-up
HCA / USScyc figures accumulation-vs-cycles and cyclic-simple-shear responses

In these plots the simulation is drawn against your experimental curves (as in the home-page animation), making it easy to see at a glance how well — and where — the optimized parameters reproduce each test.

Where the files go

The output locations are set by the three directories passed to the model constructor (with defaults):

model = hypoplasticity_isa(
    out_dir="./results/",     # final results, report and plots
    out_dir2="./run_tmp/",    # temporary run files during optimization
    out_dir3="./run_final/",  # files of the final (best) run
)

together with the working path you give to globals.setup. Temporary per-evaluation run files live under the temporary directory and the final, best-fit run is preserved separately, so you can inspect the exact numgeo inputs and outputs that produced the calibrated response.

Reviewing a run

Start with the PDF report for the overview, then open the per-test PNG/PDF plots to judge the fit of individual tests, and consult the text log for the precise parameter values and run settings.

Critical-state-line summary page

When a CSL fit generated by ACT.utilities.csl.fit_csl is present in the result directory, the PDF report adds a compact CSL summary page. The page contains the input source, number of fitted points, \(R^2\), fitted parameters and the CSL comparison figure on the same page. The corresponding csl_fit_*.png file is not repeated again in the normal result-figure section.