aurora-scale-sizes
Science Score: 44.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
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (10.3%) to scientific vocabulary
Repository
Basic Info
Statistics
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 1
Metadata Files
README.md
Aurora scale sizes:
A heuristic approach using a combination of gaussian mixture models and existing image processing techniques to get scale-dependent power in aurora. This method has certain advantages over FFT and wavelet methods, but has no mathematical basis. It has adjustable parameters to increase/decrease robustness against noise at the expense of decreased/increased detection of subtle structures.
Advantages:
–No need to assume underlying signal (cf. needing to choose mother wavelet in wavelet transform).
–Adjustable robustness against noise.
–Avoids spurious power at large scales when the structures are actually narrow (cf. FFT methods, where, for example, the FFT of a gaussian pulse gives another gaussian in wavenumber space, where the width in the wavenumber domain is inversely related to the width in the spatial domain; the highest power is still at large scales, even though the structure is narrow).
Disadvantages:
– Computation time.
– There is a slight bias towards finding small scale structures when the range of brightnesses in the image is particularly large, as the more gaussians are fitted in the GMM, the more likely it is that small structures will be identified which are not real structures, but are due to non-uniform edges of larger structures. The de-noising controlled by the optional parameters mitigates this effect, but you should check the output graphically to see whether it is significant.
Usage:
– We recommend sigma clipping images to remove stars prior to using the algorithm, but the de-noising has a good chance of removing them. The algorithm currently doesn't handle NaNs, so replace clipped pixels with a local mean and add some gaussian noise so it blends in.
–The main function is aurora_power. It works best on discrete and bright emissions, but results will be reasonable in other cases. Images are meant to be in Rayleighs; behaviour has not been tested on raw counts.
– To get the metres per pixel: if the field of view (FOV) is $\theta$ radians, and you have NxN pixels in the FOV:
$mpp \approx h\times 1000 \times tan(\frac{\theta}{N})$,
where h is the emission height in km (e.g. 100 km).
– Set mpp_base to something comparable to mpp, say rounded down to the nearest 10 or 5.
– The plotting function gives a quick overview of the output.
Tested on python3.9
Tested with following dependencies:
– numpy 1.24.4
– skimage 0.24.0
– sklearn 1.5.0
– scipy 1.11.3
– matplotlib 3.7.0
Owner
- Login: n-brindley
- Kind: user
- Repositories: 1
- Profile: https://github.com/n-brindley
Citation (CITATION.cff)
# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!
cff-version: 1.2.0
title: aurora-scale-sizes
message: >-
If you use this software, please cite it using the
metadata from this file.
type: software
authors:
- given-names: Nicholas
family-names: Brindley
affiliation: University of Southampton
orcid: 'https://orcid.org/0009-0008-0743-8220'
repository-code: 'https://github.com/n-brindley/aurora-scale-sizes.git'
abstract: >-
A heuristic approach to determining scale-dependent power
in auroral images. It uses a combination of existing image
processing methods and gaussian mixture models.
keywords:
- Aurora
license: MIT
commit: 40297a98817cf1834f2d37d92e76f9190b807904
date-released: '2024-10-31'
GitHub Events
Total
- Release event: 1
- Push event: 34
- Create event: 2
Last Year
- Release event: 1
- Push event: 34
- Create event: 2