Metadata-Version: 2.4
Name: gspy
Version: 2.2.8
Summary: gspy converts commonly used data formats into a netcdf file honoring our GS convention.
Project-URL: Documentation, https://usgs.github.io/gspy/
Project-URL: Issues, https://https://github.com/usgs/gspy/issues
Project-URL: Source, https://https://github.com/usgs/gspy
Project-URL: Homepage, https://usgs.github.io/gspy/
Project-URL: source_archive, https://usgs.github.io/gspy/archive/5d80961a98119bc74c15ca24b4213de2764d164f.zip
Author-email: Leon Foks <nfoks@contractor.usgs.gov>, Stephanie James <sjames@usgs.gov>, Burke Minsley <bminsley@usgs.gov>
License-File: LICENSE.md
Keywords: netcdf,xarray
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: chardet
Requires-Dist: fortranformat
Requires-Dist: h5netcdf
Requires-Dist: h5py
Requires-Dist: matplotlib
Requires-Dist: netcdf4
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: pygmt
Requires-Dist: pyproj
Requires-Dist: pyyaml
Requires-Dist: rioxarray
Requires-Dist: scipy
Requires-Dist: xarray
Provides-Extra: dev
Requires-Dist: sphinx-gallery; extra == 'dev'
Requires-Dist: sphinx-rtd-theme; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx-gallery; extra == 'docs'
Requires-Dist: sphinx-rtd-theme; extra == 'docs'
Description-Content-Type: text/x-rst

####################################################
Welcome to GSpy: Geophysical Data Standard in Python
####################################################

This package provides functions and workflows for standardizing geophysical datasets based on the NetCDF file format.
The current implementation supports both time and frequency domain electromagnetic data,
raw and processed, 1-D inverted models along flight lines, and 2-D/3-D gridded layers.

Suggested Citations
~~~~~~~~~~~~~~~~~~~

If you use this software to generate gspy conformant data we suggest citing the software itself.

Foks, N.L., James, S. R., and Minsely, B. J. 2022. GSPy: Geophysical Data Standard in Python. U.S. Geological Survey software release. doi:10.5066/P9XNQVGQ

The manuscript accompanying this software release defining the standard itself you can also cite the following.

James, S. R., Foks, N.L., and Minsely, B. J. 2022. GSPy: A new toolbox and data standard for Geophysical Datasets. Frontiers in Earth Science. 10. doi:10.3389/feart.2022.907614

Documentation
~~~~~~~~~~~~~

`Documentation is here! <https://usgs.github.io/gspy/>`_

Goals
~~~~~

1. Standardize a geophysical data format based on the CF convention and NetCDF.
2. Restructure raw and processed data, or model, products into a consistent format for release.
3. Document metadata pertinent to geophysical dataset release.
4. Develop tools for processing data and preparing data for inversion.
5. Develop exploratory tools to interrogate data.

NetCDF Data Standard
~~~~~~~~~~~~~~~~~~~~
Datasets are read from a variety of original formats (CSV, ASEG-GDF, TIF) and reconfigured to follow a NetCDF based data standard, which includes detailed metadata:

1. All variables have detailed attributes (units, null values, data format).
2. Contains supporting information on the airborne survey, data collection, and modeling parameters.
3. Standardized coordinate reference system (CRS) variables for maximum portability to other GIS software (QGIS, ArcGIS, etc).
4. Inputs with different CRSs are reprojected to be consistent for a given survey.

Installation
~~~~~~~~~~~~
pip install gspy
