There basically three different methodologies for the installation. You should choose the one, which is the most appropriate solution concerning your skills and your usage:

The recommended installation

We recommend to use anaconda for installing python and psyplot (see :ref:`install-conda`). If you however already have python installed on your system, you can also use pip (see :ref:`install-pip`).

The developer installation

Install it from source (see :ref:`install-source`)

We highly recommend to use conda for installing psyplot. After having downloaded the miniconda installer, you can install psyplot and the optional plugins (see :ref:`optional_deps`) via:

$ conda install -c conda-forge psy-view psy-reg

If you only want to install the core, i.e. the raw framework, run:

$ conda install -c conda-forge psyplot

If you want to be able to read GeoTiff Raster files, you will need to have gdal installed:

$ conda install gdal

Please also visit the xarray installation notes for more informations on how to best configure the xarray package for your needs.

If you do not want to use conda for managing your python packages, you can also use the python package manager pip and install via:

$ pip install psyplot

However to be on the safe side, make sure you have the :ref:`dependencies` installed.

To install it from source, make sure you have the :ref:`dependencies` installed, clone the github repository via:

git clone https://github.com/psyplot/psyplot.git

and install it via:

python setup.py install

Psyplot supports officially python 3.6 and 3.7. Previous versions are also available for python 2.7. Furthermore the package is built upon multiple other packages, mainly

• xarray>=0.8: Is used for the data management in the psyplot package
• matplotlib>=1.4.3<3.1: The python visualiation package
• PyYAML: Needed for the configuration of psyplot
• docrep: A package for efficient documentation processing for large APIs
• funcargparse: A package to create command line parsers from function docstrings

We furthermore recommend to use

• :ref:`psyplot-gui <psyplot_gui:install>`: A graphical user interface to psyplot
• :ref:`psy-view <psy_view:install>`: An ncview-like interface based on psyplot and psy-maps
• :ref:`psy-simple <psy_simple:install>`: A psyplot plugin to make simple plots
• :ref:`psy-maps <psy_maps:install>`: A psyplot plugin for visualizing data on a map
• :ref:`psy-reg <psy_reg:install>`: A psyplot plugin for visualizing fits to your data

We us pytest to run our tests. So you can either run clone out the github repository and run:

$ python setup.py test

or install pytest by yourself and run:

$ py.test

To also test the plugin functionality, install the psyplot_test module in tests/test_plugin via:

$ cd tests/test_plugin && python setup.py install

and run the tests via one of the above mentioned commands.

To build the docs, check out the github repository and install the requirements in 'docs/environment.yml'. The easiest way to do this is via anaconda by typing:

$ conda env create -f docs/environment.yml
$ source activate psyplot_docs

Then build the docs via:

$ cd docs
$ make html

conda create -n py37 python=3.7
source activate py37
conda install notebook ipykernel
ipython kernel install --user

The uninstallation depends on the system you used to install psyplot. Either you did it via :ref:`conda <install-conda>` (see :ref:`uninstall-conda`), via :ref:`pip <install-pip>` or from the :ref:`source files <install-source>` (see :ref:`uninstall-pip`).

Anyway, if you may want to remove the psyplot configuration files. If you did not specify anything else (see :func:`psyplot.config.rcsetup.psyplot_fname`), the configuration files for psyplot are located in the user home directory. Under linux and OSX, this is $HOME/.config/psyplot. On other platforms it is in the .psyplot directory in the user home.

If you installed psyplot via :ref:`conda <install-conda>`, simply run:

conda remove psyplot

or, if you installed it into an own conda environment, remove the environment via:

conda env remove -n <environment-name>

Uninstalling via pip simply goes via:

pip uninstall psyplot

Note, however, that you should use :ref:`conda <uninstall-conda>` if you also installed it via conda.