Johns Hopkins Turbulence Databases

Using JHTDB with Python


Python code: directly from here or

This downloads a directory with sample IPython Notebook code in the examples folder that illustrate the basic functionality of the interface. Choose one of the following to use the pyJHTDB package.
Please see the README file for more information.

Use through SciServer (RECOMMENDED)

The SciServer is a cloud-based data-driven cluster, of The Institute for Data Intensive Engineering and Science (IDIES) at Johns Hopkins University. Users get the advantages of more reliable and faster data access since the SciServer is directly connected to JHTDB through a 10 Gigabit ethernet connection. SciServer provides docker containers with the pyJHTDB library pre-installed.

To use pyJHTDB through Sciserver:

Login to SciServer (may need to create a new account first).
Click on Compute and then Create container (You could also run jobs in batch mode, by selecting Compute Jobs).
Type in Container name, select JH Turbulence DB in Compute Image and then click on Create.
Click on the container you just created, then you could start using pyJHTDB with Python or IPython Notebook.

Examples of using pyJHTDB could be found at Please go to for more information on SciServer as well as the help on Sciserver.

Use on local computers

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

Installing from source

In terminal:

cd /path/to/your/folder/
git clone
cd pyJHTDB
pip install --upgrade ./

Note that doing this should update pyJHTDB and all the required packages, including numpy, scipy, sympy, h5py and matplotlib.
Disclaimer: While many efforts have been made to ensure that these data are accurate and reliable within the limits of the current state of the art, neither JHU nor any other party involved in creating, producing or delivering the website shall be liable for any damages arising out of users' access to, or use of, the website or web services. Users use the website and web services at their own risk. JHU does not warrant that the functional aspects of the website will be uninterrupted or error free, and may make changes to the site without notice.

Last update: 12/2/2019 3:14:44 PM