[ET Trac] [Einstein Toolkit] #1796: Include IllinoisGRMHD into the Toolkit, as an Arrangement

[Einstein Toolkit]

#1796: Include IllinoisGRMHD into the Toolkit, as an Arrangement
-----------------------------------+----------------------------------------
 Reporter:  zachetie@…             |       Owner:  Zachariah Etienne  
     Type:  enhancement            |      Status:  new                
 Priority:  major                  |   Milestone:  ET_2015_11         
Component:  EinsteinToolkit thorn  |     Version:  development version
 Keywords:  GRMHD IllinoisGRMHD    |  
-----------------------------------+----------------------------------------
 IllinoisGRMHD, an open-source, compact rewrite of the Illinois NR group's
 GRMHD code, has been graciously hosted by the ET community in its
 BitBucket repo for more than a year, under the EinsteinEvolve arrangement.

 This ticket requests official inclusion of an updated IllinoisGRMHD and
 closely-related thorns into the ET, as an arrangement.

 IllinoisGRMHD brings a number of key new features to the Toolkit,
 including:

 1) a staggered, vector-potential-based, AMR-compatible GRMHD scheme that
 automatically preserves divergenceless B-fields without the need for
 specialized interpolation schemes or divergence cleaning.

 2) excision-less, robust modeling of GRMHD flows into black hole interiors

 3) a highly-robust conservative-to-primitive solver, which checks the
 physicality of the conservative variables *prior* to inversion, and
 modifies them minimally to restore physicality.

 The proposed arrangement will include:
 1) IllinoisGRMHD: Core GRMHD evolution routines, some significant bugfixes
 since the original version currently in the ET's bitbucket repo; about
 3,400 lines of code (cloc)

 2) ID_converter_ILGRMHD: Converts HydroBase variables into variables
 IllinoisGRMHD can read (e.g., IllinoisGRMHD uses a velocity definition
 consistent with the magnetic induction equation, not the Valencia
 formulation); about 209 lines of code (cloc)

 3) convert_to_HydroBase: Does the reverse of ID_converter_ILGRMHD, needed
 for compatibility with HydroBase-based analysis thorns; 126 lines of code.

 All codes are written in C99 and are fully OpenMP-ified. You can read more
 about IllinoisGRMHD in its code announcement paper (CQG in press):
 http://arxiv.org/abs/1501.07276

 Additionally, a Guide to Getting Started with IllinoisGRMHD has also been
 written and is available at the IllinoisGRMHD webpage:
 http://math.wvu.edu/~zetienne/ILGRMHD/

 You may now download all three of these thorns (licensed GNU GPL v2 or
 higher) from:
 math.wvu.edu/~zetienne/IllinoisGRMHD_arrangement_July_20_2015.tar.gz

-- 
Ticket URL: <https://trac.einsteintoolkit.org/ticket/1796>
Einstein Toolkit <http://einsteintoolkit.org>
The Einstein Toolkit