Note
Users will need an installation of Python (v3.6 or greater). It’s highly recommended that users download an Anaconda distribution of Python. Anaconda is a package distribution of Python that includes many widely used libraries as well as the Spyder IDE for editing and compiling code. Anaconda is free for individuals.
The easiest way to install sensortoolkit is via pip
. Open up a command line interface (for Anaconda users,
the Anaconda Prompt is recommended) and type the following command:
pip install sensortoolkit
sensortoolkit is developed and maintained in a USEPA GitHub repository. The latest development build can be obtained by cloning the repository:
git clone https://github.com/USEPA/sensortoolkit.git
Next, navigate to the folder location for the cloned repository:
cd path/to/sensortoolkit
Next, sensortoolkit needs to be installed to a target directory where python
looks for packages whenever the user tells python to import a package name.
By default, this is the /site-packages
directory, and should be located at a
path that looks something like C:\Users\...\Anaconda3\Lib\site-packages
(if you have Anaconda installed). The location of this package may be a little
different depending on how your python installation was configured, although this
shouldn't matter too much.
Type the following CLI prompt to install sensortoolkit (don't forget the period!):
pip install .
The installation process checks for several packages sensortoolkit needs to run (dependencies). If you have Anaconda installed, you'll notice that the installation process may indicate that a lot of the required libraries are already installed as those packages come with the base installation of Anaconda.
If you've installed sensortoolkit using the installing with pip instructions listed above, updating your installation is equally as easy!
Open a command line interface and type the following:
pip install --upgrade sensortoolkit
Tip
If you wish to upgrade to a specific version of sensortoolkit, this can be done via the following command:
pip install --upgrade sensortoolkit==X.X.X
where X.X.X is replaced by the version you would like to install.
If you cloned the GitHub repository, first, open a command line interface and change directories to the folder containing your cloned version of the sensortoolkit repository:
cd path/to/sensortoolkit
Next, install available updates via a 'git pull' command:
git pull
remote: Enumerating objects: 4141, done.
remote: Counting objects: 100% (4141/4141), done.
remote: Compressing objects: 100% (690/690), done.
remote: Total 3747 (delta 3334), reused 3396 (delta 3044), pack-reused 0
Receiving objects: 100% (3747/3747), 7.86 MiB | 487.00 KiB/s, done.
Resolving deltas: 100% (3334/3334), completed with 362 local objects.
From https://github.com/USEPA/sensortoolkit.git
e5aed929..026ee1c2 master -> origin/master
Updating files: 100% (559/559), done.
Updating e5aed929..026ee1c2
Fast-forward
[A log of various files in the source code that have been modified in the current dev. package]