2D Scatter Point Files
This is the approved revision of this page, as well as being the most recent.
Two-dimensional scatter point sets are stored in 2D scatter point files. Multiple scatter point sets can be stored in a single file. Each point in a scatter point set is defined by a pair of xy coordinates. The format of the 2D scatter file is shown in Figure 1 and a sample file in Figure 2.
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 | |
. | |
. | |
idnp xnp ynp | |
ENDSET | /* End of cards for scatter point set */ |
/* Repeat point set cards as many times as necessary */ |
Figure 1. 2D Scatter Point File Format.
SCAT2D |
BEGSET |
NAME "gages" |
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 |
Figure 2. Sample 2D Scatter Point File.
The cards used in the 2D scatter point file are as follows:
Card Type | SCAT2D |
Description | File type identifier. Must be on first line of file. No fields. |
Required | YES |
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 | ||
Field | Variable | Value | Description |
Format
NAME "name"
Sample
NAME "wells"
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
DELEV
Description
Defines the default elevation for the scatter point set.
Required
NO
Format
DELEV el
Sample
DELEV 9.0
Field
Variable Value Description
1
el ± The default elevation for the following scatter points. Remains as default until new DELEV card is encountered.
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