How to use PRIDE#

Once you have installed PRIDE, the easiest way to interact with it is to use the command line interface: pride. For now, this program takes a single, required, argument: the path to a configuration file, which is a YAML file with the following structure.

Example configuration file
Experiment:
  # VEX file [Path (relative or absolute)]
  vex: <path_to_vex_file>
  # Name of the near field target
  target: <target_name>
  # Phase center (station name)
  phase_center: GEOCENTR     # DO NOT MODIFY
  # Ignore scans from the following stations (two-letter codes)
  ignore_stations: []
  # Output directory
  output_directory: output

Resources:
  # Directory containing the SPICE kernels
  ephemerides: "spice"

Displacements:
  # Solid Earth tides caused by the Sun and the Moon
  SolidTide: true
  # Ocean loading
  OceanLoading: true
  # Rotational deformation due to pole tides
  PoleTide: true

Delays:
  Tropospheric:
      # Calculate tropospheric delay
      calculate: true
      # Tropospheric model: ["petrov", "vienna"]
      model: vienna
      # Allow backup model if primary not available (e.g. use Vienna if no Petrov)
      backup: false
      backup_model: petrov
      # Directory with tropospheric data files
      data: "data/tropospheric"

  Ionospheric:
      # Calculate ionospheric delay
      calculate: true
      # Directory with ionospheric data files
      data: "data/ionospheric"

  Geometric:
      # Calculate geometric delay
      calculate: true
      # Directory with data files for geometric delay
      data: "spice"

  AntennaDelays:
      # Calculate delays due to geometry and deformation of antennas
      calculate: true
      # Directory with data files for thermal deformation
      data: "data/tropospheric" # We obtain info from site-specific V3GR
      # Fallback to default configuration if no site-specific data is available
      fallback: true

For normal applications, the only section of this file you will have to interact with is Experiment, which includes the following entries:

vex

The path to your VEX file. It can be absolute or relative to the configuration file. Examples: GR035.vex, ec094a.vix

target

A short, lowercase, name for your near-field target. It should be compatible with SPICE. Examples: juice, mex, vex

ignore_stations

A list of two-letter codes of stations that are listed in the VEX file, but should be ignored during delay estimation. The codes should be capitalized. Example: ["Cd", "Ww"]

output_directory

The path to the directory where the program will save the .del files it produces as output. The path might be absolute or relative to the configuration file. Example: output

Once the configuration file is ready, you can process the experiment running

pride config.yaml

This will create the output directory, and populate it with .del files, containing geocentric delays, and Doppler phase corrections, for each of the stations.

This Page