<div dir="ltr"><div><div class="gmail_signature"><div dir="ltr"><div dir="ltr"><div><font face="arial, helvetica, sans-serif">Dear ET folks,</font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif">We are pleased to announce the public release of <b>GiRaFFE</b>, an open-source General Relativistic Force-Free Electrodynamics (GRFFE) code for dynamical spacetimes. </font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><b><font face="arial, helvetica, sans-serif">-= Code Release Paper =-</font></b></div><div><font face="arial, helvetica, sans-serif">Our code release paper--including a full description of the GiRaFFE code, a discussion of potential applications of GiRaFFE, and code validation test results--has been uploaded to the arXiv: <a href="https://arxiv.org/abs/1704.00599" target="_blank">https://arxiv.org/abs/1<wbr>704.00599</a> . </font></div><div><font face="arial, helvetica, sans-serif"><b><br></b></font></div><div><font face="arial, helvetica, sans-serif"><b>-= Executive Summary =-</b><br></font></div><div><font face="arial, helvetica, sans-serif">GiRaFFE adopts the strategy pioneered by McKinney [1] and modified by Paschalidis and Shapiro [2] to convert a general relativistic magnetohydrodynamic (GRMHD) code into a GRFFE code. In short, GiRaFFE exists as an extensive modification to IllinoisGRMHD [3]. Both GiRaFFE and IllinoisGRMHD leverage the Einstein Toolkit’s highly-scalable infrastructure [4,5] to make possible large-scale simulations of magnetized plasmas in strong, dynamical spacetimes on adaptive-mesh refinement (AMR) grids.<br></font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif">As you are aware, IllinoisGRMHD is an open-source rewrite of the Illinois Numerical Relativity Group&#39;s GRMHD code. GiRaFFE, on the other hand, is not based on any existing GRFFE code and is designed only to solve the equations of GRFFE in the context of fixed or dynamically-generated spacetimes. GiRaFFE has passed a large suite of GRFFE code validation tests passed by other state-of-the-art GRFFE codes, leading us to conclude that GiRaFFE is now ready for large-scale, state-of-the-art GRFFE simulations in dynamical spacetimes.</font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif"><b>-= New Thorns for the Einstein Toolkit =-</b><br></font></div><div><font face="arial, helvetica, sans-serif">All GiRaFFE thorns are listed below. Next to the name of each thorn, we include the number of lines of code to highlight the fact that <b>GiRaFFE is quite compact and designed to be welcoming to new users</b>. In addition, the comment-to-line-of-code ratio is very nearly 50%, and the code release paper provides a clean, broad-brush overview of the formalism and algorithms adopted. To become acquainted with any given thorn, first take a look at its README file.<br></font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif"><b>* GiRaFFE (~1,600 lines of code)</b>: Solves the GRFFE equations in the formalism of Paschalidis &amp; Shapiro [2] using the same reconstruction (PPM) and staggered vector potential methods as IllinoisGRMHD.<br></font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif"><b>* GiRaFFEfood</b><b> (~1,300 lines of code)</b>: Code validation initial data and basic diagnostics. Contains </font></div><div><ul><li style="margin-left:15px"><font face="arial, helvetica, sans-serif">Five 1D tests in flat spacetime (fast wave, Alfvén wave, degenerate Alfvén wave, &quot;three-wave&quot;, FFE breakdown),</font></li><li style="margin-left:15px"><font face="arial, helvetica, sans-serif">One 3D test in flat spacetime (aligned rotator), and<br></font></li><li style="margin-left:15px"><font face="arial, helvetica, sans-serif">Three 3D tests in curved spacetimes (&quot;Exact Wald&quot; solution, &quot;Magnetospheric Wald&quot; solution, and split monopole). <br></font></li></ul></div><div><font face="arial, helvetica, sans-serif"><b>* ShiftedKerrSchild (~230 lines of code)</b>: Sets up all 3+1 quantities for a Kerr-Schild spacetime with an arbitrary radial shift, to mitigate effects of extreme spacetime curvature near r_{KS}=0. See Appendix of code release paper for full discussion.<br></font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif"><b>* VolumeIntegrals_slab_Gfood (~310 lines of code)</b>: Performs volume integrals over arbitrary rectangular prisms as specified in parameter files.</font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif"><b>* GiRaFFE_to_HydroBase</b> &amp; <b>ID_co<wbr>nverter_GiRaFFE (~230 lines of code)</b>: Acts as a translation layer to convert 3-velocities in HydroBase&#39;s Valencia formalism to/from the 3-velocity found in the induction equation (v^i = u^i/u^0; native to GiRaFFE).</font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><b><font face="arial, helvetica, sans-serif">-= License =-</font></b></div><div><font face="arial, helvetica, sans-serif">To maximize compatibility with existing thorns in ET, all of the aforementioned GiRaFFE thorns are either licensed GPLv2+ or 2-clause BSD (FreeBSD). See LICENSE file in each.</font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><div><font face="arial, helvetica, sans-serif"><b>-= Download GiRaFFE! =-</b></font></div><div><font face="arial, helvetica, sans-serif"><b>The collection of thorns comprising GiRaFFE may be downloaded here:</b> </font><b><font face="arial, helvetica, sans-serif"><a href="https://bitbucket.org/zach_etienne/wvuthorns" target="_blank">https://bitbucket.org/za<wbr>ch_etienne/wvuthorns</a></font></b></div><div><font face="arial, helvetica, sans-serif"><br></font></div></div><div><font face="arial, helvetica, sans-serif">Sincerely,<br></font></div><font face="arial, helvetica, sans-serif"><br>The GiRaFFE team<br><br>-Zach Etienne<br>-Mew-Bing Wan<br>-Maria Babiuc<br>-Sean McWilliams<br>-Ashok Choudhary<br><br>References:<br>[1] J.C. McKinney. Mon. Not. R. Astron. Soc., 367:1797, 2006.<br>[2] V. Paschalidis and S. L. Shapiro. Phys. Rev. D, 88:104031, 2013.<br>[3] Z. B. Etienne, V. Paschalidis, R. Haas, P. M¨osta, and S. L. Shapiro. Class. Quantum Grav., 32(17):175009, 2015.<br>[4] <a href="https://einsteintoolkit.org/" target="_blank">https://einsteintoolkit.<wbr>org/</a><br>[5] <a href="https://carpetcode.org/" target="_blank">https://carpetcode.org/<br></a></font><br></div></div></div></div>
</div>