# # EXECUTABLE PROGRAM ZoneOverPass v2.5 # 15-JUN-2023 # # History # # Changes with respect ZoneOverPass v2.4.1 (02-MAY-2022) # Added support for CHIME, CIMR, CO2M, CRISTAL, FORUM, LSTM, ROSEL, TRUTHS Added as output site2sun azimuth/elevation topocentric angles, sat2site azimuth/elevation angles in satellite attitude (for ground sites only) # # Changes with respect ZoneOverPass v2.4 (19-OCT-2020) # Linked against EO CFI v4.24, before v4.15 Added Target2Satellite azimuth at entry/exit point UTC times in CCSDSA with Microseconds (output) # # Changes with respect ZoneOverPass v2.3.2 (09-OCT-2020) # Correct issue with KML: coordinates of swath points after step not updated # # Changes with respect ZoneOverPass v2.3.1 (07-JUL-2020) # Correct 0.5 seconds offset in distance to mid-swath output (for point or circle zones) Calculate distance from ground site to satellite and pointing angles from ground site to satellite (for point or circle zones) # # Changes with respect ZoneOverPass v2.3 (29-MAY-2019) # Disable verbose command to log warning messages in zone calculation function Calculate distance to mid-swath instead of distance to ground-track Enlarge width of HTML report in CSS stylesheet # # Changes with respect ZoneOverPass v2.2 (22-MAR-2019) # Add cycle number to output when ORBSCT file type Add GENERIC_MEO Add parameter to input configuration file to set the duration when using TLE file (before 15 days was used as default) Update mission_configuration_files folder to v1.17 # # Changes with respect ZoneOverPass v2.1.1: # Draw circle of given radius around ground sites in KML output Add balloon in KML for point-zone Add relative orbit number if orbit file input is Orbit Scenario File (ORBSCT type) Updated mission_configuration_files folder (see details in mission_configuration_files/Readme_mission_config.txt) # # Changes with respect ZoneOverPass v2.1: # Updated mission_configuration_files folder (see details in mission_configuration_files/Readme_mission_config.txt) # # Changes with respect ZoneOverPass v2.0.1: # Add support for TLE files Add support for non pre-defined missions (using satellite configuration file) # # Changes with respect ZoneOverPass v2.0: # Updated mission_configuration_files folder (see details in mission_configuration_files/Readme_mission_config.txt) # # Changes with respect ZoneOverPass v1.4: # Distinguish between Ground Site (zone with num_points=1) and Zone in output files For Ground Site, calculate distance to ground track Swath filename in configuration file User-defined Swath identifier in configuration file Updated mission_configuration_files folder (see details in mission_configuration_files/Readme_mission_config.txt) # # # Linked against EO CFI SW libraries v4.24 # It calculates the zone visibility segments for all zones in the zone database file # It creates a set of output files (.CSV, .KML, .HTML) per zone # # Usage: ZoneOverPass input_config_file start_time stop_time # Inputs: Input configuration file # Input configuration file # Start/Stop Times are in UTC. Expected calendar CCSDS format: YYYY-MM-DDTHH:MM:SS # # Example commands macOS Intel & Linux, both 64-bit (from Terminal) # Example #1, SENTINEL2A with MSI swath ./ZoneOverPass input_config_file_S2A_MSI.txt 2016-06-06T00:00:00 2016-06-09T00:00:00 # Example #2, SENTINEL2A with ORBIT ground-track ./ZoneOverPass input_config_file_S3A_ORBIT.txt 2016-06-06T00:00:00 2016-06-09T00:00:00 # Example #3, SENTINEL3A with OLCI swath ./ZoneOverPass input_config_file_S3A_OLCI.txt 2016-06-06T00:00:00 2016-06-09T00:00:00 # # Example commands Windows 64-bit (from Command Prompt Window) # Example #1, SENTINEL2A with MSI swath ZoneOverPass.exe input_config_file_S2A_MSI.txt 2016-06-06T00:00:00 2016-06-09T00:00:00 # Example #2, SENTINEL2A with ORBIT ground-track ZoneOverPass.exe input_config_file_S3A_ORBIT.txt 2016-06-06T00:00:00 2016-06-09T00:00:00 # Example #3, SENTINEL3A with OLCI swath ZoneOverPass.exe input_config_file_S3A_OLCI.txt 2016-06-06T00:00:00 2016-06-09T00:00:00 # #Output Files created (1 pair per zone in zone database file): # Output of example command #1 S2A_EXAMPLE_CIRCLE_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S2A_EXAMPLE_CIRCLE_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S2A_EXAMPLE_CIRCLE_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S2A_EXAMPLE_POINT_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S2A_EXAMPLE_POINT_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S2A_EXAMPLE_POINT_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S2A_AFRICA_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S2A_AFRICA_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S2A_AFRICA_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S2A_PACIFIC_AREA_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S2A_PACIFIC_AREA_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S2A_PACIFIC_AREA_MSI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML # Output of example command #2 S3A_EXAMPLE_CIRCLE_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_EXAMPLE_CIRCLE_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_EXAMPLE_CIRCLE_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S3A_EXAMPLE_POINT_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_EXAMPLE_POINT_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_EXAMPLE_POINT_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S3A_AFRICA_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_AFRICA_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_AFRICA_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S3A_PACIFIC_AREA_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_PACIFIC_AREA_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_PACIFIC_AREA_ORBIT_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML # Output of example command #3 S3A_EXAMPLE_CIRCLE_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_EXAMPLE_CIRCLE_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_EXAMPLE_CIRCLE_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S3A_EXAMPLE_POINT_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_EXAMPLE_POINT_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_EXAMPLE_POINT_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S3A_AFRICA_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_AFRICA_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_AFRICA_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML S3A_PACIFIC_AREA_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.KML S3A_PACIFIC_AREA_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.CSV S3A_PACIFIC_AREA_OLCI_VISIBILITY_SEGMENTS_20160606_000000_20160609_000000_0001.HTML # # Contents of Input Configuration File "input_config_file.txt" # Satellite ID (allowed values: AEOLUS, BIOMASS, CHIME, CIMR, CO2M, CRISTAL, CRYOSAT2, EARTHCARE, FLEX, FORUM, LSTM, METOPSG, ROSEL, SEOSAT, SENTINEL1A, SENTINEL1B, SENTINEL1C, SENTINEL2A, SENTINEL2B, SENTINEL2C, SENTINEL3A, SENTINEL3B, SENTINEL3C, SENTINEL5P, SENTINEL6, SMOS, TRUTHS, GENERIC, GENERIC_MEO or user-defined mission name) Orbit Filename (types: MPL_ORBSCT e.g. S2A_OPER_MPL_ORBSCT_20150623T033125_99999999T999999_0006.EOF, MPL_ORBPRE, MPL_ORBRES or TLE) Swath Filename (e.g. swath defintion file SDF_MSI.S2) Zone Database Filename (file with list of zones, in EO CFI / Esov NG Zone Database format) Instrument Swath ID (any string, e.g MSI) Swath Color (aabbggrr, aa=alpha, bb=blue, gg=green rr=red, with ranges 00 to ff) Number of days to propagate after TLE record time (e.g to propagate for one month into the future, set to 30.0) # # Example Input Configuration Files provided in the package # input_config_file_S2A_MSI.txt --> Example of SENTINEL2A with MSI swath, with example zone database file input_config_file_S3A_ORBIT.txt --> Example of SENTINEL3A with ORBIT ground-track, with example zone database file input_config_file_S3A_OLCI.txt --> Example of SENTINEL3A with OLCI swath, with example zone database file # # Example Zone Database File provided in the package # EXAMPLE_ZONEDBFILE.EOF --> It contains a few example areas ground point: EXAMPLE_POINT circular area: EXAMPLE_CIRCLE polygon area: AFRICA rectangular area: PACIFIC_AREA # # Mission Configuration Files # Package with mission files for all supported missions can be found under the link: http://eop-cfi.esa.int/Repo/PUBLIC/DOCUMENTATION/MISSION_DATA/ORBIT_SWATH_DATA/ See Readme_mission_config.txt for further details