Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed "icons" with words that were embedded in the text to improve readability and made a few other grammatical edits

The Volume Transformer allows you to create a new version of an image that is rotated in 3D about any axis (X, Y, Z, or other) and has blank space trimmed from its edges, if that is opted for. You may adjust the angle of an ortho plane and/or choose a "bottom" plane to define the rotation angle.

Interface

The Volume Transformer is one of eight tools found in the 3D Tools tab in the (Pre-version 12) Analysis Panel. Go to 3D View or 3D Plane View to show the 3D Tools tab. Click on the 3D Tools tab, and then click on the Volume Transformer icon Image Modified to launch the tool. When the Volume Transformer is first launched, the GUI below appears.

Image Modified

Volume Transformer GUI


Each time the Volume Transformer is launched, an ortho plane is shown. Any existing clipping planes are hidden, and an ortho plane is created if one did not exist prior to the launch of the tool.

Tool options

Basic options

OptionIconDescription
ResetImage ModifiedResets the transformation to its default state (no transformation)
Optimize Image SizeImage Modified


If selected, blank space will be trimmed from the sides of the transformed image, which can cause the transformation to be slower
Apply TransformImage ModifiedApplies the transformation, generating a new image that is added to the Image Explorer and displayed in the Image Viewer once it has been created

More options

You can access these options by clicking on the expand icon Image Modified next to More Options.

OptionIconDescription
Extra Alignment Points

Image Modified

Adds three points that anchor the ortho plane and can be moved to any spatial locations to help with fine adjustment of the rotation angle
Show Intersecting PlaneImage ModifiedClips away the portions of the image that do not intersect with the ortho plane
PreviewImage ModifiedShows a preview of the transformation
Channels to ProcessImage Modified


Allows you to select/deselect image channels to transform

Advanced option

You can access this option by clicking on the expand icon Image Modified next to More Options and then on the expand icon Image Modified next to Advanced.

OptionIconDescription
Choose Bottom Plane

Image Modified

Allows you to select a plane that, relative to the transformation preview, will be transformed to an XY plane



Panel

On this page:

Table of Contents
maxLevel2



Using the Volume Transformer

To launch the Volume Transformer, click on the 3D Tools tab in the Analysis Panel in Aivia and select the Volume Transformer Image Modified from the 3D Tools toolbar. This will open the Volume Transformer interface and create or show an existing ortho plane while hiding any existing clipping planes.



Align the plane with the image

Select and drag the unidirectional red, green, and blue arrows or one of the shaded squares between two arrows to adjust the position of the alignment point; this can help ease the alignment process but will not affect the volume transformation. Select and drag the curved, double-sided red, green, and blue arrows to adjust the angle of the ortho plane; this will affect how the image is transformed. Align the plane so that it appears "flat" to the image. 

Reset the ortho plane

Click on Reset Image Removed to  to revert the ortho plane to its initial state, which corresponds to no rotation of the image.

Use extra alignment points

Add three more alignment points to help with aligning the ortho plane to the image by selecting Extra Alignment Points Image Removed in in the expanded More Options section. These three yellow points anchor the ortho plane and may be translated along the x-, y-, or z-axes. To translate any of the alignment points, hover over the alignment point and then click and drag one of the arrows extending outward from the point or one of the squares between two such arrows. While any of the three extra alignment points is being moved, the other two remain in the same spatial location, helping to define the ortho plane. However, if the original alignment point, which appears as a white cube, is selected and used to manipulate the ortho plane, the extra alignment points are not guaranteed to stay in the same spatial locations.



Section


Image Modified
Image display during alignment with extra alignment points







Show the intersecting plane

Select Show Intersecting Plane Image Removed in  in the expanded More Options section to clip away parts of the image and show only the section made but cutting the image with the ortho plane. 

Optimize image size

Select Optimize Image Size Image Removed before  before applying a transformation to trim blank space from the sides of the rotated image. Note that optimizing the image size can make the transformation take longer.

Show a preview

You may turn on a preview by clicking the expand icon Image Modified next to More Options and then selecting Preview Image Removed to to get an idea of how the image will be rotated. While a preview is shown, the original image is hidden.


Section


Image Modified
Intersecting plane shown





Select image channels to transform

By default, the image channels that are visible are transformed, and those that are hidden are neither transformed nor included in the transformed image. Click on the expand icon Image Modified next to More Options and then on Channels to Process Image Removed to  to open a menu where image channels can be selected or deselected for transformation.

Choose a new bottom plane

To change what the bottom plane (XY plane that appears furthest away when an image is first put in 3D View) will be in the transformed image, click on the expand icon Image Modified next to More Options, then on the expand icon Image Modified next to Advanced, and finally on the Bottom drop-down menu Image Removed. By default, the bottom plane is set to Auto, which means the bottom plane is chosen in order to minimize the length of the z-dimension in the transformed image. The bottom plane that will be used in the transformation has a bold white frame around it. You may designate any of the six surfaces of the image cube as the bottom plane.

Apply transform

Click Apply Transform Image Removed to  to transform the image. The transformed image will be displayed in the Image Viewer once it has been created, and its thumbnail will appear in addition to that of the original image in the Image Explorer. The transformed image is NOT automatically saved. 

Image credits

Philipp Keller, Howard Hughes Medical Institute, Janelia Farms Research Campus, Ashburn VA; Cell Tracking Challenge, http://www.celltrackingchallenge.net/datasets.html

Related articles

Filter by label (Content by label)
showLabelsfalse
max5
showSpacefalse
cqllabel in ( "3d-tools" , "using-aivia" , "ortho-slicer" ) and space = "AW"

Page Properties
hiddentrue


Related issues




Section


Image Modified
Channel selection menu