Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Python wrapper for the Johns Hopkins turbulence database library

Project description

Python wrapper for the JHU Turbulence Database Cluster library. More information can be found at

Installing pypi version

If you have pip, you can simply do this:

pip install pyJHTDB

If you’re running unix (i.e. some MacOS or GNU/Linux variant), you will probably need to have a sudo in front of the pip command. If you don’t have pip on your system, it is quite easy to get it following the instructions at

Cutout/local data functionality

If you want to use the cutout functionality, you will need to install h5py before you install pyJHTDB, with:

pip install h5py

If you would like to use the local data functionality, you will need a full installation of the HDF5 libraries, see for instructions.

Installing from source

ubuntu 14.04

Bare-bone installation:

sudo apt-get install build-essential gfortran
sudo apt-get install python-setuptools
sudo apt-get install python-dev
sudo easy_install numpy
sudo python install

Note that doing this should, in principle, also install sympy on your system, since it’s used by pyJHTDB.

Happy fun installation:

sudo apt-get install build-essential gfortran
sudo apt-get install python-setuptools
sudo apt-get install python-dev
sudo apt-get install libpng-dev libfreetype6-dev
sudo apt-get install libhdf5-dev
sudo easy_install numpy
sudo easy_install h5py
sudo easy_install matplotlib
sudo python install

I haven’t tested the installation on any other system, but I think reasonable variations on the above should work for the minimal installation on all unix systems (i.e. for MacOS as well). If you manage to get it working (i.e. you import test_plain like the README says and you can run it), please let me know what steps you needed to take for your system, so I can append the instructions to this file.

Basic usage

On first contact with this library, we recommend that you first run test_plain. To be more specific:

from pyJHTDB import test_plain

The code that is executed can be found in “pyJHTDB/”, and it’s the simplest example of how to access the turbulence database.


While our service is open to anyone, we would like to keep track of who is using the service, and how. To this end, we would like each user or site to obtain an authorization token from us: For simple experimentation, the default token included in the package should be valid.

If you do obtain an authorization token, please write it in the file auth_token.txt, in the folder .config/JHTDB from your home folder. This folder should be generated automatically upon first importing the package.

The .config/JHTDB folder is also used to store data used by the pyJHTDB.interpolator.spline_interpolator class, including shared libraries. If you do not plan on using the local interpolation functionality, no data files will be generated.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyJHTDB-20180607-cp27-cp27m-macosx_10_6_x86_64.whl (329.5 kB) Copy SHA256 hash SHA256 Wheel 2.7 Jun 7, 2018
pyJHTDB-20180607.tar.gz (282.1 kB) Copy SHA256 hash SHA256 Source None Jun 7, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page