Metadata-Version: 2.2
Name: pygaps
Version: 4.6.1
Summary: Framework for processing gas adsorption isotherms
Author-email: Paul Iacomi <mail@pauliacomi.com>
License: MIT License
        
        Copyright (c) 2022, Paul Iacomi
        
        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.
        
Project-URL: Homepage, https://github.com/pauliacomi/pygaps
Project-URL: Repository, https://github.com/pauliacomi/pygaps.git
Project-URL: Documentation, https://pygaps.readthedocs.io
Keywords: adsorption,isotherm,characterization,processing,material
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: numpy>=1.16.5
Requires-Dist: scipy>=1.5.0
Requires-Dist: pandas>=1.1.0
Requires-Dist: matplotlib>=3.3.0
Requires-Dist: coolprop>=6.0.0; python_version < "3.13"
Requires-Dist: coolprop>=6.7.0; python_version >= "3.13"
Requires-Dist: adsorption-file-parser>=0.2.6
Requires-Dist: xlrd>=1.1
Requires-Dist: xlwt>=1.3
Requires-Dist: openpyxl
Requires-Dist: gemmi
Requires-Dist: requests
Requires-Dist: importlib_resources; python_version < "3.9"
Provides-Extra: all
Requires-Dist: pygaps[dev,docs,test]; extra == "all"
Provides-Extra: dev
Requires-Dist: pygaps[docs,test]; extra == "dev"
Requires-Dist: codecov; extra == "dev"
Requires-Dist: yapf; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: pylint; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: flake8-pyproject; extra == "dev"
Requires-Dist: autopep8; extra == "dev"
Requires-Dist: pydocstyle; extra == "dev"
Requires-Dist: pygments; extra == "dev"
Requires-Dist: docutils; extra == "dev"
Provides-Extra: docs
Requires-Dist: pygments>=2.11; extra == "docs"
Requires-Dist: docutils>=0.11; extra == "docs"
Requires-Dist: doc8; extra == "docs"
Requires-Dist: pandoc; extra == "docs"
Requires-Dist: restructuredtext-lint; extra == "docs"
Requires-Dist: ipykernel; extra == "docs"
Requires-Dist: sphinx>=4.0; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: furo; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest>=6.0.0; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: coverage[toml]; extra == "test"
Requires-Dist: nose; extra == "test"


|
|

.. image:: https://raw.githubusercontent.com/pauliacomi/pyGAPS/master/docs/logo.svg
   :width: 200px
   :align: center

========
Overview
========

pyGAPS (Python General Adsorption Processing Suite) is a framework for
adsorption data analysis and fitting, written in Python 3.

.. start-badges

.. list-table::
    :widths: 10 90
    :stub-columns: 1

    * - status
      - | |status| |commits-since|
    * - docs
      - | |docs|
    * - license
      - | |license|
    * - tests
      - | |GHA| |codecov|
        | |requires|
    * - package
      - | |version| |wheel|
        | |supported-versions| |supported-implementations|

.. |status| image:: https://www.repostatus.org/badges/latest/active.svg
    :target: https://www.repostatus.org/#active
    :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.

.. |commits-since| image:: https://img.shields.io/github/commits-since/pauliacomi/pygaps/latest/develop
    :alt: Commits since latest release
    :target: https://github.com/pauliacomi/pygaps/compare/master...develop

.. |docs| image:: https://readthedocs.org/projects/pygaps/badge/?style=flat
    :target: https://readthedocs.org/projects/pygaps
    :alt: Documentation Status

.. |license| image:: https://img.shields.io/badge/License-MIT-yellow.svg
    :target: https://opensource.org/licenses/MIT
    :alt: Project License

.. |GHA| image:: https://github.com/pauliacomi/pyGAPS/workflows/CI/badge.svg
    :alt: GHA-CI Build Status
    :target: https://github.com/pauliacomi/pyGAPS/actions

.. |requires| image:: https://requires.io/github/pauliacomi/pyGAPS/requirements.svg?branch=master
    :alt: Requirements Status
    :target: https://requires.io/github/pauliacomi/pyGAPS/requirements/?branch=master

.. |codecov| image:: https://img.shields.io/codecov/c/github/pauliacomi/pygaps.svg
    :alt: Coverage Status
    :target: https://codecov.io/gh/pauliacomi/pyGAPS

.. |version| image:: https://img.shields.io/pypi/v/pygaps.svg
    :alt: PyPI Package latest release
    :target: https://pypi.org/project/pygaps

.. |wheel| image:: https://img.shields.io/pypi/wheel/pygaps.svg
    :alt: PyPI Wheel
    :target: https://pypi.org/project/pygaps

.. |supported-versions| image:: https://img.shields.io/pypi/pyversions/pygaps.svg
    :alt: Supported versions
    :target: https://pypi.org/project/pygaps

.. |supported-implementations| image:: https://img.shields.io/pypi/implementation/pygaps.svg
    :alt: Supported implementations
    :target: https://pypi.org/project/pygaps


