SMS:2D Scatter Point Files

From XMS Wiki
Jump to: navigation, search

2D Scatter Point Files (*.xy)

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. However, multiple scatter point sets can be stored in a single 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. Scatter files are opened through File | Open and are saved from File | Save Scatter from the Scatter module. When scatter point files are saved, a super file is saved. The super file saves and references the scatter and dataset files.

File Format

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 coordinatess, one per line */
id2 x2 y2
.
.
idnpxnpynp
ENDSET /* End of cards for scatter point set */
/* Repeat point set cards as many times as necessary */

Sample File

SCAT2D 
BEGSET 
NAME "lakes" 
ID 8493 
DELEV 0.00000000000e+00 
IXY 25 
1 1.47000000000e+02 3.90000000000e+02 
2 8.82000000000e+02 9.49000000000e+02 
. 
. 
24 1.73000000000e+02 7.01000000000e+02 
25 5.39000000000e+02 8.98000000000e+02 
ENDSET 

Cards

Card Type BEGSET
Description Identifies the beginning of a scatter point set. No fields.
Required NO


Card Type NAME
Description Defines the name for the following scatter point set.
Required NO
Format NAME "name"
Sample NAME "st mary"
Field Variable Value Description
1 name str The name for the following scatter points. Remains as default until new NAME card is encountered.


Card Type ID
Description Defines the ID for the scatter point set.
Required YES
Format ID id
Sample ID 43098
Field Variable Value Description
1 id + The ID for the following scatter point set.


Card Type IXY
Description Defines a scatter point set.
Required YES
Format
IXY np
id1 x1 y1
id2 x2 y2
.
.
idnp xnp ynp
Sample
IXY 4
1 12.3 34.5
2 52.2 23.5
3 63.2 27.4
4 91.1 29.3
Field Variable Value Description
1 np + The number of scatter points in the scatter point set.
2 id + The ids of the points.
3-4 x,y ± The coordinates of the points.
Repeat fields 2–4 np times


Card Type ENDSET
Description Identifies the end of a scatter point set. No fields.
Required NO

Related Topics

File Formats