Python package to unpack and calibrate binary data from a WetLabs ACS
The pyACS package can be installed directly with python's package manager.
pip install pyACS
pyACS can also be installed from the sources available at GitHub repository.
python setup.py install
Note that the only default dependency is numpy. Installing the library SciPy in addition will improve performances.
pip install scipy
pyACS can be used from a terminal to convert binary files recorded with Compass software to CSV files.
python -m pyACS [-h] [-v] [--version] [-aux] device_file bin_file [destination]
positional arguments: device_file Device file. bin_file Source file to decode and calibrate (.bin). destination Destination file of decoded and calibrated data.
optional arguments: -h, --help Show this help message and exit -v, --verbose Enable verbosity. --version Prints version information. -aux, --auxiliaries Output auxiliary data (internal and external temperatures).
The class ACS
provides key methods to handle the binary ACS data
read_device_file
: Parse device file to be able to unpack and calibrate binary framefind_frame
: Find registered ACS frames in bytearrayunpack_frame
: Unpack/Decode a binary frame into named tupleFrameContainer
calibrate_frame
: Convert a frame engineering units (counts) into scientific units (1/m for a and c)
The classes BinReader
and ConvertBinToCSV
are an illustration of the usage of the ACS class to parse binary files recorded with Compass software (.bin).