diff --git a/joss.04992/10.21105.joss.04992.crossref.xml b/joss.04992/10.21105.joss.04992.crossref.xml new file mode 100644 index 0000000000..f817b9ad7f --- /dev/null +++ b/joss.04992/10.21105.joss.04992.crossref.xml @@ -0,0 +1,274 @@ + + + + 20231010T110730-7f4a4d8cfa552fb06ee8fb42596dd51843fb69e6 + 20231010110730 + + JOSS Admin + admin@theoj.org + + The Open Journal + + + + + Journal of Open Source Software + JOSS + 2475-9066 + + 10.21105/joss + https://joss.theoj.org + + + + + 10 + 2023 + + + 8 + + 90 + + + + RelativisticDynamics.jl: Relativistic Spin-Orbital +Dynamics in Julia + + + + Tom + Kimpson + + + + 10 + 10 + 2023 + + + 4992 + + + 10.21105/joss.04992 + + + http://creativecommons.org/licenses/by/4.0/ + http://creativecommons.org/licenses/by/4.0/ + http://creativecommons.org/licenses/by/4.0/ + + + + Software archive + 10.5281/zenodo.8412240 + + + GitHub review issue + https://github.com/openjournals/joss-reviews/issues/4992 + + + + 10.21105/joss.04992 + https://joss.theoj.org/papers/10.21105/joss.04992 + + + https://joss.theoj.org/papers/10.21105/joss.04992.pdf + + + + + + The Laser Interferometer Space Antenna: +Unveiling the Millihertz Gravitational Wave Sky + Thorpe + Bulletin of the american astronomical +society + 51 + 2019 + Thorpe, J. I., Ziemer, J., Thorpe, +I., Livas, J., Conklin, J. W., Caldwell, R., Berti, E., McWilliams, S. +T., Stebbins, R., Shoemaker, D., Ferrara, E. C., Larson, S. L., +Shoemaker, D., Key, J. S., Vallisneri, M., Eracleous, M., Schnittman, +J., Kamai, B., Camp, J., … Wass, P. (2019). The Laser Interferometer +Space Antenna: Unveiling the Millihertz Gravitational Wave Sky. Bulletin +of the American Astronomical Society, 51, 77. +https://arxiv.org/abs/1907.06482 + + + Mathisson + Acta Phys. Pol. + 6 + 10.1007/s10714-010-0939-y + 1937 + Mathisson, A. (1937). Acta Phys. +Pol., 6, 163. +https://doi.org/10.1007/s10714-010-0939-y + + + Spinning test-particles in general +relativity. i + Papapetrou + Proceedings of the Royal Society of London A: +Mathematical, Physical and Engineering Sciences + 1097 + 209 + 10.1098/rspa.1951.0200 + 0080-4630 + 1951 + Papapetrou, A. (1951). Spinning +test-particles in general relativity. i. Proceedings of the Royal +Society of London A: Mathematical, Physical and Engineering Sciences, +209(1097), 248–258. +https://doi.org/10.1098/rspa.1951.0200 + + + A covariant multipole formalism for extended +test bodies in general relativity + Dixon + Il Nuovo Cimento + 2 + 34 + 10.1007/BF02734579 + 1964 + Dixon, W. G. (1964). A covariant +multipole formalism for extended test bodies in general relativity. Il +Nuovo Cimento, 34(2), 317–339. +https://doi.org/10.1007/BF02734579 + + + Spin dynamics of a millisecond pulsar +orbiting closely around a massive black hole + Li + Monthly Notices of the Royal Astronomical +Society + 1 + 485 + 10.1093/mnras/stz389 + 0035-8711 + 2019 + Li, K. J., Wu, K., & Singh, D. +(2019). Spin dynamics of a millisecond pulsar orbiting closely around a +massive black hole. Monthly Notices of the Royal Astronomical Society, +485(1), 1053–1066. +https://doi.org/10.1093/mnras/stz389 + + + Orbital spin dynamics of a millisecond pulsar +around a massive BH with a general mass quadrupole + Kimpson + Monthly Notices of the RAS + 4 + 497 + 10.1093/mnras/staa2103 + 2020 + Kimpson, T., Wu, K., & Zane, S. +(2020). Orbital spin dynamics of a millisecond pulsar around a massive +BH with a general mass quadrupole. Monthly Notices of the RAS, 497(4), +5421–5431. +https://doi.org/10.1093/mnras/staa2103 + + + Pulsar timing in extreme mass ratio binaries: +a general relativistic approach + Kimpson + 1 + 486 + 10.1093/mnras/stz845 + 2019 + Kimpson, T., Wu, K., & Zane, S. +(2019). Pulsar timing in extreme mass ratio binaries: a general +relativistic approach. 486(1), 360–377. +https://doi.org/10.1093/mnras/stz845 + + + Radio timing in a millisecond pulsar - +extreme/intermediate mass ratio binary system + Kimpson + Astronomy and Astrophysics + 644 + 10.1051/0004-6361/202038561 + 2020 + Kimpson, T., Wu, K., & Zane, S. +(2020). Radio timing in a millisecond pulsar - extreme/intermediate mass +ratio binary system. Astronomy and Astrophysics, 644, A167. +https://doi.org/10.1051/0004-6361/202038561 + + + Single precision in weather forecasting +models: An evaluation with the IFS + Váňa + Monthly Weather Review + 2 + 145 + 10.1175/MWR-D-16-0228.1 + 2017 + Váňa, F., Düben, P., Lang, S., +Palmer, T., Leutbecher, M., Salmond, D., & Carver, G. (2017). Single +precision in weather forecasting models: An evaluation with the IFS. +Monthly Weather Review, 145(2), 495–502. +https://doi.org/10.1175/MWR-D-16-0228.1 + + + Motion of multipole particles in general +relativity theory binaries + Tulczyjew + Acta Phys. Pol. + 18 + 1959 + Tulczyjew, W. M. (1959). Motion of +multipole particles in general relativity theory binaries. Acta Phys. +Pol., 18, 393. + + + Action-angle coordinates for black-hole +geodesics I: Spherically symmetric and Schwarzschild + Witzany + arXiv e-prints + 10.48550/arXiv.2203.11952 + 2022 + Witzany, V. (2022). Action-angle +coordinates for black-hole geodesics I: Spherically symmetric and +Schwarzschild. arXiv e-Prints, arXiv:2203.11952. +https://doi.org/10.48550/arXiv.2203.11952 + + + GRChombo: An adaptable numerical relativity +code for fundamental physics + Andrade + Journal of Open Source +Software + 68 + 6 + 10.21105/joss.03703 + 2021 + Andrade, T., Salo, L. A., +Aurrekoetxea, J. C., Bamber, J., Clough, K., Croft, R., Jong, E. de, +Drew, A., Duran, A., Ferreira, P. G., Figueras, P., Finkel, H., França, +T., Ge, B.-X., Gu, C., Helfer, T., Jäykkä, J., Joana, C., Kunesch, M., … +Wong, K. (2021). GRChombo: An adaptable numerical relativity code for +fundamental physics. Journal of Open Source Software, 6(68), 3703. +https://doi.org/10.21105/joss.03703 + + + Strong-field tests of relativistic gravity +and binary pulsars + Damour + Phys. Rev. D + 45 + 10.1103/PhysRevD.45.1840 + 1992 + Damour, T., & Taylor, J. H. +(1992). Strong-field tests of relativistic gravity and binary pulsars. +Phys. Rev. D, 45, 1840–1868. +https://doi.org/10.1103/PhysRevD.45.1840 + + + + + + diff --git a/joss.04992/10.21105.joss.04992.jats b/joss.04992/10.21105.joss.04992.jats new file mode 100644 index 0000000000..46d250582b --- /dev/null +++ b/joss.04992/10.21105.joss.04992.jats @@ -0,0 +1,562 @@ + + +
+ + + + +Journal of Open Source Software +JOSS + +2475-9066 + +Open Journals + + + +4992 +10.21105/joss.04992 + +RelativisticDynamics.jl: Relativistic Spin-Orbital +Dynamics in Julia + + + + +Kimpson +Tom + + + + + + +School of Physics, University of Melbourne, Parkville, VIC +3010, Australia + + + + +Australian Research Council (ARC) Centre of Excellence for +Gravitational Wave Discovery (OzGrav) + + + + +14 +10 +2022 + +8 +90 +4992 + +Authors of papers retain copyright and release the +work under a Creative Commons Attribution 4.0 International License (CC +BY 4.0) +2022 +The article authors + +Authors of papers retain copyright and release the work under +a Creative Commons Attribution 4.0 International License (CC BY +4.0) + + + +Julia +astronomy +dynamics +gravity +general relativity + + + + + + Summary +

