gsd python package

GSD provides an optional python API. This is the most convenient way for users to read and write GSD files. Developers, or users not working with the python language, may want to use the C API.

Package contents

The GSD main module

The main package gsd is the root package. It holds submodules and does not import them. Users import the modules they need into their python script:

import gsd.fl
f = gsd.fl.GSDFile('filename', 'rb');
gsd.__version__

str – GSD software version number. This is the version number of the software package as a whole, not the file layer version it reads/writes.

Logging

All python modules in GSD use the python standard library module logging to log events. Use this module to control the verbosity and output destination:

import logging
logging.basicConfig(level=logging.INFO)

See also

Module logging
Documenation of the logging standard module.