determine_equatorial_density_from_uv_measurements

These functions allow to determine the height scale H and density ρ0 values of the jovian plasma sheet (at a specific moon) based on the longitude of the UV footprints (TEB and MAW)

https://github.com/corentinlouis/determine_equatorial_density_from_uv_measurements

Science Score: 54.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
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.5%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

These functions allow to determine the height scale H and density ρ0 values of the jovian plasma sheet (at a specific moon) based on the longitude of the UV footprints (TEB and MAW)

Basic Info
  • Host: GitHub
  • Owner: CorentinLouis
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 197 KB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 1 year ago · Last pushed 11 months ago
Metadata Files
Readme Citation Zenodo

README.md

Determining the Jovian equatorial density from UV measurements of the Galilean moons' footprints

License: MIT DOI

Overview

This pipeline allows the determination of the density $\rho$ and the height scale $H$ of the Jovian equatorial density from the Trans-hemispheric Electron Beam (TEB) and Main Alfvén Wing (MAW) UV spots and the longitudinal separation between them.

The main steps of the pipeline are the following:

  1. We first assume the Plasma Sheet (PS) is aligned with one of the equators (jovicentric, centrifugal, or magnetic). We then assume a plasma sheet height scale $H$, which gives the magnetic field line length values $L$ in the Northern ($LN$) and Southern ($LS$) hemispheres, inside and outside of the PS: $L\text{N in PS}$, $L\text{N out PS}$, $L\text{S in PS}$ and $L\text{S out PS}$.

  2. We assume a plasma density $\rho_0$ at the center of the PS and determine $\rho$, the density along the magnetic field line in the PS, using the following density profile equation:

$\rhoi = \rho0 exp \left( -\sqrt{\frac{(ri - r0)^2 + z_i^2}{H}} \right)$

where $r0$ is the equatorial radius set at the moon's orbital distance, $ri = xi^2+ yi^2$ is the equatorial radial distance, and $z_i$ is the altitude above the equator of the position of the measurement point $i$.

  1. We determine the Alfvén speed $vA$, based on the calculated $\rhoi$ and the magnetic field amplitude $Bi$, using a magnetic field model. From that, we obtain the values of $t\text{TEB}$, $t\text{MAW}$, $\lambda\text{TEB}$, $\lambda\text{MAW}$, and therefore $\Delta \lambda\text{calculated}$.

  2. By applying this method to different values of $\rho0$, we minimize $|\Delta \lambda\text{calculated} - \Delta \lambda_\text{observed}|$ .

  3. We then repeat the calculations for different values of the scale height $H$ to minimize $|\lambda\text{MAW calculated} - \lambda\text{MAW observed}|$ and $|\lambda\text{TEB calculated} - \lambda{TEB observed}|$.

How to use it

The main function to be used is density_and_scale_height_of_CS_calculation.

The script requires specifying key parameters such as: - a magnetic field model that gives the magnetic field values along the magnetic field line connected to the Galilean moon, in the North (r_N, theta_N, phi_N, B_total_N) and South (r_S, theta_S, phi_S, B_total_S). Distance values need to be in Jovian radii. Magnetic field values need to be in Tesla; - an array of electron energies to be tested (E_array); - specific scale height values $H$ for the Current Sheet to be tested (z_lim_N_array); - the distance along the chosen equator that will be taken as reference (r_0, in planetary Radius) - longitudes of the observed MAW and TEB spots (longitude_observed_MAW, longitude_observed_TEB); - a first guess of the value of $\rho0$ to help the code obtain the correct values for the longitudes of the spots and their separation (`rho0volumetricfirstguess; default is $3.6436e-21 \text{kg/m}^3$, i.e., $4000 \text{particles/cm}^3$); - the rotation rate of the moon (rotationrate; default is $0.0098$, Callisto's rotation rate); - the equator of reference (jovicentricequator,centrifugalequator, ormagneticequator; default iscentrifugalequator = True); - density model can be chosen betweendiskandtorus(default istorus = True); - Uncertainties can be added using the $\Delta L$ (deltaL`) input. These uncertainties are based on the tilt angle of the Alfvén wings, which increases the length of the magnetic field line in the plasma sheet as $L = L\text{in PS} \times \Delta L$, with $\Delta L= \frac{1}{cos \theta}, with $\theta = atan(MA)$, with $MA$ the Mach Alfvén number.

  • verbose mode can be deactivated using verbose = False.

