NAME
cs_preprocess - Code_Saturne preprocessor
SYNOPSIS
cs_preprocess -m <file> [-sc] [options]
DESCRIPTION
Code_Saturne preprocessor reads meshes from several formats. It enables
non-conforming joining and periodicity handling, as well as some
postprocessing for mesh checking.
OPTIONS
-m, --mesh <file>
Preprocessor input mesh file (mesh file format determined
automatically by filename extension or forced by -format sub-
option)
-sc, --sim-comm
simulate messages without file output
General options
--cwd <directory>
working directory (if different from current directory)
-h, --help
Print a usage message and exit.
-i, --in [<file>]
Command line completed by a file (default file: standard input)
--int-face [<sub-options>]
Count and display interior faces these faces may be selected
with face-selection sub-options
-j, --join [<sub-options>]
Join non-conforming faces; select faces to join with face-
selection sub-options
--log [<file>]
Redirect terminal output to a file (default file:
preprocessor.log)
-p, --perio <sub-options>
Mesh periodicity defined by argument; joining sub-options for
tolerances and selection of periodic faces with face-selection
sub-options
--reorient
If necessary, correct orientation of cells and faces
--version
Print version number
Postprocessing options
--case <name>
Case name (without this option, the default name is: preprocess)
--cgns [<sub-options>]
CGNS geometry output
--ensight [<sub-options>]
EnSight Gold geometry output
--med [<sub-options>]
MED 2.3 geometry output
Mesh selection sub-options (-m, --mesh)
--format <keyword>
Selection of mesh file format
--num <n>
Selection of mesh number in file (if the format allows it)
--grp-cel <keyword>
Add groups of cells (based on format features/conventions)
* based on sections: keyword "section"
* based on zones: keyword "zone"
--grp-fac <keyword>
Add groups of faces (based on format features/conventions)
* based on sections: keyword "section"
* based on zones: keyword "zone"
Available mesh formats (-m, --mesh; --format)
Extension Keyword
CGNS .cgns cgns
pro-STAR/STAR4 .ngeom ngeom
EnSight (6 or Gold) .case ensight
GAMBIT Neutral .neu gambit
GMSH .msh gmsh
NUMECA Hex .hex hex
I-deas universal .unv unv
MED .med med
Simail (NOPO) .des des
Meta-mesh file .mesh meta
Postprocessing selection sub-options (--cgns, --ensight, --med)
--discard-poly
discard polygonal faces (wth more than 4 edges) or polyhedra
--simple
force mesh output on a single part (EnSight) or section (CGNS)
--text force text output (EnSight)
--big-endian
force binary output to big-endian (EnSight)
--color-to-group
transform colors to groups (MED)
--volume
activate output of volume mesh (by default if -boundary or -info
not given)
--boundary
activate output of boundary mesh (by default if -volume or -info
not given)
--info activate output of information meshes (by default if -volume or
-boundary not given)
Periodicity sub-options (-perio, -periodic)
--trans <tx ty tz>
translation vector
--rota --angle <alpha> --dir <dx dy dz> [--invpt <px py pz>]
rotation defined by an angle (in degrees) and a direction
vector, and eventually by an invariant point (origin by default)
--rota --matrix <mij> [--invpt <px py pz>]
rotation defined by the rotation matrix (given line by line),
and eventually by an invariant point (origin by default)
Non-conformal face joining sub-options (-j, --join, -p, --perio)
--fraction <real number>
fraction of the length of the smallest edge under which we
consider that vertices may be fused (default value: 0.1)
--plane <real number>
minimal cosine of the normals of 2 coplanar faces (default
value: 0.8)
--semi-conf
fast joining algorithm (allowed if faces already share vertices)
Face selection sub-options (for joining, selection, and periodicity)
--color <number(s)>
color numbers of faces to select
--group <name(s)>
group names of faces to select
--invsel
invert selection
ENVIRONMENT
CS_PREPROCESS_MIN_EDGE_LEN
Length under which an edge is considered degenerate (default:
1.e-15).
CS_PREPROCESS_MEM_LOG
Name of memory operations trace file.
CS_PREPROCESS_IGNORE_IDEAS_COO_SYS
Ignore I-deas coordinate systems.
CS_PREPROCESS_JOIN_MAX_SUB_FACES
Number of new faces of an initial face above which we consider
that conformal joining face reconstruction has gone into an
infinite loop (default: 100)
SEE ALSO
cs_io_dump(1), cs_partition(1)
2009-02-04