Regression Testing Functions

ic_regression_list args

General resultlib read function. Reads the files specified by the file list using the reader specified by the backend. If create is one, the unstructured/structured meshes will be recreated.

ic_regression_test action cfile match [-fuzzy] mesh [-info] compareopts [""] prec [double] tstep [0] dir [""] cstyle [domain] factory [""] meshimpl [""]

Carry out regression test.

  • action : create or run

  • cfile : is the comparison file name. If the macro $D is in the name, the directory given by the dir parameter will be substituted for it. All of the rest of the arguments are optional.

  • match : {-exact | -fuzzy} If -exact, then the all portions of the mesh comparison must match exactly. If -fuzzy, then the comparison does not have to be exact (ie, allow discrepancies up to certain percentage of the checks).

  • mesh : {-mapped | -info | -nofamily | -nofamilycounts | -grid | -elements | -all}* this list tells what the regression test will match. If -mapped is specified, then the nodes of the mesh are mapped to the comparison mesh. If -info in list, the counts of nodes, elements, structured domains, families and family members will all be checked. If -nofamily is specified with -info, the family name portion of the mesh will not be checked. If no family counts is specified, the family names will be checked, but no match in counts of the family members will be required. If -grid is specified, then the nodes of the mesh will be checked. If -elements is specified, then the finite elements will be checked. If -nofamily (or -nofamilycounts) specified with -elements, then the family id will not be checked. If -all is specified, then information, grid and elements will all be checked. The -nofamily and -nofamilycounts will still act as qualifiers in this case.

  • compareopts : any additional comparison options. The match and grid arguments set the basic comparison options for the regression test. You can augment the comparison (for instance changing the tolerances for distances) by setting this option. These options will be appended to those determined by the match and mesh options.

  • prec: {double | float} precision of grid coordinates. Default is double.

  • tstep : timestep to load. Reserved for future use.

  • dir : is the directory the comparison file can be found. Default is env(REGRESSION_DIR) if set, or the current working directory if not. Only used if $D is in the comparison file name.

  • cstyle : is the style of the comparison file. The only options are script or domain; CGNS is reserved for future use.

  • factory : the factory for the backend for the comparison file. If not given, it will use the domain factory which has an internal domain file reader (only relevant in case of the comparison file style not being a script file).

  • meshimpl : the mesh implementation. If not given, this will use med_impl.

ic_regression_test_rfint rfint action cfile match [-fuzzy] mesh [-info] compareopts [""] prec [double] tstep [0] dir [""] cstyle [domain] factory [""] meshimpl [""]

The only difference between this and ic_regression_test is that it allows the mesh to be computed externally. For instance, load mesh tests would use this interface as opposed to the regression_test interface.