pvcaptest is an open source python package created to facilitate capacity testing following the ASTM E2848 standard. The captest module contains a single class, CapData, which provides methods for loading, visualizing, filtering, and regressing capacity testing data. The module also includes functions that take CapData objects as arguments and provide summary data and capacity test results.
Documentation and examples are available on readthedocs including full examples in jupyter notebooks that can be run in the browser without installing anything.
These instructions assume that you are new to using conda and python, if that is not the case skip to the last section for users familiar with conda and pip.
The recommended method to install pvcaptest is to create a conda environment for pvcaptest. Installing Anaconda or miniconda will install both python and conda. There is no need to install python separately.
conda install -c conda-forge pvcaptestand pressing enter. The
-c conda-forgeoption tells conda to install pvcaptest from the conda forge channel.
This will install the pvcaptest package in the base environment created when Anaconda is installed. This should work and provide you with jupyter notebook and jupyer lab to run pvcaptest in. If you think you will use your Anaconda installation to create and maintain additional environments, the following process for creating a stand alone option is likely a better option.
Better long term option:
environment.ymlfile. Click the green code button and click 'Download ZIP'.
environment.ymlfile to the folder identified by the path from the previous step.
conda env create -f environment.yml
yenter to proceed and wait for conda to finish installing pvcaptest and the other packages.
conda activate captest_env.
The environment created will include jupyter lab and notebook for you to use pvcaptest in. You can start these using the commands
jupyter lab or
See the conda documentation for more details on using conda to create and manage environments.
Conda install into an existing environment:
conda install -c conda-forge pvcaptest
If you prefer, you can pip install pvcaptest, but the recommended approach is to use the conda package.
Note: The conda package is named pvcaptest and the pip package is named captest. The project is moving to consistent use of the pvcaptest name, but the package name on pypi will remain as captest.