Function InitBaseGeometry

Wrapping/Python/mitk/Geometries.cpp:26–212

using namespace mitk;

void InitBaseGeometry(py::module_& m)
{
  py::class_<BaseGeometry, BaseGeometry::Pointer>(m, "BaseGeometry",
    R"(Spatial geometry of a 3D object.

A ``BaseGeometry`` ties the discrete index space (voxel indices) of an
image or data object to a continuous world coordinate system. It carries:

- An **origin**: world coordinates of the index ``(0, 0, 0)``.
- A **spacing**: world distance between adjacent indices along each axis.
- A **direction cosine matrix**: orientation of the index axes in world
  space.
- **Bounds**: the index-space extent of the data.

``BaseGeometry`` is abstract. The concrete subclasses bound here are
:py:class:`Geometry3D`, :py:class:`PlaneGeometry`, and
:py:class:`SlicedGeometry3D`.
)")
    .def_property("image_geometry", &BaseGeometry::GetImageGeometry, &BaseGeometry::SetImageGeometry,
      R"(Whether this geometry is interpreted as an image geometry.

When True, world coordinates address voxel centers (corner-based addressing
shifted by half a voxel); when False, world coordinates address voxel
corners.
)")
    .def_property("origin", &BaseGeometry::GetOrigin, &BaseGeometry::SetOrigin,
      "World coordinates of the index ``(0, 0, 0)`` as a :py:class:`Point3D`.")
    .def_property("spacing", &BaseGeometry::GetSpacing, &BaseGeometry::SetSpacing,
      "Voxel spacing in world units as a :py:class:`Vector3D` ``(sx, sy, sz)``.")
    .def("enforce_spacing",
      [](BaseGeometry& g, const Vector3D& s) {
        g.SetSpacing(s, true);
      },
      py::arg("spacing"),
      R"(Set spacing and rescale the index-to-world transform accordingly.

Equivalent to ``SetSpacing(spacing, enforceSetSpacing=True)``: rather than
storing the spacing as an independent value, the transform is rebuilt so
that the requested spacing is preserved exactly when the matrix is
re-decomposed.

Args:
    spacing: New spacing as a :py:class:`Vector3D`.
)")
    .def_property("frame_of_reference_id", &BaseGeometry::GetFrameOfReferenceID, &BaseGeometry::SetFrameOfReferenceID,
      "DICOM Frame of Reference ID used to group geometries that share a coordinate system.")
    .def_property("bounds",
      [](const BaseGeometry& g) {
        const auto b = g.GetBounds();
        return std::vector<ScalarType>(b.begin(), b.end());
      },
      [](BaseGeometry& g, const std::vector<ScalarType>& v) {
        if (v.size() != 6)
          mitkThrow() << "Bounds must be of length 6";

        BaseGeometry::BoundsArrayType b;
        std::copy(v.begin(), v.end(), b.begin());