Abstract
We report on a new international community coding project to provide shared scientific computer code that performs common calculations to aid in planning scientific observations, modeling, and data analysis. We have developed code which calculates Jupiter’s internal and external magnetic fields. All magnetic field model code is provided in four programming languages (C++, IDL, MATLAB and Python). The code is freely available on GitHub. For Jupiter’s internal magnetic field, we present a number of spherical harmonic internal magnetic field models. These include JRM33, the latest Jupiter internal magnetic field model (Connerney et al. in J. Geophys. Res., Planets 127(2):e07055, 2022), as well as older jovian models (e.g. JRM09 (Connerney et al. in Geophys. Res. Lett. 45(6):2590–2596, 2018), O6 (Connerney in Planetary Radio Emissions III, pp. 13–33, 1992), VIP4 (Connerney et al. in J. Geophys. Res. 103(A6):11,929–11,940, 1998) and VIPAL (Hess et al. in J. Geophys. Res. Space Phys. 116(A5):A05217, 2011)). The internal magnetic field code can be easily modified for other planets by simply inputting another spherical harmonic magnetic field model. We have also developed code to calculate the magnetic field perturbations due to the azimuthal and radial currents flowing externally around Jupiter in the jovian magnetodisc according to the model of Connerney et al. (J. Geophys. Res. 86(A10):8370–8384, 1981; J. Geophys. Res. Space Phys. 125(10):e28138, 2020). The internal and external magnetic field codes can be combined to model the magnetic field in Jupiter’s magnetosphere. Finally, we provide field-line tracing software (C++ and a Python wrapper for C++) that utilizes the internal and external magnetic field models. The software can be used to trace along field lines from any position in the jovian magnetosphere to, for example, the ionosphere or an equator, and can also be utilized at different planets.
Availability of data and materials
Not applicable.
Code Availability
All codes are publicly available, GitHub URLs and Zenodo DOIs are listed in Table 5.
References
Acton CH (1996) Ancillary data services of NASA’s Navigation and Ancillary Information Facility. Planet Space Sci 44(1):65–70. https://doi.org/10.1016/0032-0633(95)00107-7
Acuña MH, Ness NF (1976) The main magnetic field of Jupiter. J Geophys Res 81(16):2917. https://doi.org/10.1029/JA081i016p02917
Acuña MH, Behannon KW, Connerney JEP (1983) Jupiter’s magnetic field and magnetosphere. In: Dessler AJ (ed) Physics of the Jovian magnetosphere. Cambridge University Press, Cambridge, pp 1–50
Alexeev II, Belenkaya ES (2005) Modeling of the Jovian magnetosphere. Ann Geophys 23(3):809–826. https://doi.org/10.5194/angeo-23-809-2005
Allegrini F, Wilson RJ, Ebert RW et al (2019) Juno J/SW Jovian Auroral Distribution Calibrated V1.0, JNO-J/SW-JAD-3-CALIBRATED-V1.0. https://doi.org/10.17189/1519715
Bloxham J, Moore KM, Kulowski L et al. (2022) Differential rotation in Jupiter’s interior revealed by simultaneous inversion for the magnetic field and zonal flux velocity. J Geophys Res, Planets 127(5):e07138. https://doi.org/10.1029/2021JE007138
Caudal G (1986) A self-consistent model of Jupiter’s magnetodisc including the effects of centrifugal force and pressure. J Geophys Res 91(A4):4201–4222. https://doi.org/10.1029/JA091iA04p04201
Connerney JEP (1992) Doing more with Jupiter’s magnetic field. In: Planetary radio emissions III, pp 13–33
Connerney JEP (1993) Magnetic fields of the outer planets. J Geophys Res 98(E10):18,659–18,680. https://doi.org/10.1029/93JE00980
Connerney JEP (2007) Planetary magnetism. In: Schubert G (ed) Treatise on geophysics, vol 10. Elsevier, Amsterdam, pp 243–280. https://doi.org/10.1016/B978-044452748-6.00159-0
Connerney JEP (2017) Juno Mag Calibrated Data J V1.0, JNO-J-3-FGM-CAL-V1.0. https://doi.org/10.17189/1519711
Connerney JEP, Acuña MH, Ness NF (1981) Modeling the Jovian current sheet and inner magnetosphere. J Geophys Res 86(A10):8370–8384. https://doi.org/10.1029/JA086iA10p08370
Connerney JEP, Acuña MH, Ness NF (1982) Voyager 1 assessment of Jupiter’s planetary magnetic field. J Geophys Res 87(A5):3623–3627. https://doi.org/10.1029/JA087iA05p03623
Connerney JEP, Acuña MH, Ness NF et al. (1998) New models of Jupiter’s magnetic field constrained by the Io flux tube footprint. J Geophys Res 103(A6):11,929–11,940. https://doi.org/10.1029/97JA03726
Connerney JEP, Benn M, Bjarno JB et al. (2017) The Juno magnetic field investigation. Space Sci Rev 213(1–4):39–138. https://doi.org/10.1007/s11214-017-0334-z
Connerney JEP, Kotsiaros S, Oliversen RJ et al. (2018) A new model of Jupiter’s magnetic field from Juno’s first nine orbits. Geophys Res Lett 45(6):2590–2596. https://doi.org/10.1002/2018GL077312
Connerney JEP, Timmins S, Herceg M et al. (2020) A Jovian magnetodisc model for the Juno era. J Geophys Res Space Phys 125(10):e28138. https://doi.org/10.1029/2020JA028138
Connerney JEP, Timmins S, Oliversen RJ et al. (2022) A new model of Jupiter’s magnetic field at the completion of Juno’s prime mission. J Geophys Res, Planets 127(2):e07055. https://doi.org/10.1029/2021JE007055
Edwards TM, Bunce EJ, Cowley SWH (2001) A note on the vector potential of Connerney et al.’s model of the equatorial current sheet in Jupiter’s magnetosphere. Planet Space Sci 49(10–11):1115–1123. https://doi.org/10.1016/S0032-0633(00)00164-1
Gledhill JA (1967) Magnetosphere of Jupiter. Nature 214(5084):155–156. https://doi.org/10.1038/214155a0
Harris CR, Millman KJ, van der Walt SJ et al. (2020) Array programming with NumPy. Nature 585(7825):357–362. https://doi.org/10.1038/s41586-020-2649-2
Hess SLG, Bonfond B, Zarka P et al. (2011) Model of the Jovian magnetic field topology constrained by the Io auroral emissions. J Geophys Res Space Phys 116(A5):A05217. https://doi.org/10.1029/2010JA016262
Hess SLG, Bonfond B, Bagenal F et al. (2017) A model of the Jovian internal field derived from in-situ and auroral constraints. In: Fischer G, Mann G, Panchenko M et al. (eds) Planetary radio emissions VIII, pp 157–167. https://doi.org/10.1553/PRE8s157
Imai M (2016) Characteristics of Jovian Low-Frequency Radio Emissions during the Cassini and Voyager Flyby of Jupiter. PhD thesis. https://doi.org/10.14989/doctor.k19504
James MK, Wilson RJ, Vogt MF et al (2022a) Jupitermag. Zenodo. https://doi.org/10.5281/zenodo.7374607
James MK, Wilson RJ, Vogt MF et al (2022b) libjupitermag. Zenodo. https://doi.org/10.5281/zenodo.7310141
Khurana KK (1992) A generalized hinged-magnetodisc model of Jupiter’s nightside current sheet. J Geophys Res 97(A5):6269–6276. https://doi.org/10.1029/92JA00169
Khurana KK (1997) Euler potential models of Jupiter’s magnetospheric field. J Geophys Res 102(A6):11,295–11,306. https://doi.org/10.1029/97JA00563
Khurana KK (2022) Khurana Jupiter Current Sheet Structure Model 2022. https://doi.org/10.5281/zenodo.6555235
Khurana KK, Schwarzl HK (2005) Global structure of Jupiter’s magnetospheric current sheet. J Geophys Res Space Phys 110(A7):A07227. https://doi.org/10.1029/2004JA010757
Khurana KK, Kivelson MG, Vasyliunas VM et al. (2004) The configuration of Jupiter’s magnetosphere. In: Bagenal F, Dowling TE, McKinnon WB (eds) Jupiter. The planet, satellites and magnetosphere. Cambridge planetary science, vol 1. Cambridge University Press, Cambridge, pp 593–616
Khurana KK, Leinweber HK, Hospodarsky GB et al. (2022) Radial and local time variations in the thickness of Jupiter’s magnetospheric current sheet. J Geophys Res Space Phys 127(10):e2022JA030664. https://doi.org/10.1029/2022JA030664
McComas DJ, Alexander N, Allegrini F et al. (2017) The Jovian auroral distributions experiment (JADE) on the Juno mission to Jupiter. Space Sci Rev 213(1–4):547–643. https://doi.org/10.1007/s11214-013-9990-9
Ness NF, Acuna MH, Lepping RP et al. (1979) Jupiter’s magnetic tail. Nature 280(5725):799–802. https://doi.org/10.1038/280799a0
Palmaerts B, Vogt MF, Krupp N et al. (2017) Dawn-dusk asymmetries in Jupiter’s magnetosphere. In: Haaland S, Runov A, Forsyth C (eds) Dawn-dusk asymmetries in planetary plasma environments, pp 307–322. https://doi.org/10.1002/9781119216346.ch24
Pensionerov IA, Alexeev II, Belenkaya ES et al. (2019) Model of Jupiter’s current sheet with a piecewise current density. J Geophys Res Space Phys 124(3):1843–1854. https://doi.org/10.1029/2018JA026321
Provan G, Wilson RJ, Vogt MF et al (2023) con2020. Zenodo. https://doi.org/10.5281/zenodo.7589982RL
Ridley VA, Holme R (2016) Modeling the Jovian magnetic field and its secular variation using all available magnetic field observations. J Geophys Res, Planets 121(3):309–337. https://doi.org/10.1002/2015JE004951
Russell CT, Dougherty MK (2010) Magnetic fields of the outer planets. Space Sci Rev 152(1–4):251–269. https://doi.org/10.1007/s11214-009-9621-7
Sharan S, Langlais B, Amit H et al. (2022) The internal structure and dynamics of Jupiter unveiled by a high-resolution magnetic field and secular variation model. Geophys Res Lett 49(15):e98839. https://doi.org/10.1029/2022GL098839
Smith EJ, Davis JL, Jones DE (1976) Jupiter’s magnetic field and magnetosphere. In: Gehrels T, Matthews S (eds) IAU colloq. 30: Jupiter: studies of the interior, atmosphere, magnetosphere and satellites, pp 788–829
Vogt MF, Bunce EJ, Nichols JD et al. (2017) Long-term variability of Jupiter’s magnetodisk and implications for the aurora. J Geophys Res Space Phys 122(12):12,090–12,110. https://doi.org/10.1002/2017JA024066
Vogt MF, Bagenal F, Bolton SJ (2022) Magnetic field conditions upstream of Ganymede. J Geophys Res Space Phys 127(12):e2022JA030497. https://doi.org/10.1029/2022JA030497
Vogt MF, Wilson RJ, Provan G et al (2023) Con2020 - Current Sheet Model Code. Zenodo. https://doi.org/10.5281/zenodo.7586161
Wang Jz, Huo Zx, Zhang L (2021) A modular model of Jupiter’s magnetospheric magnetic field based on Juno data. J Geophys Res Space Phys 126(5):e29085. https://doi.org/10.1029/2020JA029085
Wang Jz, Huo Zx, Zhang L (2022) An empirical model of the current sheet in Jupiter’s magnetosphere. Planet Space Sci 211:105395. https://doi.org/10.1016/j.pss.2021.105395
Wilson RJ, Vogt MF, Provan G et al (2022) PSH: Planetary spherical harmonics community code. Zenodo. https://doi.org/10.5281/zenodo.7327992
Winch DE, Ivers DJ, Turner JPR et al. (2005) Geomagnetism and Schmidt quasi-normalization. Geophys J Int 160(2):487–504. https://doi.org/10.1111/j.1365-246X.2004.02472.x
Yu ZJ, Leinweber HK, Russell CT (2010) Galileo constraints on the secular variation of the Jovian magnetic field. J Geophys Res, Planets 115(E3):E03002. https://doi.org/10.1029/2009JE003492
Acknowledgements
We are grateful to Masafumi Imai for sharing his own IDL JRM09 codes with the Juno community and to Krishan Khurana for sharing code years ago, which both formed the seed of the codes presented in this work. We thank Jack Connerney for his insight and useful discussions in clarifying equations and constants used throughout. We thank Fran Bagenal for encouraging and herding the original community efforts here. This was a community effort to write and test the codes, mostly done in spare time, hence largely unfunded. Writing this paper and setting up/documenting the GitHubs and Zenodo repositories was too big for spare time alone, hence partially funded. RJW was supported at the University of Colorado as a part of NASA’s Juno mission supported by NASA through contact 699050X with the Southwest Research Institute. MFV was supported by NASA grant 80NSSC20K0559 through the New Frontiers Data Analysis Program. GP and MKJ were funded by STFC grant ST/W00089X/1. AK was supported by an STFC Studentship.
Author information
Authors and Affiliations
Contributions
All authors contributed equally to this work.
Corresponding author
Ethics declarations
Ethics approval
Not applicable.
Consent to participate
Not applicable.
Consent for publication
All authors gave consent to publish.
Competing Interests
The authors declare no competing interests.
Additional information
Publisher’s Note
Springer Nature remains neutral with regard to jurisdictional claims in published maps and institutional affiliations.
Note by the Editor: This is a Special Communication. In addition to invited review papers and topical collections, Space Science Reviews publishes unsolicited Special Communications. These are papers linked to an earlier topical volume/collection, report-type papers, or timely papers dealing with a strong space-science-technology combination (such papers summarize the science and technology of an instrument or mission in one paper).
Rights and permissions
About this article
Cite this article
Wilson, R.J., Vogt, M.F., Provan, G. et al. Internal and External Jovian Magnetic Fields: Community Code to Serve the Magnetospheres of the Outer Planets Community. Space Sci Rev 219, 15 (2023). https://doi.org/10.1007/s11214-023-00961-3
Received:
Accepted:
Published:
DOI: https://doi.org/10.1007/s11214-023-00961-3