Objects and modifiers

Microscopy Nodes loads your microscopy data as different types of objects, depending on how you loaded each channel.

mic nodes objects

Each type of object is placed in a holder collection. The Axes and Slice Cube are always present.

You can select an object by clicking on it in the outliner (as shown in the screenshot) and change its properties:

Change underlying data in the modifier menu of the properties or the (advanced) Geometry Nodes workspace
Change visualization in the material menu of the properties or the Shader Nodes workspace

The exact settings and where to change them change per object, so see below.

Holder

The Holder is an empty object which is the parent of the other Microscopy Nodes objects.

The holder can be scaled, moved and rotated and then all of its objects will be transformed along with it.

Axes

The Axes object is always loaded with your dataset. It draws a scale grid based on the number of pixels, pixel size, and pixel unit.

Geometry options
- pixel unit per tick
  
  The distance between grid lines
- Grid
  
  Whether to draw a grid or only a box
- Line thickness
  
  Relative thickness of the grid lines
- Frontface culling
  
  If ticked, clips out the axes that are closest to the camera or viewpoint, so that they do not obstruct the view.
- Separate planes
  
  For each plane (xy bottom, top etc) you can select whether they will be drawn
Shader options
- Color

Scale grids can be moved, scaled and rotated independently of the holder without losing their accuracy.

Bars versus grids

Scale grids remain meaningful in a 3D perspective scene. A conventional scale bar is globally accurate only with an orthographic camera. Microscopy Nodes provides dynamic and rigid scale-bar nodes; see Scale bars, grids, and time labels.

Volumes

The Volume holds channels of volumetric data, which can be rendered either as emitting or scattering light. It is generated when you enable Volume during loading.

Geometry options
- Included channels
  
  If channels are not included, they are also not loaded into RAM
Shader options
- Pixel intensities
- Opacity calculation
- Color LUT

The easiest way to edit a volume shader is in the Shader Nodes workspace, where you can most easily switch between channels in the properties.

You can toggle between emission and scattering modes using the emission toggle in loading.

Surfaces

The Surface object is a mesh extracted from a volume using an isosurface threshold. It is generated when you enable Surface during loading.

Geometry options
- Included channels
- Threshold
  
  The intensity value above which the surface is extracted.
- Voxel size (only listed if Mesh Resolution is not Actual)
  
  Interactive scalable unit for mesh detail
Shader options
- Standard mesh shading parameters (color, opacity etc)

Label Masks

The Label Mask object is a mesh generated from a label image, such as a segmentation channel. It is generated when you enable Labelmask during loading.

Each value in the volume is turned into a separate mesh.

Geometry options
- Included channels
Shader options
- Color per label
- Revolving colormap or linearly distributed among objects
- Standard mesh shading parameters (color, opacity etc)

Slice Cube

The Slice Cube is a movable object that defines a region of interest for other objects.

With shader slicing, its bounds make data outside the cube transparent. With geometry slicing, it becomes a voxel mask and provides inside and outside grids that can be processed, recolored, or reloaded independently.

The default cube can be replaced by another object, mesh, collection, label mask, or grid in the Geometry Nodes mask setup. See Slice, mask, and recolor data.

How the Microcopy Nodes objects work

The data objects are Geometry Nodes objects that reference preloaded data stored in the cache collection. In the Geometry Nodes workspace you can add edit the loaded data and add modifiers.