python (H_array, # Height Scale in Rp rho_0_array, # Total mass density at the center of the PS in kg/cm^3 n_0_ions_array, # Ion density in the PS in cm^{-3} n_0_electrons, # Electron density in the PS in cm^{-3} longitude_TEB, # TEB longitude longitude_MAW, # MAW longitude rho_at_Moon_array, # Total mass density at the moon n_at_Moon_ions, # Ion density at the moon's orbit in cm^{-3} n_at_Moon_electrons, # Electron density at the moon's orbit in cm^{-3} units ) = density_and_scale_height_of_CS_calculation( r_N, theta_N, phi_N, B_total_N, r_S, theta_S, phi_S, B_total_S, E_array, z_lim_N_array, r_0, longitude_observed_MAW, longitude_observed_TEB, rho_0_volumetric_first_guess=rho_0_volumetric_first_guess, rotation_rate=rotation_rate, jovicentric_equator=False, centrifugal_equator=True, magnetic_equator=False, verbose=True, disk=False, torus=True, delta_L=delta_L )

Example of Use: Reproducing Rabia et al. (2025) Results

The Rabia_2025_Nature.ipynb file is a Jupyter notebook that provides an example of how to reproduce the results in Jonas et al. (2025). In this notebook, two methods are provided: 1. The first one takes different values of $H$ as inputs and provides the best $\rho$ results for each $H$ that minimize the TEB and MAW longitudes, and the longitudinal separation between them. 2. The second one minimizes the longitudes of the TEB and MAW spots, as well as their separation, across different $H$ and $\rho$ values to find the best fit.

The first method reproduces the results shown in Table 2 of Rabia et al. (2025) for $H=0.75$, $1.00$, $1.50$, $2.00$, and $3.00$ $R\text{J}$​, while the second method yields the best results highlighted in red in the table for $H=0.94 \text{R}\text{J}$​.

Owner

  • Login: CorentinLouis
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
title: "Determining the Jovian equatorial density from UV measurements of the Galilean moons' footprints"
authors:
  - family-names: "Louis"
    given-names: "Corentin K."
    orcid: "0000-0002-9552-8822"
    affiliation: "https://ror.org/017zz7s54"
  - family-names: "Rabia"
    given-names: "Jonas"
    orcid: "0000-0003-1429-9122"
    affiliation: "https://ror.org/05hm2ja81"
  - family-names: "Prangé"
    given-names: "Renée"
    orcid: "0000-0001-8809-4563"
    affiliation: "https://ror.org/017zz7s54"
license: "MIT"
version: 1.0.0
date-released: 2025-05-06
url: "https://github.com/CorentinLouis/determine_equatorial_density_from_UV_measurements/"
abstract: |
  This pipeline allows to determine the density ρ and the height scale H of the Jovian equatorial density, from the Trans-hemispheric Electron Beam (TEB) and Main Alfvén Wing (MAW) UV spots and the separation in longitude separation between them.
keywords:
  - "Magnetosphere"
  - "Jupiter"
  - "UV satellite footprints"
  - "Data Processing"
  - "Data Analysis"


GitHub Events

Total
  • Release event: 3
  • Push event: 23
  • Public event: 1
  • Pull request event: 2
  • Create event: 4
Last Year
  • Release event: 3
  • Push event: 23
  • Public event: 1
  • Pull request event: 2
  • Create event: 4