https://github.com/asfhyp3/asf-enumeration

Python library for enumerating ARIA S1 GUNW processing inputs

https://github.com/asfhyp3/asf-enumeration

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.1%) to scientific vocabulary
Last synced: 9 months ago · JSON representation

Repository

Python library for enumerating ARIA S1 GUNW processing inputs

Basic Info
  • Host: GitHub
  • Owner: ASFHyP3
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: develop
  • Size: 5.26 MB
Statistics
  • Stars: 2
  • Watchers: 0
  • Forks: 0
  • Open Issues: 1
  • Releases: 3
Created 12 months ago · Last pushed 10 months ago
Metadata Files
Readme Changelog License Codeowners

README.md

ASF Enumeration

Enumeration code for ARIA S1 GUNW products

```python

from asfenumeration import arias1_gunw

frames = arias1gunw.getframes(flightdirection='ASCENDING', path=175) frames[0] AriaFrame(id=27236, path=175, flight_direction='ASCENDING', polygon=)))

acquisitions = arias1gunw.getacquisitions(frames[0]) acquisitions[0] Sentinel1Acquisition(date=datetime.date(2014, 10, 17), frame=AriaFrame(...), products=[<asfsearch.ASFProduct>]) ```

Installation

In order to easily manage dependencies, we recommend using dedicated project environments via Anaconda/Miniconda or Python virtual environments.

asf_enumeration can be installed into a conda environment with:

conda install -c conda-forge asf_enumeration

or into a virtual environment with:

python -m pip install asf_enumeration

Usage

These are the main data classes used by the asf_enumeration.aria_s1_gunw module - AriaFrame which represents all metadata associated with a ARIA frame (id, path, flight direction and it's polygon) - Sentinel1Acquisition which represents all available Sentinel-1 SLC's over an ARIA frame on a specific date (products, date, frame)

The asf_enumeration.aria_s1_gunw module exposes these functions - get_frames get all ARIA frames based on filter critiria (geometry, flight direction, path) - get_frame get a single ARIA frame based on it's ID - get_acquisitions get all Sentinel-1 acquisitions for a given ARIA frame - get_acquisition get a Sentinel-1 acquisition for a given ARIA frame and date - get_product get an ARIA product for a given reference date, secondary date, and ARIA frame, if the product exists - product_exists check if an ARIA product exists in the ASF archive given reference date, secondary date, and ARIA frame

Getting Frames

aria_s1_gunw.get_frames allows for filtering based on any shapely.Geometry, as well as flight_direction and path

python frames_over_point = aria_s1_gunw.get_frames(geometry=shapely.Point(122.78, -8.55)) frames_filtered = aria_s1_gunw.get_frames(flight_direction='DESCENDING', path=2)

A single frame can be looked up using aria_s1_gunw.get_frame

python frame = aria_s1_gunw.get_frame(100)

Getting Acquisitions

aria_s1_gunw.get_acquisitions returns all the Sentinel-1 acqusitions over a ARIA frame. It takes either the ARIA frame ID or an AriaFrame object as input.

python acquisitions_frame_id = aria_s1_gunw.get_acquisitions(9852) frame = aria_s1_gunw.get_frame(9852) acquisitions_frame_obj = aria_s1_gunw.get_acquisitions(frame)

An acquisition for a specific date can be found using aria_s1_gunw.get_acquisition

python single_acquisition = aria_s1_gunw.get_acquisition(frame=9852, date=datetime.date(2014, 11, 3))

Getting Products

aria_s1_gunw.get_product gets an ARIA product from the ASF archive if it exists.

```python

S1-GUNW-D-R-163-tops-2025052720250503-212910-00121E00010S-PP-07c7-v301

product = arias1gunw.get_product(datetime.date(2025, 5, 27), datetime.date(2025, 5, 3), 25388) ```

Checking if a Product Exists

aria_s1_gunw.product_exists checks if an ARIA product already exists in the ASF archive

```python

S1-GUNW-D-R-163-tops-2025052720250503-212910-00121E00010S-PP-07c7-v301

arias1gunw.product_exists(datetime.date(2025, 5, 27), datetime.date(2025, 5, 3), 25388) ```

Development

  1. Install git and conda.
  2. Clone the repository. git clone git@github.com:ASFHyP3/asf-enumeration.git cd asf-enumeration
  3. Create and activate the conda environment. conda env create -f environment.yml conda activate asf-enumeration
  4. Run the tests. pytest

Owner

  • Name: HyP3
  • Login: ASFHyP3
  • Kind: organization
  • Location: Fairbanks, AK

Alaska Satellite Facility's Hybrid Pluggable Processing Pipeline

GitHub Events

Total
  • Create event: 8
  • Issues event: 2
  • Release event: 2
  • Delete event: 10
  • Issue comment event: 1
  • Push event: 39
  • Pull request event: 18
  • Pull request review event: 27
  • Pull request review comment event: 14
Last Year
  • Create event: 8
  • Issues event: 2
  • Release event: 2
  • Delete event: 10
  • Issue comment event: 1
  • Push event: 39
  • Pull request event: 18
  • Pull request review event: 27
  • Pull request review comment event: 14

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 1
  • Total pull requests: 11
  • Average time to close issues: N/A
  • Average time to close pull requests: 2 days
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.09
  • Merged pull requests: 8
  • Bot issues: 0
  • Bot pull requests: 8
Past Year
  • Issues: 1
  • Pull requests: 11
  • Average time to close issues: N/A
  • Average time to close pull requests: 2 days
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.09
  • Merged pull requests: 8
  • Bot issues: 0
  • Bot pull requests: 8
Top Authors
Issue Authors
  • asjohnston-asf (1)
Pull Request Authors
  • dependabot[bot] (8)
  • williamh890 (3)
Top Labels
Issue Labels
Pull Request Labels
bumpless (8) minor (4) patch (4) major (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 253 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 3
  • Total maintainers: 1
pypi.org: asf-enumeration

Python library for enumerating ASF product inputs

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 253 Last month
Rankings
Dependent packages count: 8.9%
Average: 29.6%
Dependent repos count: 50.3%
Maintainers (1)
Last synced: 10 months ago

Dependencies

.github/workflows/changelog.yml actions
.github/workflows/create-jira-issue.yml actions
.github/workflows/distribute.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v2 composite
  • pypa/gh-action-pypi-publish v1.12.4 composite
.github/workflows/labeled-pr.yml actions
.github/workflows/release-template-comment.yml actions
.github/workflows/release.yml actions
.github/workflows/static-analysis.yml actions
.github/workflows/tag-version.yml actions
.github/workflows/test.yml actions
pyproject.toml pypi
  • asf_search *
  • requests *
  • shapely *
requirements-static.txt pypi
  • mypy ==1.16.0
  • ruff ==0.11.13
environment.yml pypi