Map Files (*.map)

Map files are used to store feature object and drawing object data. Feature objects include points, nodes, vertices, arcs and polygons. Drawing objects include rectangles, ovals, lines, and text. The map file also includes the grid frame.

Map files are opened through File | Open and saved from File | Save Map Data from the Map module.

File Format
Sample File
Cards

General
Feature Objects
Feature Points and Nodes
Feature Arcs
Feature Polygons
Drawing Objects

File Format

MAP                    /* file type identifier */
BEGCOV                 /* beginning of a new coverage */
COVNAME "name"         /* coverage name */
COVATTS attstype       /* coverage attributes type */
POINT                  /* new point identifier */
XY x y                 /* xy coordinates of the point*/
ID id                  /* id of the point*/
END                    /* end of data for point*/
NODE                   /* new node identifier */
XY x y                 /* xy coordinates of node*/
ID id                  /* id of node */
END                    /* end of data for node */
ARC                    /* new arc identifier */
ID id                  /* id of arc */
NODES id1 id2          /* ids of beginning and ending nodes for arc */
ARCVERTICES n          /* number of vertices between nodes for arc */
x1 y1                  /* xy location of vertices */
x2 y2
xn yn
ARCBIAS Value        /* bias value for meshing */
END                  /* end of data for arc 1 */
POLYGON              /* new polygon identifier */
ID id                /* id of polygon*/
ARCS n               /* number of boundary arcs for polygon */
id1                  /* ids of boundary arcs */
id2
.
idn
HARCS n              /* number of hole-arcs for polygon */
id1                  /* ids of hole-arcs */
id2
.
idn
END                  /* end of data for polygon */
ENDCOV               /* end of coverage data */
RECT                 /* new rectangle identifier */
C1 x1 y1 z1          /* xyz coordinates of corner 1 */
C2 x2 y2 z2          /* xyz coordinates of corner 2 */
C3 x3 y3 z3          /* xyz coordinates of corner 3 */
C4 x4 y4 z4          /* xyz coordinates of corner 4 */
THICK width          /* line thickness of rectangle border */
STYLE style          /* line style of rectangle */
LINECOL r g b        /* red green blue components of line color */
FILLCOL r g b        /* red green blue components of fill color */
FILLPAT pattern      /* fill pattern of rectangle */
THETA theta          /* Viewing angle rect. was created in */
ALPHA alpha          /* Viewing angle rect. was created in */
END                  /* end of rectangle data */
OVAL                 /* new oval identifier */
.                                        /* same cards as rectangle */
.
END                  /* end of rectangle data */
LINE                 /* new line identifier */
VERTS n              /* number of points in the line */
PT x1 y1 z1          /* xyz coordinates of point 1 */
PT x2 y2 z2          /* xyz coordinates of point 2 */
.
.
PT xn yn zn          /* xyz coordinates of point n */
THICK width          /* line thickness */
STYLE style          /* line style */
LINECOL r g b        /* red green blue components of line color */
ARRHED type          /* arrow head flag */
HEDWID width         /* arrow head base width */
HEDlEN length        /* arrow head length */
END                  /* end of line data */
TEXT                 /* new text string identifier */
STRING "str"         /* text string */
LOCAL x y z          /* xyz location of text */
PCFONT "name"        /* pc font name */
UNIXFONT "name"      /* unix font name */
COLOR r g b          /* red green blue components of text */
END                  /* end of text string data */
GRIDFRAME x y z dx dy dz q    /* dimensions of gridframe */

Sample File

MAP
LEND
BEGCOV
COVNAME "default coverage"
COVATTS 2DMESH
NODE
XY 174.112149532710280 483.364485981308410
ID 1
GWNCARD 0.000 0.000 0.000 0.000
END
ARC
ID 1
NODES        1        1
ARCVERTICES 2
132.99065 133.83178
630.56075 429.90654
ARCBIAS 1.000000
END
POLYGON
ARCS 0
PATCHPTS 0 0 0 0
HARCS 1
1
ID 0
ADAPTESS 1.000000
END
POLYGON
ARCS 1
1
PATCHPTS 0 0 0 0
ID 1
ADAPTESS 1.000000
CEILING 1 0.577 0.577 0.577 0.577
MAT
MN                   1                    mat_1
MC                   1                    255    0      204
MS                   1                    5
END
ENDCOV

General Cards

Card Type	MAP
Description	File type identifier. Must be on first line of file. No fields.
Required	YES

Feature Objects