Relativistic binaries composed of a millisecond pulsar (MSP) + orbiting a much more massive ( + + 103M), + spinning black hole (BH) are exceptional probes for investigating key + questions of fundamental physics and astrophysics. Such systems are + natural sources of gravitational waves (GWs) in the mHz regime, + expected to be detectable by the next generation of space-based GW + detectors such as LISA + (Thorpe + et al., 2019). The associated radio emission from the companion + pulsar raises the possibility of an electromagnetic (EM) counterpart, + enabling high precision multimessenger measurements to be made. The + description of the orbital dynamics of these systems, and the + influence on the resultant observed EM and GW signals, is non-trivial. + A proper treatment of the spin-orbital dynamics can be derived from + the conservation of the energy-momentum tensor + + + Tμν;ν=0 + which when expanded into a set of infinite multipole moments leads to + a description of the momentum vector + + pμ + and the spin tensor + + sμν + + + Dpμdλ=12Rμναβuνsαβ + + + Dsμνdλ=pμuνpνuμ + for affine parameter + + λ, + 4-velocity + + uν + and Riemann curvature tensor + + Rμναβ. + The system is closed by providing a spin supplementary condition, + equivalent to specifying the observer-dependent centre of mass. For + this work we take the Tulczyjew-Dixon condition + (Dixon, + 1964; + Tulczyjew, + 1959) + + + sμνpν=0

