5.2 KiB
Multiscale_Coords.ijm documentation
Introduction & Purpose
In some experiments, low resolution (LowRes) scans are acquired in order to have a global overview of the sample (usually fits in the field of view), and then higher resolution (HighRes) scans are performed in small desired regions of interest (ROI) in order to have a look at finer structures (usually local tomography). Placing the motors into the correct position for the HighRes scan requires tedious, not straightforward and error-prone calculations that need many parameters to be taken into account.
Multiscale_Coords.ijm is an ImageJ plugin to find the final/relative coordinates for moving the XX, ZZ and Y motors in a visual manner. The ROI size of the HighRes scan is shown according to the user-supplied parameters of LowRes and HighRes scans. The user can move the ROI interactively to the desired position, and the corresponding movements in um are given as the result. Start and end position values for stitched scans are also available.
Created by hector.dejea@psi.ch in May 2017 extending and adapting localtomo_coords.txt from bernd.pinzer@psi.ch (August 2011)
Instructions of use
Open your LowRes stack of images with ImageJ.
Initialise the plugin:
- Locally: ImageJ -> Plugins -> Macros -> Run -> Browse script
- Beamline: ImageJ -> Plugins -> TOMCAT -> Multiscale Coords
- A dialog asking for LowRes and HighRes acquisition parameters will appear. Fill up with the corresponding inputs:
-
- LowRes imagePixelSize: pixel size (um) in your LowRes scan.
- LowRes XX center: XX motor position in your LowRes scan.
- LowRes ZZ center: ZZ motor position in your LowRes scan.
- LowRes Y position: Y motor position in your LowRes scan.
- HighRes FOV X: field of view in pixels in X (horizontal) of HighRes scan.
- HighRes FOV Y: field of view in pixels in Y (vertical) of HighRes scan.
- HighRes imagePixelSize: pixel size (um) in your HighRes scan.
- Camera movement X: due to the use of both end stations or the change of magnification, camera realignment might be needed. Introduce here the camera movement in X.
- Camera movement Y: Following previous explanation, introduce here the camera movement in Y.
- Stitched scan: check this box if you want to do a stitched scan and not just a single volume. If checked, a new dialog will pop up after pressing OK.
-
- Overlap in X and Z (pixels): amount of overlapping pixels in the X and Z directions. Currently, it's not possible to have a different value for each direction.
- Overlap in Y (pixels): amount of overlapping slices in the Y directions.
- Scans in X: size of the stitched scan grid in the X direction (the plugin assumes X to be vertical direction in reconstructed slices).
- Scans in Z: size of the stitched scan grid in the Z direction (the plugin assumes Z to be horizontal direction in reconstructed slices).
- Slices in Y: size in number of slices of the stitched scan.
- Selected Y slice as: select the viewed slice to be the first (top) or the middle of the scan. It is recommended to use first.
Note
* If LowRes ZZ center, LowRes XX center, LowRes Y position, and Camera movements are left to 0, only the relative movements will be given. * If the value given to Slices in Y is smaller than the FOV Y in HighRes, the total FOV will be considered.
Once OK has been clicked, a circle (no stitched scan) or a rectangle (stitched scan) with the size of the area to be scanned given your inputs will appear in the image.
- Move the ROI to the position in which you would like to perform the high resolution scans and press OK. If you selected stitched scan, the circles corresponding to each of the individual scans will be shown.
Note
In case the size of the ROI shown is not adequate for your purposes, press Shift+OK and the stitched scan parameters dialog will pop up again. This applies both when stitched or not stitched scan have been selected in the first instance.
- Finally, a dialog with the relative motor movements and absolute motor position values will pop up. In addition, a command line with the corresponding inputs will be generated. If, for any reason, you wish to restart the process, check the box and press okay, which will bring you directly back to step 3.
Note
Restarting the plugin using the checkbox instead of closing and opening again has the advantage that your last input values will appear as default in the new dialogs.
