               src/utils/google/README.txt
                  Revised 14 June 2021, 


IrisToGoogle and IrisToKml are executables that convert an IRIS product and a png
file to a kml file.

IrisToGoogle continually overwrites the current kml and png file. This is used
for google earth

IrisToKml creates new kml and png files. This would be used for a movie loop

--------------------------------------------------------------------------
IrisToGoogle and IrisToKml setup menu
--------------------------------------------------------------------------
 To get IrisToGoogle and IrisToKml working correctly you must
 create a Network output process in setup.
 In setup->output->Network set the following :
   Device type:  Network
   Unit number:  1-x
   Menu alias:  GoogleEarth (IrisToGoogle) or Kml (IrisToKml)
   Min time between output:  0 sec
   File format:  PNG
   Filename format:  Default (IrisToGoogle) or IIA (IrisToKml)
   Compression scheme:  None
   Notification schema:  Rename
   Target Directory:  something like - /usr/iris_data/kml/
   Copy scheme:  Script
   User name:  Unused
   Password:  Unused
   Copy script name:  IrisToGoogle or IrisToKml
   Recipient host name: Unused
   Width of image:  Same as projection width
   Height of image: Same as projection height

 Next in the IRIS menu in Tools->Projection Config you must:
  - Create a Projection type of Eqdist Cylinder
  - Make sure the pixel image size is square (480x480, 720x720... pixels)
  - Enter the correct center Lat, Lon coordinates

Next in the IRIS menu Menus->Product Configuration you must use
the Eqdist Cylinder projection you created in the Projection
Configuration Menu to create a product that has the correct
google earth projection.

---------------------------------------------------------
Only required for the IrisToGoogle pipe
---------------------------------------------------------
 In Google Earth go to Add->Network Link...
 In Link: text field add the path and
 filename of the .kml that IRIS created.
 (Mine is: /var/www/html/google/Output03.wes-typhoon.kml)
 You can also specify a URL if your web-server running (Mine is
 (http://192.168.45.202/google/Output03.wes-typhoon.kml.  I couldn't
 get my hostname to work).  Next Select the Refresh Tab and change
 Time-Based Refresh to "Periodically" and about every 10 seconds

That's it.
