opera-rtc-s1-browse

A tool for creating OPERA RTC Sentinel-1 browse images for NASA Worldview. This tool is designed to run within Harmony. The tool creates a scaled RGB browse image in the resolution/projection of the input granule, then uses HyBIG to reformat it to a Worldview-compatible format.

Harmony Integration

This tool is designed to be run within Harmony as an intermediate step within a series of Harmony actions. These include:

1. Query CMR to get a list of OPERA-RTC products to generate browse images for
2. Create a scaled browse image of each OPERA-RTC product
3. Convert these browse products to a Worldview compatible format

To learn more about using Harmony, check out their "Getting Started" guide.

Local Usage

Once installed locally (see below for details) you can run the tool locally using the command:

create_browse OPERA_L2_RTC-S1_T035-073251-IW2_20240113T020816Z_20240113T113128Z_S1A_30_v1.0_VV.tif OPERA_L2_RTC-S1_T035-073251-IW2_20240113T020816Z_20240113T113128Z_S1A_30_v1.0_VH.tif

This will run the browse image generation portion of the work, but will not convert the browse images to a Worldview-compatible format

To explore the available options, run:

$ create_browse --help
usage: create_browse [-h] co_pol_path cross_pol_path

positional arguments:
  co_pol_path     Path to the co-polarized (VV) RTC image
  cross_pol_path  Path to the cross-polarized (VH) RTC image

options:
  -h, --help      show this help message and exit

Local Setup

Installation

1. Ensure that conda is installed on your system (we recommend using mambaforge to reduce setup times).
2. Download a local version of the opera-rtc-s1-browse repository

   git clone [email protected]:ASFHyP3/opera-rtc-s1-browse.git
   cd opera-rtc-s1-browse
   

3. In the base directory for this project, create your Python environment and activate it

   mamba env create -f environment.yml
   mamba activate opera-rtc-s1-browse
   

4. Install the opera-rtc-s1-browse package in your conda environment

   python -m pip install -e .
   

To run all commands in sequence use:

git clone [email protected]:ASFHyP3/opera-rtc-s1-browse.git
cd opera-rtc-s1-browse
mamba env create -f environment.yml
mamba activate opera-rtc-s1-browse
python -m pip install -e .

License

opera-rtc-s1-browse is licensed under the BSD 2-Clause License. See the LICENSE file for more details.

Contributing

Contributions to this project are welcome! If you would like to contribute, please submit a pull request on the GitHub repository.

Contact Us

Want to talk about opera-rtc-s1-browse? We would love to hear from you!

Found a bug? Want to request a feature? open an issue

General questions? Suggestions? Or just want to talk to the team? chat with us on gitter