pypamguard 1.0.0

A package for processing PAMGuard binary file outputs in Python.

pypamguard is a package for processing PAMGuard binary file outputs in Python.

• PyPI: https://pypi.org/project/pypamguard/
• GitHub: https://github.com/PAMGuard/pypamguard
• Documentation: https://www.pamguard.org/pypamguard/
• Website: https://www.pamguard.org/

Installation

pip install pypamguard

Getting Started

Example of loading in a simple PAMGuard data file into Python.

import pypamguard
df = pypamguard.load_binary_data_file('path/to/data/file.pgdf')

Then, for example, you can print out the file header like so.

print(df.file_header) # File header
print(df.file_header.version) # File version

Modules also have a module_header, module_footer, file_footer, and most importantly data. The data chunks are stored in an array data, and can be accessed with index notation or a loop.

print("File length", len(df.data)) # Number of module data chunks
first_obj = df.data[0] # First module data chunk
for chunk in df.data: # Looping through the data
    print(chunk.identifier)

For more information, see the documentation.

Bugs/Requests

Please use the Github issue tracker to submit bugs or feature requests.

License

This software is distributed under the terms of the MIT license. pypamguard is free and open source.

Contributing

Check CONTRIBUTING.md to get started.