.. _installation:
************
Installation
************
There are several different ways to install the ``asdf`` package. Each is
described in detail below.
Requirements
============
The ``asdf`` package has the following dependencies:
- `python `__ 3.5 or later
- `numpy `__ 1.10 or later
- `jsonschema `__ 3.0.2 or later
- `pyyaml `__ 3.10 or later
- `semantic_version `__ 2.8 or later
Support for units, time, transform, wcs, or running the tests also
requires:
- `astropy `__ 3.0 or later
Optional support for `lz4 `__
compression is provided by:
- `lz4 `__ 0.10 or later
Installing with pip
===================
.. include:: ../../README.rst
:start-after: begin-pip-install-text
:end-before: begin-source-install-text
Installing with conda
=====================
ASDF is also distributed as a `conda `__ package via
the `conda-forge `__ channel. It is also available
through the `astroconda `__
channel.
To install ``asdf`` within an existing conda environment::
$ conda install -c conda-forge asdf
To create a new conda environment and install ``asdf``::
$ conda create -n new-env-name -c conda-forge python asdf
Building from source
====================
.. include:: ../../README.rst
:start-after: begin-source-install-text
:end-before: end-source-install-text
Running the tests
=================
.. include:: ../../README.rst
:start-after: begin-testing-text
:end-before: end-testing-text