scikit-gstat


Namescikit-gstat JSON
Version 1.0.16 PyPI version JSON
download
home_page
SummaryGeostatistical expansion in the scipy style
upload_time2024-01-20 07:33:49
maintainer
docs_urlNone
authorMirko Maelicke
requires_python
licenseMIT License
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            SciKit-GStat
============

Info: scikit-gstat needs Python >= 3.6!

.. image:: https://img.shields.io/pypi/v/scikit-gstat?color=green&logo=pypi&logoColor=yellow&style=flat-square   :alt: PyPI
    :target: https://pypi.org/project/scikit-gstat

.. image:: https://img.shields.io/github/v/release/mmaelicke/scikit-gstat?color=green&logo=github&style=flat-square   :alt: GitHub release (latest by date)
    :target: https://github.com/mmaelicke/scikit-gstat

.. image:: https://github.com/mmaelicke/scikit-gstat/workflows/Test%20and%20build%20docs/badge.svg
    :target: https://github.com/mmaelicke/scikit-gstat/actions

.. image:: https://codecov.io/gh/mmaelicke/scikit-gstat/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/mmaelicke/scikit-gstat
    :alt: Codecov

.. image:: https://zenodo.org/badge/98853365.svg
   :target: https://zenodo.org/badge/latestdoi/98853365

How to cite
-----------

In case you use SciKit-GStat in other software or scientific publications,
please reference this module. There is a `GMD <https://www.geoscientific-model-development.net>`_  publication. Please cite it like:

  Mälicke, M.: SciKit-GStat 1.0: a SciPy-flavored geostatistical variogram estimation toolbox written in Python, Geosci. Model Dev., 15, 2505–2532, https://doi.org/10.5194/gmd-15-2505-2022, 2022.

