Implement a new MeshMaterialFilter

[paulromano]

Description

This PR implements a new MeshMaterialFilter that allows tallying specific combinations of mesh elements and materials. In principle, one can already do this by combining a MeshFilter and a MaterialFilter. However, in many cases a single mesh element only contains a few materials, which means tallying every single material for each mesh element would be very wasteful. This new filter works in conjunction with the Mesh.material_volumes() method, which returns a MeshMaterialVolumes object. This filter has a from_volumes() classmethod that will create a filter with bins for all mesh element-material combinations that were found from the call to material_volumes(). So, the workflow is basically:

# Build your model
model = openmc.Model()
...

# Set up a mesh
mesh = openmc.RegularMesh()
...


# Determine materials present in each mesh element
mat_vols = mesh.material_volumes(model, ...)

# Create corresponding filter
mm_filter = openmc.MeshMaterialFilter.from_volumes(mat_vols)

This new filter is one of the last infrastructural pieces needed to carry out mesh-based subvoxel R2S calculations.

Checklist

• I have performed a self-review of my own code
• I have run clang-format (version 15) on any C++ source files (if applicable)
• I have followed the style guidelines for Python source files (if applicable)
• I have made corresponding changes to the documentation (if applicable)
• I have added tests that prove my fix is effective or that my feature works (if applicable)

[shimwell]

The Bins print to terminal, but the spacing is not ideal, perhaps add more white spacing to indent

MeshMaterialFilter
        ID             =        2
        Mesh ID        =        2
        Bins           =        [[644   1]
 [645   1]
 [654   1]
 [655   1]
 [744   1]
 [745   1]
 [754   1]
 [755   1]
 [844   1]
 [845   1]
 [854   1]
 [855   1]]
        Translation    =        None

[pshriwise]

Nice @paulromano! I'm looking forward to trying this out. Some potential small refactors suggested here.

[pshriwise]

I think defining our own FilterMatch, let's call it mesh_match, here to pass to the mesh would simplify what's going on in the loop below. We can then sequentially remove invalid bins to match from mesh_match and add the remaining valid bins to match at the end.

[shimwell]

Awesome, thanks Patrick, looks like lots of good changes.

I've been putting this branch to use to see how the workflow goes.

I can probably improve this draft notebook. It does appear possible to do and R2S workflow with this new MeshMaterialFilter. I can't say it was easy and I'm not 100% sure I've done all the processing correctly but I've got something here.

https://github.com/fusion-energy/neutronics-workshop/blob/testing-MeshMaterialFilter/tasks/task_11_CSG_shut_down_dose_tallies/3_R2S_regularmesh_shutdown_dose_rate.ipynb

I think we could consider adding some utility functions to make some of the stages more compact.