The following cards are used to define coverages, polygons, arcs, and points.

Card Type	BEGCOV
Description	Beginning of a series of cards definining a coverage.
Required	YES

Card Type	COVNAME
Description	Coverage name.
Required	NO
Format	COVNAME "name"
Sample	COVNAME "general"
Field	Variable	Value	Description
1	name	str	Coverage name.

Card Type	COVATTS
Description	Coverage model attributes set.
Required	YES
Format	COVATTS type
Sample	COVATTS 2DMESH
Field	Variable	Value	Description
1	type	2DGRID 2DMESH	2D grid. 2D mesh.

Card Type	ENDCOV
Description	End of cards defining a coverage.
Required	YES

Card Type	POINT
Description	Beginning of a series of cards defining a point.
Required	NO

Card Type	XY
Description	xy coordinates of a point or node.
Required	YES
Format	XY x y
Sample	XY 10.0 20.0
Field	Variable	Value	Description
1-2	x, y	±	xy coordinates of the point or node.

Card Type	ID
Description	id of a feature object.
Required	YES
Format	ID id
Sample	ID 10
Field	Variable	Value	Description
1	id	+	id of the feature object

Card Type	GWN
Description	1-D element paramaters
Required	NO
Format	GWNCARD Wo Ws Sl Sr
Sample	GWNCARD 1.000 2.000 3.000 4.000
Field	Variable	Value	Description
1-4	Wo,Ws,SL,SR	+	1-D element paramaters

Card Type	END
Description	End of a series of cards defining a feature object or drawing object.
Required	YES

Card Type	NODE
Description	Beginning of a set of cards defining a node.
Required	NO

Card Type	ARC
Description	Beginning of a set of cards defining an arc.
Required	NO

Card Type	NODES
Description	Beginning and ending nodes of arc.
Required	YES
Format	NODES n1 n2
Sample	NODES 10 15
Field	Variable	Value	Description
1-2	n1, n2	+	id of beginning and ending nodes of an arc.

Card Type	ARCVERTICES
Description	Vertices between nodes of an arc identifier.
Required	Only if the arc has vertices
Format	ARCVERTICES nvert x1 y1 x2 y2 . . . xn yn
Sample	ARCVERTICES 3 5.0 10.0 12.0 8.0 2.5 7.6
Field	Variable	Value	Description
1	nvert	+	Number of intermediate vertices
2-3	x, y	±	Vertex coordinates. Fields 2-3 repeated for each vertex

Card Type	POLYGON
Description	Polygon Type idenfier.
Required	NO

Card Type	ARCS
Description	Defines the arcs forming the outer boundary of a polygon. There should only be one card of this type for each polygon, except for the universal polygon.
Required	YES
Format	ARCS count
Sample	ARCS 2 10 12
Field	Variable	Value	Description
1	count	+	Number of arcs in the polygon.
2	id	+	Arc id. Field 2 is repeated for each arc in the polygon. The arcs should be listed in clockwise order.

Card Type	HARCS
Description	Defines the arcs bounding the holes in the polygon. There should be one card of this type for each hole in the polygon.
Required	NO.
Format	HARCS count
Sample	HARCS 2 10 12
Field	Variable	Value	Description
1	count	+	Number of hole-arcs in the polygon.
2	id	+	Arc id. Field 2 is repeated for each arc in the polygon. The arcs should be listed in counter-clockwise order.

Feature Object Attributes

The following cards are used to specify the attributes associated with points, arcs, and polygons. They should be placed in the file between the beginning and ending cards for the associated objects.

Point and Node Attributes

Card Type	SPECHHEAD
Description	Specified Head head attribute.
Required	YES if a feature object is of Specified Head type.
Format	SPECHHEAD constflag value/id
Sample	SPECHHEAD 1 138.6
Field	Variable	Value	Description
1	constflag	0,1	The type code: 0 = Transient attribute represented by xy series. 1 = Constant attribute represented by a single value.
2	value/id	±/+	The constant value or the id of an xy series.

Card Type	SPECXVEL
Description	Specified Velocity, X velocity component
Required	YES if a feature point or node is of Specified Velocity type.
Format	SPECXVEL constflag perp-to-boundary value/id
Sample	SPECXVEL 1 0 138.6
Field	Variable	Value	Description
1	constflag	0,1	The type code: 0 = Constant attribute represented by a single value. 1 = Transient attribute represented by xy series.
2	perp-to-boundary	0,1	1 = Nodal Velocity will be perpemndicular to boundary.
3	value/id	±/+	The constant value or the id of an xy series.

