### Status
[](https://gitter.im/ccd_tools/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://travis-ci.org/m-weigand/ccd_tools)
[](https://zenodo.org/badge/latestdoi/68698547)
[Try ccd_tools on binder](https://mybinder.org/v2/gh/m-weigand/try-ccd-tools/master?filepath=ccd_test.ipynb)
Cole-Cole decomposition routines
================================
## Introduction
This package contains an implementation of the Cole-Cole decomposition (CCD)
scheme, which is used in near-surface geophysical applications to describe
electrical polarization signatures measured for frequencies in the mHz range up
to multiple kHz.
In the CCD, spectral induced polarization (SIP) signatures are described by a
superposition of elementary polarization terms, which are suitably distributed
to cover at least the frequency range spanned by the measurement data.
For more information, please refer to the homepage of the project:
[https://m-weigand.github.io/ccd_tools](https://m-weigand.github.io/ccd_tools)
Parts of this code were described in two open-access publications:
[1. Weigand and Kemna, 2016, Computers and Geosciences](http://www.sciencedirect.com/science/article/pii/S0098300415300625)
[2. Weigand and Kemna, 2016, Geophysical Journal International](http://gji.oxfordjournals.org/content/205/3/1414)
## Versions
Please refer to the [Changelog.md](Changelog.md)
## Documentation
* [Online version of the docs](https://m-weigand.github.io/ccd_tools/doc_ccd/introduction.html)
* The sphinx-generated documentation is located in docs/doc
## Roadmap
The following functionality is planned to be implemented in the near future
(2020+). After that, new feature will probably only be implemented when
required. For additional todo-items, please refer to the issues of this project
and to the file [TODO](TODO).
### 0.9
* improve testing framework for **ccd_time**
* implement Cole-Cole decomposition (c less than 1) also for conductivity
formulation
* improve Jupyter integration and provide examples
### 1.0
* proof-of-concept web interface
* implement the addition of a high-frequency EM-Cole-Cole term, decoupled from
the other polarization terms
## Installation
Detailed [installation guide](https://m-weigand.github.io/ccd_tools/doc_ccd/installation.html)
for Windows and Linux.
Stable versions are released to pipy and can be installed using:
pip install ccd_tools
Install the source package using setuptools:
python setup.py build
python setup.py install
The package can also be installed to a user-defined directory:
export PYTHONUSERBASE=$HOME/inst/pip_installs
export PYTHONPATH=$HOME/inst/pip_installs/lib/python3.4/\
site-packages/:$PYTHONPATH
python setup.py install --user
export PATH=$HOME/inst/pip_installs/bin:$PATH
For developers:
python seutp.py develop --user
To build the documentation:
cd docs/doc
make html
setuptools developer guide:
https://pythonhosted.org/setuptools/setuptools.html
### Using Jupyter Notebooks
We recommend installing and using Anaconda. Anaconda conveniently installs
Python, the Jupyter Notebook, and all needed packages for ccd-tools.
Use the following installation steps:
* Download [Anaconda](https://www.anaconda.com/download/#linux) with Python
3 version (currently Python 3.6).
* Install the version of Anaconda which you downloaded, following the instr
uctions on the download page.
* To install ccd-tools, open the Anaconda prompt and use the following command:
`pip install ccd_tools`
* To run the Notebook within the Anaconda prompt, navigate to the notebook directory and use:
`jupyter notebook`
This will print some information about the notebook server in your terminal,
including the URL of the web application (by default, http://localhost:8888).
It will then open your default web browser to this URL.
When the notebook opens in your browser, you will see the Notebook Dashboard,
including a list of the notebooks, files, and subdirectories of the directory
where the notebook server was started.
If Jupyter Notebooks are used with Virtualenvm, the Jupyter Widget JavaScript
library needs to be installed and enabled, using the following commands:
pip install ipywidgets
jupyter nbextension enable --py widgetsnbextension --sys-prefix
## Dependencies
Dependencies for the ccd tools are listed in the file
[requirements.txt](requirements.txt). When pip is used, all requirements can be
installed using:
pip install -r requirements.txt
Additional requirements to build the documentation can be found in the file
[requirements_doc.txt](requirements_doc.txt), and can be installed using:
pip install -r requirements_doc.txt
On Debian Linux systems, the following Python packages are required to run the
Cole-Cole decomposition routines:
numpy
scipy
matplotlib
geccoinv
sip_models
In order to build the documentation, the additional packages are required: ::
sphinx
Under Debian-related Linux systems, these packages can be installed using the
commands:
sudo apt-get install texlive-latex-base texlive-latex-extra\
texlive-fonts-recommended texlive-fonts-extra dvipng
sudo apt-get install python2.7-numpy python-matplotlib python2.7-scipy\
python-setuptools python-nose python-tornado
In order to build the documentation, the following sphinx-related packages must
be installed:
sudo apt-get install python-sphinx
sudo apt-get install python-sphinx python-sphinxcontrib.blockdiag
pip install sphinxcontrib-programoutput
geccoinv and sip_models have to be installed according to their own documentation.
Under Windows, the program was tested using the 'pythonxy' distribution
(https://code.google.com/p/pythonxy/).
## Licence
This program is licenced under the GPL3 or later licence. See LICENCE.txt and
headers of individual files for more information.
Some third-party packages used for the homepage (gh-pages branch) have
individual licences.
Raw data
{
"_id": null,
"home_page": "https://github.com/m-weigand/ccd_tools",
"name": "ccd-tools",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "SIP, Cole-Cole model, Debye decomposition, Cole-Cole decomposition",
"author": "Maximilian Weigand and Department of Geophysics,University of Bonn, Germany",
"author_email": "mweigand@geo.uni-bonn.de",
"download_url": "https://files.pythonhosted.org/packages/bf/e6/90d64e9a4ef81f4c3ba433480af656ab72ee5d68843c265495f34f7edd5f/ccd_tools-0.8.18.tar.gz",
"platform": null,
"description": "### Status\n\n[](https://gitter.im/ccd_tools/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n[](https://travis-ci.org/m-weigand/ccd_tools)\n[](https://zenodo.org/badge/latestdoi/68698547)\n[Try ccd_tools on binder](https://mybinder.org/v2/gh/m-weigand/try-ccd-tools/master?filepath=ccd_test.ipynb)\n\nCole-Cole decomposition routines\n================================\n\n## Introduction\n\nThis package contains an implementation of the Cole-Cole decomposition (CCD)\nscheme, which is used in near-surface geophysical applications to describe\nelectrical polarization signatures measured for frequencies in the mHz range up\nto multiple kHz.\n\nIn the CCD, spectral induced polarization (SIP) signatures are described by a\nsuperposition of elementary polarization terms, which are suitably distributed\nto cover at least the frequency range spanned by the measurement data.\n\nFor more information, please refer to the homepage of the project:\n[https://m-weigand.github.io/ccd_tools](https://m-weigand.github.io/ccd_tools)\n\n\n\nParts of this code were described in two open-access publications:\n\n[1. Weigand and Kemna, 2016, Computers and Geosciences](http://www.sciencedirect.com/science/article/pii/S0098300415300625)\n\n[2. Weigand and Kemna, 2016, Geophysical Journal International](http://gji.oxfordjournals.org/content/205/3/1414)\n\n## Versions\n\nPlease refer to the [Changelog.md](Changelog.md)\n\n## Documentation\n\n * [Online version of the docs](https://m-weigand.github.io/ccd_tools/doc_ccd/introduction.html)\n * The sphinx-generated documentation is located in docs/doc\n\n## Roadmap\n\nThe following functionality is planned to be implemented in the near future\n(2020+). After that, new feature will probably only be implemented when\nrequired. For additional todo-items, please refer to the issues of this project\nand to the file [TODO](TODO).\n\n### 0.9\n\n* improve testing framework for **ccd_time**\n* implement Cole-Cole decomposition (c less than 1) also for conductivity\n formulation\n* improve Jupyter integration and provide examples\n\n### 1.0\n\n* proof-of-concept web interface\n* implement the addition of a high-frequency EM-Cole-Cole term, decoupled from\n the other polarization terms\n\n## Installation\n\nDetailed [installation guide](https://m-weigand.github.io/ccd_tools/doc_ccd/installation.html)\nfor Windows and Linux.\n\nStable versions are released to pipy and can be installed using:\n\n\tpip install ccd_tools\n\nInstall the source package using setuptools:\n\n python setup.py build\n python setup.py install\n\nThe package can also be installed to a user-defined directory:\n\n export PYTHONUSERBASE=$HOME/inst/pip_installs\n export PYTHONPATH=$HOME/inst/pip_installs/lib/python3.4/\\\n site-packages/:$PYTHONPATH\n python setup.py install --user\n export PATH=$HOME/inst/pip_installs/bin:$PATH\n\n\nFor developers:\n\n python seutp.py develop --user\n\nTo build the documentation:\n\n cd docs/doc\n make html\n\nsetuptools developer guide:\n\nhttps://pythonhosted.org/setuptools/setuptools.html\n\n### Using Jupyter Notebooks\n\nWe recommend installing and using Anaconda. Anaconda conveniently installs\nPython, the Jupyter Notebook, and all needed packages for ccd-tools.\n\nUse the following installation steps:\n\n* Download [Anaconda](https://www.anaconda.com/download/#linux) with Python\n3 version (currently Python 3.6).\n\n* Install the version of Anaconda which you downloaded, following the instr\nuctions on the download page.\n\n* To install ccd-tools, open the Anaconda prompt and use the following command:\n\n\n `pip install ccd_tools`\n\n* To run the Notebook within the Anaconda prompt, navigate to the notebook directory and use:\n\n `jupyter notebook`\n\nThis will print some information about the notebook server in your terminal,\nincluding the URL of the web application (by default, http://localhost:8888).\nIt will then open your default web browser to this URL.\nWhen the notebook opens in your browser, you will see the Notebook Dashboard,\nincluding a list of the notebooks, files, and subdirectories of the directory\nwhere the notebook server was started.\n\nIf Jupyter Notebooks are used with Virtualenvm, the Jupyter Widget JavaScript\nlibrary needs to be installed and enabled, using the following commands:\n\n pip install ipywidgets\n jupyter nbextension enable --py widgetsnbextension --sys-prefix\n\n## Dependencies\n\nDependencies for the ccd tools are listed in the file\n[requirements.txt](requirements.txt). When pip is used, all requirements can be\ninstalled using:\n\n\tpip install -r requirements.txt\n\nAdditional requirements to build the documentation can be found in the file\n[requirements_doc.txt](requirements_doc.txt), and can be installed using:\n\n\tpip install -r requirements_doc.txt\n\nOn Debian Linux systems, the following Python packages are required to run the\nCole-Cole decomposition routines:\n\n\tnumpy\n\tscipy\n\tmatplotlib\n\tgeccoinv\n\tsip_models\n\nIn order to build the documentation, the additional packages are required: ::\n\n\tsphinx\n\nUnder Debian-related Linux systems, these packages can be installed using the\ncommands:\n\n sudo apt-get install texlive-latex-base texlive-latex-extra\\\n texlive-fonts-recommended texlive-fonts-extra dvipng\n sudo apt-get install python2.7-numpy python-matplotlib python2.7-scipy\\\n python-setuptools python-nose python-tornado\n\nIn order to build the documentation, the following sphinx-related packages must\nbe installed:\n\n sudo apt-get install python-sphinx\n sudo apt-get install python-sphinx python-sphinxcontrib.blockdiag\n pip install sphinxcontrib-programoutput\n\n\ngeccoinv and sip_models have to be installed according to their own documentation.\n\nUnder Windows, the program was tested using the 'pythonxy' distribution\n(https://code.google.com/p/pythonxy/).\n\n## Licence\n\nThis program is licenced under the GPL3 or later licence. See LICENCE.txt and\nheaders of individual files for more information.\n\nSome third-party packages used for the homepage (gh-pages branch) have\nindividual licences.\n",
"bugtrack_url": null,
"license": "GPL-3",
"summary": "Time-lapse Cole-Cole decomposition routines",
"version": "0.8.18",
"project_urls": {
"Homepage": "https://github.com/m-weigand/ccd_tools"
},
"split_keywords": [
"sip",
" cole-cole model",
" debye decomposition",
" cole-cole decomposition"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bfe690d64e9a4ef81f4c3ba433480af656ab72ee5d68843c265495f34f7edd5f",
"md5": "45f0b6405f1ed9505efce09f7878be37",
"sha256": "af876a6bdc63e670d0aff7bb90ca503982edcb6da28849fa7ef0a95c3b2a2cb4"
},
"downloads": -1,
"filename": "ccd_tools-0.8.18.tar.gz",
"has_sig": false,
"md5_digest": "45f0b6405f1ed9505efce09f7878be37",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 76151,
"upload_time": "2024-06-04T06:33:32",
"upload_time_iso_8601": "2024-06-04T06:33:32.593243Z",
"url": "https://files.pythonhosted.org/packages/bf/e6/90d64e9a4ef81f4c3ba433480af656ab72ee5d68843c265495f34f7edd5f/ccd_tools-0.8.18.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-04 06:33:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "m-weigand",
"github_project": "ccd_tools",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "ccd-tools"
}
JSON
