ecs

Langue: en

Version: 2009-02-04 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

ecs - Code_Saturne preprocessor

SYNOPSIS

ecs -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)
-echo-comm [n]
Print headers of sent messages (and n first/last elements if n is given)
-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
-o, -out [<file>]
Redirect terminal output to a file (default file: output.ecs)
-perio, -periodic <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
-ens, -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, -ens, -ensight, -med)

-divide-poly
Activate triangulation of faces with more than 4 edges
-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)
-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, -perio, -periodic)

-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

ECS_CONT_SUR_FPE
Continue on floating-point error (Linux on x86_32 or x86_64 only).
ECS_DEF_LNG_ARE_MIN
Length under which an edge is considered degenerate (default: 1.e-15).
ECS_FIC_CHRONO
Name of timing output file.
ECS_FIC_MEM
Name of memory operations trace file.
ECS_PRE_IDEAS_IGNORE_SYS_COO
Ignore I-deas coordinate systems.
ECS_RC_MAX_FAC_DEC
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)