| Name | pydar JSON |
| Version |
1.4.0
JSON |
| download |
| home_page | None |
| Summary | A Python package to access, download, view, and manipulate Cassini RADAR images |
| upload_time | 2024-10-09 06:11:26 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT License Copyright (c) 2022 unaschneck Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
geophysics
python
astronomy
nasa
radar
planetary-science
cassini
jpl
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
beautifulsoup4
matplotlib
pandas
pdr
pyproj
pytest
rasterio
urllib3
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# PYDAR
<p align="center">
<img src="https://raw.githubusercontent.com/unaschneck/pydar/main/assets/pydar_logo.jpg" />
</p>
[](https://www.repostatus.org/#active)
[](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2141064&HistoricalAwards=false)
[](https://github.com/unaschneck/pydar/actions/workflows/web_scrap_dynamic_csv_files.yml)
[](https://github.com/unaschneck/pydar/actions/workflows/pytests.yml)
A Python package to access, download, view, and manipulate Cassini RADAR images in one place
* **Find relevant flyby observation numbers/IDs for a feature, range of latitude/longitudes (or specific latitude/longitude), or a time range (or specific time)**
* retrieveIDSByFeatureName()
* retrieveIDSByLatitudeLongitude()
* retrieveIDSByLatitudeLongitudeRange()
* retrieveFeaturesFromLatitudeLongitude()
* retrieveFeaturesFromLatitudeLongitudeRange()
* retrieveIDSByTime()
* retrieveIDSByTimeRange()
* **Use flyby observation numbers/IDs to retrieve flyby observation data (.FMT, .TAB, .LBL, .IMG) from SBDR and BIDR data files by default**
* convertFlybyIDToObservationNumber()
* convertObservationNumberToFlybyID()
* extractFlybyDataImages()
* **Access specific observation data from AAREADME and .LBL readme information**
* returnAAREADMEOptions()
* readAAREADME()
* returnLBLOptions()
* readLBLREADME()
* **Display PDS image retrieved for flyby observation**
* displayImages()
> [!Note]
> This is Beta quality software that is being actively developed, use at your own risk. This project is not supported or endorsed by either JPL or NASA. The code is provided “as is”, use at your own risk.
## Install
PyPi pip install at [pypi.org/project/pydar/](https://pypi.org/project/pydar/)
```
pip install pydar
```
## Quickstart: PYDAR
Cassini-Huygens was an [orbiter around Saturn and its moons](https://science.nasa.gov/mission/cassini/), originally launched in 1997. Cassini ran successfully for years before it was purposefully burned up in Saturn's upper atmosphere to avoid potential contamination of Saturn's moons . As the orbiter passed over Titan in dozens of flybys gigabits of data were recorded and sent back
All Cassini data for Titan is organized and retrieved based on [flyby observation numbers or ID numbers](https://solarsystem.nasa.gov/missions/cassini/mission/tour/flybys/?page=0&per_page=40&order=publish_date+desc%2Ccreated_at+desc&search=&tags=cassini%3Aflybys). Pydar makes it easy to find and view relevant flybys based on a time range, latitude/longitude position, or a feature name
```python
import pydar
feature_name_example = "ontario lacus"
flyby_ids = pydar.retrieveIDSByFeatureName(feature_name=feature_name_example)
```
Returns a dictionary of flyby IDs (and their relevant segments) that Ontario Lacus could be found from: `{'T7': ['S01'], 'T36': ['S03'], 'T39': ['S06', 'S05', 'S01', 'S04'], 'T48': ['S04'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S01', 'S03'], 'T56': ['S01'], 'T57': ['S01', 'S02'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S04', 'S01', 'S05', 'S02', 'S03'], 'T71': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`
The relevant data files can be downloaded for any combination of these flyby IDs and segment numbers. For example, flyby ID 'T65' and segment 'S01' at resolution 'D' for 8 pixels/degree
```
# Extract Flyby Data Files to pydar_results/ directory
pydar.extractFlybyDataImages(flyby_id='T65',
resolution='D',
segment_num="S01")
```
> [!Important]
> extractFlybyDataImages() only needs to be run once for each flyby to retrieve new data but will take some time to download
```
# Display all Images in pydar_results/ directory
pydar.displayImages(image_directory="pydar_results/CORADR_0211_V03_S01")
```
<p align="center">
<img src="https://raw.githubusercontent.com/unaschneck/pydar/main/assets/ontario_example_output.png" />
</p>
## Overview and Background
For information on Cassini instrument specifics and acronyms refer to the [Cassini Radar User Guide](https://pds-imaging.jpl.nasa.gov/documentation/Cassini_RADAR_Users_Guide_2nd_Ed_191004_cmp_200421.pdf)
The Cassini Radar data can be found at the [PDS Imaging Node](https://planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/). The directory is organized by [PDS standards](https://pdssbn.astro.umd.edu/howto/understand.shtml). The file format are defined in the [Small Body Node](https://pdssbn.astro.umd.edu/howto/file_types.shtml). The radar echo is stored originally as floating points in LBDR files. The SAR processors turn the LBDR files into BIDR image. The BIDR data is organized as follows:
```
Cassini RADAR Information (CORADR_xxxx_Vxx) where xxxx is the radar data take number and Vxx is the data version number
|_ AAREADME.txt
Information about observation xxxx (xxxx > 0035 for Titan flybys)
|_CALIB/
|_CATALOG/
BIDRDS.CAT: Information about the BIDR dataset
|_DATA/
| |_BIDR/
| |_ BIbcdeefggg_Dhhh_Tiii_Vnn.LBL: header information for observation < -------- MAIN DATA OF INTEREST'S LABEL
| |_ BIbcdeefggg_Dhhh_Tiii_Vnn.ZIP: IMG file compressed in zip file < -------- MAIN DATA OF INTEREST
| | | b = Kind and bit-type of data
| | | F = Primary dataset (incidence-
| | | angle-corrected sigma0) in
| | | 32-bit floating-point format
| | | (linear scale, not dB)
| | | B = Primary dataset in unsigned
| | | byte format (dB, normalized
| | | to [0, 255])
| | | U = Sigma0 without incidence angle
| | | correction in 32-bit floating-
| | | point format (linear scale,
| | | not dB)
| | | E = Incidence angle map, 32-bit
| | | floating-point values in degrees
| | | T = Latitude map, 32-bit floating-
| | | point values in degrees
| | | N = Longitude map, 32-bit floating-
| | | point values in degrees
| | | M = Beam mask map, 8-bit unsigned
| | | byte values
| | | L = Number of looks map, 32-bit
| | | integer values
| | | D = standard deviations of Synthetic Aperture Radar
| | | (SAR) normalized backscatter cross-section noise
| | | subtracted values w/o incidence angle correction.
| | | The values are physical scale (not in dB)
| | | S = Synthetic Aperture Radar (SAR) normalized backscatter cross-section values
| | | physical scale (not in dB) and have not been corrected for incidence-angle effects.
| | | Biases due to thermal and quantization noise have been removed.
| | | X = Noise equivalent sigma-0 values associated with Synthetic Aperture Radar (SAR)
| | | normalized backscatter cross-section noise subtracted values w/o incidence angle
| | | correction. The values are physical scale (not in dB)."
| | | c = Map projection
| | | Q = Oblique cylindrical
| | | d = Map resolution
| | | B = 2 pixels/degree
| | | D = 8 pixels/degree
| | | F = 32 pixels/degree
| | | G = 64 pixels/degree
| | | H = 128 pixels/degree
| | | I = 256 pixels/degree
| | | ee = Absolute value of latitude at
| | | center of file, rounded to
| | | nearest degree
| | | f = Hemisphere of center of file
| | | N = Northern
| | | S = Southern
| | | ggg = West longitude at center of
| | | file, rounded to nearest degree
| | | hhh = 3-digit data take ID
| | | (observation counter) from which
| | | data are included, left-padded
| | | with zeroes as needed
| | | iii = 3-digit index of Titan flyby
| | | from which data are included,
| | | left-padded with zeroes as
| | | needed. (Note: the index
| | | for the "Ta" flyby is "00A")
|_______ |________ | ____________________ nn = 2-digit version number
|
|_DOCUMENT/
|_ERRATA.txt
|_EXTRAS/
|_BIbcdeefggg_Dhhh_Tiii_Vnn.JPG: jpg of IMG files in DATA
|_INDEX/
|_SOFTWARE/
|_VOLDESC.CAT <--- VERSION INFORMATION LISTED HERE ('VOLUME_VERSION_ID' = "Version 1", "Version 2", "Version 3") and in filename
```
.IMG files can be viewed using the [planetary images library](https://planetaryimage.readthedocs.io/_/downloads/en/latest/pdf/) or via `pydar.displayImages()`
### Download Time
Download time for data files vary when using `pydar.extractFlybyDataImages()` and depends on the number and size of files of interest. On average, most single feature downloads take between 1-5 minutes to download, but can be longer for higher resolution files.
([Cassini Radar Volume SIS, Version 2.1](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0284/DOCUMENT/VOLSIS.PDF) Table 1, pg. 3)
### Cross-Reference Table for Observations and Flybys
The Titan flyby IDs (e.g. 'T65') are not used in the naming convention for the CORADR filenames. Instead, all files are referred to by their observation number (e.g. '0211'). The Titan flyby information is contained in the BIDR filenames and in the VOLDESC.CAT under 'Description' and can be found using the following cross-reference table: [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv)
To convert between a Titan Flyby ID and an observation number use either `pydar.convertFlybyIDToObservationNumber(flyby_id)` or `pydar.convertObservationNumberToFlybyID(flyby_observation_num)`
### Observation Information as Filename
The data filename contains a lot of information about the observation
(EXAMPLE) Filename: "BIBQD05S184_D065_T008S03_V03"
- BI = BIDR data
- B = data in dB normalized
- Q = oblique cylindrical
- D = 8 pixels/degree
- 05 = absolute value of latitude at center rounded to nearest degree
- S = hemisphere of center of file (Southern)
- 184 = West longitude at center of file rounded to nearest degree
- D065 = 2-digit data take ID aka observation counter with left-padded zeros
- T008 = 3-digit Titan flyby with left-padding
- S03 = 2-digit segment number (00-99)
- V03 = 2-digit version number (01-99)
Image file from BIBQD05S184_D065_T008S03_V03.JPG:
### Volume Version of Data
Some passes have multiple versions of the data, up to 3 different versions currently.
* **Version 1 (V01)** was the first archived version of the data and assumed Titan had zero obliquity, which resulted in misregistration between passes
* **Version 2 (V02)** used a Titan spin model that reduced misregistration error
* **Version 3 (V03)** used a long-term, accurate spin model for Titan along with other improvements
Only some Titan passes produced all of the version numbers.
* TA-T25 : V01, V02, V03
* $\gt$ T28: V02, V03
* T108-T126: labeled only once as V02 but is actually V03
The version number is listed in the filename and in VOLDESC.CAT under the 'VOLUME_VERSION_ID'
Example:
Version 1 is named BIFQI48N071_D035_T00A_V01.IMG
Version 2 is named BIFQI49N071_D035_T00AS01_V02.IMG
Version 3 is named BIFQI49N071_D035_T00AS01_V03.IMG
> [!Important]
> _**Version 3 is currently the latest and preferred version and will be the version included when downloaded**_
### Segment Number of Data
A single flyby can produce multiple image segments (Sxx). *S01 is the primary imaging segment* with other segments referring to periods in the flyby when the instrument went to/from altimetry/SAR/HiSAR or weird pointing profiles.
*Credit: Cassini Radar User Guide (Wall et al. 2019, pg.16)*
## Backend Data Files
### Dynamically Updated Backend Files
Pydar includes multiple scripts to web scrape from relevant URLs to generate some of the backend data files
Changes in the relevant URLs are checked once a month via Github Actions to keep csv files up to date and any changes found will be bundled into the subsequent release
**coradr_jpl_options.csv**
Contains all the CORADR IDs and available data types from [planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/](https://planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/)
Headers: ["CORADR ID", "Is a Titan Flyby", "Contains ABDR", "Contains ASUM", "Contains BIDR", "Contains LBDR", "Contains SBDR", "Contains STDR"]
View data file: [coradr_jpl_options.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/coradr_jpl_options.csv)
**swath_coverage_by_time_position.csv**
Contains all the information for .LBL files within all CORADR ID pages (for each segment and resolution file)
Collected from URLs matching: `https://planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/[CORADAR_ID]/DATA/BIDR/`
Headers: ["CORADR ID", "FLYBY ID", "SEGMENT NUMBER", "FILENAME", "DATE TYPE SYMBOL", "DATE TYPE", "RESOLUTION (pixels/degrees)", "TARGET_NAME", "MAXIMUM_LATITUDE (Degrees)", "MINIMUM_LATITUDE (Degrees)", "EASTERNMOST_LONGITUDE (Degrees)", "WESTERNMOST_LONGITUDE (Degrees)", "START_TIME", "STOP_TIME"]
View data file: [swath_coverage_by_time_position.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/swath_coverage_by_time_position.csv)
**feature_name_details.csv**
Contains all named features on Titan with their furthest latitude/longitude position and URL where information was collected from
Collected from the [planetarynames.wr.usgs.gov](https://planetarynames.wr.usgs.gov/SearchResults?Target=74_Titan)
Headers: ["Feature Name", "Northmost Latitude", "Southmost Latitude", "Eastmost Longitude", "Westmost Longitude", "Center Latitude", "Center Longitude", "URL"]
View data file: [feature_name_details.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/feature_name_details.csv)
### Static Data Files
**cassini_flyby.csv**
Reference for converting between a Titan Flyby ID (e.g. "T7") and its Observation Number (e.g. "059") (and back)
Headers: ["Titan flyby id", "Radar Data Take Number", "Sequence number", "Orbit Number/ID"]
View data file: [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv)
**sar_swath_details.csv**
Currently unused, but will potentially be used in the future for incidence angle, polarization, azimuth, SAR range resolution, SAR azimuth resolution, and number of looks
Converted to a static csv file from the Cassini User Guide (pg. 136-139)
View data file: [sar_swath_details.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/sar_swath_details.csv)
## BIDR and SBDR Files
> [!Warning]
> "CORADR_0048", "CORADR_0186", "CORADR_0189", "CORADR_0209", "CORADR_0234" do not have associated BIDR values.
> [!Caution]
> There are data gaps and problems from the original downlinking and satellite location
CORADR_0048 (T4) did not have SAR data, only scatterometry and radiometry because of telemetry reasons in the handbook
CORADR_0186 (T52) only have radiometry and compressed scatterometry
CORADR_0189 (T53) only has radiometry and compressed scatterometry because of what appears to be a downlink problem
CORADR_0209 (T63) only has scatterometry and radiometry
CORADR_0234 (T80) only has scatterometry and radiometry
## Coming Soon: SBDR Files
Total width of the RADAR swath is created by combining the five individual sub-swaths, where the center beam is the highest gain
(_The Cassini Huygens Mission: Orbiter Remote Sensing Observation 2004_)
[SBDR column descriptions](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0045/DOCUMENT/BODPSIS.PDF)
## Retrieve Data from CASSINI Function Calls
To collect flyby information and images for the latitude/longitude range of a named feature on Titan
### retrieveIDSByFeatureName()
Retrieve a list of flyby IDs with their associated segment numbers based on a feature name from Titan
```python
retrieveIDSByFeatureName(feature_name=None)
```
* **[REQUIRED]** feature_name (string): Feature name on Titan, not case-sensitive
Feature names are retrieved from [feature_name_details.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/feature_name_details.csv) (if the feature has both latitude/longitude coordinates)
<details closed>
<summary>List of Valid Feature Names (Click to view all)</summary>
<br>
['Aaru', 'Abaya Lacus', 'Adiri', 'Afekan', 'Akmena Lacus', 'Albano Lacus', 'Anbus Labyrinthus', 'Angmar Montes', 'Annecy Lacus', 'Antilia Faculae', 'Apanohuaya Flumen', 'Ara Fluctus', 'Arala Lacus', 'Arnar Sinus', 'Arrakis Planitia', 'Arwen Colles', 'Atacama Lacuna', 'Atitlán Lacus', 'Aura Undae', 'Avacha Sinus', 'Aztlan', 'Bacab Virgae', 'Baffin Sinus', 'Balaton Lacus', 'Bayta Fretum', 'Bazaruto Facula', 'Beag', 'Belet', 'Bermoothes Insula', 'Bilbo Colles', 'Bimini Insula', 'Bolsena Lacus', 'Boni Sinus', 'Boreas Undae', 'Bralgu Insulae', 'Brienz Lacus', 'Buada Lacus', 'Buyan Insula', 'Buzzell Planitia', 'Caladan Planitia', 'Cardiel Lacus', 'Cayuga Lacus', 'Celadon Flumina', 'Cerknica Lacuna', 'Chapala Lacus', 'Chilwa Lacus', 'Ching-tu', 'Chusuk Planitia', 'Coats Facula', 'Concordia Regio', 'Corrin Labyrinthus', 'Crete Facula', 'Crveno Lacus', 'Dem Lacus', 'Dilmun', 'Dilolo Lacus', 'Dingle Sinus', 'Dolmed Montes', 'Doom Mons', 'Dridzis Lacus', 'Ecaz Labyrinthus', 'Echoriath Montes', 'Eir Macula', 'Elba Facula', 'Elivagar Flumina', 'Elpis Macula', 'Enriquillo Lacus', 'Erebor Mons', 'Eurus Undae', 'Eyre Lacuna', 'Fagaloa Sinus', 'Faramir Colles', 'Feia Lacus', 'Fena Lacus', 'Fensal', 'Flensborg Sinus', 'Fogo Lacus', 'Forseti', 'Freeman Lacus', 'Fundy Sinus', 'Gabes Sinus', 'Gammu Labyrinthus', 'Gamont Labyrinthus', 'Gandalf Colles', 'Ganesa Macula', 'Gansireed Labyrinthus', 'Garotman Terra', 'Gatun Lacus', 'Genetaska Macula', 'Genova Sinus', 'Giedi Planitia', 'Gihon Flumen', 'Ginaz Labyrinthus', 'Gram Montes', 'Grasmere Lacus', 'Grumman Labyrinthus', 'Guabonito', 'Hagal Planitia', 'Hammar Lacus', 'Handir Colles', 'Hano', 'Hardin Fretum', 'Harmonthep Labyrinthus', 'Hawaiki Insulae', 'Hetpet Regio', 'Hlawga Lacus', 'Hobal Virga', 'Hotei Arcus', 'Hotei Regio', 'Hubur Flumen', 'Hufaidh Insulae', 'Huygens Landing Site', 'Ihi', 'Ihotry Lacus', 'Imogene Lacus', 'Ipyr Labyrinthus', 'Irensaga Montes', 'Jerid Lacuna', 'Jingpo Lacus', 'Junction Labyrinthus', 'Junín Lacus', 'Kaitain Labyrinthus', 'Kalseru Virga', 'Karakul Lacus', 'Karesos Flumen', 'Kayangan Lacus', 'Kerguelen Facula', 'Kivu Lacus', 'Koitere Lacus', 'Kokytos Flumina', 'Kraken Mare', 'Krocylea Insulae', 'Kronin Labyrinthus', 'Ksa', 'Kumbaru Sinus', 'Kutch Lacuna', 'Ladoga Lacus', 'Lagdo Lacus', 'Lampadas Labyrinthus', 'Lanao Lacus', 'Lankiveil Labyrinthus', 'Leilah Fluctus', 'Lernaeus Labyrinthus', 'Letas Lacus', 'Ligeia Mare', 'Lithui Montes', 'Logtak Lacus', 'Luin Montes', 'Lulworth Sinus', 'Mackay Lacus', 'Maizuru Sinus', 'Manza Sinus', 'Maracaibo Lacus', 'Mayda Insula', 'Melrhir Lacuna', 'Menrva', 'Merlock Montes', 'Meropis Insula', 'Mezzoramia', 'Mindanao Facula', 'Mindolluin Montes', 'Misty Montes', 'Mithrim Montes', 'Mohini Fluctus', 'Momoy', 'Montego Sinus', 'Moray Sinus', 'Moria Montes', 'Muritan Labyrinthus', 'Muzhwi Lacus', 'Mweru Lacus', 'Mystis', 'Müggel Lacus', 'Mývatn Lacus', 'Nakuru Lacuna', 'Naraj Labyrinthus', 'Nath', 'Neagh Lacus', 'Negra Lacus', 'Ngami Lacuna', 'Nicobar Faculae', 'Nicoya Sinus', 'Nimloth Colles', 'Niushe Labyrinthus', 'Notus Undae', 'Oahu Facula', 'Ochumare Regio', 'Ohrid Lacus', 'Okahu Sinus', 'Olomega Lacus', 'Omacatl Macula', 'Oneida Lacus', 'Onogoro Insula', 'Ontario Lacus', 'Orog Lacuna', 'Paititi Terra', 'Palma Labyrinthus', 'Patos Sinus', 'Paxsi', 'Penglai Insula', 'Perkunas Virgae', 'Phewa Lacus', 'Pielinen Lacus', 'Planctae Insulae', 'Polaznik Macula', 'Polelya Macula', 'Poritrin Planitia', 'Prespa Lacus', 'Puget Sinus', 'Punga Mare', 'Qinghai Lacus', 'Quilotoa Lacus', 'Quivira', 'Racetrack Lacuna', 'Rannoch Lacus', 'Rerir Montes', 'Richese Labyrinthus', 'Robino Lacus', 'Roca Lacus', 'Rohe Fluctus', 'Rombaken Sinus', 'Romo Planitia', 'Rossak Planitia', 'Royllo Insula', 'Rukwa Lacus', 'Rwegura Lacus', 'Saldanha Sinus', 'Salusa Labyrinthus', 'Sambation Flumina', 'Santorini Facula', 'Saraswati Flumen', 'Sarygamysh Lacus', 'Seldon Fretum', 'Selk', 'Senkyo', 'Sevan Lacus', 'Shangri-La', 'Shikoku Facula', 'Shiwanni Virgae', 'Shoji Lacus', 'Sikun Labyrinthus', 'Sinlap', 'Sionascaig Lacus', 'Skelton Sinus', 'Soi', 'Sotonera Lacus', 'Sotra Patera', 'Sparrow Lacus', 'Suwa Lacus', 'Synevyr Lacus', 'Taniquetil Montes', 'Tasmania Facula', 'Taupo Lacus', 'Tengiz Lacus', 'Texel Facula', 'Tibi Lacus', 'Tishtrya Virgae', 'Tlaloc Virgae', 'Tleilax Labyrinthus', 'Toba Lacus', 'Tollan Terra', 'Tortola Facula', 'Totak Lacus', 'Towada Lacus', 'Trevize Fretum', 'Trichonida Lacus', 'Trold Sinus', 'Tsegihi', 'Tsiipiya Terra', 'Tsomgo Lacus', 'Tui Regio', 'Tumaco Sinus', 'Tunu Sinus', 'Tupile Labyrinthus', 'Uanui Virgae', 'Urmia Lacus', 'Uvs Lacus', 'Uyuni Lacuna', 'Vaca Lacus', 'Van Lacus', 'Veles', 'Veliko Lacuna', 'Vid Flumina', 'Viedma Lacus', 'Vis Facula', 'Vänern Lacus', 'Waikare Lacus', 'Wakasa Sinus', 'Walvis Sinus', 'Weija Lacus', 'Winia Fluctus', 'Winnipeg Lacus', 'Woytchugga Lacuna', 'Xanadu', 'Xanthus Flumen', 'Xolotlán Lacus', 'Xuttah Planitia', 'Yalaing Terra', 'Yessey Lacus', 'Yojoa Lacus', 'Ypoa Lacus', 'Zaza Lacus', 'Zephyrus Undae', 'Zub Lacus']
</details>
```python
import pydar
pydar.retrieveIDSByFeatureName(feature_name="Ontario Lacus")
```
Output = `{'T7': ['S01'], 'T36': ['S03'], 'T39': ['S06', 'S05', 'S01', 'S04'], 'T48': ['S04'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S01', 'S03'], 'T56': ['S01'], 'T57': ['S01', 'S02'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S04', 'S01', 'S05', 'S02', 'S03'], 'T71': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`
### retrieveIDSByLatitudeLongitude()
Retrieve a list of flyby IDs with their associated segments based on specific latitude and longitude
```python
retrieveIDSByLatitudeLongitude(latitude=None, longitude=None)
```
* **[REQUIRED]** latitude (float/int): Latitude (in degrees), range from -90° to 90°
* **[REQUIRED]** longitude (float/int): Longitude (in degrees), range from 0° to 360°
```python
import pydar
pydar.retrieveIDSByLatitudeLongitude(latitude=-80, longitude=170)
```
Output = `{'T39': ['S06', 'S05', 'S01'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S03'], 'T56': ['S01'], 'T57': ['S01'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`
### retrieveIDSByLatitudeLongitudeRange()
Retrieve a list of flyby IDs with their associated segments based on range of latitudes and longitudes
```python
retrieveIDSByLatitudeLongitudeRange(min_latitude=None,
max_latitude=None,
min_longitude=None,
max_longitude=None)
```
* **[REQUIRED]** min_latitude (float/int): Latitude (in degrees) where min_latitude must be greater than or equal to the max_latitude, range from -90° to 90°
* **[REQUIRED]** max_latitude (float/int): Latitude (in degrees) where max_latitude must be less than or equal to the min_latitude, range from -90° to 90°
* **[REQUIRED]** min_longitude (float/int): Longitude (in degrees) where min_longitude must be less than or equal to the max_longitude, range from 0° to 360°
* **[REQUIRED]** max_longitude (float/int): Longitude (in degrees) where max_longitude be greater than or equal to the min_longitude, range from 0° to 360°
```python
import pydar
pydar.retrieveIDSByLatitudeLongitudeRange(min_latitude=-82,
max_latitude=-72,
min_longitude=183,
max_longitude=185)
```
Output = `{'T7': ['S01'], 'T36': ['S03'], 'T39': ['S06', 'S05', 'S01', 'S04'], 'T48': ['S04'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S01', 'S03'], 'T56': ['S01'], 'T57': ['S01', 'S02'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S04', 'S01', 'S05', 'S02', 'S03'], 'T71': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`
### retrieveFeaturesFromLatitudeLongitude()
Return a list of features found at a specific latitude/longitude position
```
retrieveFeaturesFromLatitudeLongitude(latitude=None, longitude=None)
```
* **[REQUIRED]** latitude (float/int): Latitude (in degrees), range from -90° to 90°
* **[REQUIRED]** longitude (float/int): Longitude (in degrees), range from 0° to 360°
```python
import pydar
pydar.retrieveFeaturesFromLatitudeLongitude(latitude=-72, longitude=183)
```
Output = `['Ontario Lacus', 'Rossak Planitia']`
### retrieveFeaturesFromLatitudeLongitudeRange()
Return a list of features found at a range of latitude/longitude positions
```
retrieveFeaturesFromLatitudeLongitudeRange(min_latitude=None,
max_latitude=None,
min_longitude=None,
max_longitude=None)
```
* **[REQUIRED]** min_latitude (float/int): Latitude (in degrees) where min_latitude must be less than or equal to the max_latitude, range from -90° to 90°
* **[REQUIRED]** max_latitude (float/int): Latitude (in degrees) where max_latitude must be greater than or equal to the min_latitude, range from -90° to 90°
* **[REQUIRED]** min_longitude (float/int): Longitude (in degrees) where min_longitude must be less than or equal to the max_longitude, range from 0° to 360°
* **[REQUIRED]** max_longitude (float/int): Longitude (in degrees) where max_longitude must be greater than or equal to the min_longitude, range from 0° to 360°
```python
import pydar
pydar.retrieveFeaturesFromLatitudeLongitudeRange(min_latitude=-82,
max_latitude=-72,
min_longitude=183,
max_longitude=190)
```
Output = `['Crveno Lacus', 'Ontario Lacus', 'Romo Planitia', 'Rossak Planitia', 'Saraswati Flumen']`
### retrieveIDSByTime()
Retrieve a dictionary of flyby IDs and segment numbers based on a specific timestamp
```
retrieveIDSByTime(year=None,
doy=None,
hour=None,
minute=None,
second=None,
millisecond=None)
```
* **[REQUIRED]** year (int): Year for observation, range from 2004 to 2014
* **[REQUIRED]** doy (int): Day of the year, from 0 to 365 (where January 10 = 10) (__Note__: 'doy' not 'day' for days of the year)
* [OPTIONAL] hour (int): Hour, from 0 to 23 in UTC, defaults to 0 when undefined
* [OPTIONAL] minute (int): Minute, from 0 to 59, defaults to check the all minutes when undefined
* [OPTIONAL] second (int): Second, from 0 to 59, defaults to check the all seconds when undefined
* [OPTIONAL] millisecond (int): Millisecond, from 0 to 999, defaults to check all milliseconds when undefined
Where `2004 year, 300 doy, 15 hour, 30 minute, 7 second, 789 millisecond` becomes `2004-300T15:30:07.789`
```python
import pydar
pydar.retrieveIDSByTime(year=2004,
doy=300,
hour=15,
minute=30,
second=7,
millisecond=789)
```
Output = `{'Ta': ['S01']}`
If hour, minute, second, or millisecond is left undefined, will search the entire range for all possible values and can find more possible ids
For a single day, some flybys have segments that are defined in one large range, but not within a smaller range
```python
import pydar
pydar.retrieveIDSByTime(year=2005, doy=301)
```
Output for the entire day of 301 = `{'T8': ['S02', 'S03', 'S01']}`
```python
import pydar
pydar.retrieveIDSByTime(year=2005, doy=301, hour=3)
```
Output for the day 301 but just for hour 3 = `{'T8': ['S03', 'S01']}` (does not include S02)
### retrieveIDSByTimeRange()
Retrieve a dictionary of flyby IDs and segment numbers based on a start and end datetime
```
retrieveIDSByTimeRange(start_year=None,
start_doy=None,
start_hour=None,
start_minute=None,
start_second=None,
start_millisecond=None,
end_year=None,
end_doy=None,
end_hour=None,
end_minute=None,
end_second=None,
end_millisecond=None)
```
* **[REQUIRED]** start_year (int): Year for observation, range from 2004 to 2014, start_year must be less than/equal to end_year
* **[REQUIRED]** end_year (int): Year for observation, range from 2004 to 2014, end_year must be greater than/equal to start_year
* **[REQUIRED]** start_doy (int): Day of the year, from 0 to 365 (where January 10 = 10) (__Note__: 'doy' not 'day' for days of the year), start_doy must be less than/equal to end_doy
* **[REQUIRED]** end_doy (int): Day of the year, from 0 to 365 (where January 10 = 10) (__Note__: 'doy' not 'day' for days of the year), end_doy must be less than/equal to start_doy
* [OPTIONAL] start_hour (int): Hour, from 0 to 23 in UTC, defaults to check all hours when undefined, start_hour must be less than/equal to end_hour
* [OPTIONAL] end_hour (int): Hour, from 0 to 23 in UTC, defaults to check all hours when undefined, end_hour must be less than/equal to start_hour
* [OPTIONAL] start_minute (int): Minute, from 0 to 59, defaults to check all minutes when undefined, start_minute must be less than/equal to end_minute
* [OPTIONAL] end_minute (int): Minute, from 0 to 59, defaults to check all minutes when undefined, end_minute must be greater than/equal to start_minute
* [OPTIONAL] start_second (int): Second, from 0 to 59, defaults to check all seconds when undefined, start_second must be less than/equal to end_second
* [OPTIONAL] end_second (int): Second, from 0 to 59, defaults to check all seconds when undefined, end_second must be greater than/equal to start_second
* [OPTIONAL] start_millisecond (int): Milliscond, from 0 to 999, defaults to check all milliseconds when undefined, start_millisecond must be less than/equal to end_millisecond
* [OPTIONAL] end_millisecond (int): Milliscond, from 0 to 999, defaults to check all milliseconds when undefined, end_millisecond must be greater than/equal to start_millisecond
```python
import pydar
pydar.retrieveIDSByTimeRange(start_year=2004,
start_doy=299,
start_hour=2,
start_minute=15,
start_second=23,
start_millisecond=987,
end_year=2005,
end_doy=301,
end_hour=2,
end_minute=15,
end_second=23,
end_millisecond=987)
```
Output = `{'Ta': ['S01'], 'T3': ['S01'], 'T7': ['S01']}`
### convertFlybyIDToObservationNumber()
Converts a Titan Flyby ID (for example: 'T65') to an observation number with front padding ('T65' -> '0211')
```python
convertFlybyIDToObservationNumber(flyby_id)
```
* **[REQUIRED]** flyby_id (string): a valid flyby ID with prefix 'T'
```python
import pydar
observation_number = convertFlybyIDToObservationNumber(flyby_id='T65')
```
Output = `0211`
Observation number based on the 'Radar Data Take Number' in the [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv) data file with front padding to ensure that all observation numbers are 4 digits long (0065 and 0211)
### convertObservationNumberToFlybyID()
Converts a Titan Observation Number (for example: '211' or '0211') to an flyby id ('0211' -> 'T65')
```python
convertObservationNumberToFlybyID(flyby_observation_num)
```
* **[REQUIRED]** flyby_observation_num (string): a valid observation number
```python
import pydar
flyby_id = pydar.convertObservationNumberToFlybyID(flyby_observation_num='211')
```
Output = `T65`
Flyby ids are based on the 'Radar Data Take Number' in the [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv) data file with front padding of 'T'
Requires each Titan flyby ID to be a valid flyby ID in [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv)
### extractFlybyDataImages()
Downloads flyby data SBDR for a selected flyby observation number or flyby id: .FMT and .TAB files (for example: [SBDR.FMT](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/SBDR/SBDR.FMT) and [SBDR_15_D087_V03.TAB](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/SBDR/SBDR_15_D087_V03.TAB))
Downloads flyby data BIDR for a selected flyby observation number or flyby id: .LBL and .ZIP files (for example: [BIBQH80N051_D087_T016S01_V03.LBL](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/BIDR/BIBQH80N051_D087_T016S01_V03.LBL) and [BIBQH80N051_D087_T016S01_V03.ZIP](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/BIDR/BIBQH80N051_D087_T016S01_V03.ZIP))
```
extractFlybyDataImages(flyby_observation_num=None,
flyby_id=None,
segment_num=None,
additional_data_types_to_download=[],
resolution='I',
top_x_resolutions=None)
```
Either a flyby_id (for example: 'T65') or a flyby_observation_num (for example: '0035') is required.
> [!Note]
> A `flyby_id` will be translated into a `flyby_observation_number` to access on the backend and the results will be saved under the observation number. For example, 'T65' will become observation number '0211'
* **[REQUIRED/OPTIONAL]** flyby_observation_num (string): required if flyby_id not included
* **[REQUIRED/OPTIONAL]** flyby_id (string): required if flyby_observation_num not included
* **[REQUIRED]** segment_num (string): a flyby includes multiple image segments (S0X) where S01 is the primary imaging segment ["S01", "S02", "S03", "S04"]
* [OPTIONAL] resolution (String): resolution options "B", "D", "F", "H", or "I" (2, 8, 32, 128, 256 pixels/degree), defaults to highest resolution 'I'
* [OPTIONAL] top_x_resolutions: Save the top x resolution types (5 total resolutions), will override any default resolution string
* [OPTIONAL] additional_data_types_to_download (List of Strings): Possible options ["ABDR", "ASUM", "BIDR", "LBDR", "SBDR", "STDR"] (__NOTE__: current v1 functionality does not download any additional data types)
```python
import pydar
pydar.extractFlybyDataImages(flyby_id='T65',
resolution='D',
segment_num="S01")
```
`extractFlybyDataImages()` will retrieve images from PDS website and saves results in a directory labeled 'pydar_results' with the flyby observation number, version number, and segment number in the title (for example `pydar_results/CORADR_0065_V03_S01`). Download time depends on file and resolution size but ranges from 1-5 minutes
### readAAREADME()
Print AAREADME.TXT to console for viewing
```
readAAREADME(coradr_results_directory=None,
section_to_print=None,
print_to_console=True)
```
* **[REQUIRED]** coradr_results_directory (string): CORADAR results folder downloaded (example: "pydar_results/CORADR_0211_V03_S01/")
* [OPTIONAL] section_to_print (string): Specify a section to print to console from the AAREADME, defaults to print the entire AAREADME.TXT, not case-sensitive
* [OPTIONAL] print_to_console (boolean): Print to console, defaults to true, otherwise function will return output as a string
To see a list of all section_to_print options, see: `returnAAREADMEOptions()`
```python
import pydar
pydar.readAAREADME(coradr_results_directory="pydar_results/CORADR_0065_V03_S01",
section_to_print="Volume")
```
Output = `Volume CORADR_0065: Titan Flyby T8, Sequence S15, Oct 27, 2005`
```python
import pydar
pydar.returnAAREADMEOptions()
```
Output = `['PDS_VERSION_ID', 'RECORD_TYPE', 'INSTRUMENT_HOST_NAME', 'INSTRUMENT_NAME', 'PUBLICATION_DATE', 'NOTE', 'END_OBJECT', 'Volume', 'Introduction', 'Disk Format', 'File Formats', 'Volume Contents', 'Recommended DVD Drives and Driver Software', 'Errata and Disclaimer', 'Version Status', 'Contact Information']`
### readLBLREADME()
Print .LBL README to console for viewing
```
readLBLREADME(coradr_results_directory=None,
section_to_print=None,
print_to_console=True)
```
* **[REQUIRED]** coradr_results_directory (string):
* [OPTIONAL] section_to_print (string): Specify a section to print to console from the AAREADME, defaults to print the entire AAREADME.TXT, not case-sensitive
* [OPTIONAL] print_to_console (boolean): Print to console, defaults to true, otherwise function will return output as a string
To see a list of all section_to_print options, see: `returnLBLOptions()`
```python
import pydar
pydar.readLBLREADME(coradr_results_directory="pydar_results/CORADR_0035_S01/",
section_to_print="OBLIQUE_PROJ_X_AXIS_VECTOR")
```
Output = `(0.13498322,0.00221225,-0.99084542)`
```python
import pydar
pydar.returnLBLOptions()
```
<details closed>
<summary>Line-By-Line Options (Click to view all)</summary>
<br>
['PDS_VERSION_ID', 'DATA_SET_ID', 'DATA_SET_NAME', 'PRODUCER_INSTITUTION_NAME', 'PRODUCER_ID', 'PRODUCER_FULL_NAME', 'PRODUCT_ID', 'PRODUCT_VERSION_ID', 'INSTRUMENT_HOST_NAME', 'INSTRUMENT_HOST_ID', 'INSTRUMENT_NAME', 'INSTRUMENT_ID', 'TARGET_NAME', 'START_TIME', 'STOP_TIME', 'SPACECRAFT_CLOCK_START_COUNT', 'SPACECRAFT_CLOCK_STOP_COUNT', 'PRODUCT_CREATION_TIME', 'SOURCE_PRODUCT_ID', 'MISSION_PHASE_NAME', 'MISSION_NAME', 'SOFTWARE_VERSION_ID', 'FILE_NAME COMPRESSED', 'RECORD_TYPE COMPRESSED', 'ENCODING_TYPE', 'INTERCHANGE_FORMAT', 'UNCOMPRESSED_FILE_NAME', 'REQUIRED_STORAGE_BYTES', '^DESCRIPTION', 'FILE_NAME UNCOMPRESSED', 'RECORD_TYPE UNCOMPRESSED', 'RECORD_BYTES', 'FILE_RECORDS', 'LABEL_RECORDS', '^IMAGE', 'LINES', 'LINE_SAMPLES', 'SAMPLE_TYPE', 'SAMPLE_BITS', 'CHECKSUM', 'SCALING_FACTOR', 'OFFSET', 'MISSING_CONSTANT', 'NOTE', '^DATA_SET_MAP_PROJECTION', 'MAP_PROJECTION_TYPE', 'FIRST_STANDARD_PARALLEL', 'SECOND_STANDARD_PARALLEL', 'A_AXIS_RADIUS', 'B_AXIS_RADIUS', 'C_AXIS_RADIUS', 'POSITIVE_LONGITUDE_DIRECTION', 'CENTER_LATITUDE', 'CENTER_LONGITUDE', 'REFERENCE_LATITUDE', 'REFERENCE_LONGITUDE', 'LINE_FIRST_PIXEL', 'LINE_LAST_PIXEL', 'SAMPLE_FIRST_PIXEL', 'SAMPLE_LAST_PIXEL', 'MAP_PROJECTION_ROTATION', 'MAP_RESOLUTION', 'MAP_SCALE', 'MAXIMUM_LATITUDE', 'MINIMUM_LATITUDE', 'EASTERNMOST_LONGITUDE', 'WESTERNMOST_LONGITUDE', 'LINE_PROJECTION_OFFSET', 'SAMPLE_PROJECTION_OFFSET', 'OBLIQUE_PROJ_POLE_LATITUDE', 'OBLIQUE_PROJ_POLE_LONGITUDE', 'OBLIQUE_PROJ_POLE_ROTATION', 'OBLIQUE_PROJ_X_AXIS_VECTOR', 'OBLIQUE_PROJ_Y_AXIS_VECTOR', 'OBLIQUE_PROJ_Z_AXIS_VECTOR', 'LOOK_DIRECTION', 'COORDINATE_SYSTEM_NAME', 'COORDINATE_SYSTEM_TYPE']
</details>
<details closed>
<summary>Section Header Options (Click to view all)</summary>
<br>
['PRODUCT DESCRIPTION', 'DESCRIPTION OF COMPRESSED AND UNCOMPRESSED FILES', 'POINTERS TO START RECORDS OF OBJECTS IN FILE', 'DESCRIPTION OF OBJECTS CONTAINED IN FILE']
</details>
## Use Downloaded Data
### displayImages()
Displays downloaded image .IMG files (unzipped from within the .ZIP files) and display all images in directory
```
displayImages(image_directory=None, fig_title=None, cmap="gray", figsize_n=6, fig_dpi=120)
```
* **[REQUIRED]** image_directory (string): directory containing a .LBL and .IMG file
* [OPTIONAL] fig_title (str): figure title, defaults to filename
* [OPTIONAL] cmap (str): optional colormaps ([see more options](https://matplotlib.org/stable/tutorials/colors/colormaps.html)), defaults to 'gray'
* [OPTIONAL] figsize_n (int): plot dimensions, defaults to 6x6
* [OPTIONAL] fig_dpi (int): plot dpi, defaults to 120
```python
import pydar
pydar.displayImages(image_directory="pydar_results/CORADR_0065_V03_S01")
```
<p align="center">
<img src="https://raw.githubusercontent.com/unaschneck/pydar/main/assets/ontario_example_output.png" />
</p>
> [!Note]
> `displayImages()` will show all images in the saved results directory
**COMING SOON: extractMetadata**
Extract Metadata from .FMT and .TAB files
COMING SOON: Extract metadata from .TAB file (using .FMT as a reference)
## Development Environment
For developers, to run or test against `pydar` github repo, a development environment can be created via conda
First, [install Miniconda](https://docs.conda.io/projects/miniconda/en/latest/miniconda-install.html)
Then, using the existing `environment.yml`, a new conda environment can be create to run/test scripts against
```
conda env create --file environment.yml
```
Once the environment has been built, activate the environment:
```
conda activate pydar
```
To run existing and new tests from the root directory:
```
python -m pytest
```
## Credits
Feature Names collected from [Gazetteer of Planetary Nomenclature](https://planetarynames.wr.usgs.gov/SearchResults?Target=74_Titan)
Instrument information and naming conventions collected from the [Cassini Radar User Guide](https://pds-imaging.jpl.nasa.gov/documentation/Cassini_RADAR_Users_Guide_2nd_Ed_191004_cmp_200421.pdf)
This material is based upon work supported by the National Science Foundation Graduate Fellowship under Grant No. 2141064. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the authors and do not necessarily reflect the views of the National Science Foundation.
## Acknowledging Software
Please acknowledge the use of this software in any publications by citing:
```
Cassini RADAR data extraction software was provided by C. Y. Schneck and U. G. Schneck and is available at URL: https://github.com/unaschneck/pydar
```
Please send a copy of such publications to: cyschneck@gmail.com & ugschneck@gmail.com (we'd love to see them!)
## Bug and Feature Request
Submit a bug fix, question, or feature request as a [Github Issue](https://github.com/unaschneck/pydar/issues) or to ugschneck@gmail.com/cyschneck@gmail.com
Raw data
{
"_id": null,
"home_page": null,
"name": "pydar",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "geophysics, python, astronomy, nasa, radar, planetary-science, cassini, jpl",
"author": null,
"author_email": "Cora Schneck <cyschneck@gmail.com>, Una Schneck <ugschneck@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/89/a3/50fb71e78e3c88e247c4b5346df4f9ac7b897c3c99150069238c32b1238a/pydar-1.4.0.tar.gz",
"platform": null,
"description": "# PYDAR\n <p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/unaschneck/pydar/main/assets/pydar_logo.jpg\" />\n</p>\n\n\n\n[](https://www.repostatus.org/#active)\n[](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2141064&HistoricalAwards=false)\n\n[](https://github.com/unaschneck/pydar/actions/workflows/web_scrap_dynamic_csv_files.yml)\n[](https://github.com/unaschneck/pydar/actions/workflows/pytests.yml)\n\nA Python package to access, download, view, and manipulate Cassini RADAR images in one place\n\n* **Find relevant flyby observation numbers/IDs for a feature, range of latitude/longitudes (or specific latitude/longitude), or a time range (or specific time)**\n * retrieveIDSByFeatureName()\n * retrieveIDSByLatitudeLongitude()\n * retrieveIDSByLatitudeLongitudeRange()\n * retrieveFeaturesFromLatitudeLongitude()\n * retrieveFeaturesFromLatitudeLongitudeRange()\n * retrieveIDSByTime()\n * retrieveIDSByTimeRange()\n* **Use flyby observation numbers/IDs to retrieve flyby observation data (.FMT, .TAB, .LBL, .IMG) from SBDR and BIDR data files by default**\n * convertFlybyIDToObservationNumber()\n * convertObservationNumberToFlybyID()\n * extractFlybyDataImages()\n* **Access specific observation data from AAREADME and .LBL readme information**\n * returnAAREADMEOptions()\n * readAAREADME()\n * returnLBLOptions()\n * readLBLREADME()\n* **Display PDS image retrieved for flyby observation**\n * displayImages()\n\n> [!Note]\n> This is Beta quality software that is being actively developed, use at your own risk. This project is not supported or endorsed by either JPL or NASA. The code is provided \u201cas is\u201d, use at your own risk. \n\n## Install\nPyPi pip install at [pypi.org/project/pydar/](https://pypi.org/project/pydar/)\n\n```\npip install pydar\n```\n\n## Quickstart: PYDAR\n\nCassini-Huygens was an [orbiter around Saturn and its moons](https://science.nasa.gov/mission/cassini/), originally launched in 1997. Cassini ran successfully for years before it was purposefully burned up in Saturn's upper atmosphere to avoid potential contamination of Saturn's moons . As the orbiter passed over Titan in dozens of flybys gigabits of data were recorded and sent back\n\nAll Cassini data for Titan is organized and retrieved based on [flyby observation numbers or ID numbers](https://solarsystem.nasa.gov/missions/cassini/mission/tour/flybys/?page=0&per_page=40&order=publish_date+desc%2Ccreated_at+desc&search=&tags=cassini%3Aflybys). Pydar makes it easy to find and view relevant flybys based on a time range, latitude/longitude position, or a feature name\n\n```python\nimport pydar\nfeature_name_example = \"ontario lacus\"\nflyby_ids = pydar.retrieveIDSByFeatureName(feature_name=feature_name_example)\n```\nReturns a dictionary of flyby IDs (and their relevant segments) that Ontario Lacus could be found from: `{'T7': ['S01'], 'T36': ['S03'], 'T39': ['S06', 'S05', 'S01', 'S04'], 'T48': ['S04'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S01', 'S03'], 'T56': ['S01'], 'T57': ['S01', 'S02'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S04', 'S01', 'S05', 'S02', 'S03'], 'T71': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`\n\nThe relevant data files can be downloaded for any combination of these flyby IDs and segment numbers. For example, flyby ID 'T65' and segment 'S01' at resolution 'D' for 8 pixels/degree\n```\n# Extract Flyby Data Files to pydar_results/ directory\npydar.extractFlybyDataImages(flyby_id='T65',\n resolution='D',\n segment_num=\"S01\")\n```\n> [!Important]\n> extractFlybyDataImages() only needs to be run once for each flyby to retrieve new data but will take some time to download\n```\n# Display all Images in pydar_results/ directory\npydar.displayImages(image_directory=\"pydar_results/CORADR_0211_V03_S01\")\n```\n <p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/unaschneck/pydar/main/assets/ontario_example_output.png\" />\n</p>\n\n## Overview and Background\nFor information on Cassini instrument specifics and acronyms refer to the [Cassini Radar User Guide](https://pds-imaging.jpl.nasa.gov/documentation/Cassini_RADAR_Users_Guide_2nd_Ed_191004_cmp_200421.pdf)\n\nThe Cassini Radar data can be found at the [PDS Imaging Node](https://planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/). The directory is organized by [PDS standards](https://pdssbn.astro.umd.edu/howto/understand.shtml). The file format are defined in the [Small Body Node](https://pdssbn.astro.umd.edu/howto/file_types.shtml). The radar echo is stored originally as floating points in LBDR files. The SAR processors turn the LBDR files into BIDR image. The BIDR data is organized as follows:\n```\nCassini RADAR Information (CORADR_xxxx_Vxx) where xxxx is the radar data take number and Vxx is the data version number\n |_ AAREADME.txt\n Information about observation xxxx (xxxx > 0035 for Titan flybys)\n |_CALIB/\n |_CATALOG/\n BIDRDS.CAT: Information about the BIDR dataset\n |_DATA/\n | |_BIDR/\n | |_ BIbcdeefggg_Dhhh_Tiii_Vnn.LBL: header information for observation < -------- MAIN DATA OF INTEREST'S LABEL\n | |_ BIbcdeefggg_Dhhh_Tiii_Vnn.ZIP: IMG file compressed in zip file < -------- MAIN DATA OF INTEREST\n | | | b = Kind and bit-type of data\n | | | F = Primary dataset (incidence-\n | | | angle-corrected sigma0) in\n | | | 32-bit floating-point format\n | | | (linear scale, not dB)\n | | | B = Primary dataset in unsigned\n | | | byte format (dB, normalized\n | | | to [0, 255])\n | | | U = Sigma0 without incidence angle\n | | | correction in 32-bit floating-\n | | | point format (linear scale,\n | | | not dB)\n | | | E = Incidence angle map, 32-bit\n | | | floating-point values in degrees\n | | | T = Latitude map, 32-bit floating-\n | | | point values in degrees\n | | | N = Longitude map, 32-bit floating-\n | | | point values in degrees\n | | | M = Beam mask map, 8-bit unsigned\n | | | byte values\n | | | L = Number of looks map, 32-bit\n | | | integer values\n | | | D = standard deviations of Synthetic Aperture Radar \n | | | (SAR) normalized backscatter cross-section noise \n | | | subtracted values w/o incidence angle correction.\n | | | The values are physical scale (not in dB)\n | | | S = Synthetic Aperture Radar (SAR) normalized backscatter cross-section values\n | | | physical scale (not in dB) and have not been corrected for incidence-angle effects.\n | | | Biases due to thermal and quantization noise have been removed.\n | | | X = Noise equivalent sigma-0 values associated with Synthetic Aperture Radar (SAR) \n | | | normalized backscatter cross-section noise subtracted values w/o incidence angle \n | | | correction. The values are physical scale (not in dB).\"\n | | | c = Map projection\n | | | Q = Oblique cylindrical\n | | | d = Map resolution\n | | | B = 2 pixels/degree\n | | | D = 8 pixels/degree\n | | | F = 32 pixels/degree\n | | | G = 64 pixels/degree\n | | | H = 128 pixels/degree\n | | | I = 256 pixels/degree\n | | | ee = Absolute value of latitude at\n | | | center of file, rounded to\n | | | nearest degree\n | | | f = Hemisphere of center of file\n | | | N = Northern\n | | | S = Southern\n | | | ggg = West longitude at center of\n | | | file, rounded to nearest degree\n | | | hhh = 3-digit data take ID\n | | | (observation counter) from which\n | | | data are included, left-padded\n | | | with zeroes as needed\n | | | iii = 3-digit index of Titan flyby\n | | | from which data are included,\n | | | left-padded with zeroes as\n | | | needed. (Note: the index\n | | | for the \"Ta\" flyby is \"00A\")\n |_______ |________ | ____________________ nn = 2-digit version number\n |\n |_DOCUMENT/\n |_ERRATA.txt\n |_EXTRAS/\n |_BIbcdeefggg_Dhhh_Tiii_Vnn.JPG: jpg of IMG files in DATA \n |_INDEX/\n |_SOFTWARE/\n |_VOLDESC.CAT <--- VERSION INFORMATION LISTED HERE ('VOLUME_VERSION_ID' = \"Version 1\", \"Version 2\", \"Version 3\") and in filename\n```\n.IMG files can be viewed using the [planetary images library](https://planetaryimage.readthedocs.io/_/downloads/en/latest/pdf/) or via `pydar.displayImages()`\n\n### Download Time\nDownload time for data files vary when using `pydar.extractFlybyDataImages()` and depends on the number and size of files of interest. On average, most single feature downloads take between 1-5 minutes to download, but can be longer for higher resolution files.\n\n\n([Cassini Radar Volume SIS, Version 2.1](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0284/DOCUMENT/VOLSIS.PDF) Table 1, pg. 3)\n\n### Cross-Reference Table for Observations and Flybys\nThe Titan flyby IDs (e.g. 'T65') are not used in the naming convention for the CORADR filenames. Instead, all files are referred to by their observation number (e.g. '0211'). The Titan flyby information is contained in the BIDR filenames and in the VOLDESC.CAT under 'Description' and can be found using the following cross-reference table: [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv)\n\nTo convert between a Titan Flyby ID and an observation number use either `pydar.convertFlybyIDToObservationNumber(flyby_id)` or `pydar.convertObservationNumberToFlybyID(flyby_observation_num)`\n\n### Observation Information as Filename\nThe data filename contains a lot of information about the observation\n\n(EXAMPLE) Filename: \"BIBQD05S184_D065_T008S03_V03\"\n\n- BI = BIDR data\n- B = data in dB normalized\n- Q = oblique cylindrical\n- D = 8 pixels/degree\n- 05 = absolute value of latitude at center rounded to nearest degree\n- S = hemisphere of center of file (Southern)\n- 184 = West longitude at center of file rounded to nearest degree\n- D065 = 2-digit data take ID aka observation counter with left-padded zeros\n- T008 = 3-digit Titan flyby with left-padding\n- S03 = 2-digit segment number (00-99)\n- V03 = 2-digit version number (01-99)\n\nImage file from BIBQD05S184_D065_T008S03_V03.JPG:\n\n\n\n### Volume Version of Data\n\nSome passes have multiple versions of the data, up to 3 different versions currently.\n\n* **Version 1 (V01)** was the first archived version of the data and assumed Titan had zero obliquity, which resulted in misregistration between passes\n* **Version 2 (V02)** used a Titan spin model that reduced misregistration error \n* **Version 3 (V03)** used a long-term, accurate spin model for Titan along with other improvements\n\nOnly some Titan passes produced all of the version numbers.\n\n* TA-T25 : V01, V02, V03\n\n* $\\gt$ T28: V02, V03\n\n* T108-T126: labeled only once as V02 but is actually V03\n\nThe version number is listed in the filename and in VOLDESC.CAT under the 'VOLUME_VERSION_ID'\n\nExample:\n\nVersion 1 is named BIFQI48N071_D035_T00A_V01.IMG\n\nVersion 2 is named BIFQI49N071_D035_T00AS01_V02.IMG\n\nVersion 3 is named BIFQI49N071_D035_T00AS01_V03.IMG\n\n> [!Important]\n> _**Version 3 is currently the latest and preferred version and will be the version included when downloaded**_\n\n### Segment Number of Data\nA single flyby can produce multiple image segments (Sxx). *S01 is the primary imaging segment* with other segments referring to periods in the flyby when the instrument went to/from altimetry/SAR/HiSAR or weird pointing profiles. \n\n\n*Credit: Cassini Radar User Guide (Wall et al. 2019, pg.16)*\n\n## Backend Data Files\n\n### Dynamically Updated Backend Files\n\nPydar includes multiple scripts to web scrape from relevant URLs to generate some of the backend data files\n\nChanges in the relevant URLs are checked once a month via Github Actions to keep csv files up to date and any changes found will be bundled into the subsequent release\n\n**coradr_jpl_options.csv**\n\nContains all the CORADR IDs and available data types from [planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/](https://planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/)\n\nHeaders: [\"CORADR ID\", \"Is a Titan Flyby\", \"Contains ABDR\", \"Contains ASUM\", \"Contains BIDR\", \"Contains LBDR\", \"Contains SBDR\", \"Contains STDR\"]\n\nView data file: [coradr_jpl_options.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/coradr_jpl_options.csv)\n\n**swath_coverage_by_time_position.csv**\n\nContains all the information for .LBL files within all CORADR ID pages (for each segment and resolution file)\n\nCollected from URLs matching: `https://planetarydata.jpl.nasa.gov/img/data/cassini/cassini_orbiter/[CORADAR_ID]/DATA/BIDR/`\n\nHeaders: [\"CORADR ID\", \"FLYBY ID\", \"SEGMENT NUMBER\", \"FILENAME\", \"DATE TYPE SYMBOL\", \"DATE TYPE\", \"RESOLUTION (pixels/degrees)\", \"TARGET_NAME\", \"MAXIMUM_LATITUDE (Degrees)\", \"MINIMUM_LATITUDE (Degrees)\", \"EASTERNMOST_LONGITUDE (Degrees)\", \"WESTERNMOST_LONGITUDE (Degrees)\", \"START_TIME\", \"STOP_TIME\"]\n\nView data file: [swath_coverage_by_time_position.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/swath_coverage_by_time_position.csv)\n\n**feature_name_details.csv**\n\nContains all named features on Titan with their furthest latitude/longitude position and URL where information was collected from\n\nCollected from the [planetarynames.wr.usgs.gov](https://planetarynames.wr.usgs.gov/SearchResults?Target=74_Titan)\n\nHeaders: [\"Feature Name\", \"Northmost Latitude\", \"Southmost Latitude\", \"Eastmost Longitude\", \"Westmost Longitude\", \"Center Latitude\", \"Center Longitude\", \"URL\"]\n\nView data file: [feature_name_details.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/feature_name_details.csv)\n\n### Static Data Files\n\n**cassini_flyby.csv**\n\nReference for converting between a Titan Flyby ID (e.g. \"T7\") and its Observation Number (e.g. \"059\") (and back)\n\nHeaders: [\"Titan flyby id\", \"Radar Data Take Number\", \"Sequence number\", \"Orbit Number/ID\"]\n\nView data file: [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv)\n\n**sar_swath_details.csv**\n\nCurrently unused, but will potentially be used in the future for incidence angle, polarization, azimuth, SAR range resolution, SAR azimuth resolution, and number of looks\n\nConverted to a static csv file from the Cassini User Guide (pg. 136-139)\n\nView data file: [sar_swath_details.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/sar_swath_details.csv)\n\n## BIDR and SBDR Files\n> [!Warning]\n> \"CORADR_0048\", \"CORADR_0186\", \"CORADR_0189\", \"CORADR_0209\", \"CORADR_0234\" do not have associated BIDR values.\n\n> [!Caution]\n> There are data gaps and problems from the original downlinking and satellite location\n\nCORADR_0048 (T4) did not have SAR data, only scatterometry and radiometry because of telemetry reasons in the handbook\n\nCORADR_0186 (T52) only have radiometry and compressed scatterometry\n\nCORADR_0189 (T53) only has radiometry and compressed scatterometry because of what appears to be a downlink problem\n\nCORADR_0209 (T63) only has scatterometry and radiometry\n\nCORADR_0234 (T80) only has scatterometry and radiometry \n\n## Coming Soon: SBDR Files\nTotal width of the RADAR swath is created by combining the five individual sub-swaths, where the center beam is the highest gain\n\n(_The Cassini Huygens Mission: Orbiter Remote Sensing Observation 2004_)\n\n[SBDR column descriptions](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0045/DOCUMENT/BODPSIS.PDF)\n\n## Retrieve Data from CASSINI Function Calls\n\nTo collect flyby information and images for the latitude/longitude range of a named feature on Titan\n\n### retrieveIDSByFeatureName()\n\nRetrieve a list of flyby IDs with their associated segment numbers based on a feature name from Titan\n\n```python\nretrieveIDSByFeatureName(feature_name=None)\n```\n* **[REQUIRED]** feature_name (string): Feature name on Titan, not case-sensitive\n\nFeature names are retrieved from [feature_name_details.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/feature_name_details.csv) (if the feature has both latitude/longitude coordinates)\n<details closed>\n<summary>List of Valid Feature Names (Click to view all)</summary>\n<br>\n['Aaru', 'Abaya Lacus', 'Adiri', 'Afekan', 'Akmena Lacus', 'Albano Lacus', 'Anbus Labyrinthus', 'Angmar Montes', 'Annecy Lacus', 'Antilia Faculae', 'Apanohuaya Flumen', 'Ara Fluctus', 'Arala Lacus', 'Arnar Sinus', 'Arrakis Planitia', 'Arwen Colles', 'Atacama Lacuna', 'Atitl\u00e1n Lacus', 'Aura Undae', 'Avacha Sinus', 'Aztlan', 'Bacab Virgae', 'Baffin Sinus', 'Balaton Lacus', 'Bayta Fretum', 'Bazaruto Facula', 'Beag', 'Belet', 'Bermoothes Insula', 'Bilbo Colles', 'Bimini Insula', 'Bolsena Lacus', 'Boni Sinus', 'Boreas Undae', 'Bralgu Insulae', 'Brienz Lacus', 'Buada Lacus', 'Buyan Insula', 'Buzzell Planitia', 'Caladan Planitia', 'Cardiel Lacus', 'Cayuga Lacus', 'Celadon Flumina', 'Cerknica Lacuna', 'Chapala Lacus', 'Chilwa Lacus', 'Ching-tu', 'Chusuk Planitia', 'Coats Facula', 'Concordia Regio', 'Corrin Labyrinthus', 'Crete Facula', 'Crveno Lacus', 'Dem Lacus', 'Dilmun', 'Dilolo Lacus', 'Dingle Sinus', 'Dolmed Montes', 'Doom Mons', 'Dridzis Lacus', 'Ecaz Labyrinthus', 'Echoriath Montes', 'Eir Macula', 'Elba Facula', 'Elivagar Flumina', 'Elpis Macula', 'Enriquillo Lacus', 'Erebor Mons', 'Eurus Undae', 'Eyre Lacuna', 'Fagaloa Sinus', 'Faramir Colles', 'Feia Lacus', 'Fena Lacus', 'Fensal', 'Flensborg Sinus', 'Fogo Lacus', 'Forseti', 'Freeman Lacus', 'Fundy Sinus', 'Gabes Sinus', 'Gammu Labyrinthus', 'Gamont Labyrinthus', 'Gandalf Colles', 'Ganesa Macula', 'Gansireed Labyrinthus', 'Garotman Terra', 'Gatun Lacus', 'Genetaska Macula', 'Genova Sinus', 'Giedi Planitia', 'Gihon Flumen', 'Ginaz Labyrinthus', 'Gram Montes', 'Grasmere Lacus', 'Grumman Labyrinthus', 'Guabonito', 'Hagal Planitia', 'Hammar Lacus', 'Handir Colles', 'Hano', 'Hardin Fretum', 'Harmonthep Labyrinthus', 'Hawaiki Insulae', 'Hetpet Regio', 'Hlawga Lacus', 'Hobal Virga', 'Hotei Arcus', 'Hotei Regio', 'Hubur Flumen', 'Hufaidh Insulae', 'Huygens Landing Site', 'Ihi', 'Ihotry Lacus', 'Imogene Lacus', 'Ipyr Labyrinthus', 'Irensaga Montes', 'Jerid Lacuna', 'Jingpo Lacus', 'Junction Labyrinthus', 'Jun\u00edn Lacus', 'Kaitain Labyrinthus', 'Kalseru Virga', 'Karakul Lacus', 'Karesos Flumen', 'Kayangan Lacus', 'Kerguelen Facula', 'Kivu Lacus', 'Koitere Lacus', 'Kokytos Flumina', 'Kraken Mare', 'Krocylea Insulae', 'Kronin Labyrinthus', 'Ksa', 'Kumbaru Sinus', 'Kutch Lacuna', 'Ladoga Lacus', 'Lagdo Lacus', 'Lampadas Labyrinthus', 'Lanao Lacus', 'Lankiveil Labyrinthus', 'Leilah Fluctus', 'Lernaeus Labyrinthus', 'Letas Lacus', 'Ligeia Mare', 'Lithui Montes', 'Logtak Lacus', 'Luin Montes', 'Lulworth Sinus', 'Mackay Lacus', 'Maizuru Sinus', 'Manza Sinus', 'Maracaibo Lacus', 'Mayda Insula', 'Melrhir Lacuna', 'Menrva', 'Merlock Montes', 'Meropis Insula', 'Mezzoramia', 'Mindanao Facula', 'Mindolluin Montes', 'Misty Montes', 'Mithrim Montes', 'Mohini Fluctus', 'Momoy', 'Montego Sinus', 'Moray Sinus', 'Moria Montes', 'Muritan Labyrinthus', 'Muzhwi Lacus', 'Mweru Lacus', 'Mystis', 'M\u00fcggel Lacus', 'M\u00fdvatn Lacus', 'Nakuru Lacuna', 'Naraj Labyrinthus', 'Nath', 'Neagh Lacus', 'Negra Lacus', 'Ngami Lacuna', 'Nicobar Faculae', 'Nicoya Sinus', 'Nimloth Colles', 'Niushe Labyrinthus', 'Notus Undae', 'Oahu Facula', 'Ochumare Regio', 'Ohrid Lacus', 'Okahu Sinus', 'Olomega Lacus', 'Omacatl Macula', 'Oneida Lacus', 'Onogoro Insula', 'Ontario Lacus', 'Orog Lacuna', 'Paititi Terra', 'Palma Labyrinthus', 'Patos Sinus', 'Paxsi', 'Penglai Insula', 'Perkunas Virgae', 'Phewa Lacus', 'Pielinen Lacus', 'Planctae Insulae', 'Polaznik Macula', 'Polelya Macula', 'Poritrin Planitia', 'Prespa Lacus', 'Puget Sinus', 'Punga Mare', 'Qinghai Lacus', 'Quilotoa Lacus', 'Quivira', 'Racetrack Lacuna', 'Rannoch Lacus', 'Rerir Montes', 'Richese Labyrinthus', 'Robino Lacus', 'Roca Lacus', 'Rohe Fluctus', 'Rombaken Sinus', 'Romo Planitia', 'Rossak Planitia', 'Royllo Insula', 'Rukwa Lacus', 'Rwegura Lacus', 'Saldanha Sinus', 'Salusa Labyrinthus', 'Sambation Flumina', 'Santorini Facula', 'Saraswati Flumen', 'Sarygamysh Lacus', 'Seldon Fretum', 'Selk', 'Senkyo', 'Sevan Lacus', 'Shangri-La', 'Shikoku Facula', 'Shiwanni Virgae', 'Shoji Lacus', 'Sikun Labyrinthus', 'Sinlap', 'Sionascaig Lacus', 'Skelton Sinus', 'Soi', 'Sotonera Lacus', 'Sotra Patera', 'Sparrow Lacus', 'Suwa Lacus', 'Synevyr Lacus', 'Taniquetil Montes', 'Tasmania Facula', 'Taupo Lacus', 'Tengiz Lacus', 'Texel Facula', 'Tibi Lacus', 'Tishtrya Virgae', 'Tlaloc Virgae', 'Tleilax Labyrinthus', 'Toba Lacus', 'Tollan Terra', 'Tortola Facula', 'Totak Lacus', 'Towada Lacus', 'Trevize Fretum', 'Trichonida Lacus', 'Trold Sinus', 'Tsegihi', 'Tsiipiya Terra', 'Tsomgo Lacus', 'Tui Regio', 'Tumaco Sinus', 'Tunu Sinus', 'Tupile Labyrinthus', 'Uanui Virgae', 'Urmia Lacus', 'Uvs Lacus', 'Uyuni Lacuna', 'Vaca Lacus', 'Van Lacus', 'Veles', 'Veliko Lacuna', 'Vid Flumina', 'Viedma Lacus', 'Vis Facula', 'V\u00e4nern Lacus', 'Waikare Lacus', 'Wakasa Sinus', 'Walvis Sinus', 'Weija Lacus', 'Winia Fluctus', 'Winnipeg Lacus', 'Woytchugga Lacuna', 'Xanadu', 'Xanthus Flumen', 'Xolotl\u00e1n Lacus', 'Xuttah Planitia', 'Yalaing Terra', 'Yessey Lacus', 'Yojoa Lacus', 'Ypoa Lacus', 'Zaza Lacus', 'Zephyrus Undae', 'Zub Lacus']\n</details>\n\n```python\nimport pydar\npydar.retrieveIDSByFeatureName(feature_name=\"Ontario Lacus\")\n```\nOutput = `{'T7': ['S01'], 'T36': ['S03'], 'T39': ['S06', 'S05', 'S01', 'S04'], 'T48': ['S04'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S01', 'S03'], 'T56': ['S01'], 'T57': ['S01', 'S02'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S04', 'S01', 'S05', 'S02', 'S03'], 'T71': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`\n\n### retrieveIDSByLatitudeLongitude()\n\nRetrieve a list of flyby IDs with their associated segments based on specific latitude and longitude\n\n```python\nretrieveIDSByLatitudeLongitude(latitude=None, longitude=None)\n```\n* **[REQUIRED]** latitude (float/int): Latitude (in degrees), range from -90\u00b0 to 90\u00b0\n* **[REQUIRED]** longitude (float/int): Longitude (in degrees), range from 0\u00b0 to 360\u00b0\n\n```python\nimport pydar\npydar.retrieveIDSByLatitudeLongitude(latitude=-80, longitude=170)\n```\nOutput = `{'T39': ['S06', 'S05', 'S01'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S03'], 'T56': ['S01'], 'T57': ['S01'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`\n\n### retrieveIDSByLatitudeLongitudeRange()\n\nRetrieve a list of flyby IDs with their associated segments based on range of latitudes and longitudes\n\n```python\nretrieveIDSByLatitudeLongitudeRange(min_latitude=None,\n max_latitude=None,\n min_longitude=None,\n max_longitude=None)\n```\n* **[REQUIRED]** min_latitude (float/int): Latitude (in degrees) where min_latitude must be greater than or equal to the max_latitude, range from -90\u00b0 to 90\u00b0\n* **[REQUIRED]** max_latitude (float/int): Latitude (in degrees) where max_latitude must be less than or equal to the min_latitude, range from -90\u00b0 to 90\u00b0\n* **[REQUIRED]** min_longitude (float/int): Longitude (in degrees) where min_longitude must be less than or equal to the max_longitude, range from 0\u00b0 to 360\u00b0\n* **[REQUIRED]** max_longitude (float/int): Longitude (in degrees) where max_longitude be greater than or equal to the min_longitude, range from 0\u00b0 to 360\u00b0\n\n```python\nimport pydar\npydar.retrieveIDSByLatitudeLongitudeRange(min_latitude=-82,\n max_latitude=-72,\n min_longitude=183,\n max_longitude=185)\n```\nOutput = `{'T7': ['S01'], 'T36': ['S03'], 'T39': ['S06', 'S05', 'S01', 'S04'], 'T48': ['S04'], 'T49': ['S01'], 'T50': ['S02'], 'T55': ['S01', 'S03'], 'T56': ['S01'], 'T57': ['S01', 'S02'], 'T58': ['S01'], 'T59': ['S01'], 'T65': ['S04', 'S01', 'S05', 'S02', 'S03'], 'T71': ['S01'], 'T95': ['S03'], 'T98': ['S01', 'S04']}`\n\n### retrieveFeaturesFromLatitudeLongitude()\n\nReturn a list of features found at a specific latitude/longitude position\n\n```\nretrieveFeaturesFromLatitudeLongitude(latitude=None, longitude=None)\n```\n* **[REQUIRED]** latitude (float/int): Latitude (in degrees), range from -90\u00b0 to 90\u00b0\n* **[REQUIRED]** longitude (float/int): Longitude (in degrees), range from 0\u00b0 to 360\u00b0\n\n```python\nimport pydar\npydar.retrieveFeaturesFromLatitudeLongitude(latitude=-72, longitude=183)\n```\n\nOutput = `['Ontario Lacus', 'Rossak Planitia']`\n\n### retrieveFeaturesFromLatitudeLongitudeRange()\n\nReturn a list of features found at a range of latitude/longitude positions\n\n```\nretrieveFeaturesFromLatitudeLongitudeRange(min_latitude=None,\n max_latitude=None,\n min_longitude=None,\n max_longitude=None)\n```\n* **[REQUIRED]** min_latitude (float/int): Latitude (in degrees) where min_latitude must be less than or equal to the max_latitude, range from -90\u00b0 to 90\u00b0\n* **[REQUIRED]** max_latitude (float/int): Latitude (in degrees) where max_latitude must be greater than or equal to the min_latitude, range from -90\u00b0 to 90\u00b0\n* **[REQUIRED]** min_longitude (float/int): Longitude (in degrees) where min_longitude must be less than or equal to the max_longitude, range from 0\u00b0 to 360\u00b0\n* **[REQUIRED]** max_longitude (float/int): Longitude (in degrees) where max_longitude must be greater than or equal to the min_longitude, range from 0\u00b0 to 360\u00b0\n\n```python\nimport pydar\npydar.retrieveFeaturesFromLatitudeLongitudeRange(min_latitude=-82,\n max_latitude=-72,\n min_longitude=183,\n max_longitude=190)\n```\nOutput = `['Crveno Lacus', 'Ontario Lacus', 'Romo Planitia', 'Rossak Planitia', 'Saraswati Flumen']`\n\n### retrieveIDSByTime()\n\nRetrieve a dictionary of flyby IDs and segment numbers based on a specific timestamp\n\n```\nretrieveIDSByTime(year=None,\n doy=None,\n hour=None,\n minute=None,\n second=None,\n millisecond=None)\n```\n* **[REQUIRED]** year (int): Year for observation, range from 2004 to 2014\n* **[REQUIRED]** doy (int): Day of the year, from 0 to 365 (where January 10 = 10) (__Note__: 'doy' not 'day' for days of the year)\n* [OPTIONAL] hour (int): Hour, from 0 to 23 in UTC, defaults to 0 when undefined\n* [OPTIONAL] minute (int): Minute, from 0 to 59, defaults to check the all minutes when undefined\n* [OPTIONAL] second (int): Second, from 0 to 59, defaults to check the all seconds when undefined\n* [OPTIONAL] millisecond (int): Millisecond, from 0 to 999, defaults to check all milliseconds when undefined\n\nWhere `2004 year, 300 doy, 15 hour, 30 minute, 7 second, 789 millisecond` becomes `2004-300T15:30:07.789`\n\n```python\nimport pydar\npydar.retrieveIDSByTime(year=2004,\n doy=300,\n hour=15,\n minute=30, \n second=7, \n millisecond=789)\n```\nOutput = `{'Ta': ['S01']}`\n\nIf hour, minute, second, or millisecond is left undefined, will search the entire range for all possible values and can find more possible ids\n\nFor a single day, some flybys have segments that are defined in one large range, but not within a smaller range\n\n```python\nimport pydar\npydar.retrieveIDSByTime(year=2005, doy=301)\n```\nOutput for the entire day of 301 = `{'T8': ['S02', 'S03', 'S01']}`\n\n```python\nimport pydar\npydar.retrieveIDSByTime(year=2005, doy=301, hour=3)\n```\nOutput for the day 301 but just for hour 3 = `{'T8': ['S03', 'S01']}` (does not include S02)\n\n### retrieveIDSByTimeRange()\n\nRetrieve a dictionary of flyby IDs and segment numbers based on a start and end datetime\n\n```\nretrieveIDSByTimeRange(start_year=None, \n start_doy=None,\n start_hour=None,\n start_minute=None, \n start_second=None,\n start_millisecond=None,\n end_year=None, \n end_doy=None,\n end_hour=None,\n end_minute=None, \n end_second=None,\n end_millisecond=None)\n```\n\n* **[REQUIRED]** start_year (int): Year for observation, range from 2004 to 2014, start_year must be less than/equal to end_year\n* **[REQUIRED]** end_year (int): Year for observation, range from 2004 to 2014, end_year must be greater than/equal to start_year\n* **[REQUIRED]** start_doy (int): Day of the year, from 0 to 365 (where January 10 = 10) (__Note__: 'doy' not 'day' for days of the year), start_doy must be less than/equal to end_doy\n* **[REQUIRED]** end_doy (int): Day of the year, from 0 to 365 (where January 10 = 10) (__Note__: 'doy' not 'day' for days of the year), end_doy must be less than/equal to start_doy\n* [OPTIONAL] start_hour (int): Hour, from 0 to 23 in UTC, defaults to check all hours when undefined, start_hour must be less than/equal to end_hour\n* [OPTIONAL] end_hour (int): Hour, from 0 to 23 in UTC, defaults to check all hours when undefined, end_hour must be less than/equal to start_hour\n* [OPTIONAL] start_minute (int): Minute, from 0 to 59, defaults to check all minutes when undefined, start_minute must be less than/equal to end_minute\n* [OPTIONAL] end_minute (int): Minute, from 0 to 59, defaults to check all minutes when undefined, end_minute must be greater than/equal to start_minute\n* [OPTIONAL] start_second (int): Second, from 0 to 59, defaults to check all seconds when undefined, start_second must be less than/equal to end_second\n* [OPTIONAL] end_second (int): Second, from 0 to 59, defaults to check all seconds when undefined, end_second must be greater than/equal to start_second\n* [OPTIONAL] start_millisecond (int): Milliscond, from 0 to 999, defaults to check all milliseconds when undefined, start_millisecond must be less than/equal to end_millisecond\n* [OPTIONAL] end_millisecond (int): Milliscond, from 0 to 999, defaults to check all milliseconds when undefined, end_millisecond must be greater than/equal to start_millisecond\n\n```python\nimport pydar\npydar.retrieveIDSByTimeRange(start_year=2004,\n start_doy=299,\n start_hour=2,\n start_minute=15,\n start_second=23,\n start_millisecond=987,\n end_year=2005, \n end_doy=301,\n end_hour=2,\n end_minute=15,\n end_second=23,\n end_millisecond=987)\n```\nOutput = `{'Ta': ['S01'], 'T3': ['S01'], 'T7': ['S01']}`\n\n### convertFlybyIDToObservationNumber()\n\nConverts a Titan Flyby ID (for example: 'T65') to an observation number with front padding ('T65' -> '0211')\n\n```python\nconvertFlybyIDToObservationNumber(flyby_id)\n```\n* **[REQUIRED]** flyby_id (string): a valid flyby ID with prefix 'T'\n\n```python\nimport pydar\nobservation_number = convertFlybyIDToObservationNumber(flyby_id='T65')\n```\nOutput = `0211`\n\nObservation number based on the 'Radar Data Take Number' in the [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv) data file with front padding to ensure that all observation numbers are 4 digits long (0065 and 0211)\n\n### convertObservationNumberToFlybyID()\n\nConverts a Titan Observation Number (for example: '211' or '0211') to an flyby id ('0211' -> 'T65')\n\n```python\nconvertObservationNumberToFlybyID(flyby_observation_num)\n```\n* **[REQUIRED]** flyby_observation_num (string): a valid observation number\n\n```python\nimport pydar\nflyby_id = pydar.convertObservationNumberToFlybyID(flyby_observation_num='211')\n```\nOutput = `T65`\n\nFlyby ids are based on the 'Radar Data Take Number' in the [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv) data file with front padding of 'T'\n\nRequires each Titan flyby ID to be a valid flyby ID in [cassini_flyby.csv](https://github.com/unaschneck/pydar/blob/main/pydar/data/cassini_flyby.csv)\n\n### extractFlybyDataImages()\n\nDownloads flyby data SBDR for a selected flyby observation number or flyby id: .FMT and .TAB files (for example: [SBDR.FMT](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/SBDR/SBDR.FMT) and [SBDR_15_D087_V03.TAB](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/SBDR/SBDR_15_D087_V03.TAB))\n\nDownloads flyby data BIDR for a selected flyby observation number or flyby id: .LBL and .ZIP files (for example: [BIBQH80N051_D087_T016S01_V03.LBL](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/BIDR/BIBQH80N051_D087_T016S01_V03.LBL) and [BIBQH80N051_D087_T016S01_V03.ZIP](https://pds-imaging.jpl.nasa.gov/data/cassini/cassini_orbiter/CORADR_0087_V03/DATA/BIDR/BIBQH80N051_D087_T016S01_V03.ZIP))\n\n```\nextractFlybyDataImages(flyby_observation_num=None,\n flyby_id=None,\n segment_num=None,\n additional_data_types_to_download=[],\n resolution='I',\n top_x_resolutions=None)\n```\nEither a flyby_id (for example: 'T65') or a flyby_observation_num (for example: '0035') is required. \n\n> [!Note]\n> A `flyby_id` will be translated into a `flyby_observation_number` to access on the backend and the results will be saved under the observation number. For example, 'T65' will become observation number '0211'\n\n* **[REQUIRED/OPTIONAL]** flyby_observation_num (string): required if flyby_id not included\n* **[REQUIRED/OPTIONAL]** flyby_id (string): required if flyby_observation_num not included\n* **[REQUIRED]** segment_num (string): a flyby includes multiple image segments (S0X) where S01 is the primary imaging segment [\"S01\", \"S02\", \"S03\", \"S04\"]\n* [OPTIONAL] resolution (String): resolution options \"B\", \"D\", \"F\", \"H\", or \"I\" (2, 8, 32, 128, 256 pixels/degree), defaults to highest resolution 'I'\n* [OPTIONAL] top_x_resolutions: Save the top x resolution types (5 total resolutions), will override any default resolution string\n* [OPTIONAL] additional_data_types_to_download (List of Strings): Possible options [\"ABDR\", \"ASUM\", \"BIDR\", \"LBDR\", \"SBDR\", \"STDR\"] (__NOTE__: current v1 functionality does not download any additional data types)\n\n```python\nimport pydar\npydar.extractFlybyDataImages(flyby_id='T65',\n resolution='D',\n segment_num=\"S01\")\n```\n\n`extractFlybyDataImages()` will retrieve images from PDS website and saves results in a directory labeled 'pydar_results' with the flyby observation number, version number, and segment number in the title (for example `pydar_results/CORADR_0065_V03_S01`). Download time depends on file and resolution size but ranges from 1-5 minutes\n\n### readAAREADME()\n\nPrint AAREADME.TXT to console for viewing\n\n```\nreadAAREADME(coradr_results_directory=None,\n section_to_print=None, \n print_to_console=True)\n```\n\n* **[REQUIRED]** coradr_results_directory (string): CORADAR results folder downloaded (example: \"pydar_results/CORADR_0211_V03_S01/\")\n* [OPTIONAL] section_to_print (string): Specify a section to print to console from the AAREADME, defaults to print the entire AAREADME.TXT, not case-sensitive \n* [OPTIONAL] print_to_console (boolean): Print to console, defaults to true, otherwise function will return output as a string\n\nTo see a list of all section_to_print options, see: `returnAAREADMEOptions()`\n\n```python\nimport pydar\npydar.readAAREADME(coradr_results_directory=\"pydar_results/CORADR_0065_V03_S01\",\n section_to_print=\"Volume\")\n```\nOutput = `Volume CORADR_0065: Titan Flyby T8, Sequence S15, Oct 27, 2005`\n```python\nimport pydar\npydar.returnAAREADMEOptions()\n```\n\nOutput = `['PDS_VERSION_ID', 'RECORD_TYPE', 'INSTRUMENT_HOST_NAME', 'INSTRUMENT_NAME', 'PUBLICATION_DATE', 'NOTE', 'END_OBJECT', 'Volume', 'Introduction', 'Disk Format', 'File Formats', 'Volume Contents', 'Recommended DVD Drives and Driver Software', 'Errata and Disclaimer', 'Version Status', 'Contact Information']`\n\n### readLBLREADME()\n\nPrint .LBL README to console for viewing\n\n```\nreadLBLREADME(coradr_results_directory=None,\n section_to_print=None, \n print_to_console=True)\n```\n\n* **[REQUIRED]** coradr_results_directory (string):\n* [OPTIONAL] section_to_print (string): Specify a section to print to console from the AAREADME, defaults to print the entire AAREADME.TXT, not case-sensitive\n* [OPTIONAL] print_to_console (boolean): Print to console, defaults to true, otherwise function will return output as a string\n\nTo see a list of all section_to_print options, see: `returnLBLOptions()`\n\n```python\nimport pydar\npydar.readLBLREADME(coradr_results_directory=\"pydar_results/CORADR_0035_S01/\",\n section_to_print=\"OBLIQUE_PROJ_X_AXIS_VECTOR\")\n```\nOutput = `(0.13498322,0.00221225,-0.99084542)`\n```python\nimport pydar\npydar.returnLBLOptions()\n```\n<details closed>\n<summary>Line-By-Line Options (Click to view all)</summary>\n<br>\n['PDS_VERSION_ID', 'DATA_SET_ID', 'DATA_SET_NAME', 'PRODUCER_INSTITUTION_NAME', 'PRODUCER_ID', 'PRODUCER_FULL_NAME', 'PRODUCT_ID', 'PRODUCT_VERSION_ID', 'INSTRUMENT_HOST_NAME', 'INSTRUMENT_HOST_ID', 'INSTRUMENT_NAME', 'INSTRUMENT_ID', 'TARGET_NAME', 'START_TIME', 'STOP_TIME', 'SPACECRAFT_CLOCK_START_COUNT', 'SPACECRAFT_CLOCK_STOP_COUNT', 'PRODUCT_CREATION_TIME', 'SOURCE_PRODUCT_ID', 'MISSION_PHASE_NAME', 'MISSION_NAME', 'SOFTWARE_VERSION_ID', 'FILE_NAME COMPRESSED', 'RECORD_TYPE COMPRESSED', 'ENCODING_TYPE', 'INTERCHANGE_FORMAT', 'UNCOMPRESSED_FILE_NAME', 'REQUIRED_STORAGE_BYTES', '^DESCRIPTION', 'FILE_NAME UNCOMPRESSED', 'RECORD_TYPE UNCOMPRESSED', 'RECORD_BYTES', 'FILE_RECORDS', 'LABEL_RECORDS', '^IMAGE', 'LINES', 'LINE_SAMPLES', 'SAMPLE_TYPE', 'SAMPLE_BITS', 'CHECKSUM', 'SCALING_FACTOR', 'OFFSET', 'MISSING_CONSTANT', 'NOTE', '^DATA_SET_MAP_PROJECTION', 'MAP_PROJECTION_TYPE', 'FIRST_STANDARD_PARALLEL', 'SECOND_STANDARD_PARALLEL', 'A_AXIS_RADIUS', 'B_AXIS_RADIUS', 'C_AXIS_RADIUS', 'POSITIVE_LONGITUDE_DIRECTION', 'CENTER_LATITUDE', 'CENTER_LONGITUDE', 'REFERENCE_LATITUDE', 'REFERENCE_LONGITUDE', 'LINE_FIRST_PIXEL', 'LINE_LAST_PIXEL', 'SAMPLE_FIRST_PIXEL', 'SAMPLE_LAST_PIXEL', 'MAP_PROJECTION_ROTATION', 'MAP_RESOLUTION', 'MAP_SCALE', 'MAXIMUM_LATITUDE', 'MINIMUM_LATITUDE', 'EASTERNMOST_LONGITUDE', 'WESTERNMOST_LONGITUDE', 'LINE_PROJECTION_OFFSET', 'SAMPLE_PROJECTION_OFFSET', 'OBLIQUE_PROJ_POLE_LATITUDE', 'OBLIQUE_PROJ_POLE_LONGITUDE', 'OBLIQUE_PROJ_POLE_ROTATION', 'OBLIQUE_PROJ_X_AXIS_VECTOR', 'OBLIQUE_PROJ_Y_AXIS_VECTOR', 'OBLIQUE_PROJ_Z_AXIS_VECTOR', 'LOOK_DIRECTION', 'COORDINATE_SYSTEM_NAME', 'COORDINATE_SYSTEM_TYPE']\n</details>\n<details closed>\n<summary>Section Header Options (Click to view all)</summary>\n<br>\n['PRODUCT DESCRIPTION', 'DESCRIPTION OF COMPRESSED AND UNCOMPRESSED FILES', 'POINTERS TO START RECORDS OF OBJECTS IN FILE', 'DESCRIPTION OF OBJECTS CONTAINED IN FILE']\n</details>\n\n## Use Downloaded Data\n### displayImages()\n\nDisplays downloaded image .IMG files (unzipped from within the .ZIP files) and display all images in directory\n\n```\ndisplayImages(image_directory=None, fig_title=None, cmap=\"gray\", figsize_n=6, fig_dpi=120)\n```\n\n* **[REQUIRED]** image_directory (string): directory containing a .LBL and .IMG file\n* [OPTIONAL] fig_title (str): figure title, defaults to filename\n* [OPTIONAL] cmap (str): optional colormaps ([see more options](https://matplotlib.org/stable/tutorials/colors/colormaps.html)), defaults to 'gray'\n* [OPTIONAL] figsize_n (int): plot dimensions, defaults to 6x6\n* [OPTIONAL] fig_dpi (int): plot dpi, defaults to 120\n\n\n```python\nimport pydar\npydar.displayImages(image_directory=\"pydar_results/CORADR_0065_V03_S01\")\n```\n <p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/unaschneck/pydar/main/assets/ontario_example_output.png\" />\n</p>\n\n> [!Note]\n> `displayImages()` will show all images in the saved results directory\n\n**COMING SOON: extractMetadata**\n\nExtract Metadata from .FMT and .TAB files\n\nCOMING SOON: Extract metadata from .TAB file (using .FMT as a reference)\n\n## Development Environment\nFor developers, to run or test against `pydar` github repo, a development environment can be created via conda\n\nFirst, [install Miniconda](https://docs.conda.io/projects/miniconda/en/latest/miniconda-install.html)\n\nThen, using the existing `environment.yml`, a new conda environment can be create to run/test scripts against\n\n```\nconda env create --file environment.yml\n```\nOnce the environment has been built, activate the environment:\n```\nconda activate pydar\n```\nTo run existing and new tests from the root directory:\n```\npython -m pytest\n```\n\n## Credits\nFeature Names collected from [Gazetteer of Planetary Nomenclature](https://planetarynames.wr.usgs.gov/SearchResults?Target=74_Titan)\n\nInstrument information and naming conventions collected from the [Cassini Radar User Guide](https://pds-imaging.jpl.nasa.gov/documentation/Cassini_RADAR_Users_Guide_2nd_Ed_191004_cmp_200421.pdf)\n\nThis material is based upon work supported by the National Science Foundation Graduate Fellowship under Grant No. 2141064. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the authors and do not necessarily reflect the views of the National Science Foundation.\n\n## Acknowledging Software \nPlease acknowledge the use of this software in any publications by citing:\n\n```\nCassini RADAR data extraction software was provided by C. Y. Schneck and U. G. Schneck and is available at URL: https://github.com/unaschneck/pydar\n```\n\nPlease send a copy of such publications to: cyschneck@gmail.com & ugschneck@gmail.com (we'd love to see them!)\n\n\n## Bug and Feature Request\n\nSubmit a bug fix, question, or feature request as a [Github Issue](https://github.com/unaschneck/pydar/issues) or to ugschneck@gmail.com/cyschneck@gmail.com\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2022 unaschneck Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "A Python package to access, download, view, and manipulate Cassini RADAR images",
"version": "1.4.0",
"project_urls": {
"Issues": "https://github.com/unaschneck/pydar/issues",
"Repository": "https://github.com/unaschneck/pydar"
},
"split_keywords": [
"geophysics",
" python",
" astronomy",
" nasa",
" radar",
" planetary-science",
" cassini",
" jpl"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1ac180ebf42fa6ab7b9ab32dd7234cd8f85d336f78922d3caf59b9ef3a47c719",
"md5": "400ef7a3fa6db081a4bde52b9420bd30",
"sha256": "13c0fb9ad6a13edfe466123db17c26e6216d4b299ce6bd691616d0283d40e3c9"
},
"downloads": -1,
"filename": "pydar-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "400ef7a3fa6db081a4bde52b9420bd30",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 108092,
"upload_time": "2024-10-09T06:11:24",
"upload_time_iso_8601": "2024-10-09T06:11:24.845638Z",
"url": "https://files.pythonhosted.org/packages/1a/c1/80ebf42fa6ab7b9ab32dd7234cd8f85d336f78922d3caf59b9ef3a47c719/pydar-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "89a350fb71e78e3c88e247c4b5346df4f9ac7b897c3c99150069238c32b1238a",
"md5": "3fcc47d140fac1a82d4bef9842a657f2",
"sha256": "e368a4739df3f961ff2e85853534f937db4c8eea2c1ad3265974140a73d3d2b0"
},
"downloads": -1,
"filename": "pydar-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "3fcc47d140fac1a82d4bef9842a657f2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 126722,
"upload_time": "2024-10-09T06:11:26",
"upload_time_iso_8601": "2024-10-09T06:11:26.682849Z",
"url": "https://files.pythonhosted.org/packages/89/a3/50fb71e78e3c88e247c4b5346df4f9ac7b897c3c99150069238c32b1238a/pydar-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-09 06:11:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "unaschneck",
"github_project": "pydar",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "beautifulsoup4",
"specs": []
},
{
"name": "matplotlib",
"specs": []
},
{
"name": "pandas",
"specs": []
},
{
"name": "pdr",
"specs": []
},
{
"name": "pyproj",
"specs": []
},
{
"name": "pytest",
"specs": []
},
{
"name": "rasterio",
"specs": []
},
{
"name": "urllib3",
"specs": []
}
],
"lcname": "pydar"
}
