Exporting to KML Files

This routine exports GASWorkS model data to a KML (Keyhole Markup Language) file for use in mapping programs such as Google Earth. It is run from the Export item in the Utilities menu, and its progress is shown in the Export Log. The KML Export Settings screen controls exactly which pipe, node, and customer features and annotations are written to the file — its three tabs are documented in detail below. The model must be in longitude and latitude coordinates to export a KML file, and a model must be open with the GDI Window displayed before starting.

GDI Commands

Export A KML File

Model data from GASWorkS can be exported to a KML file.

This routine is run by selecting the Export item from the Utilities menu and choosing the KML file type; it has no GDI Command Line alias.

Notes

• The KML Export routine creates a Keyhole Markup Language (KML) file. Once created, the KML file can be imported or opened by mapping programs such as Google Earth.
• To export to a KML file, the model must be in longitude and latitude coordinates. If the model is not in the proper coordinates, a message may be displayed asking whether to project the coordinates; respond appropriately.

KML Export Settings

The KML Export Settings screen is displayed after the Save screen and controls the content of the exported file. It has three tabs — Pipe Items, Node Items, and Customer Items. Each tab begins with a master “Include … Items” checkbox that turns the export of that entire feature type on or off; the specification and “Include …” options on the tab apply only when that master checkbox is enabled. The Save Settings and Open Settings buttons store and recall a settings configuration, and the Clear button resets the current tab.

Pipe Items Tab

The Pipe Items tab controls whether pipes are exported, the color assigned to each pipe size, and which pipe properties are annotated. Check Include Pipe Items to enable the tab; the settings below apply only when it is checked.

Specifications

• Pipe Size / Color Assignment — A table for assigning a display color to each pipe size. Select a pipe size from the Pipe Size list (for example 1/2P CTS, 2P, 4P-S11) and choose the color to apply to it in the Color Assignment column, so that pipes of that size appear in the chosen color when the KML file is viewed in a mapping program.

Options

• Include Diameter (ID Value) — Annotates the pipe’s inside diameter (ID) value.
• Include Efficiency — Annotates the pipe’s efficiency value.
• Include Flow Rate — Annotates the calculated flow rate for each pipe.
• Include Length — Annotates each pipe’s length.
• Include Link ID Number — Annotates the pipe’s link (from-node / to-node connection) ID number.
• Include Pressure Drop — Annotates the pressure drop across each pipe.
• Include Roughness — Annotates the pipe’s roughness value.
• Include Size/Type Code — Annotates the pipe’s size/type code.

Node Items Tab

The Node Items tab controls whether nodes are exported and which node properties are drawn or annotated. Check Include Node Items to enable the tab; the sizes and options below apply only when it is checked.

Specifications

• Symbol Size — Size of the node symbols (Web L/L units).
• Text Size — Size of the node annotation text (Web L/L units).
• Text Offset — Distance the node text is offset from the symbol, expressed as a percent of symbol size.

Options

• Include Atmospheric Pressure — Annotates each node’s atmospheric pressure.
• Include Base Load (Entered) — Annotates the entered base load at the node.
• Include Elevation — Annotates the node’s elevation.
• Include External Load (Entered) — Annotates the entered external load at the node.
• Include Load (Total Adjusted) — Annotates the node’s total adjusted load.
• Include Node Name — Annotates the node’s name.
• Include Pressure — Annotates the node’s pressure.
• Include Temperature — Annotates the node’s temperature.

Customer Items Tab

The Customer Items tab controls whether customers are exported and which customer properties are drawn or annotated. Check Include Customer Items to enable the tab; the sizes and options below apply only when it is checked.

Specifications

• Symbol Size — Size of the customer symbols (Web L/L units).
• Text Size — Size of the customer annotation text (Web L/L units).
• Text Offset — Distance the customer text is offset from the symbol, expressed as a percent of symbol size.
• Service Line Thickness — Line weight used for the exported customer service lines.

Options

• Include ID Number — Annotates each customer’s ID number.
• Include Link ID Number — Annotates the customer’s link (connection) ID number.
• Include Service Lines — Draws the customer service lines.
• Include Total Load — Annotates each customer’s total load.

Notes & Considerations

• The routine assumes that GASWorkS has been started, a model is open, and the GDI Window is displayed.
• The model must be in longitude and latitude coordinates. If it is not, a message may be displayed asking whether to project the coordinates; respond appropriately. Use Project A Model to convert a model to the proper coordinate system beforehand.
• If an existing file is selected on the Save screen, a message will be displayed asking whether to overwrite the file; respond appropriately.
• The Export Log section of the Export screen displays the status of the routine; when the routine is complete, click the Close button.
• The content of the exported file is determined entirely by the KML Export Settings screen. Enable the master “Include … Items” checkbox on each tab for the feature types you want, then choose the individual properties to draw or annotate.

See Also

• Importing CSV, DXF & KML Files
• Exporting Model Data (CSV, DBF & XLS)
• Example: Importing DXF & Working with Shapefiles

FAQ