Adding option to create a partially heterogeneous assemblies for 1D XS model

[mgjarrett]

What is the change?

The latticePhysicsInterface and crossSectionGroupManager modules are being updated to enable a new type of 1D cylindrical cross section model. The key features added are:

• New type of block collection in crossSectionGroupManager, CylindricalComponentsPartHetAverageBlockCollection, which extends the existing CylindricalComponentsAverageBlockCollection with a modified method for calculating the average nuclide temperatures within the representative block.
• New crossSectionControlSettings:
  1. mergeIntoFuel allows a user to specify components to be merged into the fuel for the cross section model
  2. ductHeterogeneous enables the user to select the partially heterogeneous 1D model (as opposed to fully heterogeneous)
  3. traceIsotopeThreshold allows a user to split low-concentration isotopes out of the 1D cross section model and instead run a 0D model to obtain cross sections for those isotopes.

Much of the implementation details related to these new crossSectionControl options would need to be implemented in the downstream plugins that extend the latticePhysicsInterface.

Why is the change being made?

These features are being added to enable downstream lattice physics plugins to have more options and flexibility when it comes to building a 1D cylindrical equivalent model of a 2D hexagonal assembly for cross section generation. Since a fully-heterogeneous 1D cylindrical model can pose a significantly more compute-intensive problem for the lattice physics solver than a simple 0D model, it is helpful to have options for simplifying the 1D model. Combining small/unimportant components into others (mergeIntoFuel), homogenizing several regions together (ductHeterogeneous), and pulling out trace isotopes that don't contribute significantly to reaction rates (traceIsotopeThreshold) can all help to reduce the complexity of the 1D model.

---

Checklist

• This PR has only one purpose or idea.
• Tests have been added/updated to verify any new/changed code.

• The code style follows good practices.
• The commit message(s) follow good practices.

• The release notes have been updated if necessary.
• The documentation is still up-to-date in the doc folder.
• The dependencies are still up-to-date in pyproject.toml.

[jakehader]

@mgjarrett - Do you have some images you could share on what this model looks like when enabled? Is there any part of the user manual / documentation should be amended to describe this in more detail with examples?

[mgjarrett]

@mgjarrett - Do you have some images you could share on what this model looks like when enabled? Is there any part of the user manual / documentation should be amended to describe this in more detail with examples?

Here are two PNGs generated by ARMI of the converted 1D cylindrical representation of the 2D hexagon. This is for a hexagon with 10 rings of pins (271 total pins in the lattice).

Partially Heterogeneous (everything inside the duct is homogenized):

Fully heterogeneous:

[mgjarrett]

I could maybe expand this gallery example to include the partially heterogeneous option:
https://terrapower.github.io/armi/gallery/analysis/run_hexBlockToRZConversion.html#sphx-glr-gallery-analysis-run-hexblocktorzconversion-py

[john-science]

bump