Metadata-Version: 2.4
Name: scubas
Version: 0.1.9
Summary: Precision ionospheric radio sounding tools
Author-email: Shibaji Chakraborty <chakras4@erau.edu>
Maintainer-email: Shibaji Chakraborty <chakras4@erau.edu>
License: MIT
Project-URL: Homepage, https://github.com/shibaji7/SCUBAS
Project-URL: Documentation, https://scubas.readthedocs.io/en/latest/
Keywords: Python>=3.6,submarine cable,electrical surge,geomagnetic induction,geomagnetic disturbance
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Education
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
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: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Requires-Dist: matplotlib>=3.3.4
Requires-Dist: pyproj
Requires-Dist: loguru
Requires-Dist: scipy
Requires-Dist: SciencePlots
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov>=4; extra == "dev"
Requires-Dist: pyproj>=3; extra == "dev"
Requires-Dist: matplotlib>=3.5; extra == "dev"
Requires-Dist: numpy; extra == "dev"
Requires-Dist: pandas; extra == "dev"
Requires-Dist: loguru; extra == "dev"
Requires-Dist: requests; extra == "dev"
Requires-Dist: tqdm; extra == "dev"
Requires-Dist: toml; extra == "dev"
Requires-Dist: SciencePlots; extra == "dev"
Requires-Dist: scipy; extra == "dev"
Dynamic: license-file

# SCUBAS
SUCBAS: **S**ubmarine **C**ables **U**pset **b**y **A**uroral **S**treams.

## Installation
`scubas` includes both a reusuable Python package (intended to be imported and reused by other projects) and a set of scripts / notebooks using that package. How you should install `scubas` depends on how you intend to use it.

**If you want to run the interactive scripts / notebooks**, you should download this repository and install from it. **If you want to use the library in other projects**, you can either do that or just install the library from a package index or use `pip` installer.

### If you want to run the interactive notebooks

Make sure you have a recent Python version (*Python>=3.7*) and Jupyter installed.

Clone this repository into a suitable location on your computer:

`git clone https://github.com/shibaji7/SCUBAS`

`cd SCUBAS`

`pip install .`

You should now be able to open and run the notebooks within `scripts/` using Jupyter.

### If you want to use the library in other projects

#### From the Python Package Index:

The `scubas` package is distributed on the Python Package Index: https://pypi.org/project/scubas/

`pip install scubas`

#### From the git repository:

Follow the same instructions as installing the interactive notebooks.

## Folder Structure

- `scubas` -  the python package
- `docs` - documentation for the codebase
- `scripts`, etc. - example analysis scripts and Jupyter notebooks

## Citing this Project

- Chakraborty S, Boteler DH, Shi X, Murphy BS, Hartinger MD, Wang X, Lucas G and Baker JBH (2022) Modeling geomagnetic induction in submarine cables. *Front. Phys.* 10:1022475. [doi:10.3389/fphy.2022.1022475](https://doi.org/10.3389/fphy.2022.1022475)
