awips2/cave/com.raytheon.viz.gfe/help/MapFiles.html

85 lines
4.5 KiB
HTML
Raw Normal View History

2022-05-05 12:34:50 -05:00
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.79 [en] (X11; U; Linux 2.4.9-31smp i686) [Netscape]">
<meta name="Author" content="Juliya Dynina">
<title>Map Background Configuration</title>
</head>
<body bgcolor="#FFFFFF">
<h1 CLASS="3Heading">
<a NAME="Top"></a>Map Files - Map Background Shapefile Handling</h1>
<div CLASS="3Heading">September 25, 2012</div>
<h1 CLASS="3Heading">
</h1>
<h2>
<a NAME="Organization"></a>Organization</h2>
<a href="#Overview">Overview</a>
<br><a href="#Updating">Updating Map Shapefiles</a>
<br>
<hr WIDTH="100%">
<h2>
<a NAME="Overview"></a>Overview</h2>
<p>
AWIPS2 handles map backgrounds differently than AWIPS1 did. The Maps.py file
is no longer used for creating map backgrounds. Instead, a PostGIS <i>maps</i> database is used
in conjunction with xml configuration. Consequently, there is a change to how local
maps are added to the system. These maps are available across all perspective in CAVE and are
not specific to GFE.
</p>
<p>
<a href="mapConfig.html">Maps.py</a> and <a href="localMapsConfig.html">localMaps.py</a> are now only used to generate edit areas from maps database tables.
</p>
<hr WIDTH="100%">
<h2><a NAME="Updating"></a>Updating Map Shapefiles</h2>
<p><ol>
<li>Any site level .shp, .shx and .dbf map files should be placed into the
/awips2/edex/data/utility/edex_static/site/LLL/shapefiles/<i>table_name</i> directory
where <i>table_name</i> is unique.</li>
<li>To import one shapefile at a time, execute the
/awips2/database/sqlScripts/share/sql/maps/importShapeFile.sh script with the following
arguments: shapefile, scheme (mapdata), table (shapefile name), geometry simplification
levels (not used for Point data), user, port, and awips root directory. For detailed
instructions on how to do this, see the
<a href="https://collaborate.nws.noaa.gov/trac/siteconfig/wiki/HowToImportShapeFile">Importing
Map Shapefiles into AWIPS2 using importShapeFile</a> web page.</li>
<li>Next, you will need to add bundle files procedures. To do this, access the Localization
perspective in CAVE and browsing to the Bundles-&gt;Maps folder. MB3 on the Maps folder and
create a new xml file which corresponds to the shapefile folder. Copy and modify the contents
from an existing file.
<ul>
<li><b>Line and Polygon shapefiles</b> - in the resourceData element, change the value of the
table element to the name of the database table (shapefile folder name), and the mapName
to the label to show in the Map menu in CAVE. If labels are required in the new map, then edit
the labelField in the Capability element. Otherwise, delete the capability element with type
<i>labelableCapability</i>. The value for the labelField relates to a column in the database table
with the same name. For example, the value CWA for the labelField refers to the values in the
cwa column of the CWA table in the mapdata scheme.</li>
<li><b>Point shapefiles</b> - in the resourceData element, change the type attribute to
<i>dbPointMapResourceData</i>, change the value of the table element to the name of the new database
table name (shapefile filder name), and the mapName to the label to show in the Map menu in CAVE. If labels
are required in the new map, then edit the labelField in the Capability element. Otherwise,
delete the capability element with type <i>labelableCapability</i>. The value for the labelField
relates to a column in the database table with the same name. For example, the value CWA for
the labelField refers to the values in the cwa column of the CWA table in the mapdata scheme.</li>
</ul>
For more information on configuring the resource data options, the
<a href="https://collaborate.nws.noaa.gov/trac/siteconfig/wiki/MapResourceDataConfigOptions">MapResourceDataConfigOptions</a>
page provides more details on configuring the capabilities and resources for a map.
<li>Save to SITE level and restart CAVE.</li>
</ol>
</p>
<p><b><font color="#FF0000">See the <a href="serverConfiguration.html#ServerDatabaseConfigurationModificationOptions">server
configuration overview</a> for information on how to make changes that
are supported to the map backgrounds.</font></b>
<hr WIDTH="100%">
<br>
<div CLASS="Body">&nbsp;<a href="#Top">Back To Top</a>
<br>&nbsp;<a href="GFESuite.html#TableOfContents">Back To TOC</a></div>
</body>
</html>