Radar Analysis Graphical Utility (RAGU)
Project description
Radar Analysis Graphical Utility
Authors: Brandon Tober and Michael Christoffersen
What is RAGU?
RAGU is a user-interface radar interpretation software written in Python 3 and released under the GNU General Public License v3. RAGU was originally developed to ingest and interpret NASA Operation IceBridge airborne radar sounding data, but has been expanded for use with other sounder and ground penetrating radar datasets. While RAGU is primarily an interpretation software, minimal radar processing tools are included with the software.
Dataset Capabilities:
RAGU was originally developed to work with NASA's Operation IceBridge Alaska radar sounding data. The dataset capabilities have since been expanded to include the following:
- NASA OIB-AK
- CReSIS (Radar Depth Sounder & Snow Radar)
- SHARAD (USRDR, USGEOM, US clutter sims)
- MARSIS (JPL multilook products)
- KAGUYA (SELENE) Lunar Radar Sounder (LRS)
- RIMFAX
- GSSI
- pulseEKKO
Have another radar dataset you'd like to be able to use RAGU to interpret? Please feel free to send the necessary python code to read in the data and we can incorporate an ingester. Or, feel free to collaborate and create an ingester for reading your data type with RAGU. Follow the ingester template: - ingest/ingest_template.py
Package overview
- config.py script used to create the RAGU configuration file
- bin/main.py is run to start the RAGU app
- ui/gui.py handles the graphical user-interface and sets up the app
- ui/impick.py handles profile-view, radargram image picking
- ui/wvpick.py handles waveform-view picking optimization
- ui/basemap.py handles the basemap
- ui/notepad.py handles the notepad
- radar/ contains radar data object information
- radar/processing.py performs simple user-specified radar data processing
- ingest/ hadnles radar data ingest
- nav/navparse.py is used to parse radar gps data into the appropriate format and perform any necessary coordinate transformations
- nav/gps.py is used to read and parse raw gps nmea strings into the appropriate format
- tools/utils.py contains a set of utility functions utilized by the app
- tools/constants.py contains global constants
Outputs
Pick files:
-
Comma-Separated Value (.csv)
-
Geopackage (.gpkg)
For CSV and Geopackage files, see the format file in for per trace export attribute information.
Figure:
A figure each may also be exported for the uninterpreted radar profile, the accompanying clutter simulation, and the interpreted radar profile. Example over Malaspina Glacier, AK:
Processing Script:
A file log/processing script may also be exported to keep track of and easily repeat any data processing steps. Example processing script:
### RAGU processing log ###
import sys
# change dir to RAGU code directory
sys.path.append('/home/user/code/RAGU/code')
from ingest import ingest
igst = ingest("/home/user/data/ARES/20140524-200130.h5")
rdata = igst.read("","+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs","earth")
rdata.lowpass(order=5, cf=1250000.0)
rdata.tpowGain(power=1.2)
Running RAGU
System Requirements
Supported Operating Systems:
- Linux (tested on Ubuntu 18.04, 20.04)
- Windows (tested on Windows 10)
- Mac (tested on Catalina)
Dependencies
- tkinter
- matplotlib
- numpy
- scipy
- pandas
- geopandas
- pyproj
- rasterio
- h5py
Setup
- Install ragu via pypa
$ pip install ragu
Nonte: One may first wish to create an anaconda environment from which to install ragu.
Prior to running ragu, a user may set appropriate data paths, data coordinate reference system, and output preferences in ~/RAGU/config.ini. Path variables may be left blank, but must remain uncommented.
- Call ragu from the command line to initialize the GUI:
$ ragu
Notes
Several auxiliary tools which RAGU users may find useful can be found at radar_tools
Future Development
Additional dataset ingesters:
- Segy
Processing:
- gain
- filtering
- migration
Tools:
- depth conversion
- dielectric extraction
- pick amplitude tracking
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.