+

Together, equations 2 - + 4 form the + Mathisson-Papetrou-Dixon (MPD) equations + (Dixon, + 1964; + Mathisson, + 1937; + Papapetrou, + 1951), and describe the spin-orbital evolution in a fully + consistent way that is applicable to strong field regimes.

+
+ + Statement of need +

RelativisticDynamics.jl is an open-source + Julia package for relativistic spin-orbital dynamics in the + gravitational strong field for a Kerr spacetime. Existing codes for + modelling the dynamics of spinning objects like pulsars in the + strong-field regime are generally lacking, since such systems occupy + an intermediate regime that is generally overlooked. At the “low” end + of this regime there are post-Newtonian or geodesic descriptions (e.g. + Damour + & Taylor, 1992) which neglect the influence of the pulsar + spin on the underlying spacetime metric (“spin-curvature” coupling). + At the “high” end there is the full Numerical Relativity (NR) + solutions (e.g. + Andrade + et al., 2021) which are primarily applicable to two BHs with a + mass ratio + + 𝒪(1), + and are computationally intractable for these MSP systems which are + observed over a large number of orbital cycles.

+

RelativisticDynamics.jl aims to bridge this + gap by providing a modern, fast code for accurate numerical evolution + of spinning relativistic systems, via the MPD formalism. Julia is a + modern language that solves the “two language problem”, enabling fast + dynamic typing and JIT compilation in conjunction with petaflop + performance, comparable with numerical languages that are better known + in the astrophysics community such as C or Fortran. As a modern + language, it also provides a dedicated package manager and a large + catalogue of composable packages for scientific + computing. This enables RelativisticDynamics.jl + to easily leverage and interface with other scientific computing + packages. The author and collaborators have used the general methods + and mathematics described in this package for multiple research + projects (e.g. + Kimpson + et al., 2019, + 2020a, + 2020b; + Li et + al., 2019) with a particular focus on the radio signals from + spinning pulsar systems. This package represents an attempt to create + a documented, well-tested, open source resource for public use in this + area, that can also be used as a computational playground for + exploring techniques that could be applicable to more advanced + numerical models. The package has been formulated in terms of ODE + integration, rather than using e.g. action-angle variables + (Witzany, + 2022), to allow for extension to general spacetime metrics and + straightforward computation of quantities relevant for pulsar + observations e.g. spin axis orientation.

+

