https://github.com/beforerr/dmsp_elfin

https://github.com/beforerr/dmsp_elfin

Science Score: 26.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.5%) to scientific vocabulary
Last synced: 11 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: Beforerr
  • License: mit
  • Language: Julia
  • Default Branch: main
  • Size: 132 KB
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 25
  • Releases: 0
Created about 1 year ago · Last pushed 11 months ago
Metadata Files
Readme License

README.md

DMSP-ELFIN Conjunction Finder [WIP]

This tool identifies conjunction events between DMSP and ELFIN satellites based on their MLT (Magnetic Local Time) and MLAT (Magnetic Latitude) values.

What is a Conjunction Event?

A conjunction event is defined when: - The absolute difference in MLT between DMSP and ELFIN is less than a threshold d₁ - The absolute difference in MLAT between DMSP and ELFIN is less than a threshold d₂ - This condition persists for at least Tₘᵢₙ seconds

Usage

Basic Usage

bash julia conjunction_finder.jl --dmsp path/to/dmsp_data.gz --elfin path/to/elfin_data.csv

Generate Sample Data

If you don't have real ELFIN data available, you can generate sample data based on DMSP data:

bash julia conjunction_finder.jl --generate-sample

Full Options

bash julia conjunction_finder.jl --dmsp path/to/dmsp_data.gz \ --elfin path/to/elfin_data.csv \ --mlt-threshold 0.5 \ --mlat-threshold 2.0 \ --min-duration 60 \ --output conjunction_events.csv

Input Data Format

DMSP Data

See DMSP notebook

ELFIN Data

See ELFIN notebook

Output

The script produces: 1. A CSV file with conjunction events (start time, end time, duration) 2. A JSON file with summary statistics 3. Plot images for each conjunction event showing MLT and MLAT values

Example

```bash

Download DMSP data and find conjunctions with generated ELFIN data

julia conjunction_finder.jl --dmsp https://www.ncei.noaa.gov/data/dmsp-space-weather-sensors/access/f17/ssj/2022/10/j5f1722288.gz --generate-sample --mlt-threshold 0.3 --mlat-threshold 1.5 --min-duration 120 ```

This will: 1. Download DMSP data from the specified URL 2. Generate sample ELFIN data based on the DMSP data 3. Find conjunction events where MLT difference < 0.3 hours and MLAT difference < 1.5 degrees 4. Only include events lasting at least 120 seconds 5. Save results to conjunctionevents.csv and conjunctionstats.json 6. Create plots for each conjunction event in the plots/ directory

Project Structure

  • conjunction_finder.jl: Main script for finding conjunctions
  • run.sh: Convenience script to run the conjunction finder

Archive files:

  • DMSPReader.jl: Module for reading DMSP SSJ data files

Owner

  • Name: Beforerr
  • Login: Beforerr
  • Kind: user

GitHub Events

Total
  • Delete event: 1
  • Issue comment event: 1
  • Push event: 9
  • Pull request event: 19
  • Create event: 22
Last Year
  • Delete event: 1
  • Issue comment event: 1
  • Push event: 9
  • Pull request event: 19
  • Create event: 22

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 12
  • Total Committers: 1
  • Avg Commits per committer: 12.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 12
  • Committers: 1
  • Avg Commits per committer: 12.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Beforerr z****8@g****m 12

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total 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
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
Top Authors
Issue Authors
Pull Request Authors
  • github-actions[bot] (13)
  • dependabot[bot] (1)
Top Labels
Issue Labels
Pull Request Labels
dependencies (1) github_actions (1)

Dependencies

.github/workflows/CI.yml actions
  • actions/checkout v4 composite
  • julia-actions/cache v2 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/julia-runtest v1 composite
  • julia-actions/setup-julia v2 composite
.github/workflows/CompatHelper.yml actions
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite