-------------------
GENERAL INFORMATION
-------------------

ReadMe Author: NAWAPAT KAWEEYANUN, University of Southampton, ORCID ID: 0000-0003-0634-0164

Date of data collection: 15 July 2024

Information about geographic location of data collection: Southampton, U.K.

Related projects:
None

--------------------------
SHARING/ACCESS INFORMATION
-------------------------- 

Licenses/restrictions placed on the data, or limitations of reuse:

Recommended citation for the data:

This dataset supports the publication:
AUTHORS: Nawapat Kaweeyanun, Adam Masters 
TITLE: Dataset: Three-dimensional modeling of Ganymede’s Chapman-Ferraro magnetic field and its role in subsurface ocean induction
JOURNAL: Icarus
PAPER DOI IF KNOWN: 10.1016/j.icarus.2024.116356

Links to other publicly accessible locations of the data: N/A

Links/relationships to ancillary or related data sets: N/A


--------------------
DATA & FILE OVERVIEW
--------------------

The following list contains Matlab scripts and functions that form the analytical model for Chapman-Ferraro magnetic field at Ganymede.

- BCF_depth.m: Script for evaluating BCF as a function of top-of-ocean depth.
- BCF_evolution.m: Script to plot evolution of BCF at selected measurement points on Ganymede's surface over defined range of System-III Jovian east longitude (equivalent to time).
- BCF_from_MP.m: Function for computing Biot-Savart integration of Chapman-Ferraro magnetic field from Ganymede's magnetopause.
- BCF_surface.m: Script for computing Chapman-Ferraro magnetic field (BCF) at either top-of-ocean sphere or magnetospheric cross-sectional plane.
- Chapman_Ferraro_current_density.m: Function for Chapman-Ferraro current density using magnetic field strength gradient across the upstream magnetopause.
- dSgridEx.m: Script for generating surface area grids for Biot-Savart integration on magnetopause flank surfaces.
- dSgridKiv98.m: %Script for generating surface area grids for Biot-Savart integration on a half-cylindrical Ganymede magnetopause grid.
- dynamical_pressure.m: Function for dynamical (ram) pressure based on plasma density and velocity both upstream of the magnetopause and along the boundary itself.
- Fig2PlotScript.m: Script for plotting Figure 2 (Chapman-Ferraro magnetic field on top-of-ocean spheres for three extreme Ganymede latitudes inside the Jovian plasma sheet).
- Fig3PlotScript.m: Script for plotting Figure 3 (BCF evolution over Jovian synodic period).
- Fig4PlotScript.m: Script for plotting Figure 4 (BCF as function of top-of-ocean depth).
- Fig5PlotScript.m: Script for plotting Figure 5 (Chapman-Ferraro magnetic field in cross-magnetopause planes at specific GphiO Z-coordinate and Jovian System-III east longitude).
- flaring_angle.m: Function to calculate flaring angle between inflowing Jovian plasma and each magnetopause grid point.
- ganymede_field_boundary.m: Function to calculate Ganymede field strength required to balance Jovian acting pressure at the magnetopause.
- jCF_from_MP.m: Function for generating Chapman-Ferraro current densities (in SI units) from a half-cylindrical Ganymede magnetopause grid.
- jCF_MPex.m: Function for generating Chapman-Ferraro current densities (in SI units) from flank magnetopause extensions.
- jovian_field_boundary.m: Function to derive magnetic field components draping along the Jovian-side magnetopause.
- jovian_mass_density.m: Function to compute Jovian plasma mass density compressed at the magnetopause.
- jovian_vel_boundary.m: Function to calculate Jovian velocity parallel to the magnetopause.
- magnetic_pressure.m: Function to calculate upstream magnetic pressure based on field input.
- magnetic_pressure_boundary.m: Function to calculate magnetic pressure at the Jovian-side magnetopause.
- magnetopause_surface_fixed.m: Function to create fixed half-cylindrical magnetopause based on Kivelson et al., 1998.
- MPex.m: Function for extending magnetopause surface from the half-cylindrical section toward downstream of Ganymede.
- plasma_pressure.m: Function to calculate Jovian plasma pressure acting on the magnetopause.
- README_MODEL.txt: this guideline document
- tight_subplot.m: Function to create subplot axes with adjustable gaps and margins.
- upstream_jovian_field_dir.m: Function to generate unit vector upstream Jovian magnetic field direction based on System-III Jovian east longitude.
- upstream_parameters.m: Function to calculate upstream Jovian plasma mass density and pressure from System-III Jovian east longitude.

Relationship between files, if important for context: Always run script files from same directory as functions. 

Additional related data collected that was not included in the current data package: N/A

If data was derived from another source, list source: N/A

If there are there multiple versions of the dataset, list the file updated, when and why update was made: N/A


--------------------------
METHODOLOGICAL INFORMATION
--------------------------

Description of methods used for collection/generation of data.
1) Run BCF_surface.m (with plane section commented out, see script for detail) three times at 158, 248, and 338 Jovian System-III east longitudes to generate data for Figure 2.
2) Run BCF_evolution.m with stated list of parameters to generate data for Figure 3.
3) Run BCF_depth.m two times at 158 and 248 Jovian System-III east longitudes to generate data for Figure 4.
4) Run BCF_surface.m (with spherical section commented out, see script for detail) three times at 158, 248, and 338 Jovian System-III east longitudes to generate data for Figure 5a-c.
5) Run BCF_surface.m (with spherical section commented out, see script for detail) six times corresponding to chosen Galileo flyby times to generate data for Figure 5d

Methods for processing the data: 

1) Run Fig2PlotScript.m to plot data for Figure 2.
2) Run Fig3PlotScript.m seven times at Ganymedean latitudes (-90, -55, -35, 0, 35, 55, 90) plot data for Figure 3.
3) Run Fig4PlotScript two times corresponding to the System-III longitudes in Step (5) to plot data for Figure 4.
4) Run Fig5PlotScript.m to plot data for Figure 5.

Software- or Instrument-specific information needed to interpret the data, including software and hardware version numbers: 

- Any version of MATLAB (but preferably 2018a and later) with Symbolic Math Toolbox installed.

Standards and calibration information, if appropriate: N/A

Environmental/experimental conditions: N/A

Describe any quality-assurance procedures performed on the data:

- Code is checked against Galileo magnetometer measurement and results from Olsen et al., 2018.

People involved with sample collection, processing, analysis and/or submission:

Nawapat Kaweeyanun, Adam Masters.


--------------------------
DATA-SPECIFIC INFORMATION <Create sections for each datafile or set, as appropriate>
--------------------------

See README.txt file in general directory for description of data produced.

