Data

Tools

Indexes

Applications

Experiments

Open Source Science

dascasi

Digital All Sky Camera utilities, for U. Alaska Geophysical Institute cameras

https://github.com/space-physics/dascasi

Science Score: 38.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ○
    codemeta.json file
  • ○
    .zenodo.json file
  • ○
    DOI references
  • ✓
    Academic publication links
    Links to: zenodo.org
  • ✓
    Committers with academic emails
    1 of 8 committers (12.5%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.3%) to scientific vocabulary

Keywords

all-sky-camera aurora camera
Last synced: 6 months ago · JSON representation ·

Repository

Digital All Sky Camera utilities, for U. Alaska Geophysical Institute cameras

Basic Info
  • Host: GitHub
  • Owner: space-physics
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 3.76 MB
Statistics
  • Stars: 2
  • Watchers: 2
  • Forks: 2
  • Open Issues: 0
  • Releases: 15
Topics
all-sky-camera aurora camera
Created about 10 years ago · Last pushed almost 3 years ago
Metadata Files
Readme License Citation

README.md

DASC all-sky camera utilities

image ci PyPi Download stats

Utilities for plotting, saving, analyzing the Poker Flat Research Range Digital All Sky Camera. (Other locations, too). This program handles the corrupted FITS files due to the RAID array failure on 2013 data. The raw data FITS contain one image per file.

DASC projected images (using scripts/PlotProjectedImage.py ) DASC az/el PKR (using scripts/PlotAzimuthElevation.py)

Install

Most people will find it useful to have the example scripts and the tests built into the Git repo.

```sh git clone https://github.com/space-physics/dascasi

pip install -e dascasi ```

Usage

To use the API directly, like:

```python import dascasi as du

data = du.load('tests/PKRDASC055820151007082351.743.FITS') ```

This returns a dictionary of xarray.DataArray, which is like a "smart" Numpy array. The images are indexed by wavelength if it was specified in the data file, or '0000' otherwise. The images are in a 3-D stack: (time, x, y). data.time is the time of each image. also several metadata parameters are included like the location of the camera.

Save the data using lossless compression to HDF5 by

python du.save_hdf5(data, "foo.h5")

Now we give several examples.

Download raw DASC files by time

Download Poker Flat Research Range "PKR" October 7, 2015 from 8:23 to 8:54 UTC to ~/data/:

sh python -m dascasi.download PKR 2015-10-07T08:23 2015-10-07T08:54 ~/data

  • -w four-letter wavelength in nanometers e.g. 0630

As usual, we assume UTC and do NOT specify the timezone.

convert FITS stack to HDF5

It is very tedious to download large amounts of DASC data in single FITS files. We have tried to make this faster by multi-threading the download, but then the FTP server anti-leeching leaves us with broken downloads. As an alternative in general, it's more convenient to have a single HDF5 file for a day rather than 10,000 FITS files. Convert a bunch of FITS files to HDF5 like:

sh python scripts/ConvertDASC_FITS_to_HDF5.py ~/data/2015-10-07 ~/data/2015-10-07.h5

  • -t start stop times to convert

Make movies from DASC raw data files

Play movie of all wavelengths in subplots for files in a directory, for example:

sh python -m dascasi.movie dascasi/tests/

additional options include:

  • -t specify time limits e.g. -t 2014-01-02T02:30 2014-01-02T02:35
  • -w choose only certain wavelength(s)

Spatial registration (plate scale)

To match data from DASC with other instruments, it is vital that the plate scale data user be appropriate for the time and instrument. Calibration data may be downloaded, for other times / instruments please contact UAF-GI.

```python import dascasi as du

data = du.load('dascasi/tests/', azelfn='/path/to/yourcalibrationfile') ```

now data includes data variables az and el, same shape as the image(s), along with camera position in lat lon alt_m.

  • Be sure you know if you're using magnetic north or geographic north
  • Note the calibration date in the filename--was the camera was moved since that date?

In all cases, the end user must manually verify the calibration with sky features such as stars / moon.

Map Projection

A common task in auroral and airglow analysis is to project the image to an imaginary alttiude, that is, as if all the brightness were coming from that altitude. Each wavelength has a distinctive peak emission altitude due to the energies, kinetic reactions and vertical density profiles involved.

It takes considerable time to stretch the image stack pixels to fit a project geographic grid, so this is not enabled by default. It will be enabled if the du.load(..., wavelengthaltitudekm=) parameter is used. See PlotProjectedImage.py for an example.

Some analyses can be done far more rapidly by just projecting pixel(s) of interest rather than an entire 3-D image stack.

Owner

  • Name: Space Physics
  • Login: space-physics
  • Kind: organization
  • Location: 1 au

Space Physics modeling and analysis

Citation (CITATION) 

https://doi.org/10.5281/zenodo.3471731

GitHub Events

Total
Last Year

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 261
  • Total Committers: 8
  • Avg Commits per committer: 32.625
  • Development Distribution Score (DDS): 0.487
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Michael Hirsch, Ph.D s****n 134
scienceopen s****n 93
michael s****n@n****m 12
Michael H n****y@g****m 10
michael h****7@g****m 8
scivision s****n@n****m 2
aldebaran1 s****k@b****u 1
michael n****y@n****m 1
Committer Domains (Top 20 + Academic)
noreply.github.com: 2 bu.edu: 1 noreply.users.gitlab.com: 1 github.com: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: 3 days
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 2.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
Pull Request Authors
  • aldebaran1 (3)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 62 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 13
  • Total maintainers: 1
pypi.org: dascutils

Utilities for UAF Digital All-Sky Camera: reading and plotting

  • Versions: 13
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 62 Last month
  • Docker Downloads: 0
Rankings
Docker downloads count: 4.3%
Dependent packages count: 10.1%
Average: 18.7%
Forks count: 19.1%
Dependent repos count: 21.6%
Stargazers count: 27.8%
Downloads: 29.4%
Maintainers (1)
scivision
Last synced: 6 months ago