Release 2021.09.06

Upgrade instructions

From #3307 (Add FixedSpeedCubic to BinaryCompactObject):

When time dependence is enabled in the BinaryCompactObject domain, previously, the options for the ExpansionFactor included options to specify the two FunctionOfTimes used by the CubicScale map, e.g.

ExpansionMap:
  OuterBoundary: 25.0
  InitialExpansion: [1.0, 1.0]
  InitialExpansionVelocity: [-0.1, -0.01]
  FunctionOfTimeNames: ['ExpansionFactor', 'ExpansionFactorOuterBdry']

After this PR, instead specify one FunctionOfTime and the desired asymptotic velocity (and timescale for approaching that velocity) for the outer boundary, e.g.

ExpansionMap:
  OuterBoundary: 25.0
  InitialExpansion: 1.0
  InitialExpansionVelocity: -0.1
  FunctionOfTimeName: 'ExpansionFactor'
  AsymptoticVelocityOuterBoundary: -1.0e-6
  DecayTimescaleOuterBoundaryVelocity: 50.0

From #3421 (Specify temporal_id for interpolation in interpolation target tags):

Interpolation target tags must now specify a temporal_id. In almost all cases it should be using temporal_id = ::Tags::Time;.

From #3365 (Use Frame::BlockLogical as source frame for CoordinateMap in a Block):

• DomainCreators will need to switch the source frame of their CoordinateMaps to use Frame::BlockLogical
• If you use BlockLogicalCoordinates for interpolation, they will need to be defined in Frame::BlockLogical
• If you create a CoordinateMap to construct a Block, it will need to use Frame::BlockLogical as the source frame

From #3330 (Logarithmic cylinder):

The Cylinder now allows to choose the distribution of grid points along the z-axis for each layer. To keep the behaviors the same as before for a single layer, specify DistributionInZ: [Linear].

From #3471 (Convert BoundaryCondition to factory map):

• Instead of having a type alias of creatable_classes within the system-specific BoundaryCondition base classes, specify a type alias such as standard_boundary_conditions in the BoundaryConditions namespace of the system.
• In evolution executables, add a tmpl::pair<SYSTEM::BoundaryConditions::BoundaryCondition, SYSTEM::BoundaryConditions::standard_boundary_conditions> to the factory_classes in the metavariables (where SYSTEM should be replaced by the appropriate namespace of the evolution system).
• You don't need the system-specific BoundaryConditions::register_derived_with_charm function in charm_init_node_funcs anymore.

Merged pull-requests (68)

New features (3):

• Events and dense triggers with local time stepping (#3355)
• Switch GRMHD executable to support DG-subcell (#3427)
• Add multigrid to elliptic executables (#3392)

General changes (49):

• Ease code coverage target for random-value tests (#3403)
• Small CMake cleanups (#3402)
• Add TimeDependence to RotatedIntervals (#3389)
• Add a note to Pybindings docs (#3415)
• Document stable step sizes for different time steppers (#3406)
• GRMHD subcell TCI check positivity of TildeD and TildeTau (#3410)
• Add Newtonian Euler numerical characteristics (#3395)
• Convert interpolation indexing to doubles (#3409)
• Add FixedSpeedCubic to BinaryCompactObject (#3307)
• Move index reordering higher up in TensorExpression syntax trees (#3387)
• Add option to apply Persson TCI to GRMHD TildeB (#3418)
• Add NeighborPackagedData to GRMHD (#3413)
• Mixed GH+MHD boundary conditions (#3358)
• Add shape map (#3017)
• Allow adding dense triggers programmatically (#3429)
• Specify temporal_id for interpolation in interpolation target tags (#3421)
• Add MinusLaplacian subdomain preconditioner to speed up elliptic solves (#3378)
• Pass more things to dense triggers' is_ready (#3433)
• Use Frame::BlockLogical as source frame for CoordinateMap in a Block (#3365)
• Add output operators for DataBox and AlgorithmImpl (#3401)
• Update Gh Bjorhus BC to freeze VPlus if char speed becomes negative (#3370)
• Add previous trigger time to dense triggers (#3445)
• Avoid default-constructing all DataBox items twice (#3441)
• Make a common H5 error message friendlier (#3439)
• Add analytic data for a plane wave in Minkowski background (#3100)
• Add load balancing notes to dev guide (#3426)
• Logarithmic cylinder (#3330)
• Enable running a gauge wave on a moving mesh (#3435)
• Observe lapse, constraints in GH exec (#3462)
• Support spatial spacetime indices for TensorExpressions::AddSub (#3420)
• Add a flag to prevent factory creation of a class (#3444)
• Add elliptic HasConverged trigger (#3452)
• Update python on ocean (#3400)
• Add Krivodonova and Kuzmin analytic solution to ScalarAdvection (#3386)
• Add filtering to GH Exec (#3461)
• Evaluate damping parameters in grid frame (#3460)
• Make timescale tuner serializable and constructible from options. (#3425)
• Make Averager serializable and constructible from options. (#3424)
• Add Quaternion FunctionOfTime (#3327)
• Subcell minor fixes (#3455)
• Clarify simple-action failure message (#3474)
• Make PiecewisePolynomial streamable (#3423)
• Add range checking to Blaze vector access (#3458)
• Add outflowing boundary conditions to CurvedScalarWave system (#3407)
• Add Krivodonova and Kuzmin executable to ScalarAdvection (#3405)
• Convert BoundaryCondition to factory map (#3471)
• Add action to randomize elliptic initial guess (#3437)
• Add orcid ID (Yoonsoo Kim) (#3488)
• Add apparent-horizon boundary conditions (#2961)

Bugfixes (16):

• Fix compilation error when the inertial coordinates are evolved in CCE (#3408)
• Fix AH find (#3399)
• Fix bounds for XCTS equation tests (#3404)
• A few minor fixes (#3428)
• Fix random roundoff cylindrical map errors (#3430)
• Fix PiecewisePolynomial results at update times (#3432)
• Fix InterpolationTarget docs (#3438)
• Fix order of multigrid actions in XCTS executable (#3443)
• Remove incorrect assertion in component mocking (#3449)
• Increase an input file test timeout (#3463)
• Fix typos in Poisson first order system documentation (#3466)
• Move test functions into anonymous namespace (#3472)
• MutableCache callbacks now work in ActionTesting. (#3465)
• Add missing include to DeterminantAndInverse.hpp (#3480)
• Clear PreviousTriggerTime when it is invalid (#3486)
• Update visualization docs (#3487)

Contributors (16): @Sizheng-Ma, @nilsleiffischer, @fmahebert, @moxcodes, @kidder, @nilsdeppe, @wthrowe, @geoffrey4444, @macedo22, @nikwit, @markscheel, @knelli2, @prayush, @tomwlodarczyk, @yoonso0-0, @osheamonn