# # EXECUTABLE PROGRAM GroundSitePass v1.3 # 27-DEC-2019 # # History # # v1.3 (27–DEC-2019) # Update mission_configuration_files folder to v1.14 Added swath color to input configuration file Added topocentric satellite azimuth and elevation to output files KML: Draw circle of given radius, Draw balloon for 1-point swaths CSV, HTML: move Asc/Desc column next to Pass counter # # Linked against EO CFI SW libraries v4.14 # It calculates the overpass UTC 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 three types of output files (.CSV, .KML, .HTML) # # 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 2019-12-01T00:00:00 2019-12-03T00:00:00 # Example command Mac OS X 10.8 onwards (from Terminal) ./GroundSitePass input_config_file.txt 2019-12-01T00:00:00 2019-12-03T00:00:00 # Example command Linux (from shell window) ./GroundSitePass input_config_file.txt 2019-12-01T00:00:00 2019-12-03T00:00:00 # # Output Files created: S5P_TROPOMI_VISIBILITY_SEGMENTS_20191201_000000_20191203_000000_0001.CSV —> File in Comma Separated Value format, can be opened with Excel S5P_TROPOMI_VISIBILITY_SEGMENTS_20191201_000000_20191203_000000_0001.KML —> Once loaded in Google Earth, clicking on the individual time segments displays a balloon with info associated to the pass S5P_TROPOMI_VISIBILITY_SEGMENTS_20191201_000000_20191203_000000_0001.HTML —> To be visualised with the correct format, the CSS stylesheet file (overpass_table.css) has to be in the same folder as the HTML table. The tables, once displayed with the browser, can be easily copied and pasted to Word or Excel. # # 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 --> Satellite Azimuth at site, az=0 is the North direction, az=90 deg = East direction --> Satellite Elevation, el=90 is the Zenith direction, el < 0 means below Earth surface # # Contents Input Configuration File "input_config_file.txt" # Satellite ID (allowed values: AEOLUS, BIOMASS, CRYOSAT2, EARTHCARE, FLEX, METOPSG, SENTINEL1A, SENTINEL1B, SENTINEL2A, SENTINEL2B, SENTINEL3A, SENTINEL3B, SENTINEL5P, SENTINEL6, SEOSAT or GENERIC) Orbit Filename --> Example type Orbit Scenario File (MPL_ORBSCT): S5P_OPER_MPL_ORBSCT_20171013T104928_99999999T999999_0008.EOF --> It can also be an MPL_ORBPRE Swath Filename —> Example Swath Definition File: SDF_TROPOMI.S5P 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 ID (any string) —> Example instrument name: TROPOMI 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) Swath Color (aabbggrr, aa=alpha, bb=blue, gg=green rr=red, with ranges 00 to ff) # # Example Zone Database Files provided in the package # GROUND_SITES_EXAMPLE_ZONEDBFILE.EOF --> It contains a few example ground points # # Mission Configuration Files folder # See mission_configuration_files/Readme_mission_config.txt for further details