Supported by:
ISIS Coverage to SIGRID-3 Shapefile Conversion
March 2008
Download SIGRID-3 Code & Sample (save to disk and unzip)
The ISIS Coverage to SIGRID-3 Shapefile Conversion takes a ESRI coverage in CIS e00 transfer format and generate a SIGRID-3 specification shapefile. This conversion is done automatically on all production analyses produced by the Canadian Ice Servce.
This package is a specially-prepared example for JCOMM of how the SIGRID-3 shapefile is generated. Rather that use Oracle tables, ESRI Info files have been created to mimic the functionality provided by Oracle.
The production environment at the Canadian Ice Service is HP-UX 11.23, Perl5 and ArcGIS 9.2 Workstation. This conversion will also run on Linux and Windows but the notes below were generated for HP-UX.
Several HP-UX environment variables are requrired to run this conversion utility. These are;
- ISIS_SERVER_HOME
- ISIS_AML
- ISIS_BIN
- ISIS_LOGFILES
- ISIS_WS_TEMP
- ISIS_SHARED
- ISIS_DATA
Additionally, the standard environment variables of ARCHOME and SHLIB_PATH should be set appropriately.
On the test HP-UX system, these environment variables are defined as;
- ISIS_SERVER_HOME=/isis_ops (this is the root directory for all programs)
- ISIS_AML=/isis_ops/aml
- ISIS_BIN=/isis_ops/bin
- ISIS_LOGFILES=/isis_ops/logs
- ISIS_WS_TEMP=/isis_ops/tmpws
- ISIS_SHARED=/isis_ops_shared
- ISIS_DATA=/isis_ops_shared/data
Within the $ISIS_SERVER_HOME root, subdirectories are requrired. These are;
- $ISIS_SERVER_HOME/aml
- $ISIS_SERVER_HOME/bin
- $ISIS_SERVER_HOME/logs
- $ISIS_SERVER_HOME/tmpws
The logs and tmpws subdirectories will be empty initially but the other subdirectories have the content;
- $ISIS_SERVER_HOME/aml/server_export_sigrid3.aml
- $ISIS_SERVER_HOME/aml/define_feature_types.eaf
- $ISIS_SERVER_HOME/aml/define_server_variables.eaf
- $ISIS_SERVER_HOME/aml/log_event.eaf
- $ISIS_SERVER_HOME/aml/set_path_variables.eaf
- $ISIS_SERVER_HOME/aml/sigrid_read_template_lut.eaf
- $ISIS_SERVER_HOME/aml/utl_get_temp_covername.eaf
- $ISIS_SERVER_HOME/aml/utl_get_temp_filename.eaf
- $ISIS_SERVER_HOME/aml/utl_make_polycover.eaf
- $ISIS_SERVER_HOME/aml/utl_project.eaf
- $ISIS_SERVER_HOME/aml/utl_read_metadata.eaf
- $ISIS_SERVER_HOME/aml/utl_valid_line_type_list.eaf
- $ISIS_SERVER_HOME/aml/utl_valid_pnt_type_list.eaf
- $ISIS_SERVER_HOME/bin/file_util_lib.pl
- $ISIS_SERVER_HOME/bin/read_metadata.pl
NOTE: The logs and tmpws subdirectories must exist and have OPEN permissions.
Within the $ISIS_SHARED root, one subdirectory is requrired. This is;
$ISIS_SHARED/data/luts
The conversion of an CIS Analysis Coverage to a SIGRID-3 shapefile is done with server_export_sigrid3.aml:
&run server_export_sigrid3 [path_input_exportfile] [path_input_metafile] [path_output_directory] [path_output_shpdsc] [shapefile_basename] {DEBUG}
where:
- [path_input_exportfile] is a CIS e00 file
- [path_input_metafile] is a CIS ASCII metadata file
- [path_output_directory] is a directory for the generated SIGRID-3 shapefile component files (shp,shx,dbf)
- [path_output_shpdsc] is an internal file used to track the archiving of the shapefile
- [shapefile_basename] is the basename of the generated SIGRID-3 shapefile component files (maximum 8 characters)
- {DEBUG} is an optional flag to maintain temporary files created by the conversion
An example coverage in ESRI e00 transfer format has been provided which explains how to generate the SIGRID-3 shapefile.
Assuming that the example_glakes.e00 and example_glakes.md files have been placed in /tmp, the following sequence will perform the conversion.
mkdir /tmp/sigrid_output
arc \\&run ${ISIS_AML}/server_export_sigrid3 ~
/tmp/example_glakes.e00 /tmp/example_glakes.md /tmp/sigrid_output /tmp/sigrid_glakes.dsc glakes DEBUG
After a successful conversion, the following files will exist for the Great Lakes region;
- /tmp/sigrid_output/glakes.dbf
- /tmp/sigrid_output/glakes.shp
- /tmp/sigrid_output/glakes.shx
- /tmp/sigrid_glakes.dsc
NOTE: An example of the output SIGRID-3 shapefile produced from example_glakes.e00 is provided in example_output (glakes.shp, glakes.shp, glakes.dbf)
(Last Updated: 25-06-2008)