Command Line Options¶

Command line documentation can be retrieved with the help flag:

$ intact --help

Output:

Usage:
  Intact [OPTION...]

  -h, --help                    Print program usage
      --build-info              Print report about current build, then exit
      --version                 Print the software version
  -s, --scenario arg            Scenario json file
  -f, --fields arg              Fields to sample (if empty, all available
                                fields will be sampled). Comma delimited.
  -o, --output arg              Output directory. The default it the
                                directory of the scenario file.
      --skip-sample             Skip the sampling step of the solver.
      --json-gh-output          Output the sampled results in JSON format
                                for communication with Intact.Simulation
                                for Grasshopper.
      --json-output             Output the sampled results in JSON format
                                (VTK is the default output).
      --legacy-vtk-output       Output the sampled results in legacy VTK
                                format.
      --single-file-vtk-output  Output the sampled results in a single file
                                VTK format for modal and linear buckling
                                scenarios.
      --tempdir                 Make a temporary directory for output
      --scenario-name arg       Prefix for output files, defaults to
                                scenario file name
      --load-solution-file      Load a cached solution file/s
      --logdir arg              Path to the log file. Default value is
                                current working directory.
      --logname arg              If not specified, log will not be put in a
                                file
      --save-solution           Save the scenario solution in vtk format
      --refinement-level arg    Refinement ratio w.r.t. assembly bounding
                                box. If not present, no refinement is
                                performed.
  -v, --verbosity arg           Verbosity level, run with --help for more
                                information
      --define-version          Software version
      --license-check           Check license validity.
      --seats-available         Print the number of available seats to
                                stdout.

Specify Verbosity Level:
  -v n        Set loguru::g_stderr_verbosity level
  -v INFO     Only show INFO, WARNING, ERROR, FATAL (default)
  -v WARNING  Only show WARNING, ERROR, FATAL
  -v ERROR    Only show ERROR, FATAL
  -v FATAL    Only show FATAL
  -v OFF      Turn off logging to stderr.

Key Options¶

-s, --scenario <path/to/scenario.json>: (Required) Path to the scenario JSON file. Mandatory for all calls except --help or --build-info.
-o, --output <path/to/output_dir>: Output directory for generated files. By default, files are placed in the same directory as the scenario JSON file. The scenario JSON and referenced geometry files will be copied to the output directory.
--refinement-level <ratio>: Refine surface and volume mesh geometry prior to sampling. Useful when triangle quality is poor. The ratio of element edge length to bounding box size will not exceed the specified refinement level.
--save-solution: Save the scenario solution in VTK format for later resampling.
--load-solution-file: Load a previously cached solution file.
--build-info: Get detailed information about the tool version. Useful for bug reports.