Card Type	SPECYVEL
Description	Specified Velocity, Y velocity component
Required	YES if a feature point or node is of Specified Velocity type.
Format	SPECYVEL constflag value/id
Sample	SPECYVEL 1 152.6
Field	Variable	Value	Description
1	constflag	0,1	The type code: 0 = Constant attribute represented by a single value. 1 = Transient attribute represented by xy series.
2	perp-to-boundary	0,1	1 = Nodal Velocity will be perpemndicular to boundary.
3	value/id	±/+	The constant value or the id of an xy series.

Card Type	REFINE
Description	es the size of the refine point.
Required	NO
Format	REFINE value
Sample	REFINE 100
Field	Variable	Value	Description
1	Value	+	The constant value which specifies the size of surrounding ele,ments after meshing.

Arc Attributes

Card Type	SPECHELEV
Description	Specified Head elevation attribute
Required	YES if a refine arc is of Specified Head type.
Format	SPECHELEV constflag value/Id type total-flow
Sample	SPECHELEV 0 132 0 1
Field	Variable	Value	Description
1	constflag	0,1	The type code: 0 = Transient attribute represented by xy series. 1 = Constant attribute represented by a single value.
2	value/id	±/+	The constant value or the id of an xy series.
3	type	0,1	The type code: 0 = Essential Specified Head Arc. 1 = Natural Specified Head Arc.
4	total-flow	0,1	The type code: 0 = Arc is not total flow arc. 1 = Arc is total flow arc.

Card Type	SPECCONC
Description	Specified Concentration, Concentration Attribute.
Required	YES if a feature arc is of Specified Concentration type.
Format	SPECCONC constflag value/id
Sample	SPECCONC 0 1.32
Field	Variable	Value	Description
1	constflag	0,1	The type code: 0 = Transient attribute represented by xy series. 1 = Constant attribute represented by a single value.
2	value/id	±/+	The constant value or the id of an xy series.

Card Type	SPECFLOW
Description	Specified Flow, flow attribute.
Required	YES if a feature arc is of Specified Flow type.
Format	SPECFLOW constflag value/id total-flow
Sample	SPECFLOW 0 1.32 1
Field	Variable	Value	Description
1	constflag	0,1	The type code: 0 = Transient attribute represented by xy series. 1 = Constant attribute represented by a single value.
2	value/id	±/+	The constant value or the id of an xy series.
3	total-flow	0,1	The type code: 0 = Arc is not total flow arc. 1 = Arc is total flow arc.

Card Type	FLUX
Description	Flux arc attribute.
Required	YES if a feature arc is of Flux type.
Format	FLUX total-flow
Sample	FLUX 1
Field	Variable	Value	Description
1	total-flow	0,1	The type code: 0 = Arc is not total flow arc. 1 = Arc is total flow arc.

Polygon Attributes

Card Type	ADAPTESS
Description	Adaptive Tesselation type attributes.
Required	YES if a feature polygon is of adaptive tessellation type.
Format	ADAPTESS bias
Sample	ADAPTESS 1.0
Field	Variable	Value	Description
1	bias	+	Bias for meshing.

Card Type	PATCH
Description	Patch type attributes.
Required	YES if a feature polygon is of patch type.
Format	PATCH bias
Sample	PATCH 1.0
Field	Variable	Value	Description
1	bias	+	Bias for meshing.

Card Type	CEILING
Description	Four points defining a ceiling.
Required	NO
Format	CEILING flag a b c d
Sample	CEILING 1 0.577 0.577 0.577 0.577
Field	Variable	Value	Description
1	flag	0,1	The type code: 0 = Ceiling is off. 1 = Ceiling is on.
2-5	a,b,c,d	±	Four values a,b,c,d for use in plane equation ax + by + cz +d = 0 to define plane of ceiling..

Card Type	MAT
Description	Beginning of the polygon material values
Required	NO

Card Type	MN
Description	Material name and id.
Required	YES if the MAT card is used.
Format	MN id name
Sample	MN 1 material_1
Field	Variable	Value	Description
1	id	+	id of the material.
2	name	+	name of the material.

Card Type	MC
Description	Material colors.
Required	YES I fthe MAT card is used.
Format	MN id r g b
Sample	MN 1 255 255 255
Field	Variable	Value	Description
1	id	+	id of the material.
2-4	r,g,b	+	Red, Green, Blue color components.

