Metadata-Version: 2.4
Name: rsr
Version: 1.0.8
Summary: Utilities for applying the Radar Statistical Reconnaissance technique
Author-email: Cyril Grima <cyril.grima@gmail.com>
Project-URL: Repository, https://github.com/cgrima/rsr
Project-URL: Issues, https://github.com/cgrima/rsr/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: lmfit>=1.0.1
Requires-Dist: matplotlib>=3.3.3
Requires-Dist: numpy>=1.19.4
Requires-Dist: pandas>=1.1.4
Requires-Dist: subradar>=1.1.4
Requires-Dist: scipy>=1.5.2
Requires-Dist: scikit-learn>=0.0
Dynamic: license-file

# Presentation

This is a Python package providing basic utilities for applying the Radar Statistical Reconnaissance.

# Installation

`pip install rsr`

# Example

Below, 'f' is a Statfit python Class that holds the results of the rsr processing ([description here](https://github.com/cgrima/rsr/blob/master/rsr/Classdef.py)) 

```python

import rsr
import wget
import pandas as pd
import matplotlib.pyplot as plt
%pylab

# Load data (example is non-calibrated surface echo linear amplitudes from SHARAD orbit 0887601)
data_filename = wget.download('https://raw.githubusercontent.com/cgrima/rsr/master/rsr/data.txt')
data = pd.read_csv(data_filename)
amp = data['amp'].values

# Apply RSR to a given subset of amplitude.
sample = amp[80000:85000]
f = rsr.run.processor(sample, fit_model='hk')
f.plot() # Plot results

# Apply RSR along a vector of successive amplitude.
# The RSR is applied on windows made of 1000 values. Each window is separated by
# 500 samples (can be time consuming).
a = rsr.run.along(amp, winsize=1000, sampling=250, nbcores=2)
rsr.utils.plot_along(a) # Plot results
```

# Citation

Grima, C., Schroeder, D. M., Blankenship, D. D., and Young, D. A. (2014) [Planetary landing zone reconnaissance using ice penetrating radar data: concept validation in Antarctica][1]. Planetary and Space Science 103, 191-204.

  [1]: http://www.sciencedirect.com/science/article/pii/S0032063314002244