The code itself is published and has a DOI. It can be cited as:

  Mirko Mälicke, Romain Hugonnet, Helge David Schneider, Sebastian Müller, Egil Möller, & Johan Van de Wauw. (2022). mmaelicke/scikit-gstat: Version 1.0 (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.5970098


Full Documentation
------------------

The full documentation can be found at: https://mmaelicke.github.io/scikit-gstat

Description
-----------

SciKit-Gstat is a scipy-styled analysis module for geostatistics. It includes
two base classes ``Variogram`` and ``OrdinaryKriging``. Additionally, various
variogram classes inheriting from ``Variogram`` are available for solving
directional or space-time related tasks.
The module makes use of a rich selection of semi-variance
estimators and variogram model functions, while being extensible at the same
time.
The estimators include:

- matheron
- cressie
- dowd
- genton
- entropy
- two experimental ones: quantiles, minmax

The models include:

- sperical
- exponential
- gaussian
- cubic
- stable
- matérn

with all of them in a nugget and no-nugget variation. All the estimator are
implemented using numba's jit decorator. The usage of numba might be subject
to change in future versions.


Installation
~~~~~~~~~~~~

PyPI
^^^^
.. code-block:: bash

  pip install scikit-gstat

**Note:** It can happen that the installation of numba or numpy is failing using pip. Especially on Windows systems.
Usually, a missing Dll (see eg. `#31 <https://github.com/mmaelicke/scikit-gstat/issues/31>`_) or visual c++ redistributable is the reason.

GIT:
^^^^

.. code-block:: bash

  git clone https://github.com/mmaelicke/scikit-gstat.git
  cd scikit-gstat
  pip install -r requirements.txt
  pip install -e .

Conda-Forge:
^^^^^^^^^^^^

From Version `0.5.5` on `scikit-gstat` is also available on conda-forge.
Note that for versions `< 1.0` conda-forge will not always be up to date, but
from `1.0` on, each minor release will be available.

.. code-block:: bash

  conda install -c conda-forge scikit-gstat


Quickstart
----------

The `Variogram` class needs at least a list of coordiantes and values.
All other attributes are set by default.
You can easily set up an example by using the `skgstat.data` sub-module,
that includes a growing list of sample data.

.. code-block:: python

  import skgstat as skg

  # the data functions return a dict of 'sample' and 'description'
  coordinates, values = skg.data.pancake(N=300).get('sample')

  V = skg.Variogram(coordinates=coordinates, values=values)
  print(V)

.. code-block:: bash

  spherical Variogram
  -------------------
  Estimator:         matheron
  Effective Range:   353.64
  Sill:              1512.24
  Nugget:            0.00

All variogram parameters can be changed in place and the class will automatically
invalidate and update dependent results and parameters.

.. code-block:: python

  V.model = 'exponential'
  V.n_lags = 15
  V.maxlag = 500

  # plot - matplotlib and plotly are available backends
  fig = V.plot()

.. image:: ./example.png

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "scikit-gstat",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "Mirko Maelicke",
    "author_email": "mirko.maelicke@kit.edu",
    "download_url": "https://files.pythonhosted.org/packages/18/a4/c12988b1ea5f9457c84557f48e619d54b4f3f8998eddb6652581ed157dff/scikit-gstat-1.0.16.tar.gz",
    "platform": null,
    "description": "SciKit-GStat\n============\n\nInfo: scikit-gstat needs Python >= 3.6!\n\n.. image:: https://img.shields.io/pypi/v/scikit-gstat?color=green&logo=pypi&logoColor=yellow&style=flat-square   :alt: PyPI\n    :target: https://pypi.org/project/scikit-gstat\n\n.. image:: https://img.shields.io/github/v/release/mmaelicke/scikit-gstat?color=green&logo=github&style=flat-square   :alt: GitHub release (latest by date)\n    :target: https://github.com/mmaelicke/scikit-gstat\n\n.. image:: https://github.com/mmaelicke/scikit-gstat/workflows/Test%20and%20build%20docs/badge.svg\n    :target: https://github.com/mmaelicke/scikit-gstat/actions\n\n.. image:: https://codecov.io/gh/mmaelicke/scikit-gstat/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/mmaelicke/scikit-gstat\n    :alt: Codecov\n\n.. image:: https://zenodo.org/badge/98853365.svg\n   :target: https://zenodo.org/badge/latestdoi/98853365\n\nHow to cite\n-----------\n\nIn case you use SciKit-GStat in other software or scientific publications,\nplease reference this module. There is a `GMD <https://www.geoscientific-model-development.net>`_  publication. Please cite it like:\n\n  M\u00e4licke, M.: SciKit-GStat 1.0: a SciPy-flavored geostatistical variogram estimation toolbox written in Python, Geosci. Model Dev., 15, 2505\u20132532, https://doi.org/10.5194/gmd-15-2505-2022, 2022.\n\nThe code itself is published and has a DOI. It can be cited as:\n\n  Mirko M\u00e4licke, Romain Hugonnet, Helge David Schneider, Sebastian M\u00fcller, Egil M\u00f6ller, & Johan Van de Wauw. (2022). mmaelicke/scikit-gstat: Version 1.0 (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.5970098\n\n\nFull Documentation\n------------------\n\nThe full documentation can be found at: https://mmaelicke.github.io/scikit-gstat\n\nDescription\n-----------\n\nSciKit-Gstat is a scipy-styled analysis module for geostatistics. It includes\ntwo base classes ``Variogram`` and ``OrdinaryKriging``. Additionally, various\nvariogram classes inheriting from ``Variogram`` are available for solving\ndirectional or space-time related tasks.\nThe module makes use of a rich selection of semi-variance\nestimators and variogram model functions, while being extensible at the same\ntime.\nThe estimators include:\n\n- matheron\n- cressie\n- dowd\n- genton\n- entropy\n- two experimental ones: quantiles, minmax\n\nThe models include:\n\n- sperical\n- exponential\n- gaussian\n- cubic\n- stable\n- mat\u00e9rn\n\nwith all of them in a nugget and no-nugget variation. All the estimator are\nimplemented using numba's jit decorator. The usage of numba might be subject\nto change in future versions.\n\n\nInstallation\n~~~~~~~~~~~~\n\nPyPI\n^^^^\n.. code-block:: bash\n\n  pip install scikit-gstat\n\n**Note:** It can happen that the installation of numba or numpy is failing using pip. Especially on Windows systems.\nUsually, a missing Dll (see eg. `#31 <https://github.com/mmaelicke/scikit-gstat/issues/31>`_) or visual c++ redistributable is the reason.\n\nGIT:\n^^^^\n\n.. code-block:: bash\n\n  git clone https://github.com/mmaelicke/scikit-gstat.git\n  cd scikit-gstat\n  pip install -r requirements.txt\n  pip install -e .\n\nConda-Forge:\n^^^^^^^^^^^^\n\nFrom Version `0.5.5` on `scikit-gstat` is also available on conda-forge.\nNote that for versions `< 1.0` conda-forge will not always be up to date, but\nfrom `1.0` on, each minor release will be available.\n\n.. code-block:: bash\n\n  conda install -c conda-forge scikit-gstat\n\n\nQuickstart\n----------\n\nThe `Variogram` class needs at least a list of coordiantes and values.\nAll other attributes are set by default.\nYou can easily set up an example by using the `skgstat.data` sub-module,\nthat includes a growing list of sample data.\n\n.. code-block:: python\n\n  import skgstat as skg\n\n  # the data functions return a dict of 'sample' and 'description'\n  coordinates, values = skg.data.pancake(N=300).get('sample')\n\n  V = skg.Variogram(coordinates=coordinates, values=values)\n  print(V)\n\n.. code-block:: bash\n\n  spherical Variogram\n  -------------------\n  Estimator:         matheron\n  Effective Range:   353.64\n  Sill:              1512.24\n  Nugget:            0.00\n\nAll variogram parameters can be changed in place and the class will automatically\ninvalidate and update dependent results and parameters.\n\n.. code-block:: python\n\n  V.model = 'exponential'\n  V.n_lags = 15\n  V.maxlag = 500\n\n  # plot - matplotlib and plotly are available backends\n  fig = V.plot()\n\n.. image:: ./example.png\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Geostatistical expansion in the scipy style",
    "version": "1.0.16",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0432b95f741b6998f620d7caf567d0b04e4178baba145e783099b2769fc7b2e1",
                "md5": "e1637eddccd1054bd9be38af33e9f86b",
                "sha256": "34a27e45c17435f3155ccc030319e9f08ffa7c5256fe2e6ef97f9f311b476075"
            },
            "downloads": -1,
            "filename": "scikit_gstat-1.0.16-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e1637eddccd1054bd9be38af33e9f86b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 708303,
            "upload_time": "2024-01-20T07:33:46",
            "upload_time_iso_8601": "2024-01-20T07:33:46.651165Z",
            "url": "https://files.pythonhosted.org/packages/04/32/b95f741b6998f620d7caf567d0b04e4178baba145e783099b2769fc7b2e1/scikit_gstat-1.0.16-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "18a4c12988b1ea5f9457c84557f48e619d54b4f3f8998eddb6652581ed157dff",
                "md5": "bf600301bbe804496bd1a7156c86ffc2",
                "sha256": "341610eb4f1bb769f7dc4d190b5a4c11bd72c958620e5717703f330402e610ab"
            },
            "downloads": -1,
            "filename": "scikit-gstat-1.0.16.tar.gz",
            "has_sig": false,
            "md5_digest": "bf600301bbe804496bd1a7156c86ffc2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 692904,
            "upload_time": "2024-01-20T07:33:49",
            "upload_time_iso_8601": "2024-01-20T07:33:49.004708Z",
            "url": "https://files.pythonhosted.org/packages/18/a4/c12988b1ea5f9457c84557f48e619d54b4f3f8998eddb6652581ed157dff/scikit-gstat-1.0.16.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-20 07:33:49",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "scikit-gstat"
}
        
Elapsed time: 0.16659s