AlTiS-NG Wiki

1 Welcome to AlTiS-NG

AlTiS-NG is a powerful tool for processing altimetry data. This documentation will guide you through the installation, setup, and usage of AlTiS-NG.

1.1 Getting Started

1.1.1 Download AlTiS-NG

AlTiS-NG is available for Windows and Linux. It is standalone software provided as a binary package, ready to run on your platform without any installation procedure. The current version of AlTiS-NG is available in the CTOH catalog : http://dx.doi.org/10.6096/3007.

Alternatively, you can choose to download the source code and compile it yourself.

Download AlTiS-NG for your platform:

Platform Binary File
Windows 10 altis-gui_vx.x_windows-10.exe
Windows 11 altis-gui_vx.x_windows-11.exe
Ubuntu 22.04 altis-gui_vx.x_ubuntu-22.04
Ubuntu 24.04 altis-gui_vx.x_ubuntu-24.04

Products on Congo basin for testing AlTiS-NG Software

1.2 Altimetry Products

AlTiS utilizes official Level-2 altimetry data products (Geographical Data Record - GDR) provided by space agencies such as ESA, NASA, and CNES. To enhance the performance of the AlTiS software, the CTOH distributes reduced GDR data files derived from the official products. These files are specifically conditioned to optimize data size through geographical selection and include the appropriate altimetry parameters for hydrological studies.

To request these reduced altimetry products tailored for AlTiS:

  1. Fill out the request form.
  2. The product is supplied in a ZIP archive.
  3. Once downloaded, you can directly load it into AlTiS without extracting the ZIP archive.

1.3 Products Configuration File

AlTiS-NG configuration file of products is available here.

Figure 1: AlTiS-NG to set the product configuratoin file

1.4 Graphical User Interface

Figure 2: AlTiS-NG GUI with altimetry measurement on a river

The main AlTiS-NG GUI consists of five components:

  1. Menu Bar
  2. Map and Plots Views
  3. Configuration Tab
  4. Graphical Tools Tabs
  5. Product Information Tabs

1.4.2 Map and Plots Views

The AlTiS GUI is composed of 4 plots, which share common X- or Y-axes:

  • Top Left: Map of the study area. Longitude versus Latitude map of the study domain, showing altimetry data points.
  • Top Right: Graphical projection of the altimetry data as a function of latitude coordinate: \(lat=f(wse)\)
  • Bottom Left: Graphical projection of the altimetry data as a function of longitude coordinate: \(wse=f(lon)\)
  • Bottom Right: The raw time series: \(wse=f(time)\)

1.4.3 Configuration Tab

On the left-hand side, you can find the Preferences Tab (refer to number 3 in the AlTiS GUI Figure 2). This tab contains various preference parameters that are also accessible through the Edit > Preferences menu, such as basemap settings. Additionally, you can adjust parameters for plot figures, including color, point style, and marker size.

Within this tab, you can configure the display of the median value (median circles), which indicates the position of the selected altimetry measurement, as well as the trajectories of each satellite cycle pass. You will also find shortcuts to configure the display of the shapefile in the Edit > Preferences menu.

1.4.4 Graphical Tools Tabs

The Graphical Tools tabs (refer to number 4 in the AlTiS GUI Figure 2) consolidate various graphical tools. These tools are categorized as follows:

Tab Description
Map Navigation Tools for moving and centering the map on the data selection, with a screenshot button to export a view (png) of the current selection.
Data Selection Tools for selecting data using rectangular or polygonal windows, including buttons to undo and redo selections in case of errors.
Time Series A button to create a time series from the current selection.

1.4.5 Product Information Tabs

The product information section consists of two tabs.

  • Product Tab: Provides details about the loaded product, including the mission name, orbit phase, product version, etc. This tab also includes the Parameter field, which is for displaying the water surface elevation (WSE) computed by AlTiS, along with a list of parameters included in the loaded product. After loading the product, you must select one of these parameters from the list to display it and start the processing.

  • Cycle Tab: Helps you select the cycle(s) of the track to display. You can choose one or multiple cycles by holding down the Ctrl key while clicking on the different cycles. This feature is useful for analyzing data cycle by cycle.