In addition to providing a fast, modern package for strong field + spin dynamics, RelativisticDynamics.jl has two + additional important features from the perspective of modern + relativistic astrophysics. Firstly, it is fully type flexible, being + able to support arbitrary number formats. By making use of Julia’s + type-flexibility the model is written in such a way so as to be able + to support hardware accelerated, low precision arithmetic and + alternative rounding methods such as stochastic rounding. This enables + rapid prototyping and exploration of reduced precision numerical + techniques in astrophysics, an approach common in other numerical + fields such as weather and climate modelling (e.g. + Váňa et + al., 2017). Secondly, + RelativisticDynamcis.jl is written to be fully + differentiable via automatic differentiation. This enables the package + to be used for differentiable physics applications in astrophysics, + for example gravitational waveform modelling and parameter estimation + or training neural networks based on the model. Automatic + differentiation also provides a potential avenue for extension of the + package to general (i.e. non-Kerr) spacetimes, whereby a user can + specify the metric and the associated Christoffel symbols and Riemann + tensors - which are simply linear combinations of the metric + derivatives - are calculated automatically.

+

Future potential extensions of this code include taking the + dynamics beyond second order in the multipole expansion, and the + inclusion of alternative spin conditions and spacetime metrics. The + inclusion of a diagnostics tool for extracting gravitational waveforms + in the time domain via a numerical kludge method would also be a + worthwhile addition. Moreover, we have considered only bound dynamical + systems - the ability to also explore hyberbolic systems would also be + an interesting development.

+

+

+ +

Example orbital trajectories for a ms-pulsar with + eccentricity + + e=0.1 + (left panels), + + e=0.8 + (right panels), orbiting a massive BH with extremal spin, + + + a=0.998. + The orbital motion is presented in the + + + xy + plane (top panels) and + + xz + plane (bottom panels). The pulsar is initialised in the orbital + plane with zero inclination. In the absence of spin-curvature + coupling the particle would remain in the plane + ( + + z=0). + Note the + + z-motion + is on the scale of km, not gravitational radii.

+
+
+ + Acknowledgements +

This work exploring the spin-evolution of relativistic systems via + the the MPD equations was originally motivated through interesting + discussions with Kinwah Wu. The port to a modern, precision-flexible + model in Julia was heavily inspired by Milan Klöwer. Our thanks to + both

