Installing overreact
The recommended way of installing the package is from the command line using pip:
$ pip install overreact
✏️ You may need to call
pip3
instead ofpip
.
The above command will install a minimal set of features. If you plan to use
the command-line interface, you have to specify the cli
extra feature:
$ pip install overreact[cli]
💡 If you would like to use automatic differentiation (through Google's JAX library) instead of the default numerical differentiation, you have to specify the
fast
extra feature as well:$ pip install overreact[cli,fast]
Dependencies
overreact depends on:
cclib
(parser for computational chemistry logfiles).- SciPy (numerical integration, optimization, unit conversion and others).
✏️ Don't worry, these dependencies are automatically installed when you install overreact using
pip
as indicated above.
As stated above, extra functionality is provided such as a command-line interface. If you would like to install the full set of supported features, you can specify the following extra flags:
$ pip install overreact[cli,fast]
The line above installs Rich (used in the command-line interface) and JAX (speeds up calculations) as well.
⚠️ An extra
solvents
flag is available that adds some solvent properties by means of the thermo library. It is not fully integrated into the package yet: it is meant to provide, in the future, dynamic viscosities for solvents in the context of the Collins-Kimball theory for diffusion-limited reactions (Journal of Colloid Science, 1949, 4, 425–437; Industrial & Engineering Chemistry, 1949, 41, 2551–2553). Stay tuned and, if you are interested, let's discuss it!
Troubleshooting
Can't install overreact: pip: command not found
or similar
You may need to install pip on your system.
💡 The pip developers have provided an excellent installation guide for you.
Can't run overreact: overreact: command not found
or similar
If you get this error, two things could be happening:
1️⃣ You haven't properly installed the package.
To fix this first problem, take a look at
a previous section.
If you're running a Unix, you can check if the package is installed by running
pip list | grep overreact
:
$ pip list | grep overreact
overreact 1.1.0
Alternatively, you can try to import the package directly from Python:
$ python
Python 3.9.7 (default, Sep 10 2021, 14:59:43)
[GCC 11.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import overreact
>>> overreact.__version__
'1.1.0'
2️⃣ You are missing the overreact
command in your PATH
.
To fix this, you have to add the pip executable directory (i.e. the place where
pip puts executables during installation) to your PATH
. For example, if you
installed overreact using pip install overreact
as indicated above, the
overreact executable will be inside ~/.local/bin
.
This can be solved by adding the following line to your ~/.bashrc
file (or
~/.zshrc
if you use zsh):
export PATH="$HOME/.local/bin:$PATH"
💡 Read more about
PATH
on the Unix & Linux Stack Exchange.