Read ACQ file types
Project description
Read EDGES ACQ spectrum files.
Installation
In a new/existing python environment, run pip install git+https://github.com/edges-collab/read_acq.
If you wish to develop read_acq, do the following:
git clone https://github.com/edges-collab/read_acq cd read_acq pip install -e .
Usage
read_acq can be used in a Python interpreter or directly via the command line.
CLI
To use the CLI, a single command is provided:
acq convert <data.acq> [<data2.acq> …] [-f format1 [-f format2]]
This will convert the file(s) provided to all formats provided, and place any resulting files in the same location as the original datafile(s) (but with different extension). The default format is ‘mat’. The command can be run from anywhere on the system, and the file given can be a relative or absolute path.
Multiple data files can be given, and each will be converted. Wildcards may also be used in any of the filenames, eg.:
acq convert data/*.acq
Library
The main point of entry for the Python interface is decode_file:
>>> from read_acq import decode_file
>>> data = decode_file("my_data.acq", write_formats=[])
By default, this function will also write the file in .mat format, but you can turn that off by providing write_formats=[]. The output is a numpy array of the data. Several more options are provided, use help(decode_file) in an interpreter to see all the options.
Changelog
0.4.4 [04.June.2021]
Fixed
HDF5 to ACQ converter now works.
0.4.0
First version on PyPI!
Fixed
Frequency array now has the correct channel width (it was ever so slightly off).
Changed
decode_file now only decodes the file, rather than writing. Use convert_file to convert a file to a different format.
0.3.2
Fixed
Errors in writing out files (now have tests)
0.3.1
Fixed
Error reading fastspec header due to first VERSION line.
0.3.0 [27.Dec.2019]
Added
Ability to read in new fastspec header
New format: npz
Ability to save all metadata
Changed
Structure of the code is now class-based and extendible
No longer outputs uncalibrated temperature, but rather the dimensionless ratio, Q
Fixed
Line-incrementing problem when reading
0.2.0
Added
HDF5 output format
Ability to specify output format via CLI
Metadata to outputs
Fixed
Removed warnings when dividing by zero
Installation without numpy
Progress bar iterations
0.1.0
Initial version that reads ACQ into memory.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