.. end-badges


Features
========

- Advanced adsorption data import and manipulation.
- A fully feature thermodynamic backend allowing conversions between
  pressures, temperatures, loadings, etc.
- Routine analysis such as BET/Langmuir surface area, t-plots, alpha-s
  plots, Dubinin plots etc.
- Pore size distribution calculations for mesopores (BJH, Dollimore-Heal).
- Pore size distribution calculations for micropores (Horvath-Kawazoe).
- Pore size distribution calculations using kernels (DFT, QSDFT, ...)
- Isotherm fitting with various models (Henry, Langmuir, DS/TS Langmuir,
  etc..)
- Enthalpy of adsorption calculations.
- IAST predictions for binary and multicomponent adsorption.
- Parsing to and from multiple formats such as AIF, Excel, CSV and JSON.
- Simple methods for isotherm graphing and comparison.
- An database backend for storing and retrieving data.

Documentation
=============

pyGAPS is built with three key mantras in mind:

- **Opinionated**: there are many places where the code will suggest or default
  to what the it considers a good practice. As examples: the standard units,
  pore size distribution methods and BET calculation limits.
- **Flexible**: while the defaults are there for a reason, you can override
  pretty much any parameter. Want to pass a custom adsorbate thickness function
  or use volumetric bases? Can do!
- **Transparent**: all code is well documented and open source. There are no
  black boxes.

In-depth explanations, examples and theory can be found in the
`online documentation <https://pygaps.readthedocs.io/>`__. If you are familiar
with Python and adsorption and want to jump right in, look at the `quickstart
section <https://pygaps.readthedocs.io/en/master/examples/quickstart.html>`__.
Examples for each of the capabilities specified above can be found documented
`here <https://pygaps.readthedocs.io/en/master/examples/index.html>`__. Most of
the pages are actually Jupyter Notebooks, you can download them and run them
yourself from the
`/docs/examples <https://github.com/pauliacomi/pyGAPS/tree/master/docs/examples>`__
folder.

To become well familiarised with the concepts introduced by pyGAPS, such as what
is an Isotherm, how units work, what data is required and can be stored etc., a
deep dive is available in the
`manual <https://pygaps.readthedocs.io/en/master/manual/index.html>`__.

Finally, having a strong grasp of the science of adsorption is recommended, to
understand the strengths and shortcomings of various methods. We have done our
best to explain the theory and application range of each capability and model.
To learn more, look at the
`reference <https://pygaps.readthedocs.io/en/master/reference/index.html>`__ or
simply call ``help()`` from a python interpreter (for example
``help(pygaps.PointIsotherm)``.

Support and sponsorship
=======================

This project is graciously sponsored by
`Surface Measurement Systems <https://surfacemeasurementsystems.com/>`__, by
employing Paul Iacomi, the core maintainer. The work would not be possible
without their contribution, keeping this open source project alive.

.. image:: https://raw.githubusercontent.com/pauliacomi/pyGAPS/master/docs/figures/SMS-Logo.jpg
   :width: 200px
   :align: left

If you are interested in implementing a particular feature,
or obtaining professional level support, contact us here
`Bugs or questions?`_.

Citing
======

Please consider citing the related paper we published if you use
the program in your research.

    Paul Iacomi, Philip L. Llewellyn, *Adsorption* (2019).
    pyGAPS: A Python-Based Framework for Adsorption Isotherm
    Processing and Material Characterisation.
    DOI: https://doi.org/10.1007/s10450-019-00168-5

Installation
============

The easiest way to install pyGAPS is from the command line. You can use ``pip``:

.. code:: bash

    pip install pygaps

or `Anaconda/Conda <https://www.anaconda.com/>`__:

.. code:: bash

    conda install -c conda-forge pygaps

If you are just starting out, `Anaconda/Conda <https://www.anaconda.com/>`__ is
a good bet since it manages virtual environments for you. Check out
`Installation <https://pygaps.readthedocs.io/en/master/installation.html>`__ for
more details.

Development
===========

To install the development branch, clone the repository from GitHub.
Then install the package with pip either in regular or developer mode.

.. code:: bash

    git clone https://github.com/pauliacomi/pyGAPS

    # then install editable/develop mode
    # adding [dev] will install the development dependencies
    pip install -e ./pyGAPS[dev]

If you want to contribute to pyGAPS or develop your own code from the package,
check out the detailed information in
`CONTRIBUTING.rst <https://pygaps.readthedocs.io/en/master/contributing.html>`__.

Bugs or questions?
==================

For any bugs found, please open an
`issue <https://github.com/pauliacomi/pyGAPS/issues/>`__ or, even better, submit
a `pull request <https://github.com/pauliacomi/pyGAPS/pulls/>`__. It'll make my
life easier. This also applies to any features which you think might benefit the
project. I'm also more than happy to answer any questions. Shoot an email to
mail( at )pauliacomi.com or find me at https://pauliacomi.com or on
`Twitter <https://twitter.com/iacomip>`__.
