Mac OS X¶

The recommended way to install GWpy on Mac OS X is to install the dependencies via MacPorts.

Follow these instructions to install the MacPorts package on your Mac, then execute the following command to install the required dependencies for GWpy:

sudo port install python27 python_select py27-numpy py27-scipy py27-matplotlib +latex +dvipng texlive-latex-extra py27-astropy glue
sudo port select --set python python27

You can also run the following to install a number of optional dependencies - packages that, when present, enhance the functionality of GWpy:

sudo port install py27-ipython nds2-client kerberos5 py27-pykerberos py27-h5py lal lalframe

Once you have at least the required dependencies installed, you can install GWpy using pip.

Linux¶

The GWpy package has the following build-time dependencies (i.e. required for installation):

• glue >= 1.48
• python-dateutil
• NumPy >= 1.5
• SciPy >= 0.16
• Matplotlib >= 1.3.0
• Astropy >= 1.0

You should install these packages on your system using the instructions provided by their authors.

You can also install the following optional dependencies - packages that, when present, enhance the functionality of GWpy:

• lal and lalframe (same URL)
• NDS2 (including SWIG-wrappings for python)

Once you have at least the required dependencies installed, you can install GWpy using pip.

Pip¶

The easiest way to install GWpy is to use pip. You can install pip very easily with MacPorts and most linux-based package managers.

Once you have pip installed:

pip install --pre --user gwpy

Currently, GWpy is only in a pre-release phase, and so pip requires the --pre option to install GWpy. The --user option tells the installer to copy codes into the standard user library path, on linux machines this is

~/.local/lib

while on Mac OS this is

~/Library/Python/X.Y/lib

where X.Y is the python major and minor version numbers, e.g. 2.7. For either operating system, python will automatically know about these directories, so you don’t have to fiddle with any environment variables.

GitHub¶

Any user can install the latest development version of GWpy by directing pip to the GWpy GitHub repository:

pip install --user git+https://github.com/gwpy/gwpy

Source¶

The source code for GWpy is under git version control, hosted by http://github.com. You can clone the repository from the Terminal as follows:

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

You can then, if you wish, install the package by running the setup.py script as follows:

cd gwpy
pip install -r requirements.txt
pip install .

ValueError: unknown locale: UTF-8

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

setenv LANG en_US.UTF-8
setenv LC_ALL en_US.UTF-8