# # EXECUTABLE PROGRAM GroundSitePass v1.0 # 17-JAN-2017 # Linked against EO CFI SW libraries v4.11) # It calculates the visibility time and additional information for all sites defined in the zone database file # A site is defined as a EO CFI zone with a single point (longitude, latitude) and diameter set to 0.0m # It creates one pair of output files (.CSV, .KML) per zone # # Usage: GroundSitePass input_config_file start_time stop_time # Start/Stop Times are in UTC. Expected calendar CCSDS format: YYYY-MM-DDTHH:MM:SS # Example command Windows 7 (from Command Prompt window) GroundSitePass.exe input_config_file.txt 2016-11-04T00:00:00 2016-11-06T00:00:00 # Example command Mac OS X 10.8 onwards (from Terminal) ./GroundSitePass input_config_file.txt 2016-11-04T00:00:00 2016-11-06T00:00:00 # Example command Linux (from shell window) ./GroundSitePass input_config_file.txt 2016-11-04T00:00:00 2016-11-06T00:00:00 # # Output Files created: S5P_TROPOMI_VISIBILITY_SEGMENTS_20161104_000000_20161106_000000_0001.CSV S5P_TROPOMI_VISIBILITY_SEGMENTS_20161104_000000_20161106_000000_0001.KML # # Convention for output parameters: --> Distance from site to ground-track is regarded as positive distance when the site is located on the left hand side of the ground-track. --> Sun Azimuth at site, az=0 is the North direction, az=90 deg = East direction --> Sun Elevation, el=90 is the Zenith direction, el < 0 means below Earth surface # # Contents Input Configuration File "input_config_file.txt" # Satellite ID (SENTINEL5P) Orbit Filename --> Example type Orbit Scenario File (MPL_ORBSCT): S5P_TEST_MPL_ORBSCT_20161027T044207_99999999T999999_0001.EOF --> It can also be MPL_ORBPRE Zone Database Filename --> File with list of ground points (in EO CFI / Esov NG Zone Database format) Example: GROUND_SITES_EXAMPLE_ZONEDBFILE.EOF Instrument Swath --> Allowed instrument swath values for SENTINEL5P: TROPOMI, ORBIT Maximum Distance between the ground site and the ground-track (in kilometers) --> Set by default to 3000.0 km (bigger than half swath width i.e. no constraint applied, full swath used) Minimum Sun Elevation Angle at the ground point (in degrees) --> Set by default to 0.0 (i.e. Sun visibility) # # Zone Database Files provided in the package # GROUND_SITES_EXAMPLE_ZONEDBFILE.EOF --> It contains a few example ground points # # Orbit Scenario Files provided in the package # An example orbit scenario file for SENTINEL5P has been provided S5P_TEST_MPL_ORBSCT_20161027T044207_99999999T999999_0001.EOF # # Swath Definition Files provided in the package # The swath definition files for SENTINEL5P can be found in the folder S5P_SDF/