+
+ + + + + + + ThorpeJames Ira + ZiemerJohn + ThorpeIra + LivasJeff + ConklinJohn W. + CaldwellRobert + BertiEmanuele + McWilliamsSean T. + StebbinsRobin + ShoemakerDavid + FerraraElizabeth C. + LarsonShane L. + ShoemakerDeirdre + KeyJoey Shapiro + VallisneriMichele + EracleousMichael + SchnittmanJeremy + KamaiBrittany + CampJordan + MuellerGuido + BellovaryJillian + RiouxNorman + BakerJohn + BenderPeter L. + CutlerCurt + CornishNeil + HoganCraig + ManthripragadaSridhar + WareBrent + NatarajanPriyamvada + NumataKenji + SankarShannon R. + KellyBernard J. + McKenzieKirk + SlutskyJacob + SperoRobert + HewitsonMartin + FrancisSamuel + DeRosaRyan + YuAnthony + HornschemeierAnn + WassPeter + + The Laser Interferometer Space Antenna: Unveiling the Millihertz Gravitational Wave Sky + Bulletin of the american astronomical society + 201909 + 51 + https://arxiv.org/abs/1907.06482 + 77 + + + + + + + MathissonA. + + Acta Phys. Pol. + 1937 + 6 + 10.1007/s10714-010-0939-y + 163 + + + + + + + PapapetrouA. + + Spinning test-particles in general relativity. i + Proceedings of the Royal Society of London A: Mathematical, Physical and Engineering Sciences + The Royal Society + 1951 + 209 + 1097 + 0080-4630 + http://rspa.royalsocietypublishing.org/content/209/1097/248 + 10.1098/rspa.1951.0200 + 248 + 258 + + + + + + DixonW. G. + + A covariant multipole formalism for extended test bodies in general relativity + Il Nuovo Cimento + 196410 + 34 + 2 + 10.1007/BF02734579 + 317 + 339 + + + + + + LiKaye Jiale + WuKinwah + SinghDinesh + + Spin dynamics of a millisecond pulsar orbiting closely around a massive black hole + Monthly Notices of the Royal Astronomical Society + 201902 + 485 + 1 + 0035-8711 + https://doi.org/10.1093/mnras/stz389 + 10.1093/mnras/stz389 + 1053 + 1066 + + + + + + KimpsonTom + WuKinwah + ZaneSilvia + + Orbital spin dynamics of a millisecond pulsar around a massive BH with a general mass quadrupole + Monthly Notices of the RAS + 202010 + 497 + 4 + https://arxiv.org/abs/2007.05219 + 10.1093/mnras/staa2103 + 5421 + 5431 + + + + + + KimpsonTom + WuKinwah + ZaneSilvia + + Pulsar timing in extreme mass ratio binaries: a general relativistic approach + + 201906 + 486 + 1 + https://arxiv.org/abs/1903.08258 + 10.1093/mnras/stz845 + 360 + 377 + + + + + + KimpsonTom + WuKinwah + ZaneSilvia + + Radio timing in a millisecond pulsar - extreme/intermediate mass ratio binary system + Astronomy and Astrophysics + 202012 + 644 + https://arxiv.org/abs/2012.06226 + 10.1051/0004-6361/202038561 + A167 + + + + + + + VáňaFilip + DübenPeter + LangSimon + PalmerTim + LeutbecherMartin + SalmondDeborah + CarverGlenn + + Single precision in weather forecasting models: An evaluation with the IFS + Monthly Weather Review + American Meteorological Society + Boston MA, USA + 2017 + 145 + 2 + https://journals.ametsoc.org/view/journals/mwre/145/2/mwr-d-16-0228.1.xml + 10.1175/MWR-D-16-0228.1 + 495 + 502 + + + + + + TulczyjewW. M. + + Motion of multipole particles in general relativity theory binaries + Acta Phys. Pol. + 1959 + 18 + 393 + + + + + + + WitzanyVojtěch + + Action-angle coordinates for black-hole geodesics I: Spherically symmetric and Schwarzschild + arXiv e-prints + 202203 + https://arxiv.org/abs/2203.11952 + 10.48550/arXiv.2203.11952 + arXiv:2203.11952 + + + + + + + AndradeTomas + SaloLlibert Areste + AurrekoetxeaJosu C. + BamberJamie + CloughKaty + CroftRobin + JongEloy de + DrewAmelia + DuranAlejandro + FerreiraPedro G. + FiguerasPau + FinkelHal + FrançaTiago + GeBo-Xuan + GuChenxia + HelferThomas + JäykkäJuha + JoanaCristian + KuneschMarkus + KornetKacper + LimEugene A. + MuiaFrancesco + NazariZainab + RadiaMiren + RipleyJustin + ShellardPaul + SperhakeUlrich + TraykovaDina + TunyasuvunakoolSaran + WangZipeng + WiddicombeJames Y. + WongKaze + + GRChombo: An adaptable numerical relativity code for fundamental physics + Journal of Open Source Software + The Open Journal + 2021 + 6 + 68 + https://doi.org/10.21105/joss.03703 + 10.21105/joss.03703 + 3703 + + + + + + + DamourThibault + TaylorJ. H. + + Strong-field tests of relativistic gravity and binary pulsars + Phys. Rev. D + American Physical Society + 199203 + 45 + https://link.aps.org/doi/10.1103/PhysRevD.45.1840 + 10.1103/PhysRevD.45.1840 + 1840 + 1868 + + + + +
diff --git a/joss.04992/10.21105.joss.04992.pdf b/joss.04992/10.21105.joss.04992.pdf new file mode 100644 index 0000000000..5d76bc457b Binary files /dev/null and b/joss.04992/10.21105.joss.04992.pdf differ diff --git a/joss.04992/media/cf22222ad208498c8c7ebfb9f41e82163021cda8.pdf b/joss.04992/media/cf22222ad208498c8c7ebfb9f41e82163021cda8.pdf new file mode 100644 index 0000000000..f202a0b8f0 Binary files /dev/null and b/joss.04992/media/cf22222ad208498c8c7ebfb9f41e82163021cda8.pdf differ diff --git a/joss.04992/media/e6a317557ba196a02f33e24b74834a50e1f64cad.pdf b/joss.04992/media/e6a317557ba196a02f33e24b74834a50e1f64cad.pdf new file mode 100644 index 0000000000..a156061efb Binary files /dev/null and b/joss.04992/media/e6a317557ba196a02f33e24b74834a50e1f64cad.pdf differ