Card Type	MS
Description	Material pattern.
Required	YES if the MAT card is used.
Format	MN id pattern
Sample	MN 1 5
Field	Variable	Value	Description
1	id	+	id of the material.
2	pattern	+	Pattern index.

Drawing Objects

The following cards are used to define rectangles, ovals, lines, and text strings.

Card Type	RECT
Description	The beginning of a set of cards defining a rectangle.
Required	NO

Card Type	OVAL
Description	The beginning of a set of cards defining an oval.
Required	NO

Card Type	C# (C1, C2, C3, C4, for the four corner points)
Description	Corner point identifiers of rectangle or oval.
Required	YES if a rectangle or oval has been defined.
Format	C1 x y z
Sample	C1 10 10 0
Field	Variable	Value	Description
1-3	x, y, z	±	Coordinates of corner point.

Card Type	THICK
Description	Line thickness identifier.
Required	YES if a line, rectangle or oval has been defined.
Format	THICK width
Sample	THICK 1
Field	Variable	Value	Description
1	width	+	Line thickness in pixels.

Card Type	STYLE
Description	Line style identifier.
Required	YES if a line, rectangle or oval has been defined.
Format	STYLE style
Sample	STYLE 0
Field	Variable	Value	Description
1	style	+	0 - Solid line style. 1 - Dashed line style.

Card Type	LINECOL
Description	Line color identifier.
Required	YES if a line, rectangle or oval has been defined.
Format	LINECOL r g b
Sample	LINECOL 255 255 255
Field	Variable	Value	Description
1-3	r, g, b	0-255	Red, green and blue color components

Card Type	FILLCOL
Description	Polygon fill color identifier.
Required	YES if a rectangle or oval has been defined.
Format	FILLCOL r g b
Sample	FILLCOL 255 255 255
Field	Variable	Value	Description
1-3	r, g, b	0-255	Red, green, blue color components

Card Type	FILLPAT
Description	Polygon fill pattern identifier.
Required	YES if a rectangle or oval has been defined.
Format	FILLPAT pattern
Sample	FILLPAT 0
Field	Variable	Value	Description
1	pattern	+	Pattern index.

Card Type	LINE
Description	Beginning of a set of cards defining a line object.
Required	NO

Card Type	VERTS
Description	Number of points in a line.
Required	YES if a line has been defined.
Format	VERTS count
Sample	VERTS 3
Field	Variable	Value	Description
1	count	+	Number of points in the line.

Card Type	PT
Description	Defines a point on a line object
Required	YES if a line has been defined.
Format	PT x y z
Sample	PT 213.2. 523.2 0
Field	Variable	Value	Description
1-3	x y z	±	Coordinates of the point.

Card Type	ARRHED
Description	Arrow head type identifier.
Required	YES if a line has been defined.
Format	ARRHED style
Sample	ARRHED 0
Field	Variable	Value	Description
1	style	0 1 2 3	No arrow head. Arrow head at beginning of line. Arrow head at end of line. Arrow heads at both ends of line.

Card Type	HEDWID
Description	Arrow head base width identifier.
Required	YES if a line has been defined.
Format	HEDWID width
Sample	HEDWID 10
Field	Variable	Value	Description
1	width	+	Width of the base of the arrow head in pixels.

Card Type	HEDLEN
Description	Arrow head length identifier.
Required	YES if a line has been defined.
Format	HEDLEN length
Sample	HEDLEN 25
Field	Variable	Value	Description
1	length	+	Length of the arrow head in pixels.

Card Type	TEXT
Description	Beginning of a set of cards defining a text object.
Required	NO

Card Type	STRING
Description	Text string identifier.
Required	YES if a text string has been defined.
Format	STRING "string"
Sample	STRING "map title"
Field	Variable	Value	Description
1	string	str	Text string.

Card Type	LOCAL
Description	Text string location identifier.
Required	YES if a text string has been defined.
Format	LOCAL x y
Sample	LOCAL 100 200
Field	Variable	Value	Description
1-2	x, y	±	Coordinates of the beginning of the text string.

Card Type	PCFONT
Description	PC font identifier.
Required	YES if a text string has been defined.
Format	PCFONT id
Sample	PCFONT 2
Field	Variable	Value	Description
1	id	+	The id of the PC font.

Card Type	UNIXFONT
Description	UNIX font identifier.
Required	YES if a text string has been defined.
Format	UNIXFONT id
Sample	UNIXFONT 2
Field	Variable	Value	Description
1	id	+	The id of the UNIX font.