# O2sclpy: v0.925a1¶

O2sclpy: A high-level plotting script, o2graph, for quick matplotlib or yt plots for use with the O2scl C++ library and a set of python classes for convenient plotting.

Warning

This python library is experimental and still under development.

The main objects of interest are the O2graph script, and the classes o2sclpy.cloud_file, o2sclpy.hdf5_reader, and o2sclpy.plotter .

## Installation and Requirements¶

O2sclpy can be installed with e.g. pip3 install o2sclpy. If you want to install the development version (v0.925a1), you can clone the git repository, change directory to the O2sclpy directory, and then use e.g. pip3 install . if you want to use the pip package manager or python3 setup.py install to do a direct installation. O2sclpy requires python3 packages requests, h5py, numpy, and matplotlib. O2sclpy also assumes LaTeX is installed on your system.

The O2graph script requires an installation of O2scl. The release version, O2sclpy 0.924, requires the O2scl v0.924 release from <https://github.com/awsteiner/o2scl/releases/tag/v0.924> and the development version, O2sclpy 0.925a1, requires that the most recent version of O2scl from the master branch on github is installed on your machine.

The O2graph script attempts to dynamically load the O2scl libraries libo2scl and libo2scl_hdf using python’s ctypes module. If it cannot find them, you may need to use the argument -o2scl-libdir to specify the proper directory. If you’re on OSX and using GCC, the script must load the C++ library first, and if necessary you can specify its location with the argument -o2scl-cpplib (on my OSX laptop this is -o2scl-cpplib /usr/local/lib/gcc/9/libstdc++.dylib).