1.5 Creating Time Series with AlTiS-NG

This guide will walk you through the process of creating time series step by step using the AlTiS-NG software.

1.5.1 Loading Altimetry Data Products

Once you have retrieved your altimetry products from the CTOH (ZIP archive) on your computer, loading the altimetry data product is the first step to start using AlTiS.

  1. In the File > Open menu, select your product directory for the data directory field.
  2. Select the Product from the selection list and choose the Tracks to process.
  3. Press Ok to load it.
Important

For first-time users of AlTiS, the altis configuration file (altis_products.yml) must be set first in AlTiS Configuration.

Tip

To save computer memory, you can preselect data products for a reduced area. To do this, create a Google Earth polygon (KML or KMZ file) for your reduced study area and choose the KML file option to apply the polygon as a preselection mask.

1.5.2 Parameter Selection

Once the altimetry data product is loaded, you need to choose the parameter to display:

  1. In the Product tab, there is a Parameter field which is a selection list of parameters available for display. The selection contains the water surface elevation (WSE) parameter computed by AlTiS and the list of native product parameters.
  2. To create a time series of WSE, you must choose the WSE parameter at the top of the list (named with surfheight).
Note

What is the water surface elevation parameter? In the parameter list, computed altimetry water surface elevation parameters have names following the pattern surfheight. The prefix name refers to the retracker name (OCOG, ICE-1, SAR, ocean, etc.) and the altimeter radar band.

Note

Which retracker for water surface elevation? For continental surfaces, the OCOG or ICE-1 retracker is a good first choice. However, the surface height must be validated with care due to the complex interaction of the radar wave with the ground surface. In most hydrological cases, OCOG, ICE-1, and SAR retrackers are used. For other purposes such as coastal altimetry and ice land, the retrackers are more specific and require a strong understanding of measurement physics to assess the results.

Capture_d_écran_de_2021-05-23_19-26-30

The data of the parameter is displayed on the 4 plots of the AlTiS GUI.

1.5.3 Graphical Selection

Once the parameter is displayed, the graphical selection of the data is available:

  1. From the selection tab, you have a choice of rectangular or lasso selection tool. Click on one of the buttons to start the selection process.
  2. In one of the GUI 4 plots, use the mouse to click and drag around the data points to select them and release the click.
  3. The color display of the unselected points is dimmed, and you can validate or remove the data selection.
  4. To abort the selection process, simply click on the undo button.

This selection process can be repeated as needed.

Figure 3: Selection validation

How to save my data selection? Click on Save in the menu. AlTiS saves the whole dataset in one netCDF4 file. This file can be reopened by choosing AlTiS Track in the menu.

1.5.4 Time Series

Once the graphical selection is complete, the time series can be generated:

  1. From the time series tab, click on the Time Series button. A new window appears with 4 plots.
  2. The top row plots show the median value (red) of the parameter. On the left-hand side is the time series, and on the right-hand side is the distribution.
  3. The bottom row plots show the Median Absolute Deviation value (blue) of the parameter. On the left-hand side is the time series, and on the right-hand side is the distribution.
Figure 4: Time series process
Tip

How to improve the time series? If there are outliers in the time series, it can be improved by removing the remaining parasite measurement points. Just close the time series window, make another graphical selection, and check the time series iteratively.

Figure 5: Time series window

1.5.5 Export Time Series

Once the time series is complete, it can be exported.

  1. In the time series window, click on Export.
  2. The file format to export the time series is CSV or HydroWeb.
  3. Time series is the basic export of the WSE time series.
  4. Auxiliary data is a complementary export with all parameters used to compute the WSE time series if needed to check or analyze parameters.
  5. The CSV files can be opened in spreadsheet software.
Figure 6: Export window