Fix for issue #3158 - Streamline use of CompositeSurface with SurfaceFilter

[zoeprieto]

Description

This is a preliminary solution to issue #3158. The solution b) proposed in the issue was chosen:

• Adding a CompositeSurfaces.get_surfaces() method that returns a list of the objects surface objects to make it simpler to create the desired filter, leaving SurfaceFilter as-is.

Additionally the following changes were made:

• Added a method that is get_id_surfaces() to be able to write CompositeSurface surface source files.
• Added a preliminary test in tests/unit_tests/test_filters.py.

Fixes #3158

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)

[pshriwise]

A few minor thoughts for your consideration @zoeprieto.

[pshriwise]

I think better yet we'd be able to pass a CompositeSurface directly to the SurfaceFilter class, which might require some additional handling in that object.

[zoeprieto]

Yes, I think it is clearer. It is already done. I thought it was easier to change the SurfaceFilter class than to make a CompositeSurface always return a list of surfaces. Let me know what you think.

[pshriwise]

A couple of additional thoughts on streamlining use of CompositeFilter.

[pshriwise]

I think ideally a user would be able to provide the CompositeSurface object in the bins argument alongside the other surfaces:

surfaces = [openmc.ZCylinder(r=1), openmc.ZCylinder(r=2), openmc.ZCylinder(r=3)]
prism = openmc.model.RectgangularPrism(7, 7)

surface_filter = openmc.SurfaceFilter(surfaces + [prism])

[pshriwise]

We'll probably also want to show a warning explaining that many bins will be added for the CompositeSurface if one exists to the user isn't confused about extra bins appearing in the tally results when applying the resulting filter.

[zoeprieto]

The feature to combine Surface and CompositeSurface is now available. And I have also added a user warning.