Installation
There are multiple ways to install the PetroFit package. The latest release of PetroFit can be installed from PyPi using the pip install petrofit
command (see the pip section below). To install the latest developer version of PetroFit
, please clone the PetroFit GitHub repository
and install the package (see the for developers section below). There are two recommended ways to install the requirements needed to run the PetroFit package, through
Conda and
Docker.
pip
PetroFit can be installed using pip as follows:
pip install petrofit
Conda
We have included an environment.yml
file for creating a
Conda environment. You can create an
environment as follows:
Step 1: Clone the PetroFit repo and cd
into the cloned repo.
git clone https://github.com/PetroFit/petrofit.git
cd petrofit
Step 2: Create the conda environment.
conda env create -f environment.yml
Step 3: Activate the petrofit
environment.
source activate petrofit
Step 4: Install PetroFit.
python setup.py install
or if installing from pip:
pip install petrofit
Docker
We have included a Docker file as well as a helper script to make the installation of the package as easy as possible. The docker file will create a Jupyter Notebook image which makes creating and running Notebooks possible. To install using the helper script, please follow the instructions below.
Step 1: Clone the PetroFit repo and cd
into the cloned repo.
git clone https://github.com/PetroFit/petrofit.git
cd petrofit
Step 2: Use the helper script to create the new docker image.
python docker.py build
Note
The cloned repo will be mounted when running using the helper script and any changes to the host code will become available in the docker image (notebook restart may be required to import changed version).
Step 3: Start the notebook using the helper script. You can mount a host directory or a list of directories
(separated by space) by adding their paths at the end of the command. The host directories will be mounted under
the mount
directory in the docker image.
python docker.py run [extra_mount_paths]
Important
Please note that this type of mounting is called a bind
which means the changes you make to the mounted virtual
directory will also apply in the host directory on your hard drive.
Step 4: Copy and paste the notebook URL into your internet browser. The link to the notebook home should look like this:
http://127.0.0.1:8888/?token=d020c13d029013c20d0329e6913c5df076d0a4a14e63dc77
Step 5: You can close the server like any other Jupyter notebook server by hitting Ctrl + C
(make sure to have saved your notebook before shutting down the server).
For Developers
For developers, we recommend setting up a conda environment and then using the following to install the developer version:
git clone https://github.com/PetroFit/petrofit.git
cd petrofit
pip install -e .
If you will be contributing to the software, we recommend forking the repository on GitHub first, cloning your forked repository, and then installing the developer version.
Before installing PetroFit, you may need to install the required dependencies. You can do this using the requirements file located in the top directory of the repository. To do so, navigate to the top directory of the PetroFit repository (where the requirements.txt file is located). Then run:
pip install -r requirements.txt
Frozen versions of conda environment files are provided via the petrofit_environments repository.