openmc.Region

class openmc.Region[source]

Region of space that can be assigned to a cell.

Region is an abstract base class that is inherited by openmc.Halfspace, openmc.Intersection, openmc.Union, and openmc.Complement. Each of those respective classes are typically not instantiated directly but rather are created through operators of the Surface and Region classes.

clone(memo=None)[source]

Create a copy of this region - each of the surfaces in the region’s nodes will be cloned and will have new unique IDs.

Parameters

memo (dict or None) – A nested dictionary of previously cloned objects. This parameter is used internally and should not be specified by the user.

Returns

clone – The clone of this region

Return type

openmc.Region

static from_expression(expression, surfaces)[source]

Generate a region given an infix expression.

Parameters

  • expression (str) – Boolean expression relating surface half-spaces. The possible operators are union ‘|’, intersection ‘ ‘, and complement ‘~’. For example, ‘(1 -2) | 3 ~(4 -5)’.

  • surfaces (dict) – Dictionary whose keys are surface IDs that appear in the Boolean expression and whose values are Surface objects.

get_surfaces(surfaces=None)[source]

Recursively find all surfaces referenced by a region and return them

Parameters

surfaces (dict, optional) – Dictionary mapping surface IDs to openmc.Surface instances

Returns

surfaces – Dictionary mapping surface IDs to openmc.Surface instances

Return type

dict

plot(*args, **kwargs)[source]

Display a slice plot of the region.

New in version 0.14.1.

Parameters

  • origin (iterable of float) – Coordinates at the origin of the plot. If left as None then the bounding box center will be used to attempt to ascertain the origin. Defaults to (0, 0, 0) if the bounding box is not finite

  • width (iterable of float) – Width of the plot in each basis direction. If left as none then the bounding box width will be used to attempt to ascertain the plot width. Defaults to (10, 10) if the bounding box is not finite

  • pixels (Iterable of int or int) – If iterable of ints provided, then this directly sets the number of pixels to use in each basis direction. If int provided, then this sets the total number of pixels in the plot and the number of pixels in each basis direction is calculated from this total and the image aspect ratio.

  • basis ({'xy', 'xz', 'yz'}) – The basis directions for the plot

  • seed (int) – Seed for the random number generator

  • openmc_exec (str) – Path to OpenMC executable.

  • axes (matplotlib.Axes) – Axes to draw to

  • outline (bool) – Whether outlines between color boundaries should be drawn

  • axis_units ({'km', 'm', 'cm', 'mm'}) – Units used on the plot axis

  • **kwargs – Keyword arguments passed to matplotlib.pyplot.imshow()

Returns

Axes containing resulting image

Return type

matplotlib.axes.Axes

remove_redundant_surfaces(redundant_surfaces)[source]

Recursively remove all redundant surfaces referenced by this region

New in version 0.12.

Parameters

redundant_surfaces (dict) – Dictionary mapping redundant surface IDs to class:openmc.Surface instances that should replace them.

rotate(rotation, pivot=(0.0, 0.0, 0.0), order='xyz', inplace=False, memo=None)[source]

Rotate surface by angles provided or by applying matrix directly.

New in version 0.12.

Parameters

  • rotation (3-tuple of float, or 3x3 iterable) – A 3-tuple of angles \((\phi, \theta, \psi)\) in degrees where the first element is the rotation about the x-axis in the fixed laboratory frame, the second element is the rotation about the y-axis in the fixed laboratory frame, and the third element is the rotation about the z-axis in the fixed laboratory frame. The rotations are active rotations. Additionally a 3x3 rotation matrix can be specified directly either as a nested iterable or array.

  • pivot (iterable of float, optional) – (x, y, z) coordinates for the point to rotate about. Defaults to (0., 0., 0.)

  • order (str, optional) – A string of ‘x’, ‘y’, and ‘z’ in some order specifying which rotation to perform first, second, and third. Defaults to ‘xyz’ which means, the rotation by angle \(\phi\) about x will be applied first, followed by \(\theta\) about y and then \(\psi\) about z. This corresponds to an x-y-z extrinsic rotation as well as a z-y’-x’’ intrinsic rotation using Tait-Bryan angles \((\phi, \theta, \psi)\).

  • inplace (bool) – Whether or not to return a new instance of Surface or to modify the coefficients of this Surface in place. Defaults to False.

  • memo (dict or None) – Dictionary used for memoization

Returns

Translated region

Return type

openmc.Region

translate(vector, inplace=False, memo=None)[source]

Translate region in given direction

Parameters

  • vector (iterable of float) – Direction in which region should be translated

  • inplace (bool) –

    Whether or not to return a region based on new surfaces or one based on the original surfaces that have been modified.

    New in version 0.13.1.

  • memo (dict or None) – Dictionary used for memoization. This parameter is used internally and should not be specified by the user.

Returns

Translated region

Return type

openmc.Region