Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
COSClab authored Jul 2, 2024
1 parent 7638339 commit 11c9331
Showing 1 changed file with 8 additions and 8 deletions.
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,10 @@ You can install `napari-fast4dreg` via [pip]:

It's easy!
1) Just drag and drop your image, or the test image from this repository, into napari and open it normally.
Don't worry if your file is big, napari already internally uses dask to open even the biggest images (althought it might hurt the performance).
2) Open the napari-fast4dreg plugin from the plugin menue.
3) In the image row, make sure your image is selected in the image drop down menue.
4) In the axes row, choose the structure of your input image. If your axis orientation is correct in ImageJ choose the standard TZCYX (ImageJ) orientation. If you are using python to process the image you probabbly are using the alternatively availabe CTZYX orientation. In this case just select CTZYX in the drop down menue instead.
Don't worry if your file is big, napari already internally uses dask to open even the biggest images (although it might hurt the performance).
2) Open the napari-fast4dreg plugin from the plugin menu.
3) In the image row, make sure your image is selected in the image drop down menu.
4) In the axes row, choose the structure of your input image. If your axis orientation is correct in ImageJ choose the standard TZCYX (ImageJ) orientation. If you are using python to process the image you probabbly are using the alternatively availabe CTZYX orientation. In this case just select CTZYX in the drop down menu instead.
5) Select the reference channel used for the registration. The drift will be determined for this reference channel and applied to all other channels. Counting begins by 0. In case for the test image we select the nuclear signal in channel 1.
6) Select the corrections that you want to apply on your image. Note that the crop function reduces only in xy, according to the previously determined drift. (e.g. drift = -5 in x --> drop 5 pixels from the left hand side of the registered stack.)
7) Wait for output (this may take a while, so go and get a coffe or tea).
Expand All @@ -46,10 +46,10 @@ Don't worry if your file is big, napari already internally uses dask to open eve
## Example Outcome
The output will consist of the following (if chosen):
- registered.tif: The registered file, output of this image registration pipeline.
- tmp_data: This folder was used for temporary data saving and stores at the end the registered image in a chunked manner (can be deleted or dragged into napari for a greater data versitility)
- drifts.csv: csv table, home to the drift of all corrected variables, if you prefer your own plotting style, here is where you find the pure drif table.
- XY-Drift.svg: Vector based graphic, visualising the dirft in lateral direction. The svg format can be opened by your web browser or directly imported to powerpoint. Key advantage of .svg instead of .png: You can resize any way you like without loss of image quality.
- Z-Drift.svg: Vector based graphic, visualising the dirft in axial direction.
- tmp_data: This folder was used for temporary data saving and stores at the end the registered image in a chunked manner (can be deleted or dragged into napari for a greater data versatility)
- drifts.csv: csv table, home to the drift of all corrected variables, if you prefer your own plotting style, here is where you find the pure drift table.
- XY-Drift.svg: Vector based graphic, visualising the drift in lateral direction. The svg format can be opened by your web browser or directly imported to powerpoint. Key advantage of .svg instead of .png: You can resize any way you like without loss of image quality.
- Z-Drift.svg: Vector based graphic, visualising the drift in axial direction.
- Rotation-Drift.svg: Showing rotation correction of the image in lateral direction.

![3D_MIP_registration](./media/3D_registration.gif)
Expand Down

0 comments on commit 11c9331

Please sign in to comment.