CMS-Flow Output files

ASCII Output Files

ASCII Output files from CMS are in the form of three different files listed below. These file types were chosen because they are supported in SMS and can be read in directly.

• SUPER (*.sup) files
• 2D Scatter Point (*.xy) files
• ASCII Dataset (*.dat) files

SUPER files (*.sup)

(Adapted for CMS from the SMS Wiki) Super files can still be opened in SMS. These contain a 2D scatter point file and the corresponding ASCII CMS Solution data file.

If a super file is selected using the File | Open command, each of the files listed in the super file are opened and imported. This makes it possible to quickly read in several files without having to identify each file individually in the file browser.

A sample of the file format for a super file is shown below. The first line in the file is the SUPER card, which identifies the file as a super file. Each of the other cards shown are optional. Each of the file cards has a card identifier representing the type of file. The identifier is followed by a file name. The file name should be a complete path if the file is not in the same directory as the super file. Any suffix may be used for the file name.

SUPER	/* File type identifier */
SCAT2D filename	/* 2D scatter point file */
DATA filename	/* Dataset File */
...	/* repeated DATA lines as needed */
DATA filename	/* Dataset File */

SUPER
SCAT2D	"Phase2.xy"
DATA    "Phase2_eta.dat"
DATA    "Phase2_vel.dat"

2D Scatter Point Files (*.xy)

(Adapted for CMS from the SMS Wiki) Two-dimensional scatter point sets are stored in 2D scatter point files. The file includes the scatter point locations and requires that functional information be defined in a separate dataset file. An XY coordinate pair defines each point in a scatter point set. The format allows time variant datasets to be associated with scattered data points as well as to organize datasets by allowing the user to assign an ID to the scattered dataset.

The super file saves and references the scatter and dataset files.

SCAT2D	/* File type identifier */
BEGSET	/* Beginning of cards for scatter point set */
NAME "name"	/* Name of scatter point set */
ID id	/* ID of scatter point set */
DELEV elev1	/* Default elevation */
IXY np	/* Number of points in set, begin point listing */
id1 x1 y1	/* Point id and coordinates, one per line */
id2 x2 y2
.
.
idnp xnp ynp
ENDSET	/* End of cards for scatter point set */

SCAT2D
BEGSET
NAME  "Phase2"
ID 17255
DELEV 0.0
IXY  82888
   82888  262744.0000  956221.0000
   82887  262360.0000  956221.0000
   82886  261976.0000  956221.0000
...
       3  256648.0000  937069.0000
       2  256744.0000  936973.0000
       1  256648.0000  936973.0000
ENDSET

ASCII Datasets (*.dat)

(Adapted for CMS from the SMS Wiki) CMS Solution Datasets are stored in ASCII files. Only one dataset is stored in a single file in either scalar or vector format. For scalar dataset files, one value is listed per vertex, cell, node, or scatter point. For vector dataset files, one set of XY vector components is listed per vertex, cell, node, or scatter point. If necessary, a set of status flags can be included in the file. If the status flag is false (0), the corresponding item (node, cell, etc.) is inactive. If status flags are not included in the file, it is assumed that all items are active. Dataset files are opened through File | Open and are saved when other files are saved such as [Scatter Point Files|2D scatter point files] or through the [Dataset Dialog|Export Dataset dialog].

Scalar File Format

DATASET              /* File type identifier */
OBJTYPE "scat2d"     /* Type of object data set is associated with */
BEGSCL               /* Beginning of scalar data set */
OBJID id             /* Object id */
ND numdata           /* Number of data values */
NC numcells          /* Number of cells or elements */
NAME "name"          /* Data set name */
RT_JULIAN            /* The reference time as a Julian number. */
TIMEUNITS            /* The time units. */
TS istat time        /* Time step of the following data. */
val1                 /* Scalar data values */
val2
.
.
/* Repeat TS card for each time step */
.
ENDDS                /* End of data set */

Vector File Format

DATASET
OBJTYPE "scat2d"     /* Vector at node/gridnode or element/cell */
BEGVEC               /* Beginning of vector dataset */
OBJID id             /* Object id */
ND numdata           /* Number of data values */
NC numcells          /* Number of cells or elements */
NAME "name"          /* Data set name */
RT_JULIAN reftime    /* The reference time as a Julian number. */
TIMEUNITS units      /* The time units. (hours, etc)*/
TS istat time        /* Time step of the following data. */
vx1 vy1
vx2 vy2
.
.  /* Repeat data for [numcells] number of cells.
.
/* Repeat TS card for each time step */
ENDDS                /* End of data set */