Help for the CISutil SDF KML file utility.
March 4, 2018

Create a KML file of a Section Definition File (SDF)
----------------------------------------------------

See the CIS Help document for SDF documentation.

On the SDF Files tab:
- Enter the input and output folders, SDF file name and 
  the LKI version of that SDF.

- click the "Create KML..." button

On the "Create a KML file of an SDF" form:

- Set options as described below
- Click the "Create KML" button

- In Google Earth open the KML file created 
  (it will be named the same as the SDF, but with a kml extension)
- Each section line will have an icon at its midpoint labelled with the
  section ID from the SDF.
- Section colours cycle through green, red and yellow.
- Click on a section line or label icon in Google Earth to get information.
- Sections may span LKI nodes.  If a section spans one or more nodes, 
  the nodes will be marked with a red paddle icon containing "N". 
  Click on the icon for the LKI locations at that node.

Options:
- Label section endpoints:
  - Puts small red [1] and [2] icons at the start and end points of each
    section, respectively, and labels those icons (in white) with the
    LKI segment number and km.
- Mark LKI Segment Kms
  - Specify an interval in km to one decimal place.
  - Pushpin markers will be placed every <interval> along the section
    line, coloured the same as the line, and labelled with the LKI km.
  - If the section spans an LKI node, the km markers start at zero
    past the node.
  * The labels are LKI Kms, NOT (necessarily) the distance from the
    start of the section *

Data to display in Google Earth Balloon:
---------------------------------------
  
- When a section line or icon is clicked in Google Earth, 
  an information balloon opens.
  
Standard Fields  
- check the boxes to select the standard SDF fields to display:
   - Section ID  (from the SDF field named ID, Project, ProjectID or GroupID)
   - name (without folder) of the source SDF
   - LKI version
   - start and end LKI segment and km
   - Description ( from the SDF field named Description, Note or Notes)

Auxiliary Fields:
- If you have other fields in your SDF which you would like to 
  have displayed in the section balloon, enter those field names.
- the field names are NOT case-sensitive.
- if a field name is not found in the header record of the SDF, 
  that field name will be ignored.
- to change a field label from its field name to something else, 
  code:  <new label>:<field name>
    eg:  The Shoe Size:shoesize
- multiple fields may be specified in each Auxiliary Field textbox, 
  separated by commas, 
    eg: Desc1,Description2:Desc2,ADT_2015  
  
Geometry Source:
- The LKI segment geometry (digitized highway centrelines) and kms
  come from the LKI shapefile exported from CHRIS, and in some cases
  from the LKI shapefile exported from the GeoBC geographical database.
- The CHRIS (and GeoBC) kms are scaled to the length the LKI segment 
  as stored in the LKI.
- The shapefiles are processed at Cypher Consulting to create MS-Access
  database CHgeo_LKIyyyymm_SegGeometry.mdb, which is distributed 
  with CISutil, where yyyymm is the version of the LKI defined in CHRIS
  at the time of the shapefile export.
- If the LKI version of the SDF is different from that of
  CHgeo_LKIyyyymm_SegGeometry.mdb, the LKI locations from the SDF are
  transformed to the LKI version of the geometry before querying
  the geometry.  
- All KML labelling is done according to the LKI version of the SDF.