Read functions for REGO ASI PGM raw files
Project description
Redline All-Sky Imager Raw PGM Data Readfile (REGO)
Python library for reading REGO All-Sky Imager (ASI) stream0 raw PGM-file data. The data can be found at https://data.phys.ucalgary.ca.
Supported Datasets
- REGO raw: stream0 PGM files
Installation
The rego-imager-readfile library is available on PyPI:
$ python3 -m pip install rego-imager-readfile
Supported Python Versions
rego-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 rego_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 rego_imager_readfile
>>> filename = "path/to/data/2020/01/01/fsmi_rego-654/ut06/20200101_0600_fsmi_rego-654_6300.pgm.gz"
>>> img, meta, problematic_files = rego_imager_readfile.read(filename)
Read multiple files
>>> import rego_imager_readfile, glob
>>> file_list = glob.glob("path/to/files/2020/01/01/fsmi_rego-654/ut06/*6300.pgm*")
>>> img, meta, problematic_files = rego_imager_readfile.read(file_list)
Read using multiple worker processes
>>> import rego_imager_readfile, glob
>>> file_list = glob.glob("path/to/files/2020/01/01/fsmi_rego-654/ut06/*6300.pgm*")
>>> img, meta, problematic_files = rego_imager_readfile.read(file_list, workers=4)
Development
Clone the repository and install dependencies using Poetry.
$ git clone https://github.com/ucalgary-aurora/rego-imager-readfile.git
$ cd rego-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 rego_imager_readfile-1.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 74118402945f343ebb95a2e899f060f2b6bfe824b1355c7ef68ef2090338dcbb |
|
MD5 | 9346c6637fe517072e3d6c957c2ae1b5 |
|
BLAKE2b-256 | 46f022eb89c72722c91539dbcc422266390e9fbf689cf807bb9f040dfd7a5a9a |
Hashes for rego_imager_readfile-1.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de95a18bc31247a1907f826b356714cea122c5fdd226276e0d4e3ef62a5f100b |
|
MD5 | c017fa703850cb2bfcbb5203dcaa0c31 |
|
BLAKE2b-256 | b6bdf3b49e0cb1c73671ee5fb3e9ff5b607e4c28d7a0a1f6b25405db44d0bfe3 |