SMS:2D Scatter Point Files

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