Read functions for NASCAM ASI raw files
Project description
NASCAM All-Sky Imager Raw PGM Data Readfile
Python library for reading NASCAM All-Sky Imager (ASI) stream0 raw PNG-file data. The data can be found at https://data.phys.ucalgary.ca.
Supported Datasets
- NASCAM ASI raw: stream0.png PNG files
Installation
The nascam-imager-readfile library is available on PyPI:
$ python3 -m pip install nascam-imager-readfile
Supported Python Versions
nascam-imager-readfile officially supports Python 3.8+.
Examples
Example Python notebooks can be found in the "examples" directory. Further, some examples can be found in the "Usage" section below.
Usage
Import the library using import nascam_imager_readfile
Warning: On Windows, be sure to put any read
calls into a main()
method. This is because we utilize the multiprocessing library and the method of forking processes in Windows requires it. Note that if you're using Jupyter or other IPython-based interfaces, this is not required.
Read a single file
>>> import nascam_imager_readfile
>>> filename = "path/to/data/2010/01/01/atha_nascam-iccd04/ut06/20100101_0600_atha_nascam-iccd04.png.tar"
>>> img, meta, problematic_files = nascam_imager_readfile.read(filename)
Read multiple files
>>> import nascam_imager_readfile, glob
>>> file_list = glob.glob("path/to/files/2010/01/01/atha_nascam-iccd04/ut06/*.tar")
>>> img, meta, problematic_files = nascam_imager_readfile.read(file_list)
Read using multiple worker processes
>>> import nascam_imager_readfile, glob
>>> file_list = glob.glob("path/to/files/2010/01/01/atha_nascam-iccd04/ut06/*.tar")
>>> img, meta, problematic_files = nascam_imager_readfile.read(file_list, workers=4)
Read with no output
>>> import nascam_imager_readfile, glob
>>> file_list = glob.glob("path/to/files/2010/01/01/atha_nascam-iccd04/ut06/*.tar")
>>> img, meta, problematic_files = nascam_imager_readfile.read(file_list, workers=4, quiet=True)
Development
Clone the repository and install dependencies using Poetry.
$ git clone https://github.com/ucalgary-aurora/nascam-imager-readfile.git
$ cd nascam-imager-readfile/python
$ make install
Testing
$ make test
[ or do each test separately ]
$ make test-flake8
$ make test-pylint
$ make test-pytest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nascam_imager_readfile-1.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8fac2cb7bb3874f4b69bde14379deebee9849e952e95f21e1389fa6d0fff8fbc |
|
MD5 | 057c58c4d8a31ad09b60a60879a63945 |
|
BLAKE2b-256 | 41f26c95c1a7ad9e5bb84cbb2e49c4f41d76b48dac459722605acfbfce7f96f8 |
Hashes for nascam_imager_readfile-1.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0fed3ee67e197522638c2b3747ee41a5a1d71641fb574ca67e95e36e57d7a905 |
|
MD5 | acb39ff435ca2a7cdf3f8371bae73f1d |
|
BLAKE2b-256 | 11b5adddd116e2a3a667a9e37a46f3f59d509271a907721edc8308b2bb425b35 |