Tutorial-Start_to_Finish-BSSNCurvilinear-Two_BHs_Collide-Psi4.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<script async src=\"https://www.googletagmanager.com/gtag/js?id=UA-59152712-8\"></script>\n",
    "<script>\n",
    "  window.dataLayer = window.dataLayer || [];\n",
    "  function gtag(){dataLayer.push(arguments);}\n",
    "  gtag('js', new Date());\n",
    "\n",
    "  gtag('config', 'UA-59152712-8');\n",
    "</script>\n",
    "\n",
    "# Start-to-Finish Example: Studying Gravitational Wave Ringdown from Head-On Black Hole Collision\n",
    "\n",
    "## Author: Zach Etienne\n",
    "### Formatting improvements courtesy Brandon Clark\n",
    "\n",
    "## This module implements a basic numerical relativity code to merge two black holes in *spherical-like coordinates*, as well as the gravitational wave analysis provided by the $\\psi_4$ NRPy+ tutorial notebooks ([$\\psi_4$](Tutorial-Psi4.ipynb) & [$\\psi_4$ tetrad](Tutorial-Psi4_tetrads.ipynb)).\n",
    "\n",
    "### Here we place the black holes initially on the $z$-axis, so the entire simulation is axisymmetric about the $\\phi$-axis. Minimal sampling in the $\\phi$ direction greatly speeds up the simulation.\n",
    "\n",
    "**Notebook Status:** <font color = green><b> Validated </b></font>\n",
    "\n",
    "**Validation Notes:** This module has been validated to exhibit convergence to zero of the Hamiltonian constraint violation at the expected order to the exact solution *after a short numerical evolution of the initial data* (see [plots at bottom](#convergence)), and all quantities have been validated against the [original SENR code](https://bitbucket.org/zach_etienne/nrpy). Finally, excellent agreement is seen in the gravitational wave signal from the ringing remnant black hole for multiple decades in amplitude when compared to black hole perturbation theory predictions of the exponential dropoff and frequency.\n",
    "\n",
    "### NRPy+ Source Code & Tutorials for this module: \n",
    "* [BSSN/BrillLindquist.py](../edit/BSSN/BrillLindquist.py); [\\[**tutorial**\\]](Tutorial-ADM_Initial_Data-Brill-Lindquist.ipynb): Brill-Lindquist initial data; sets all ADM variables in Cartesian basis: \n",
    "* [BSSN/ADM_Initial_Data_Reader__BSSN_Converter.py](../edit/BSSN/ADM_Initial_Data_Reader__BSSN_Converter.py); [\\[**tutorial**\\]](Tutorial-ADM_Initial_Data_Reader__BSSN_Converter.ipynb): Registers the C function for our \"universal\" initial data reader/converter initial_data_reader__convert_ADM_Cartesian_to_BSSN().\n",
    "* [CurviBoundaryConditions/CurviBoundaryConditions.py](../edit/CurviBoundaryConditions/CurviBoundaryConditions.py); [\\[**tutorial**\\]](Tutorial-Start_to_Finish-Curvilinear_BCs.ipynb): Registers the C function for our \"universal\" initial data reader/converter initial_data_reader__convert_ADM_Cartesian_to_BSSN(). This applies boundary conditions to BSSN quantities (including $\\lambda^i$, which is computed via finite difference derivatives and thus only defined in grid interior)\n",
    "* [BSSN/BSSN_Ccodegen_library.py](../edit/BSSN/BSSN_Ccodegen_library.py); [\\[**tutorial**\\]](Tutorial-BSSN_time_evolution-C_codegen_library.ipynb): Implements a number of helper functions for generating C codes from symbolic expressions generated in the following modules/tutorials:\n",
    "    * [BSSN/BSSN_constraints.py](../edit/BSSN/BSSN_constraints.py); [\\[**tutorial**\\]](Tutorial-BSSN_constraints.ipynb): Hamiltonian constraint in BSSN curvilinear basis/coordinates\n",
    "    * [BSSN/BSSN_RHSs.py](../edit/BSSN/BSSN_RHSs.py); [\\[**tutorial**\\]](Tutorial-BSSN_time_evolution-BSSN_RHSs.ipynb): Generates the right-hand sides for the BSSN evolution equations in singular, curvilinear coordinates\n",
    "    * [BSSN/BSSN_gauge_RHSs.py](../edit/BSSN/BSSN_gauge_RHSs.py); [\\[**tutorial**\\]](Tutorial-BSSN_time_evolution-BSSN_gauge_RHSs.ipynb): Generates the right-hand sides for the BSSN gauge evolution equations in singular, curvilinear coordinates\n",
    "    * [BSSN/Psi4.py](../edit/BSSN/Psi4.py); [\\[**tutorial**\\]](Tutorial-Psi4.ipynb): Generates expressions for $\\psi_4$, the outgoing Weyl scalar\n",
    "        + [BSSN/Psi4_tetrads.py](../edit/BSSN/Psi4_tetrads.py); [\\[**tutorial**\\]](Tutorial-Psi4_tetrads.ipynb): Generates quasi-Kinnersley tetrad needed for $\\psi_4$-based gravitational wave extraction\n",
    "\n",
    "\n",
    "## Introduction:\n",
    "Here we use NRPy+ to generate the C source code necessary to set up initial data for two black holes (Brill-Lindquist, [Brill & Lindquist, Phys. Rev. 131, 471, 1963](https://journals.aps.org/pr/abstract/10.1103/PhysRev.131.471); see also Eq. 1 of [Brandt & Brügmann, arXiv:gr-qc/9711015v1](https://arxiv.org/pdf/gr-qc/9711015v1.pdf)). Then we use it to generate the RHS expressions for [Method of Lines](https://reference.wolfram.com/language/tutorial/NDSolveMethodOfLines.html) time integration based on an [explicit Runge-Kutta fourth-order scheme](https://en.wikipedia.org/wiki/Runge%E2%80%93Kutta_methods) (RK4 is chosen below, but multiple options exist). \n",
    "\n",
    "The entire algorithm is outlined as follows, with links to the relevant NRPy+ tutorial notebooks listed at each step:\n",
    "\n",
    "1. Allocate memory for gridfunctions, including temporary storage for the Method of Lines time integration\n",
    "    * [**NRPy+ tutorial on Method of Lines algorithm**](Tutorial-Method_of_Lines-C_Code_Generation.ipynb).\n",
    "1. Set gridfunction values to initial data \n",
    "    * [**NRPy+ tutorial on Brill-Lindquist initial data**](Tutorial-ADM_Initial_Data-Brill-Lindquist.ipynb)\n",
    "    * [**NRPy+ tutorial on validating Brill-Lindquist initial data**](Tutorial-Start_to_Finish-BSSNCurvilinear-Exact_Initial_Data.ipynb).\n",
    "1. Next, integrate the initial data forward in time using the Method of Lines coupled to a Runge-Kutta explicit timestepping algorithm:\n",
    "    1. At the start of each iteration in time, output the Hamiltonian constraint violation \n",
    "        * [**NRPy+ tutorial on BSSN constraints**](Tutorial-BSSN_constraints.ipynb).\n",
    "    1. At each RK time substep, do the following:\n",
    "        1. Evaluate BSSN RHS expressions \n",
    "            * [**NRPy+ tutorial on BSSN right-hand sides**](Tutorial-BSSN_time_evolution-BSSN_RHSs.ipynb) ([**BSSN Introduction Notebook**](Tutorial-BSSN_formulation.ipynb))\n",
    "            * [**NRPy+ tutorial on BSSN gauge condition right-hand sides**](Tutorial-BSSN_time_evolution-BSSN_gauge_RHSs.ipynb) \n",
    "        1. Apply singular, curvilinear coordinate boundary conditions [*a la* the SENR/NRPy+ paper](https://arxiv.org/abs/1712.07658)\n",
    "            * [**NRPy+ tutorial on setting up singular, curvilinear boundary conditions**](Tutorial-Start_to_Finish-Curvilinear_BCs.ipynb)\n",
    "        1. Enforce constraint on conformal 3-metric: $\\det{\\bar{\\gamma}_{ij}}=\\det{\\hat{\\gamma}_{ij}}$ \n",
    "            * [**NRPy+ tutorial on enforcing $\\det{\\bar{\\gamma}_{ij}}=\\det{\\hat{\\gamma}_{ij}}$ constraint**](Tutorial-BSSN_enforcing_determinant_gammabar_equals_gammahat_constraint.ipynb)\n",
    "1. Repeat the above steps at two numerical resolutions to confirm convergence to zero."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='toc'></a>\n",
    "\n",
    "# Table of Contents\n",
    "$$\\label{toc}$$\n",
    "\n",
    "This notebook is organized as follows\n",
    "\n",
    "1. [Step 1](#initializenrpy): Set core NRPy+ parameters for numerical grids and reference metric\n",
    "1. [Step 2](#ccodegen): Generate C code kernels for BSSN expressions, in parallel if possible\n",
    "    1. [Step 2.a](#rfm_ccodegen): Generate C code kernels for reference metric\n",
    "1. [Step 3](#cparams_rfm_and_domainsize): Set `free_parameters.h`; also output C codes needed for declaring and setting Cparameters\n",
    "1. [Step 4](#bc_functs): Set up boundary condition functions for chosen singular, curvilinear coordinate system\n",
    "1. [Step 5](#mainc): `BrillLindquist_Playground`: The C code `main()` function\n",
    "1. [Step 6](#compileexec): Compile generated C codes & perform the black hole collision calculation\n",
    "1. [Step 7](#visualize): Visualize the output!\n",
    "    1. [Step 7.a](#installdownload): Install `scipy` and download `ffmpeg` if they are not yet installed/downloaded\n",
    "    1. [Step 7.b](#genimages): Generate images for visualization animation\n",
    "    1. [Step 7.c](#genvideo): Generate visualization animation\n",
    "1. [Step 8](#numerror): Plot the numerical error at the end of the simulation\n",
    "1. [Step 9](#compare): Compare ringdown gravitational wave signal with black hole perturbation theory\n",
    "1. [Step 10](#latex_pdf_output): Output this notebook to $\\LaTeX$-formatted PDF file"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='initializenrpy'></a>\n",
    "\n",
    "# Step 1: Set core NRPy+ parameters for numerical grids and reference metric \\[Back to [top](#toc)\\]\n",
    "$$\\label{initializenrpy}$$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:28:51.090794Z",
     "iopub.status.busy": "2021-09-23T04:28:51.084185Z",
     "iopub.status.idle": "2021-09-23T04:28:51.411410Z",
     "shell.execute_reply": "2021-09-23T04:28:51.411799Z"
    }
   },
   "outputs": [],
   "source": [
    "# Step P1: Import needed NRPy+ core modules:\n",
    "from outputC import add_to_Cfunction_dict, outC_function_master_list # NRPy+: Core C code output module\n",
    "import finite_difference as fin  # NRPy+: Finite difference C code generation module\n",
    "import NRPy_param_funcs as par   # NRPy+: Parameter interface\n",
    "import grid as gri               # NRPy+: Functions having to do with numerical grids\n",
    "import reference_metric as rfm   # NRPy+: Reference metric support\n",
    "import cmdline_helper as cmd     # NRPy+: Multi-platform Python command-line interface\n",
    "from pickling import unpickle_NRPy_env  # NRPy+: Pickle/unpickle NRPy+ environment, for parallel codegen\n",
    "import shutil, os, sys           # Standard Python modules for multiplatform OS-level functions, benchmarking\n",
    "\n",
    "EvolOption = \"low resolution\"\n",
    "\n",
    "if EvolOption == \"low resolution\":\n",
    "    FD_order  = 8  # Finite difference order: even numbers only, starting with 2. 12 is generally unstable\n",
    "    # domain_size sets the default value for:\n",
    "    #   * Spherical's params.RMAX\n",
    "    #   * SinhSpherical*'s params.AMAX\n",
    "    #   * Cartesians*'s -params.{x,y,z}min & .{x,y,z}max\n",
    "    #   * Cylindrical's -params.ZMIN & .{Z,RHO}MAX\n",
    "    #   * SinhCylindrical's params.AMPL{RHO,Z}\n",
    "    #   * *SymTP's params.AMAX\n",
    "    domain_size = 150\n",
    "    Nr          = 270\n",
    "    Nth         = 8\n",
    "    Nph         = 2\n",
    "    CFL_FACTOR  = 1.0  # In pure axisymmetry (symmetry_axes = 2 below) 1.0 works fine. Otherwise 0.5 or lower.\n",
    "elif EvolOption == \"high resolution\":\n",
    "    FD_order  = 10  # Finite difference order: even numbers only, starting with 2. 12 is generally unstable\n",
    "    # domain_size sets the default value for:\n",
    "    #   * Spherical's params.RMAX\n",
    "    #   * SinhSpherical*'s params.AMAX\n",
    "    #   * Cartesians*'s -params.{x,y,z}min & .{x,y,z}max\n",
    "    #   * Cylindrical's -params.ZMIN & .{Z,RHO}MAX\n",
    "    #   * SinhCylindrical's params.AMPL{RHO,Z}\n",
    "    #   * *SymTP's params.AMAX\n",
    "    domain_size = 300\n",
    "    Nr          = 800\n",
    "    Nth         = 16\n",
    "    Nph         = 2\n",
    "    CFL_FACTOR  = 1.0  # In pure axisymmetry (symmetry_axes = 2 below) 1.0 works fine. Otherwise 0.5 or lower.\n",
    "else:\n",
    "    print(\"ERROR: EvolOption = \" + EvolOption + \"unknown.\")\n",
    "    sys.exit(1)\n",
    "\n",
    "# Step P2: Create C code output directory:\n",
    "Ccodesrootdir = os.path.join(\"BSSN_Two_BHs_Collide_Ccodes_psi4\")\n",
    "# First remove C code output directory if it exists\n",
    "shutil.rmtree(Ccodesrootdir, ignore_errors=True)\n",
    "# Then create a fresh directory\n",
    "cmd.mkdir(Ccodesrootdir)\n",
    "\n",
    "# Step P3: Create executable output directory:\n",
    "outdir = os.path.join(Ccodesrootdir, \"output\")\n",
    "cmd.mkdir(outdir)\n",
    "\n",
    "# Step 1.a: Enable SIMD-optimized code?\n",
    "#           I.e., generate BSSN and Ricci C code kernels using SIMD-vectorized\n",
    "#           compiler intrinsics, which *greatly improve the code's performance*,\n",
    "#           though at the expense of making the C-code kernels less\n",
    "#           human-readable.\n",
    "#           * Important note in case you wish to modify the BSSN/Ricci kernels\n",
    "#             here by adding expressions containing transcendental functions\n",
    "#             (e.g., certain scalar fields):\n",
    "#           Note that SIMD-based transcendental function intrinsics are not\n",
    "#           supported by the default installation of gcc or clang (you will\n",
    "#           need to use e.g., the SLEEF library from sleef.org, for this\n",
    "#           purpose). The Intel compiler suite does support these intrinsics\n",
    "#           however without the need for external libraries.\n",
    "enable_SIMD = True\n",
    "\n",
    "# Step 1.b: Enable reference metric precomputation.\n",
    "enable_rfm_precompute = True\n",
    "\n",
    "if enable_SIMD and not enable_rfm_precompute:\n",
    "    print(\"ERROR: SIMD does not currently handle transcendental functions,\\n\")\n",
    "    print(\"       like those found in rfmstruct (rfm_precompute).\\n\")\n",
    "    print(\"       Therefore, enable_SIMD==True and enable_rfm_precompute==False\\n\")\n",
    "    print(\"       is not supported.\\n\")\n",
    "    sys.exit(1)\n",
    "\n",
    "# Step 1.c: Enable \"FD functions\". In other words, all finite-difference stencils\n",
    "#         will be output as inlined static functions. This is essential for\n",
    "#         compiling highly complex FD kernels with using certain versions of GCC;\n",
    "#         GCC 10-ish will choke on BSSN FD kernels at high FD order, sometimes\n",
    "#         taking *hours* to compile. Unaffected GCC versions compile these kernels\n",
    "#         in seconds. FD functions do not slow the code performance, but do add\n",
    "#         another header file to the C source tree.\n",
    "# With gcc 7.5.0, enable_FD_functions=True decreases performance by 10%\n",
    "enable_FD_functions = False\n",
    "\n",
    "\n",
    "# Step 2: Set some core parameters, including CoordSystem MoL timestepping algorithm,\n",
    "#                                 FD order, floating point precision, and CFL factor:\n",
    "# Choices are: Spherical, SinhSpherical, SinhSphericalv2, Cylindrical, SinhCylindrical,\n",
    "#              SymTP, SinhSymTP\n",
    "CoordSystem     = \"SinhSpherical\"\n",
    "par.set_parval_from_str(\"reference_metric::CoordSystem\", CoordSystem)\n",
    "rfm.reference_metric()\n",
    "\n",
    "# Step 2.a: Set outer boundary condition\n",
    "outer_bc_type = \"RADIATION_OUTER_BCS\"  # can be EXTRAPOLATION_OUTER_BCS or RADIATION_OUTER_BCS\n",
    "radiation_BC_FD_order = 2\n",
    "\n",
    "# Step 2.b: Set defaults for Coordinate system parameters.\n",
    "#           These are perhaps the most commonly adjusted parameters,\n",
    "#           so we enable modifications at this high level.\n",
    "\n",
    "# sinh_width sets the default value for:\n",
    "#   * SinhSpherical's params.SINHW\n",
    "#   * SinhCylindrical's params.SINHW{RHO,Z}\n",
    "#   * SinhSymTP's params.SINHWAA\n",
    "sinh_width      = 0.2 # If Sinh* coordinates chosen\n",
    "# sinh_width      = 0.4 # If Sinh* coordinates chosen\n",
    "\n",
    "# sinhv2_const_dr sets the default value for:\n",
    "#   * SinhSphericalv2's params.const_dr\n",
    "#   * SinhCylindricalv2's params.const_d{rho,z}\n",
    "sinhv2_const_dr = 0.05 # If Sinh*v2 coordinates chosen\n",
    "\n",
    "# SymTP_bScale sets the default value for:\n",
    "#   * SinhSymTP's params.bScale\n",
    "SymTP_bScale    = 0.5 # If SymTP chosen\n",
    "\n",
    "# Step 2.b: Set the order of spatial and temporal derivatives;\n",
    "#           the core data type, and the CFL factor.\n",
    "# RK_method choices include: Euler, \"RK2 Heun\", \"RK2 MP\", \"RK2 Ralston\", RK3, \"RK3 Heun\", \"RK3 Ralston\",\n",
    "#              SSPRK3, RK4, DP5, DP5alt, CK5, DP6, L6, DP8\n",
    "RK_method = \"RK4\"\n",
    "maximum_l = 2\n",
    "REAL      = \"double\"  # Best to use double here.\n",
    "default_CFL_FACTOR= 0.5  # (GETS OVERWRITTEN IF SPECIFIED AT COMMAND LINE.)\n",
    "                         # In pure axisymmetry (symmetry_axes = 2 below) 1.0 works fine. Otherwise 0.5 or lower."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:28:51.417482Z",
     "iopub.status.busy": "2021-09-23T04:28:51.416973Z",
     "iopub.status.idle": "2021-09-23T04:28:51.418903Z",
     "shell.execute_reply": "2021-09-23T04:28:51.418495Z"
    }
   },
   "outputs": [],
   "source": [
    "# Step 5: Set the finite differencing order to FD_order (set above).\n",
    "par.set_parval_from_str(\"finite_difference::FD_CENTDERIVS_ORDER\", FD_order)\n",
    "\n",
    "# Directory for reference_metric precomputation header files:\n",
    "rfm_precompute_Ccode_outdir = os.path.join(Ccodesrootdir, \"rfm_files/\")\n",
    "if enable_rfm_precompute:\n",
    "    cmd.mkdir(os.path.join(Ccodesrootdir, \"rfm_files/\"))\n",
    "    par.set_parval_from_str(\"reference_metric::rfm_precompute_Ccode_outdir\", rfm_precompute_Ccode_outdir)\n",
    "\n",
    "# Step 6: Copy SIMD/SIMD_intrinsics.h to $Ccodesrootdir/SIMD/SIMD_intrinsics.h\n",
    "if enable_SIMD:\n",
    "    cmd.mkdir(os.path.join(Ccodesrootdir,\"SIMD\"))\n",
    "    shutil.copy(os.path.join(\"SIMD/\")+\"SIMD_intrinsics.h\",os.path.join(Ccodesrootdir,\"SIMD/\"))\n",
    "\n",
    "# Step 7: Set finite_difference::enable_FD_functions appropriately. Defaults to False\n",
    "if enable_FD_functions:\n",
    "    par.set_parval_from_str(\"finite_difference::enable_FD_functions\", enable_FD_functions)\n",
    "\n",
    "# Step 8: If enable_SIMD, then copy SIMD/SIMD_intrinsics.h to $Ccodesrootdir/SIMD/SIMD_intrinsics.h\n",
    "cmd.mkdir(os.path.join(Ccodesrootdir,\"SIMD\"))\n",
    "if enable_SIMD:\n",
    "    shutil.copy(os.path.join(\"SIMD\", \"SIMD_intrinsics.h\"), os.path.join(Ccodesrootdir, \"SIMD\"))\n",
    "\n",
    "# Step 9: Set the direction=2 (phi) axis to be the symmetry axis; i.e.,\n",
    "#         axis \"2\", corresponding to the i2 direction.\n",
    "#      This sets all spatial derivatives in the phi direction to zero.\n",
    "par.set_parval_from_str(\"indexedexp::symmetry_axes\",\"2\")\n",
    "OMP_pragma_on = \"i1\"  # structure OpenMP loops to parallelize, not over i2 (phi direction),\n",
    "#                       but i1 (theta direction). Results in *very* significant speed-up!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:28:51.422047Z",
     "iopub.status.busy": "2021-09-23T04:28:51.421615Z",
     "iopub.status.idle": "2021-09-23T04:28:51.432342Z",
     "shell.execute_reply": "2021-09-23T04:28:51.432729Z"
    }
   },
   "outputs": [],
   "source": [
    "# Step 10: Generate Runge-Kutta-based (RK-based) timestepping code.\n",
    "#       As described above the Table of Contents, this is a 3-step process:\n",
    "#       3.A: Evaluate RHSs (RHS_string)\n",
    "#       3.B: Apply boundary conditions (post_RHS_string, pt 1)\n",
    "#       3.C: Enforce det(gammabar) = det(gammahat) constraint (post_RHS_string, pt 2)\n",
    "import MoLtimestepping.MoL as MoL\n",
    "# from MoLtimestepping.RK_Butcher_Table_Dictionary import Butcher_dict\n",
    "# RK_order  = Butcher_dict[RK_method][1]\n",
    "RHS_string      = \"\"\"\n",
    "Ricci_eval(params, rfmstruct, RK_INPUT_GFS, auxevol_gfs);\n",
    "rhs_eval(params, rfmstruct, auxevol_gfs, RK_INPUT_GFS, RK_OUTPUT_GFS);\"\"\"\n",
    "RHS_string += \"\"\"\n",
    "if(params->outer_bc_type == RADIATION_OUTER_BCS)\n",
    "  apply_bcs_outerradiation_and_inner(params, bcstruct, griddata->xx,\n",
    "                                     gridfunctions_wavespeed,gridfunctions_f_infinity,\n",
    "                                     RK_INPUT_GFS, RK_OUTPUT_GFS);\"\"\"\n",
    "\n",
    "# Extrapolation BCs are applied to the evolved gridfunctions themselves after the MoL update\n",
    "post_RHS_string = \"\"\"if(params->outer_bc_type == EXTRAPOLATION_OUTER_BCS)\n",
    "  apply_bcs_outerextrap_and_inner(params, bcstruct, RK_OUTPUT_GFS);\n",
    "\"\"\"\n",
    "post_RHS_string += \"enforce_detgammahat_constraint(params, rfmstruct, RK_OUTPUT_GFS);\\n\"\n",
    "\n",
    "if not enable_rfm_precompute:\n",
    "    RHS_string = RHS_string.replace(\"rfmstruct\", \"xx\")\n",
    "    post_RHS_string = post_RHS_string.replace(\"rfmstruct\", \"xx\")\n",
    "\n",
    "MoL.register_C_functions_and_NRPy_basic_defines(RK_method,\n",
    "        RHS_string=RHS_string, post_RHS_string=post_RHS_string,\n",
    "        enable_rfm=enable_rfm_precompute, enable_curviBCs=True, enable_SIMD=False)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='ccodegen'></a>\n",
    "\n",
    "# Step 2: Generate C code kernels for BSSN expressions, in parallel if possible \\[Back to [top](#toc)\\]\n",
    "$$\\label{ccodegen}$$\n",
    "\n",
    "In the following code cell, we create a list of Python functions, which each registers a single C code function in `outputC`'s `outC_function_dict` dictionary. These Python functions are defined in \n",
    "\n",
    "1. [`BSSN.Initial_Data_Reader__BSSN_Converter`](../edit/BSSN.Initial_Data_Reader__BSSN_Converter.py); [\\[**tutorial**\\]](Tutorial-ADM_Initial_Data_Reader__BSSN_Converter.ipynb), which registers the C function for our \"universal\" initial data reader/converter `initial_data_reader__convert_ADM_Cartesian_to_BSSN()`.\n",
    "1. the [`BSSN.BSSN_Ccodegen_library`](../edit/BSSN/BSSN_Ccodegen_library.py) NRPy+ module [\\[**tutorial**\\]](Tutorial-BSSN_time_evolution-C_codegen_library.ipynb), which contains Python functions for generating C code from symbolic expressions constructed within the following NRPy+ modules/tutorials:\n",
    "    1. [BSSN/BSSN_constraints.py](../edit/BSSN/BSSN_constraints.py); [\\[**tutorial**\\]](Tutorial-BSSN_constraints.ipynb): Hamiltonian constraint in BSSN curvilinear basis/coordinates\n",
    "    1. [BSSN/BSSN_RHSs.py](../edit/BSSN/BSSN_RHSs.py); [\\[**tutorial**\\]](Tutorial-BSSN_time_evolution-BSSN_RHSs.ipynb): Generates the right-hand sides for the BSSN evolution equations in singular, curvilinear coordinates\n",
    "    1. [BSSN/BSSN_gauge_RHSs.py](../edit/BSSN/BSSN_gauge_RHSs.py); [\\[**tutorial**\\]](Tutorial-BSSN_time_evolution-BSSN_gauge_RHSs.ipynb): Generates the right-hand sides for the BSSN gauge evolution equations in singular, curvilinear coordinates\n",
    "    1. [BSSN/Enforce_Detgammahat_Constraint.py](../edit/BSSN/Enforce_Detgammahat_Constraint.py); [**tutorial**](Tutorial-BSSN_enforcing_determinant_gammabar_equals_gammahat_constraint.ipynb): Generates symbolic expressions for enforcing the $\\det{\\bar{\\gamma}}=\\det{\\hat{\\gamma}}$ constraint\n",
    "\n",
    "\n",
    "Next, from within a `multiprocessing` environment, we then call all the Python C-code generation functions in this list in parallel (if `multiprocessing` is supported). This is quite useful, as these functions take several seconds to complete.\n",
    "\n",
    "Within each `multiprocessing` process, the current NRPy+ environment is cloned, and a new function is registered to the `outC_function_dict` dictionary. Thus when each process completes, it contains a unique NRPy+ environment, with only its function registered. We address this by saving each process' NRPy+ environment and sending it back in a common binary format known as a `pickle`, using NRPy+'s [`pickling`](../edit/pickling.py) module. The environments are combined in an unpickling such that all functions exist within the same `outC_function_dict` dictionary.\n",
    "\n",
    "To make the current environment fully consistent, we call `reference_metric.py` to register all its associated C functions (stored in globals) and contributions to `NRPy_basic_defines.h`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [],
   "source": [
    "# First set up the symbolic expressions for Brill-Lindquist initial data\n",
    "import BSSN.BrillLindquist as BLID\n",
    "BLID.BrillLindquist()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Next we register the `ID_function()` needed for setting ADM spacetime quantities within our \"universal\" initial data reader/converter, as described in [this tutorial](Tutorial-ADM_Initial_Data_Reader__BSSN_Converter.ipynb). Appropriately, we refer to this `ID_function()` by the name `BrillLindquist()`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "import BSSN.ADM_Initial_Data_Reader__BSSN_Converter as IDread\n",
    "\n",
    "IDread.add_to_Cfunction_dict_exact_ADM_ID_function(\"BrillLindquist\",  \"Cartesian\",\n",
    "                                                   BLID.alpha, BLID.betaU, BLID.BU, BLID.gammaDD, BLID.KDD)\n",
    "IDread.register_NRPy_basic_defines(include_T4UU=False)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:28:51.438717Z",
     "iopub.status.busy": "2021-09-23T04:28:51.438212Z",
     "iopub.status.idle": "2021-09-23T04:29:02.701767Z",
     "shell.execute_reply": "2021-09-23T04:29:02.701515Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Generating C code for psi4, part 0 (SinhSpherical coords)...Generating C code for psi4 tetrads (SinhSpherical coords)...Generating C code for Spin-weight s=-2 Spherical Harmonics (SinhSpherical coords)...Generating C code for psi4, part 2 (SinhSpherical coords)...Generating C code for psi4, part 1 (SinhSpherical coords)...\n",
      "\n",
      "\n",
      "\n",
      "\n",
      "Finished generating C code for Spin-weight s=-2 Spherical Harmonics (SinhSpherical coords) in 0.9 seconds.\n",
      "Generating symbolic expressions for BSSN_RHSs (SinhSpherical coords)...\n",
      "Generating symbolic expressions for BSSN constraints (SinhSpherical coords)...\n",
      "Generating symbolic expressions for 3-Ricci tensor (SinhSpherical coords)...\n",
      "Generating C code for Enforcing det(gammabar)=det(gammahat) constraint (SinhSpherical coords)...\n",
      "Finished generating C code for Enforcing det(gammabar)=det(gammahat) constraint (SinhSpherical coords) in 0.2 seconds.\n",
      "Finished generating symbolic expressions for 3-Ricci tensor (SinhSpherical coords) in 0.9 seconds. Next up: C codegen...\n",
      "Generating C code for 3-Ricci tensor (FD order=8) (SinhSpherical coords)...\n",
      "Finished generating symbolic expressions for BSSN constraints (SinhSpherical coords) in 1.4 seconds. Next up: C codegen...\n",
      "Generating C code for BSSN constraints (FD order=8) (SinhSpherical coords)...\n",
      "Finished generating symbolic expressions for BSSN_RHSs (SinhSpherical coords) in 2.6 seconds. Next up: C codegen...\n",
      "Generating C code for BSSN_RHSs (FD order=8) (SinhSpherical coords)...\n",
      "Finished generating C code for BSSN constraints (FD order=8) (SinhSpherical coords) in 2.9 seconds.\n",
      "Finished generating C code for psi4, part 1 (SinhSpherical coords) in 7.4 seconds.\n",
      "Finished generating C code for psi4 tetrads (SinhSpherical coords) in 16.7 seconds.\n",
      "Finished generating C code for 3-Ricci tensor (FD order=8) (SinhSpherical coords) in 18.2 seconds.\n",
      "Finished generating C code for BSSN_RHSs (FD order=8) (SinhSpherical coords) in 18.1 seconds.\n",
      "Finished generating C code for psi4, part 0 (SinhSpherical coords) in 25.3 seconds.\n",
      "Finished generating C code for psi4, part 2 (SinhSpherical coords) in 26.4 seconds.\n"
     ]
    }
   ],
   "source": [
    "# Step 2: Generate C code kernels for BSSN expressions, in parallel if possible;\n",
    "import BSSN.BSSN_Ccodegen_library as BCL\n",
    "# Step 2.a: Create a list of functions we wish to evaluate in parallel (if possible)\n",
    "# Create lists for all BSSN functions\n",
    "codegen_funcs = [IDread.add_to_Cfunction_dict_initial_data_reader__convert_ADM_Sph_or_Cart_to_BSSN]\n",
    "codegen_funcs.append(BCL.add_rhs_eval_to_Cfunction_dict)\n",
    "codegen_funcs.append(BCL.add_Ricci_eval_to_Cfunction_dict)\n",
    "codegen_funcs.append(BCL.add_BSSN_constraints_to_Cfunction_dict)\n",
    "codegen_funcs.append(BCL.add_enforce_detgammahat_constraint_to_Cfunction_dict)\n",
    "codegen_funcs.append(BCL.add_psi4_part_to_Cfunction_dict)  # part 0 of 2\n",
    "codegen_funcs.append(BCL.add_psi4_part_to_Cfunction_dict)  # part 1 of 2\n",
    "codegen_funcs.append(BCL.add_psi4_part_to_Cfunction_dict)  # part 2 of 2\n",
    "codegen_funcs.append(BCL.add_psi4_tetrad_to_Cfunction_dict)\n",
    "codegen_funcs.append(BCL.add_SpinWeight_minus2_SphHarmonics_to_Cfunction_dict)\n",
    "\n",
    "# Step 2.b: Define master functions for parallelization.\n",
    "#           Note that lambdifying this doesn't work in Python 3\n",
    "def master_func(arg):\n",
    "    if codegen_funcs[arg] == IDread.add_to_Cfunction_dict_initial_data_reader__convert_ADM_Sph_or_Cart_to_BSSN:\n",
    "        ret = codegen_funcs[arg](addl_includes=None, rel_path_to_Cparams=os.path.join(\".\"),\n",
    "                                 input_Coord=\"Cartesian\", include_T4UU=False)\n",
    "    elif codegen_funcs[arg].__name__ == \"add_psi4_part_to_Cfunction_dict\":\n",
    "        which_arg_is_part1 = -1\n",
    "        for i, func in enumerate(codegen_funcs):\n",
    "            if func.__name__ == \"add_psi4_part_to_Cfunction_dict\":\n",
    "                which_arg_is_part1 = i\n",
    "                break\n",
    "        ret = codegen_funcs[arg]( includes=[\"NRPy_basic_defines.h\"],\n",
    "                                  rel_path_to_Cparams=os.path.join(\".\"), whichpart=(arg-which_arg_is_part1),\n",
    "                                  OMP_pragma_on=OMP_pragma_on)\n",
    "    elif codegen_funcs[arg].__name__ == \"add_psi4_tetrad_to_Cfunction_dict\":\n",
    "        ret = codegen_funcs[arg](includes=[\"NRPy_basic_defines.h\"],\n",
    "                                 rel_path_to_Cparams=os.path.join(\".\"))\n",
    "    elif codegen_funcs[arg].__name__ == \"add_SpinWeight_minus2_SphHarmonics_to_Cfunction_dict\":\n",
    "        ret = codegen_funcs[arg](includes=[\"NRPy_basic_defines.h\"],\n",
    "                                 rel_path_to_Cparams=os.path.join(\".\"), maximum_l=maximum_l)\n",
    "    else:\n",
    "        if enable_rfm_precompute:\n",
    "            # We use rfm_precompute for all BSSN functions:\n",
    "            par.set_parval_from_str(\"reference_metric::enable_rfm_precompute\", \"True\")\n",
    "            rfm.reference_metric()\n",
    "\n",
    "        if codegen_funcs[arg].__name__ == \"add_BSSN_constraints_to_Cfunction_dict\":\n",
    "            ret = codegen_funcs[arg](includes=[\"NRPy_basic_defines.h\"],\n",
    "                                     rel_path_to_Cparams=os.path.join(\".\"), output_H_only=True,\n",
    "                                     enable_rfm_precompute=enable_rfm_precompute, enable_SIMD=enable_SIMD,\n",
    "                                     OMP_pragma_on=OMP_pragma_on)\n",
    "        elif codegen_funcs[arg].__name__ == \"add_rhs_eval_to_Cfunction_dict\" or \\\n",
    "            codegen_funcs[arg].__name__ == \"add_Ricci_eval_to_Cfunction_dict\":\n",
    "            ret = codegen_funcs[arg](includes=[\"NRPy_basic_defines.h\"],\n",
    "                                     rel_path_to_Cparams=os.path.join(\".\"),\n",
    "                                     enable_rfm_precompute=enable_rfm_precompute, enable_SIMD=enable_SIMD,\n",
    "                                     OMP_pragma_on=OMP_pragma_on)\n",
    "        elif codegen_funcs[arg].__name__ == \"add_enforce_detgammahat_constraint_to_Cfunction_dict\":\n",
    "            ret = codegen_funcs[arg](includes=[\"NRPy_basic_defines.h\"],\n",
    "                                     rel_path_to_Cparams=os.path.join(\".\"),\n",
    "                                     enable_rfm_precompute=enable_rfm_precompute, OMP_pragma_on=OMP_pragma_on)\n",
    "        else:\n",
    "            print(\"ERROR: DID NOT RECOGNIZE FUNCTION \" + codegen_funcs[arg].__name__ + \"\\n\")\n",
    "            sys.exit(1)\n",
    "        if enable_rfm_precompute:\n",
    "            par.set_parval_from_str(\"reference_metric::enable_rfm_precompute\", \"False\")\n",
    "            rfm.ref_metric__hatted_quantities()\n",
    "    return ret\n",
    "\n",
    "\n",
    "NRPyEnvVars = []\n",
    "raised_exception = False\n",
    "try:\n",
    "    if os.name == 'nt':\n",
    "        # It's a mess to get working in Windows, so we don't bother. :/\n",
    "        #  https://medium.com/@grvsinghal/speed-up-your-python-code-using-multiprocessing-on-windows-and-jupyter-or-ipython-2714b49d6fac\n",
    "        raise Exception(\"Parallel codegen currently not available in certain environments, e.g., Windows\")\n",
    "\n",
    "    # Step 2.d: Import the multiprocessing module.\n",
    "    import multiprocessing\n",
    "\n",
    "    # Step 2.e: Evaluate list of functions in parallel if possible;\n",
    "    #           otherwise fallback to serial evaluation:\n",
    "    pool = multiprocessing.Pool()\n",
    "    NRPyEnvVars.append(pool.map(master_func, range(len(codegen_funcs))))\n",
    "    pool.terminate()\n",
    "    pool.join()\n",
    "except:\n",
    "    print(\"FAILED PARALLEL CODEGEN!\")\n",
    "    NRPyEnvVars = [] # Reset, as pickling/unpickling unnecessary for serial codegen (see next line)\n",
    "\n",
    "    # Steps 2.d-e, alternate: As fallback, evaluate functions in serial.\n",
    "    #       This will happen on Android and Windows systems\n",
    "    for i, func in enumerate(codegen_funcs):\n",
    "        master_func(i)\n",
    "    raised_exception = True\n",
    "\n",
    "outCfunc_master_list = outC_function_master_list\n",
    "if not raised_exception:\n",
    "    outCfunc_master_list = unpickle_NRPy_env(NRPyEnvVars)\n",
    "    for el in outCfunc_master_list:\n",
    "        if el not in outC_function_master_list:  # in case there are duplicate funcs, which can happen\n",
    "            #                                      if finite_difference_functions = True\n",
    "            outC_function_master_list += [el]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='rfm_ccodegen'></a>\n",
    "\n",
    "## Step 2.a: Generate C code kernels for reference metric \\[Back to [top](#toc)\\]\n",
    "$$\\label{rfm_ccodegen}$$\n",
    "\n",
    "In the [reference_metric](../edit/reference_metric.py) NRPy+ module, `register_C_functions_and_NRPy_basic_defines()` registers the following C functions to `outC_Cfunction_dict`:\n",
    "\n",
    "1. `find_timestep()`: Finds the minimum spacing between adjacent gridpoints on our numerical grid $\\min(ds_i)$, and sets the timestep according to the [CFL](https://en.wikipedia.org/w/index.php?title=Courant%E2%80%93Friedrichs%E2%80%93Lewy_condition&oldid=806430673) condition: $\\Delta t \\le \\frac{\\min(ds_i)}{c}$, where $c$ is the wavespeed, and $ds_i = h_i \\Delta x^i$ is the proper distance between neighboring gridpoints in the $i$th direction (in 3D, there are 3 directions), $h_i$ is the $i$th reference metric scale factor, and $\\Delta x^i$ is the uniform grid spacing in the $i$th direction.\n",
    "1. `xx_to_Cart()`: Input = uniformly sampled coordinate xx0,xx1,xx2 (e.g., r,theta,phi in Spherical coordinates). Output = Cartesian coordinate (x,y,z).\n",
    "1. `set_Nxx_dxx_invdx_params__and__xx()`: Sets `Nxx{0,1,2}`, `Nxx_plus_2NGHOSTS{0,1,2}`, `dxx{0,1,2}`, and `invdx{0,1,2}`; and defines `xx[3][]`.\n",
    "1. `Cart_to_xx_and_nearest_i0i1i2()`: Input = Cartesian coordinate (x,y,z). Output = uniformly sampled coordinate xx0,xx1,xx2 (e.g., r,theta,phi in Spherical coordinates), as well as corresponding grid index `i0,i1,i2`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:02.713902Z",
     "iopub.status.busy": "2021-09-23T04:29:02.708519Z",
     "iopub.status.idle": "2021-09-23T04:29:03.025608Z",
     "shell.execute_reply": "2021-09-23T04:29:03.025204Z"
    }
   },
   "outputs": [],
   "source": [
    "# Generate & register C function set_Nxx_dxx_invdx_params__and__xx()\n",
    "# Generate & register C function xx_to_Cart() for\n",
    "#               (the mapping from xx->Cartesian) for the chosen\n",
    "#               CoordSystem:\n",
    "# Generate & register the find_timestep() function\n",
    "\n",
    "# Sets reference_metric globals: NRPy_basic_defines_str, rfm_struct__malloc, rfm_struct__define, rfm_struct__freemem\n",
    "if enable_rfm_precompute:\n",
    "    par.set_parval_from_str(\"reference_metric::rfm_precompute_Ccode_outdir\", rfm_precompute_Ccode_outdir)\n",
    "    par.set_parval_from_str(\"reference_metric::enable_rfm_precompute\", \"True\")\n",
    "    par.set_parval_from_str(\"reference_metric::rfm_precompute_to_Cfunctions_and_NRPy_basic_defines\", \"True\")\n",
    "    rfm.reference_metric()\n",
    "\n",
    "rfm.register_C_functions(enable_rfm_precompute=enable_rfm_precompute, use_unit_wavespeed_for_find_timestep=True)\n",
    "rfm.register_NRPy_basic_defines(enable_rfm_precompute=enable_rfm_precompute)\n",
    "\n",
    "if enable_rfm_precompute:\n",
    "    par.set_parval_from_str(\"reference_metric::enable_rfm_precompute\", \"False\")\n",
    "    rfm.ref_metric__hatted_quantities()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='cparams_rfm_and_domainsize'></a>\n",
    "\n",
    "# Step 3: Set `free_parameters.h`; also output C codes needed for declaring and setting Cparameters  \\[Back to [top](#toc)\\]\n",
    "$$\\label{cparams_rfm_and_domainsize}$$\n",
    "\n",
    "First we output `free_parameters.h`, which sets initial data parameters, as well as grid domain & reference metric parameters, applying `domain_size` and `sinh_width`/`SymTP_bScale` (if applicable) as set above."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:03.029927Z",
     "iopub.status.busy": "2021-09-23T04:29:03.029424Z",
     "iopub.status.idle": "2021-09-23T04:29:03.030447Z",
     "shell.execute_reply": "2021-09-23T04:29:03.030838Z"
    }
   },
   "outputs": [],
   "source": [
    "# Step 3.e.i: Set free_parameters.h\n",
    "outstr = r\"\"\"// Set free-parameter values.\n",
    "\n",
    "// Outer boundary condition choice:\n",
    "params.outer_bc_type = \"\"\"+outer_bc_type+r\"\"\";\n",
    "\n",
    "// Set the default CFL Factor. Can be overwritten at command line.\n",
    "REAL CFL_FACTOR = \"\"\"+str(default_CFL_FACTOR)+r\"\"\";\n",
    "\n",
    "// Set free-parameter values for BSSN evolution:\n",
    "params.eta = 2.0;\n",
    "\n",
    "// Set free parameters for the (Brill-Lindquist) initial data\n",
    "params.BH1_posn_x = 0.0; params.BH1_posn_y = 0.0; params.BH1_posn_z =+0.25;\n",
    "params.BH2_posn_x = 0.0; params.BH2_posn_y = 0.0; params.BH2_posn_z =-0.25;\n",
    "params.BH1_mass = 0.5; params.BH2_mass = 0.5;\n",
    "\"\"\"\n",
    "\n",
    "# Append to $Ccodesrootdir/free_parameters.h reference metric parameters based on generic\n",
    "#    domain_size,sinh_width,sinhv2_const_dr,SymTP_bScale,\n",
    "#    parameters set above.\n",
    "outstr += rfm.out_default_free_parameters_for_rfm(\"returnstring\",\n",
    "                                                  domain_size,sinh_width,sinhv2_const_dr,SymTP_bScale)\n",
    "with open(os.path.join(Ccodesrootdir,\"free_parameters.h\"),\"w\") as file:\n",
    "    file.write(outstr.replace(\"params.\", \"griddata.params.\"))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='bc_functs'></a>\n",
    "\n",
    "# Step 4: Set up boundary condition functions for chosen singular, curvilinear coordinate system \\[Back to [top](#toc)\\]\n",
    "$$\\label{bc_functs}$$\n",
    "\n",
    "Next apply singular, curvilinear coordinate boundary conditions [as documented in the corresponding NRPy+ tutorial notebook](Tutorial-Start_to_Finish-Curvilinear_BCs.ipynb)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:03.036844Z",
     "iopub.status.busy": "2021-09-23T04:29:03.036620Z",
     "iopub.status.idle": "2021-09-23T04:29:03.201578Z",
     "shell.execute_reply": "2021-09-23T04:29:03.201371Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Evolved gridfunction \"aDD00\" has parity type 4.\n",
      "Evolved gridfunction \"aDD01\" has parity type 5.\n",
      "Evolved gridfunction \"aDD02\" has parity type 6.\n",
      "Evolved gridfunction \"aDD11\" has parity type 7.\n",
      "Evolved gridfunction \"aDD12\" has parity type 8.\n",
      "Evolved gridfunction \"aDD22\" has parity type 9.\n",
      "Evolved gridfunction \"alpha\" has parity type 0.\n",
      "Evolved gridfunction \"betU0\" has parity type 1.\n",
      "Evolved gridfunction \"betU1\" has parity type 2.\n",
      "Evolved gridfunction \"betU2\" has parity type 3.\n",
      "Evolved gridfunction \"cf\" has parity type 0.\n",
      "Evolved gridfunction \"hDD00\" has parity type 4.\n",
      "Evolved gridfunction \"hDD01\" has parity type 5.\n",
      "Evolved gridfunction \"hDD02\" has parity type 6.\n",
      "Evolved gridfunction \"hDD11\" has parity type 7.\n",
      "Evolved gridfunction \"hDD12\" has parity type 8.\n",
      "Evolved gridfunction \"hDD22\" has parity type 9.\n",
      "Evolved gridfunction \"lambdaU0\" has parity type 1.\n",
      "Evolved gridfunction \"lambdaU1\" has parity type 2.\n",
      "Evolved gridfunction \"lambdaU2\" has parity type 3.\n",
      "Evolved gridfunction \"trK\" has parity type 0.\n",
      "Evolved gridfunction \"vetU0\" has parity type 1.\n",
      "Evolved gridfunction \"vetU1\" has parity type 2.\n",
      "Evolved gridfunction \"vetU2\" has parity type 3.\n",
      "Auxiliary gridfunction \"H\" has parity type 0.\n",
      "Auxiliary gridfunction \"psi4_part0im\" has parity type 0.\n",
      "Auxiliary gridfunction \"psi4_part0re\" has parity type 0.\n",
      "Auxiliary gridfunction \"psi4_part1im\" has parity type 0.\n",
      "Auxiliary gridfunction \"psi4_part1re\" has parity type 0.\n",
      "Auxiliary gridfunction \"psi4_part2im\" has parity type 0.\n",
      "Auxiliary gridfunction \"psi4_part2re\" has parity type 0.\n",
      "AuxEvol gridfunction \"RbarDD00\" has parity type 4.\n",
      "AuxEvol gridfunction \"RbarDD01\" has parity type 5.\n",
      "AuxEvol gridfunction \"RbarDD02\" has parity type 6.\n",
      "AuxEvol gridfunction \"RbarDD11\" has parity type 7.\n",
      "AuxEvol gridfunction \"RbarDD12\" has parity type 8.\n",
      "AuxEvol gridfunction \"RbarDD22\" has parity type 9.\n"
     ]
    }
   ],
   "source": [
    "import CurviBoundaryConditions.CurviBoundaryConditions as CBC\n",
    "CBC.CurviBoundaryConditions_register_NRPy_basic_defines()\n",
    "CBC.CurviBoundaryConditions_register_C_functions(radiation_BC_FD_order=radiation_BC_FD_order)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='mainc'></a>\n",
    "\n",
    "# Step 5: The C code `main()` function for `BrillLindquist_Playground` \\[Back to [top](#toc)\\]\n",
    "$$\\label{mainc}$$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:03.207038Z",
     "iopub.status.busy": "2021-09-23T04:29:03.206710Z",
     "iopub.status.idle": "2021-09-23T04:29:03.207616Z",
     "shell.execute_reply": "2021-09-23T04:29:03.207793Z"
    }
   },
   "outputs": [],
   "source": [
    "def add_to_Cfunction_dict_main__BrillLindquist_Playground():\n",
    "    includes = [\"NRPy_basic_defines.h\", \"NRPy_function_prototypes.h\", \"time.h\"]\n",
    "    desc = \"\"\"// main() function:\n",
    "// Step 0: Read command-line input, set up grid structure, allocate memory for gridfunctions, set up coordinates\n",
    "// Step 1: Set up initial data to an exact solution\n",
    "// Step 2: Start the timer, for keeping track of how fast the simulation is progressing.\n",
    "// Step 3: Integrate the initial data forward in time using the chosen RK-like Method of\n",
    "//         Lines timestepping algorithm, and output periodic simulation diagnostics\n",
    "// Step 3.a: Output 2D data file periodically, for visualization\n",
    "// Step 3.b: Step forward one timestep (t -> t+dt) in time using\n",
    "//           chosen RK-like MoL timestepping algorithm\n",
    "// Step 3.c: If t=t_final, output conformal factor & Hamiltonian\n",
    "//           constraint violation to 2D data file\n",
    "// Step 3.d: Progress indicator printing to stderr\n",
    "// Step 4: Free all allocated memory\n",
    "\"\"\"\n",
    "    c_type = \"int\"\n",
    "    name = \"main\"\n",
    "    params = \"int argc, const char *argv[]\"\n",
    "    body = r\"\"\"  griddata_struct griddata;\n",
    "  set_Cparameters_to_default(&griddata.params);\n",
    "\n",
    "  // Step 0.a: Set free parameters, overwriting Cparameters defaults\n",
    "  //          by hand or with command-line input, as desired.\n",
    "#include \"free_parameters.h\"\n",
    "\n",
    "  // Step 0.b: Read command-line input, error out if nonconformant\n",
    "  if((argc != 4 && argc != 5) || atoi(argv[1]) < NGHOSTS || atoi(argv[2]) < NGHOSTS || atoi(argv[3]) < 2 /* FIXME; allow for axisymmetric sims */) {\n",
    "    fprintf(stderr,\"Error: Expected three command-line arguments: ./BrillLindquist_Playground Nx0 Nx1 Nx2,\\n\");\n",
    "    fprintf(stderr,\"where Nx[0,1,2] is the number of grid points in the 0, 1, and 2 directions.\\n\");\n",
    "    fprintf(stderr,\"Nx[] MUST BE larger than NGHOSTS (= %d)\\n\",NGHOSTS);\n",
    "    exit(1);\n",
    "  }\n",
    "  if(argc == 5) {\n",
    "    CFL_FACTOR = strtod(argv[4],NULL);\n",
    "  }\n",
    "  if(CFL_FACTOR > 0.5 && atoi(argv[3])!=2) {\n",
    "    fprintf(stderr,\"WARNING: CFL_FACTOR was set to %e, which is > 0.5.\\n\",CFL_FACTOR);\n",
    "    fprintf(stderr,\"         This will generally only be stable if the simulation is purely axisymmetric\\n\");\n",
    "    fprintf(stderr,\"         However, Nx2 was set to %d>2, which implies a non-axisymmetric simulation\\n\",atoi(argv[3]));\n",
    "  }\n",
    "  // Step 0.c: Set up numerical grid structure, first in space...\n",
    "  const int Nxx[3] = { atoi(argv[1]), atoi(argv[2]), atoi(argv[3]) };\n",
    "  if(Nxx[0]%2 != 0 || Nxx[1]%2 != 0 || Nxx[2]%2 != 0) {\n",
    "    fprintf(stderr,\"Error: Cannot guarantee a proper cell-centered grid if number of grid cells not set to even number.\\n\");\n",
    "    fprintf(stderr,\"       For example, in case of angular directions, proper symmetry zones will not exist.\\n\");\n",
    "    exit(1);\n",
    "  }\n",
    "\n",
    "  // Step 0.d: Uniform coordinate grids are stored to *xx[3]\n",
    "  // Step 0.d.i: Set bcstruct\n",
    "  {\n",
    "    int EigenCoord;\n",
    "    EigenCoord = 1;\n",
    "    // Step 0d.ii: Call set_Nxx_dxx_invdx_params__and__xx(), which sets\n",
    "    //             params Nxx,Nxx_plus_2NGHOSTS,dxx,invdx, and xx[] for the\n",
    "    //             chosen Eigen-CoordSystem.\n",
    "    set_Nxx_dxx_invdx_params__and__xx(EigenCoord, Nxx, &griddata.params, griddata.xx);\n",
    "    // Step 0.e: Find ghostzone mappings; set up bcstruct\n",
    "    bcstruct_set_up(&griddata.params, griddata.xx, &griddata.bcstruct);\n",
    "    // Step 0.e.i: Free allocated space for xx[][] array\n",
    "    for(int i=0;i<3;i++) free(griddata.xx[i]);\n",
    "\n",
    "    // Step 0.f: Call set_Nxx_dxx_invdx_params__and__xx(), which sets\n",
    "    //          params Nxx,Nxx_plus_2NGHOSTS,dxx,invdx, and xx[] for the\n",
    "    //          chosen (non-Eigen) CoordSystem.\n",
    "    EigenCoord = 0;\n",
    "    set_Nxx_dxx_invdx_params__and__xx(EigenCoord, Nxx, &griddata.params, griddata.xx);\n",
    "  }\n",
    "\n",
    "  // Step 0.g: Time coordinate parameters\n",
    "  griddata.params.t_final = 1.5*domain_size; /* Final time is set so that at t=t_final,\n",
    "                                              * data at the origin have not been corrupted\n",
    "                                              * by the approximate outer boundary condition */\n",
    "\n",
    "  // Step 0.h: Set timestep based on smallest proper distance between gridpoints and CFL factor\n",
    "  griddata.params.dt = find_timestep(&griddata.params, griddata.xx, CFL_FACTOR);\n",
    "  //fprintf(stderr,\"# Timestep set to = %e\\n\",(double)dt);\n",
    "  const REAL out_psi4_approx_every_t = 0.5;\n",
    "  int output_psi4_every_N = (int)(out_psi4_approx_every_t/griddata.params.dt + 0.5);\n",
    "  if(output_psi4_every_N == 0) output_psi4_every_N = 1;\n",
    "\n",
    "  const REAL out_2D_approx_every_t = 5.0;\n",
    "  // Ntot = N_outputs * output_every_N -> output_every_N = Ntot/N_outputs; set N_outputs=800\n",
    "  int output_2D_every_N = (int)(out_2D_approx_every_t/griddata.params.dt + 0.5);\n",
    "  if(output_2D_every_N == 0) output_2D_every_N = 1;\n",
    "\n",
    "  // Step 0.i: Error out if the number of auxiliary gridfunctions outnumber evolved gridfunctions.\n",
    "  //              This is a limitation of the RK method. You are always welcome to declare & allocate\n",
    "  //              additional gridfunctions by hand.\n",
    "  if(NUM_AUX_GFS > NUM_EVOL_GFS) {\n",
    "    fprintf(stderr,\"Error: NUM_AUX_GFS > NUM_EVOL_GFS. Either reduce the number of auxiliary gridfunctions,\\n\");\n",
    "    fprintf(stderr,\"       or allocate (malloc) by hand storage for *diagnostic_output_gfs. \\n\");\n",
    "    exit(1);\n",
    "  }\n",
    "\n",
    "  // Step 0.j: Declare struct for gridfunctions and allocate memory for y_n_gfs gridfunctions\n",
    "  MoL_malloc_y_n_gfs(&griddata.params, &griddata.gridfuncs);\n",
    "\"\"\"\n",
    "    if enable_rfm_precompute:\n",
    "        body += \"\"\"\n",
    "  // Step 0.k: Set up precomputed reference metric arrays\n",
    "  // Step 0.k.i: Allocate space for precomputed reference metric arrays.\n",
    "  rfm_precompute_rfmstruct_malloc(&griddata.params, &griddata.rfmstruct);\n",
    "\n",
    "  // Step 0.k.ii: Define precomputed reference metric arrays.\n",
    "  rfm_precompute_rfmstruct_define(&griddata.params, griddata.xx, &griddata.rfmstruct);\"\"\"\n",
    "    body += r\"\"\"\n",
    "  // Step 0.l: Set up initial data to an exact solution (Brill-Lindquist)\n",
    "  ID_persist_struct ID_persist;\n",
    "  initial_data_reader__convert_ADM_Cartesian_to_BSSN(&griddata, &ID_persist, BrillLindquist);\n",
    "\n",
    "  // Step 0.m: Allocate memory for non-y_n_gfs gridfunctions\n",
    "  MoL_malloc_non_y_n_gfs(&griddata.params, &griddata.gridfuncs);\n",
    "\n",
    "  // Step 0.n: Apply boundary conditions, as initial data\n",
    "  //          are sometimes ill-defined in ghost zones.\n",
    "  //          E.g., spherical initial data might not be\n",
    "  //          properly defined at points where r=-1.\n",
    "  apply_bcs_outerextrap_and_inner(&griddata.params, &griddata.bcstruct, griddata.gridfuncs.y_n_gfs);\n",
    "  enforce_detgammahat_constraint(&griddata.params, &griddata.rfmstruct, griddata.gridfuncs.y_n_gfs);\n",
    "\n",
    "  // Step 1: Start the timer, for keeping track of how fast the simulation is progressing.\n",
    "#ifdef __linux__ // Use high-precision timer in Linux.\n",
    "  struct timespec start, end;\n",
    "  clock_gettime(CLOCK_REALTIME, &start);\n",
    "#else     // Resort to low-resolution, standards-compliant timer in non-Linux OSs\n",
    "  // http://www.cplusplus.com/reference/ctime/time/\n",
    "  time_t start_timer,end_timer;\n",
    "  time(&start_timer); // Resolution of one second...\n",
    "#endif\n",
    "\n",
    "  const int Nxx_plus_2NGHOSTS0 = griddata.params.Nxx_plus_2NGHOSTS0;\n",
    "  const int Nxx_plus_2NGHOSTS1 = griddata.params.Nxx_plus_2NGHOSTS1;\n",
    "  const int Nxx_plus_2NGHOSTS2 = griddata.params.Nxx_plus_2NGHOSTS2;\n",
    "\n",
    "  int num_R_ext_idx = 0;\n",
    "  for(int R_ext_idx = (Nxx_plus_2NGHOSTS0-NGHOSTS)/4; R_ext_idx<(Nxx_plus_2NGHOSTS0-NGHOSTS)*0.9; R_ext_idx+=10) num_R_ext_idx++;\n",
    "  int *restrict list_of_R_ext_idxs = (int *restrict)malloc(sizeof(int)*num_R_ext_idx);\n",
    "  int dummy = 0;\n",
    "  for(int R_ext_idx = (Nxx_plus_2NGHOSTS0-NGHOSTS)/4; R_ext_idx<(Nxx_plus_2NGHOSTS0-NGHOSTS)*0.9; R_ext_idx+=10) { list_of_R_ext_idxs[dummy] = R_ext_idx; dummy++; }\n",
    "\n",
    "  // Step 2: Integrate the initial data forward in time using the chosen RK-like Method of\n",
    "  //         Lines timestepping algorithm, and output periodic simulation diagnostics\n",
    "  while(griddata.params.time < griddata.params.t_final)\n",
    "    { // Main loop to progress forward in time.\n",
    "    // Step 3.a: Check for NaNs -- has the simulation gone bad?\n",
    "    if(griddata.params.n % 10 == 0) {\n",
    "      int num_nans = 0;\n",
    "#pragma omp parallel for reduction(+:num_nans)\n",
    "      LOOP_REGION(NGHOSTS,Nxx_plus_2NGHOSTS0-NGHOSTS,  NGHOSTS,Nxx_plus_2NGHOSTS1-NGHOSTS,  NGHOSTS,Nxx_plus_2NGHOSTS2-NGHOSTS)\n",
    "        if(isnan(griddata.gridfuncs.y_n_gfs[IDX4S(CFGF, i0, i1, i2)])) num_nans++;\n",
    "      if(num_nans > 0) {\n",
    "        char filename[100];  sprintf(filename, \"nan_checker_results.txt\"); FILE *nancheck_file = fopen(filename, \"w\");\n",
    "        LOOP_REGION(NGHOSTS,Nxx_plus_2NGHOSTS0-NGHOSTS,  NGHOSTS,Nxx_plus_2NGHOSTS1-NGHOSTS,  NGHOSTS,Nxx_plus_2NGHOSTS2-NGHOSTS) {\n",
    "          if(isnan(griddata.gridfuncs.y_n_gfs[IDX4S(CFGF, i0, i1, i2)])) {\n",
    "            REAL xCart[3];  xx_to_Cart(&griddata.params, griddata.xx, i0,i1,i2, xCart);\n",
    "            fprintf(nancheck_file, \"%e %e %e | ERROR, found NAN at time %e ; %d %d %d\\n\", xCart[0], xCart[1], xCart[2], griddata.params.time, i0,i1,i2);\n",
    "          }\n",
    "        }\n",
    "        fclose(nancheck_file);\n",
    "        fprintf(stderr, \"\\nFOUND NANs, exiting...\\n\"); exit(1);\n",
    "      }\n",
    "    }\n",
    "\n",
    "    // Step 3.b: Perform diagnostics.\n",
    "    if(griddata.params.n % output_2D_every_N == 0) {\n",
    "      // Step 3.b.i: Output 2D data file periodically, for visualization\n",
    "      // Evaluate BSSN constraints (currently only Hamiltonian constraint violation computed).\n",
    "      Ricci_eval(&griddata.params, &griddata.rfmstruct, griddata.gridfuncs.y_n_gfs, griddata.gridfuncs.auxevol_gfs);  // <- depends on Ricci.\n",
    "      BSSN_constraints(&griddata.params, &griddata.rfmstruct, griddata.gridfuncs.y_n_gfs, griddata.gridfuncs.auxevol_gfs, griddata.gridfuncs.diagnostic_output_gfs);\n",
    "\n",
    "      char filename[100];\n",
    "      sprintf(filename,\"out%d-%08d.txt\",Nxx[0],griddata.params.n);\n",
    "      FILE *out2D = fopen(filename, \"w\");\n",
    "      LOOP_REGION(NGHOSTS,Nxx_plus_2NGHOSTS0-NGHOSTS,\n",
    "                  NGHOSTS,Nxx_plus_2NGHOSTS1-NGHOSTS,\n",
    "                  NGHOSTS,Nxx_plus_2NGHOSTS2-NGHOSTS) {\n",
    "        const int idx = IDX3S(i0,i1,i2);\n",
    "        REAL xCart[3];  xx_to_Cart(&griddata.params,griddata.xx,i0,i1,i2, xCart);\n",
    "        fprintf(out2D,\"%e %e %e %e\\n\",\n",
    "                xCart[1],xCart[2],\n",
    "                griddata.gridfuncs.y_n_gfs[IDX4ptS(CFGF,idx)],log10(fabs(griddata.gridfuncs.diagnostic_output_gfs[IDX4ptS(HGF,idx)])));\n",
    "      }\n",
    "      fclose(out2D);\n",
    "      }\n",
    "    if(griddata.params.n % output_psi4_every_N == 0) {\n",
    "      // Step 3.b.ii: Decompose psi4 Weyl scalar into spin-weight -2 spherical harmonics.\n",
    "      //              This scalar encodes outgoing gravitational wave content.\n",
    "      psi4_part0(&griddata.params, griddata.gridfuncs.y_n_gfs, griddata.xx, griddata.gridfuncs.diagnostic_output_gfs);\n",
    "      psi4_part1(&griddata.params, griddata.gridfuncs.y_n_gfs, griddata.xx, griddata.gridfuncs.diagnostic_output_gfs);\n",
    "      psi4_part2(&griddata.params, griddata.gridfuncs.y_n_gfs, griddata.xx, griddata.gridfuncs.diagnostic_output_gfs);\n",
    "      driver__spherlikegrids__psi4_spinweightm2_decomposition(&griddata.params, griddata.gridfuncs.diagnostic_output_gfs,\n",
    "                                                              list_of_R_ext_idxs, num_R_ext_idx, griddata.xx, xx_to_Cart);\n",
    "    }\n",
    "\n",
    "    // Step 3.c: Step forward one timestep (t -> t+dt) in time using\n",
    "    //           chosen RK-like MoL timestepping algorithm\n",
    "    MoL_step_forward_in_time(&griddata);\n",
    "\n",
    "    // Step 3.d: If t=t_final, output conformal factor & Hamiltonian\n",
    "    //           constraint violation to 2D data file\n",
    "    if(griddata.params.time > (griddata.params.t_final - griddata.params.dt)) {\n",
    "      // Evaluate BSSN constraints (currently only Hamiltonian constraint violation computed).\n",
    "      Ricci_eval(&griddata.params, &griddata.rfmstruct, griddata.gridfuncs.y_n_gfs, griddata.gridfuncs.auxevol_gfs);  // <- depends on Ricci.\n",
    "      BSSN_constraints(&griddata.params, &griddata.rfmstruct, griddata.gridfuncs.y_n_gfs, griddata.gridfuncs.auxevol_gfs, griddata.gridfuncs.diagnostic_output_gfs);\n",
    "      char filename[100];\n",
    "      sprintf(filename,\"out%d.txt\",Nxx[0]);\n",
    "      FILE *out2D = fopen(filename, \"w\");\n",
    "      LOOP_REGION(NGHOSTS,Nxx_plus_2NGHOSTS0-NGHOSTS,\n",
    "                  NGHOSTS,Nxx_plus_2NGHOSTS1-NGHOSTS,\n",
    "                  NGHOSTS,Nxx_plus_2NGHOSTS2-NGHOSTS) {\n",
    "        int idx = IDX3S(i0,i1,i2);\n",
    "        REAL xCart[3];  xx_to_Cart(&griddata.params,griddata.xx,i0,i1,i2, xCart);\n",
    "        fprintf(out2D,\"%e %e %e %e\\n\",xCart[1],xCart[2],\n",
    "                griddata.gridfuncs.y_n_gfs[IDX4ptS(CFGF,idx)],log10(fabs(griddata.gridfuncs.diagnostic_output_gfs[IDX4ptS(HGF,idx)])));\n",
    "      }\n",
    "      fclose(out2D);\n",
    "    }\n",
    "\n",
    "    // Step 3.e: Progress indicator printing to stderr.\n",
    "    //      Note that we're at the end of an iteration, so n=0\n",
    "    //      indicates we are actually at the start of iteration 1.\n",
    "    if((griddata.params.n + 1) % 10 == 0 ||\n",
    "       (griddata.params.time > griddata.params.t_final + griddata.params.dt) ) {\n",
    "      // Step 3.d.i: Measure average time per iteration\n",
    "#ifdef __linux__ // Use high-precision timer in Linux.\n",
    "      clock_gettime(CLOCK_REALTIME, &end);\n",
    "      const long long unsigned int time_in_ns = 1000000000L * (end.tv_sec - start.tv_sec) + end.tv_nsec - start.tv_nsec;\n",
    "#else     // Resort to low-resolution, standards-compliant timer in non-Linux OSs\n",
    "      time(&end_timer); // Resolution of one second...\n",
    "      REAL time_in_ns = difftime(end_timer,start_timer)*1.0e9+0.5; // Round up to avoid divide-by-zero.\n",
    "#endif\n",
    "      const REAL s_per_iteration_avg = ((REAL)time_in_ns / (REAL)(griddata.params.n + 1)) / 1.0e9;\n",
    "      //  We are at the n+1st iteration now  ---------------------v        -------^\n",
    "      const int iterations_remaining = (int)(griddata.params.t_final/griddata.params.dt + 0.5) - (griddata.params.n + 1);\n",
    "      const REAL seconds_remaining = (int)(s_per_iteration_avg * (REAL)iterations_remaining);\n",
    "      const int time_remaining__hrs  = (int)(seconds_remaining / 3600.0);\n",
    "      const int time_remaining__mins = (int)(seconds_remaining / 60.0) % 60;\n",
    "      const int time_remaining__secs = (int)(seconds_remaining) - time_remaining__mins*60 - time_remaining__hrs*3600;\n",
    "      //const REAL num_RHS_pt_evals = (REAL)(Nxx[0]*Nxx[1]*Nxx[2]) * 4.0 * (REAL)(n+1); // 4 RHS evals per gridpoint for RK4\n",
    "      //const REAL RHS_pt_evals_per_sec = num_RHS_pt_evals / ((REAL)time_in_ns / 1.0e9);\n",
    "\n",
    "      // Step 3.d.ii: Output simulation progress to stderr\n",
    "      fprintf(stderr,\"%c[2K\", 27); // Clear the line\n",
    "      fprintf(stderr,\"It: %d t=%.2f dt=%.2e | log10H: %.1f | %.1f%%; ETA %dh%dm%ds | t/h %.2f\\r\",\n",
    "              (griddata.params.n), (double)((griddata.params.n)*griddata.params.dt), (double)griddata.params.dt,\n",
    "              (double)log10(fabs(griddata.gridfuncs.diagnostic_output_gfs[IDX4ptS(HGF,(int)(Nxx_plus_2NGHOSTS0*Nxx_plus_2NGHOSTS1*Nxx_plus_2NGHOSTS2*0.5))])),\n",
    "              (double)(100.0*(REAL)(griddata.params.n)/(REAL)(int)((griddata.params.t_final/griddata.params.dt + 0.5))),\n",
    "              time_remaining__hrs, time_remaining__mins, time_remaining__secs,\n",
    "              (double)(griddata.params.dt * 3600.0 / s_per_iteration_avg));\n",
    "      fflush(stderr); // Flush the stderr buffer\n",
    "    } // End progress indicator if(griddata.params.n % 10 == 0)\n",
    "  } // End main loop to progress forward in time.\n",
    "  fprintf(stderr,\"\\n\"); // Clear the final line of output from progress indicator.\n",
    "\n",
    "  // Step 4: Free all allocated memory\n",
    "  free(list_of_R_ext_idxs);\n",
    "\"\"\"\n",
    "    if enable_rfm_precompute:\n",
    "        body += \"\"\"  rfm_precompute_rfmstruct_freemem(&griddata.params, &griddata.rfmstruct);\"\"\"\n",
    "    body += r\"\"\"\n",
    "  free(griddata.bcstruct.inner_bc_array);\n",
    "  for(int ng=0;ng<NGHOSTS*3;ng++) free(griddata.bcstruct.pure_outer_bc_array[ng]);\n",
    "  MoL_free_memory_y_n_gfs(&griddata.params, &griddata.gridfuncs);\n",
    "  MoL_free_memory_non_y_n_gfs(&griddata.params, &griddata.gridfuncs);\n",
    "  for(int i=0;i<3;i++) free(griddata.xx[i]);\n",
    "\n",
    "  return 0;\n",
    "\"\"\"\n",
    "    # As rfmstruct stores functions of xx, when rfm_precompute is disabled,\n",
    "    #   we always pass xx to a function instead of &rfmstruct.\n",
    "    if not enable_rfm_precompute:\n",
    "        body = body.replace(\"&rfmstruct\", \"xx\")\n",
    "    add_to_Cfunction_dict(\n",
    "        includes=includes,\n",
    "        desc=desc,\n",
    "        c_type=c_type, name=name, params=params,\n",
    "        body=body,\n",
    "        rel_path_to_Cparams=os.path.join(\".\"), enableCparameters=False)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='compileexec'></a>\n",
    "\n",
    "# Step 6: Compile generated C codes & perform the black hole collision calculation \\[Back to [top](#toc)\\]\n",
    "$$\\label{compileexec}$$\n",
    "\n",
    "First we register remaining C functions and contributions to `NRPy_basic_defines.h`, then we output `NRPy_basic_defines.h` and `NRPy_function_prototypes.h`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:03.210499Z",
     "iopub.status.busy": "2021-09-23T04:29:03.210028Z",
     "iopub.status.idle": "2021-09-23T04:29:03.212175Z",
     "shell.execute_reply": "2021-09-23T04:29:03.211754Z"
    }
   },
   "outputs": [],
   "source": [
    "add_to_Cfunction_dict_main__BrillLindquist_Playground()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:03.210499Z",
     "iopub.status.busy": "2021-09-23T04:29:03.210028Z",
     "iopub.status.idle": "2021-09-23T04:29:03.212175Z",
     "shell.execute_reply": "2021-09-23T04:29:03.211754Z"
    }
   },
   "outputs": [],
   "source": [
    "import outputC as outC\n",
    "outC.outputC_register_C_functions_and_NRPy_basic_defines()  # #define M_PI,  etc.\n",
    "# Declare paramstruct, register set_Cparameters_to_default(),\n",
    "#   and output declare_Cparameters_struct.h and set_Cparameters[].h:\n",
    "outC.NRPy_param_funcs_register_C_functions_and_NRPy_basic_defines(os.path.join(Ccodesrootdir))\n",
    "par.register_NRPy_basic_defines()  # add `paramstruct params` to griddata struct.\n",
    "\n",
    "gri.register_C_functions_and_NRPy_basic_defines()  # #define IDX3S(),  etc.\n",
    "fin.register_C_functions_and_NRPy_basic_defines(NGHOSTS_account_for_onezone_upwind=True,\n",
    "                                                enable_SIMD=enable_SIMD)  # #define NGHOSTS, and UPWIND() macro if SIMD disabled\n",
    "\n",
    "# Output functions for computing all finite-difference stencils.\n",
    "#   Must be called after defining all functions depending on FD stencils.\n",
    "if enable_FD_functions:\n",
    "    fin.output_finite_difference_functions_h(path=Ccodesrootdir)\n",
    "\n",
    "# Call this last: Set up NRPy_basic_defines.h and NRPy_function_prototypes.h.\n",
    "outC.construct_NRPy_basic_defines_h(Ccodesrootdir, enable_SIMD=enable_SIMD)\n",
    "outC.construct_NRPy_function_prototypes_h(Ccodesrootdir)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, we output all the C codes in `outC_function_dict` to files in the directory `Ccodesrootdir`, generate a `Makefile`, and compile the project using a parallel `make` command. If the `make` command fails, a backup serial compilation script is run.\n",
    "\n",
    "To aid in the cross-platform-compatible (with Windows, MacOS, & Linux) compilation and execution, we make use of `cmdline_helper` [(**Tutorial**)](Tutorial-cmdline_helper.ipynb)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:03.215586Z",
     "iopub.status.busy": "2021-09-23T04:29:03.215113Z",
     "iopub.status.idle": "2021-09-23T04:29:09.658960Z",
     "shell.execute_reply": "2021-09-23T04:29:09.658568Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "(EXEC): Executing `make -j18`...\n",
      "(BENCH): Finished executing in 8.43 seconds.\n",
      "Finished compilation.\n",
      "(EXEC): Executing `taskset -c 1,3,5,7,9,11,13,15 ./BrillLindquist_Playground 270 8 2 1.0`...\n",
      "\u001b[2KIt: 30609 t=224.99 dt=7.35e-03 | log10H: -5.4 | 100.0%; ETA 0h0m0s | t/h 1797.43\n",
      "(BENCH): Finished executing in 450.77 seconds.\n"
     ]
    }
   ],
   "source": [
    "import cmdline_helper as cmd\n",
    "cmd.new_C_compile(Ccodesrootdir, os.path.join(\"output\", \"BrillLindquist_Playground\"),\n",
    "                  uses_free_parameters_h=True, compiler_opt_option=\"fast\") # fastdebug or debug also supported\n",
    "\n",
    "# Change to output directory\n",
    "os.chdir(os.path.join(Ccodesrootdir, \"output\"))\n",
    "# Clean up existing output files\n",
    "cmd.delete_existing_files(\"out*.txt\")\n",
    "cmd.delete_existing_files(\"out*.png\")\n",
    "# Run executable with CFL_FACTOR = 1.0, which is allowed since\n",
    "#   simulation is axisymmetric and all phi derivs are set to zero.\n",
    "# cmd.Execute(\"BrillLindquist_Playground\", \"72 12 2 \"+str(CFL_FACTOR))\n",
    "# cmd.Execute(\"BrillLindquist_Playground\", \"800 16 2 \"+str(CFL_FACTOR))\n",
    "cmd.Execute(\"BrillLindquist_Playground\", str(Nr) + \" \" + str(Nth) + \" \" + str(Nph) + \" \" + str(CFL_FACTOR))\n",
    "os.chdir(os.path.join(\"..\", \"..\"))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='visualize'></a>\n",
    "\n",
    "# Step 7: Visualize the output! \\[Back to [top](#toc)\\]\n",
    "$$\\label{visualize}$$ \n",
    "\n",
    "In this section we will generate a movie, plotting the conformal factor of these initial data on a 2D grid, such that darker colors imply stronger gravitational fields. Hence, we see the two black holes each of mass $0.5$ initially centered at $z/M=\\pm 0.25$, where $M$ is a mass scale (conventionally the [ADM mass](https://en.wikipedia.org/w/index.php?title=ADM_formalism&oldid=846335453) is chosen), and our formulation of Einstein's equations adopt $G=c=1$ [geometrized units](https://en.wikipedia.org/w/index.php?title=Geometrized_unit_system&oldid=861682626)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='installdownload'></a>\n",
    "\n",
    "## Step 7.a: Install `scipy` and download `ffmpeg` if they are not yet installed/downloaded \\[Back to [top](#toc)\\]\n",
    "$$\\label{installdownload}$$ \n",
    "\n",
    "Note that if you are not running this within `mybinder`, but on a Windows system, `ffmpeg` must be installed using a separate package (on [this site](http://ffmpeg.org/)), or if running Jupyter within Anaconda, use the command: `conda install -c conda-forge ffmpeg`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:09.666760Z",
     "iopub.status.busy": "2021-09-23T04:29:09.666506Z",
     "iopub.status.idle": "2021-09-23T04:29:10.197073Z",
     "shell.execute_reply": "2021-09-23T04:29:10.197468Z"
    }
   },
   "outputs": [],
   "source": [
    "!pip install scipy > /dev/null\n",
    "\n",
    "check_for_ffmpeg = !which ffmpeg >/dev/null && echo $?\n",
    "if check_for_ffmpeg != ['0']:\n",
    "    print(\"Couldn't find ffmpeg, so I'll download it.\")\n",
    "    # Courtesy https://johnvansickle.com/ffmpeg/\n",
    "    !wget https://etienneresearch.com/ffmpeg-static-amd64-johnvansickle.tar.xz\n",
    "    !tar Jxf ffmpeg-static-amd64-johnvansickle.tar.xz\n",
    "    print(\"Copying ffmpeg to ~/.local/bin/. Assumes ~/.local/bin is in the PATH.\")\n",
    "    !mkdir ~/.local/bin/\n",
    "    !cp ffmpeg-static-amd64-johnvansickle/ffmpeg ~/.local/bin/\n",
    "    print(\"If this doesn't work, then install ffmpeg yourself. It should work fine on mybinder.\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='genimages'></a>\n",
    "\n",
    "## Step 7.b: Generate images for visualization animation \\[Back to [top](#toc)\\]\n",
    "$$\\label{genimages}$$ \n",
    "\n",
    "Here we loop through the data files output by the executable compiled and run in [the previous step](#mainc), generating a [png](https://en.wikipedia.org/wiki/Portable_Network_Graphics) image for each data file.\n",
    "\n",
    "**Special thanks to Terrence Pierre Jacques. His work with the first versions of these scripts greatly contributed to the scripts as they exist below.**"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:10.205155Z",
     "iopub.status.busy": "2021-09-23T04:29:10.204679Z",
     "iopub.status.idle": "2021-09-23T04:29:12.375868Z",
     "shell.execute_reply": "2021-09-23T04:29:12.376113Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\u001b[2KProcessing file BSSN_Two_BHs_Collide_Ccodes_psi4/output/out270-00030600.txt\r"
     ]
    }
   ],
   "source": [
    "## VISUALIZATION ANIMATION, PART 1: Generate PNGs, one per frame of movie ##\n",
    "\n",
    "import numpy as np\n",
    "from scipy.interpolate import griddata\n",
    "import matplotlib.pyplot as plt\n",
    "from matplotlib.pyplot import savefig\n",
    "from IPython.display import HTML\n",
    "import matplotlib.image as mgimg\n",
    "\n",
    "import glob\n",
    "import sys\n",
    "from matplotlib import animation\n",
    "\n",
    "globby = glob.glob(os.path.join(outdir,'out*-00*.txt'))\n",
    "file_list = []\n",
    "for x in sorted(globby):\n",
    "    file_list.append(x)\n",
    "\n",
    "bound=1.4\n",
    "pl_xmin = -bound\n",
    "pl_xmax = +bound\n",
    "pl_ymin = -bound\n",
    "pl_ymax = +bound\n",
    "\n",
    "for filename in file_list:\n",
    "    fig = plt.figure()\n",
    "    x,y,cf,Ham = np.loadtxt(filename).T #Transposed for easier unpacking\n",
    "\n",
    "    plotquantity = cf\n",
    "    plotdescription = \"Numerical Soln.\"\n",
    "    plt.title(\"Black Hole Head-on Collision (conf factor)\")\n",
    "    plt.xlabel(\"y/M\")\n",
    "    plt.ylabel(\"z/M\")\n",
    "\n",
    "    grid_x, grid_y = np.mgrid[pl_xmin:pl_xmax:300j, pl_ymin:pl_ymax:300j]\n",
    "    points = np.zeros((len(x), 2))\n",
    "    for i in range(len(x)):\n",
    "        # Zach says: No idea why x and y get flipped...\n",
    "        points[i][0] = y[i]\n",
    "        points[i][1] = x[i]\n",
    "\n",
    "    grid = griddata(points, plotquantity, (grid_x, grid_y), method='nearest')\n",
    "    gridcub = griddata(points, plotquantity, (grid_x, grid_y), method='cubic')\n",
    "    im = plt.imshow(gridcub, extent=(pl_xmin,pl_xmax, pl_ymin,pl_ymax))\n",
    "    ax = plt.colorbar()\n",
    "    ax.set_label(plotdescription)\n",
    "    savefig(os.path.join(filename+\".png\"),dpi=150)\n",
    "    plt.close(fig)\n",
    "    sys.stdout.write(\"%c[2K\" % 27)\n",
    "    sys.stdout.write(\"Processing file \"+filename+\"\\r\")\n",
    "    sys.stdout.flush()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='genvideo'></a>\n",
    "\n",
    "## Step 7.c: Generate visualization animation \\[Back to [top](#toc)\\]\n",
    "$$\\label{genvideo}$$ \n",
    "\n",
    "In the following step, [ffmpeg](http://ffmpeg.org) is used to generate an [mp4](https://en.wikipedia.org/wiki/MPEG-4) video file, which can be played directly from this Jupyter notebook."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:12.872428Z",
     "iopub.status.busy": "2021-09-23T04:29:12.869612Z",
     "iopub.status.idle": "2021-09-23T04:29:12.874425Z",
     "shell.execute_reply": "2021-09-23T04:29:12.874102Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "\n",
       "<video width=\"480\" height=\"360\" controls>\n",
       "  <source src=\"BSSN_Two_BHs_Collide_Ccodes_psi4/output/BH_Head-on_Collision.mp4\" type=\"video/mp4\">\n",
       "</video>\n"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "## VISUALIZATION ANIMATION, PART 2: Combine PNGs to generate movie ##\n",
    "\n",
    "# https://stackoverflow.com/questions/14908576/how-to-remove-frame-from-matplotlib-pyplot-figure-vs-matplotlib-figure-frame\n",
    "# https://stackoverflow.com/questions/23176161/animating-pngs-in-matplotlib-using-artistanimation\n",
    "\n",
    "fig = plt.figure(frameon=False)\n",
    "ax = fig.add_axes([0, 0, 1, 1])\n",
    "ax.axis('off')\n",
    "\n",
    "myimages = []\n",
    "\n",
    "for i in range(len(file_list)):\n",
    "    img = mgimg.imread(file_list[i]+\".png\")\n",
    "    imgplot = plt.imshow(img)\n",
    "    myimages.append([imgplot])\n",
    "\n",
    "ani = animation.ArtistAnimation(fig, myimages, interval=100,  repeat_delay=1000)\n",
    "plt.close()\n",
    "ani.save(os.path.join(outdir,'BH_Head-on_Collision.mp4'), fps=5,dpi=150)\n",
    "\n",
    "## VISUALIZATION ANIMATION, PART 3: Display movie as embedded HTML5 (see next cell) ##\n",
    "\n",
    "# https://stackoverflow.com/questions/18019477/how-can-i-play-a-local-video-in-my-ipython-notebook\n",
    "\n",
    "# Embed video based on suggestion:\n",
    "#  https://stackoverflow.com/questions/39900173/jupyter-notebook-html-cell-magic-with-python-variable\n",
    "HTML(\"\"\"\n",
    "<video width=\"480\" height=\"360\" controls>\n",
    "  <source src=\\\"\"\"\"+os.path.join(outdir,\"BH_Head-on_Collision.mp4\")+\"\"\"\\\" type=\"video/mp4\">\n",
    "</video>\n",
    "\"\"\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='numerror'></a>\n",
    "\n",
    "# Step 8: Plot the numerical error at the end of the simulation \\[Back to [top](#toc)\\]\n",
    "$$\\label{numerror}$$\n",
    "\n",
    "Here we plot the log10-absolute value Hamiltonian constraint violation on the $x$-$z$ plane, near the black hole (at $x=y=z=0$). Notice the constraint violation is largest inside the horizon, as expected. Notice also the black hole is a little bit less than $1M$ in radius."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:12.886917Z",
     "iopub.status.busy": "2021-09-23T04:29:12.877392Z",
     "iopub.status.idle": "2021-09-23T04:29:13.021121Z",
     "shell.execute_reply": "2021-09-23T04:29:13.020874Z"
    },
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "image/png": "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bkPPnj3h8/nQo0cPXH311aHQXmNjI+bMmYPBgwejoKAA7du3x4gRI0xj8EaaP4dEtCDG+qyN+P1+XHrppaiursayZcvQrVs3PP3007j++uuxceNGx8tI0bESoMjJycGjjz6KDRs24Fe/+lXo/SlTpqC2thbLly+H1+u1dMwvv/wS27dvR//+/XH99dejffv2aN++Pfr372/py+z1enHHHXfg888/x4oVKyyVIZbKykq89tprmDlzJq655ho8//zzuPHGG3HNNdfgv//9L+bNm4cf//jHWL58Oe6++25b56qtrcXu3bul1549eyK2q6qqwrJly3D99dfjnnvukSpcEyZMwOHDh7Fo0SJMnjzZ8DwrVqzASSed1KJ79fLLL6OiogLz589H9+7dMWLECMyYMQPvv/8+jj322NB2Y8eOxWuvvYZgMBjzmNdddx3mzJmDQYMGhZrPKysrccUVV0jbzZo1C/Pnz8eQIUOwePFiHH/88Tj//PNtx9OdaC4PBoP497//bdhyM3ToUGzcuNHwr/3m/9lEu08vv/wyTjjhBDz++OMYOHAgTjjhBNxwww147rnnTFvUmo0dOzZqZWzfvn246KKLMGzYMPz2t7+Fz+fDFVdcgaeffhpXXHEFLrzwQvzmN79BXV0dxo8fL5X/k08+wQcffIArrrgC999/P2688UasXLkSZWVloYr72WefjVtuuQXA0bj4448/jscffxwnnXRS6DgbNmzA+PHjcd555+Gee+5Bx44dUVFRgf/93/8NbXPo0CGMGDECy5Ytww9/+EP87ne/w4033ojq6upQP6EDBw7gj3/8I8rKynD33Xdj3rx52LVrF84//3ysW7cu5n1q1vw5mD0PgUAg4nu5e/du7Nu3z/TYsT5rI+vXr8eGDRtwzz334IYbbkB2djYuv/xyLFiwAK+++mqLj0MOEGRo1qxZwuPxiHfffVf87W9/EwDE0qVLo27fvM3bb78dse75558XAETnzp3F8ccfL6qqqkRVVZU4/vjjRVZWlvj8889Ny7Jp0yYBQCxevFj4/X5x/PHHiwEDBohgMCiEEGLu3LkCgNi1a1don5KSElFeXh5xrJEjR4qRI0eGlt9++20BQPTr1080NjaG3p84caLQNE1ccMEF0v5nnHGGKCkpMS1vNFVVVQKA4cvn80Vcb35+vvj++++lYzRf68SJE1t8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zJkzBxUVFTGHhPbq1QuLFi3CjTfeiNdff910aGGzCy+8EHV1dVi1alXLLyiGZ599FuXl5bjnnntCHfvOOuusiO+SE5W73r1744svvohZntLSUjz//PO46qqrcP7552P06NGhVphYzj77bNx0002YOnUq1q1bZ5jgya733nsP+/btw7333ouJEyfi5JNPjus448ePx+uvvw4hhOMdnyk6VgIMNGc76969O373u99h+fLl2LlzJ2677ba4jpeXl4cLL7wQH3zwAaqrq0Pvf/XVV/jggw9w3nnnWT6mvjXgxRdfjFjfu3dvrF69Wvor6aWXXoo5/CoeW7dula4rGTZu3BgxtMjKEEGj/+EKIRAIBCJaHXw+H84991zTkMCFF14IAFi6dKn0/r333gvg6F+xAHDuueciIyMDDz30kLTd//zP/8Qss5ns7Gx07drVsCJo1fjx4/HJJ59IFYH169fjrbfeitqT/8CBAwAiw0nNolVwmpqapDi4meLiYpx66qktHrLZEl6vN6JSvWzZsogWtOa8FHbu72WXXRZ1pE9zGZpbFPRl+uijj0wTkxlpDk848TyoYn3WRg4ePGjYr6j5Padb+ig6JgsycNddd2HdunVYuXIl8vLy0L9/f8yZMwd33HEHxo8fH/qBb94WQGjoz+OPP4733nsPwNGMbM0WLVqElStX4pxzzgl1MLz//vvRqVMnzJ49O65yXnnllbjzzjsNhwpdd911ePbZZzFmzBhcfvnl2LhxI5544gn07t07rnOZufrqq7Fq1aoWNzW+8sorhpWG4cOHo7S0NK4ynHvuuQAgjedesWIFJk2ahKqqqpidA3v37o1JkyahrKwM33//Pd555x3cf//9+PLLLyP+Bw0c/Z/8L37xCzQ0NBh2mhswYADKy8vxyCOPYP/+/Rg5ciQ+/vhjPProoxg3blyoD0S3bt1w66234p577sEll1yCMWPG4PPPP8crr7yCLl262PqL0+PxmH4mjz/+OLZs2RIa+vbuu++Gnuerrroq1Epx00034Q9/+APGjh2LX/ziF8jMzMS9996Lbt26hTo6qprPG21I2uWXX45u3brhoosuwn//+19s2rQJv/zlL/HHP/4Rl112meE9NXLhhRfiueeei6hsxeuiiy7C448/joKCApx88sn48MMP8eabb0pZEYGjibu8Xi/uvvtu1NbWhvoodO3atcXn+uUvfxlKMnbNNddg8ODB2Lt3L1588UU8/PDDGDBgAC666CI8//zz+NGPfoSxY8di06ZNePjhh3HyySe3qANes3jG8rdUrM/ayJo1a3D99deHrruhoQGPPfYY7r33XmRmZmL8+PGOl5OiaOXRCK63Zs0akZGRIW6++Wbpfb/fL04//XTRvXt3sW/fvtD7MBlSY3Ts0aNHi/bt24u8vDxx6aWXiv/+978xy6QfIqjSD7vTDxEUQoh77rlHHHvsscLn84kzzzxTfPrpp1GHCP7tb38zPO4nn3wivW80HLF5eFEsZkMEoRuqZXa9RucX4ugQI3WYkZUhgo888og499xzRVFRkdA0TeTk5Ih+/fqJBx980HD7rVu3CgDitddek8ql19TUJObPny969eolMjMzRXFxsZg1a5aor6+XtvP7/eLXv/61KCoqEjk5OeKcc84RX331lejcubO48cYbY5Y9mtLSUnHuuedGXW82LEwd+lZTUyPGjx8v8vPzRW5urrjooovE119/HfXY//znPwUA8a9//ctw/ZtvvhkaJpiZmSkyMjJEr169xIwZM8SBAwekbY2GCDZ79913BQCxfv360DWdcsopEduVlJSIsWPHRrwPQEyZMiW0vG/fPjFp0iTRpUsXkZubK84//3xRXV1tOOT2D3/4gygtLRVer1e6Z9HOpX73hBBiz549YurUqeLYY48VWVlZokePHqK8vFzs3r1bCHF0qOCiRYtESUmJ8Pl8YuDAgeKll14S5eXlEc87TIYIPvbYY6afR7T7JoT591EIIR588EEBQNTU1Jjur3+m9u3bJ+68804xZMgQ0bFjRwFAdOjQQYwYMUKsXLnS8DiUGKwEECnM8gTo9evXT9x6660JKcO+ffsEAHHXXXfFfYwRI0aIgoIC8d5774mdO3c6WLroDh48KL755hvxs5/9TAAQ33zzTcx94skT0Mzv94sOHTqI++67L84Sp4eVK1cKAOL6668XmzdvFnV1dbaPuX//frF+/XoxevRokZmZGVG5bWZUCVAxT0DysE8AUZwWLVrUoiFesRiNs29u3taneLZq2rRpaGhowFlnnZWQnPFGpk6ditLSUjzxxBO4/PLLHR/KqfJ6vbj//vtbPAFXuhoxYgTOPPNMPPLII+jZs6el3CTRXHrppaHUy9OmTWtxCIfchX0CiBTjxo1r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\n",
      "text/plain": [
       "<Figure size 640x480 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "outfile = os.path.join(outdir,'out' + str(Nr) + '.txt')\n",
    "x,y,valuesCF,valuesHam = np.loadtxt(outfile).T #Transposed for easier unpacking\n",
    "\n",
    "pl_xmin = -2.5\n",
    "pl_xmax = +2.5\n",
    "pl_ymin = -2.5\n",
    "pl_ymax = +2.5\n",
    "\n",
    "grid_x, grid_y = np.mgrid[pl_xmin:pl_xmax:100j, pl_ymin:pl_ymax:100j]\n",
    "points = np.zeros((len(x), 2))\n",
    "for i in range(len(x)):\n",
    "    points[i][0] = x[i]\n",
    "    points[i][1] = y[i]\n",
    "\n",
    "grid = griddata(points, valuesCF, (grid_x, grid_y), method='nearest')\n",
    "gridcub = griddata(points, valuesCF, (grid_x, grid_y), method='cubic')\n",
    "\n",
    "grid = griddata(points, valuesHam, (grid_x, grid_y), method='nearest')\n",
    "gridcub = griddata(points, valuesHam, (grid_x, grid_y), method='cubic')\n",
    "\n",
    "# fig, ax = plt.subplots()\n",
    "\n",
    "plt.clf()\n",
    "plt.title(r\"x16 Num. Err.: $\\log_{10}$|\\mathcal{H}|$\")\n",
    "plt.xlabel(r\"$x/M$\")\n",
    "plt.ylabel(r\"$z/M$\")\n",
    "\n",
    "figcub = plt.imshow(gridcub.T, extent=(pl_xmin,pl_xmax, pl_ymin,pl_ymax))\n",
    "cb = plt.colorbar(figcub)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='compare'></a>\n",
    "\n",
    "# Step 9: Compare ringdown gravitational wave signal with black hole perturbation theory  \\[Back to [top](#toc)\\]\n",
    "$$\\label{compare}$$\n",
    "\n",
    "According to black hole perturbation theory ([Berti et al](https://arxiv.org/abs/0905.2975)), the resultant black hole should ring down with dominant, spin-weight $s=-2$ spherical harmonic mode $(l=2,m=0)$ according to\n",
    "\n",
    "$$\n",
    "{}_{s=-2}\\text{Re}(\\psi_4)_{l=2,m=0} = A e^{−0.0890 t/M} \\cos(0.3737 t/M+ \\phi),\n",
    "$$\n",
    "\n",
    "where $M=1$ for these data, and $A$ and $\\phi$ are an arbitrary amplitude and phase, respectively. Here we will plot the resulting waveform at $r/M=33.13$, comparing to the expected frequency and amplitude falloff predicted by black hole perturbation theory.\n",
    "\n",
    "Notice that we find about 4.2 orders of magnitude agreement! If you are willing to invest more resources and wait much longer, you will find approximately 8.5 orders of magnitude agreement (*better* than Fig 6 of [Ruchlin et al](https://arxiv.org/pdf/1712.07658.pdf)) if you simply set `EvolOption=\"high resolution\"`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/plain": [
       "<Figure size 640x480 with 0 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%matplotlib inline\n",
    "\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "from matplotlib.pyplot import savefig\n",
    "\n",
    "from matplotlib import rc\n",
    "rc('text', usetex=True)\n",
    "\n",
    "\n",
    "if EvolOption == \"low resolution\":\n",
    "    extraction_radius = \"30.20\"\n",
    "    Amplitude = 1.8e-2\n",
    "    Phase     = 2.8\n",
    "elif EvolOption == \"high resolution\":\n",
    "    extraction_radius = \"33.64\"\n",
    "    Amplitude = 1.8e-2\n",
    "    Phase     = 2.8\n",
    "else:\n",
    "    print(\"Error: output is not tuned for Nr = \"+str(Nr)+\" . Plotting disabled.\")\n",
    "    sys.exit(1)\n",
    "\n",
    "# Transposed for easier unpacking:\n",
    "t,psi4r,psi4i = np.loadtxt(os.path.join(outdir, \"outpsi4_l2_m0-r\"+extraction_radius+\".txt\")).T\n",
    "\n",
    "t_retarded    = []\n",
    "log10abspsi4r = []\n",
    "bh_pert_thry  = []\n",
    "for i in range(len(psi4r)):\n",
    "    retarded_time = t[i]-float(extraction_radius)\n",
    "    t_retarded.append(retarded_time)\n",
    "    log10abspsi4r.append(np.log(float(extraction_radius)*np.abs(psi4r[i]))/np.log(10))\n",
    "    bh_pert_thry.append(np.log(Amplitude*np.exp(-0.0890*retarded_time)*np.abs(np.cos(0.3737*retarded_time+Phase)))/np.log(10))\n",
    "\n",
    "fig, ax = plt.subplots()\n",
    "plt.title(\"Grav. Wave Agreement with BH perturbation theory\", fontsize=18)\n",
    "plt.xlabel(r\"$(t - R_{\\rm ext})/M$\", fontsize=16)\n",
    "plt.ylabel(r\"$\\log_{10}|\\psi_4|$\", fontsize=16)\n",
    "\n",
    "ax.plot(t_retarded, log10abspsi4r, 'k-', label='NRPy+ simulation')\n",
    "ax.plot(t_retarded, bh_pert_thry, 'k--', label='BH perturbation theory')\n",
    "#ax.set_xlim([0,t_retarded[len(psi4r1)-1]])\n",
    "ax.set_xlim([0, 1.5*domain_size - float(extraction_radius)])\n",
    "ax.set_ylim([-13.5, -1.5])\n",
    "\n",
    "plt.xticks(size = 14)\n",
    "plt.yticks(size = 14)\n",
    "\n",
    "legend = ax.legend(loc='upper right', shadow=True, fontsize='x-large')\n",
    "legend.get_frame().set_facecolor('C1')\n",
    "\n",
    "plt.show()\n",
    "\n",
    "# Note that you'll need `dvipng` installed to generate the following file:\n",
    "savefig(os.path.join(outdir, \"BHperttheorycompare.png\"), dpi=150)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='latex_pdf_output'></a>\n",
    "\n",
    "# Step 10: Output this notebook to $\\LaTeX$-formatted PDF file \\[Back to [top](#toc)\\]\n",
    "$$\\label{latex_pdf_output}$$\n",
    "\n",
    "The following code cell converts this Jupyter notebook into a proper, clickable $\\LaTeX$-formatted PDF file. After the cell is successfully run, the generated PDF may be found in the root NRPy+ tutorial directory, with filename\n",
    "[Tutorial-Start_to_Finish-BSSNCurvilinear-Two_BHs_Collide-Psi4.pdf](Tutorial-Start_to_Finish-BSSNCurvilinear-Two_BHs_Collide-Psi4.pdf) (Note that clicking on this link may not work; you may need to open the PDF file through another means.)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2021-09-23T04:29:13.123239Z",
     "iopub.status.busy": "2021-09-23T04:29:13.122959Z",
     "iopub.status.idle": "2021-09-23T04:29:16.138662Z",
     "shell.execute_reply": "2021-09-23T04:29:16.138340Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Created Tutorial-Start_to_Finish-BSSNCurvilinear-Two_BHs_Collide-Psi4.tex,\n",
      "    and compiled LaTeX file to PDF file Tutorial-Start_to_Finish-\n",
      "    BSSNCurvilinear-Two_BHs_Collide-Psi4.pdf\n"
     ]
    }
   ],
   "source": [
    "import cmdline_helper as cmd    # NRPy+: Multi-platform Python command-line interface\n",
    "cmd.output_Jupyter_notebook_to_LaTeXed_PDF(\"Tutorial-Start_to_Finish-BSSNCurvilinear-Two_BHs_Collide-Psi4\")"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.11.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}