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: bash 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: ``` $ createbrowse --help usage: createbrowse [-h] copolpath crosspolpath

positional arguments: copolpath Path to the co-polarized (VV) RTC image crosspolpath 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 git@github.com: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: bash git clone git@github.com: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