Files
tomcat-fiji-plugins/docs/build/html/Multiscale_Coords.html

203 lines
12 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Multiscale_Coords.ijm documentation &#8212; TOMCAT Fiji Plugins 0.1.0 documentation</title>
<link rel="stylesheet" href="_static/bizstyle.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '0.1.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/bizstyle.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Instructions for the installation of a new Fiji version from scratch with all relevant TOMCAT plugins" href="FijiInstallationInstructions.html" />
<link rel="prev" title="Welcome to TOMCAT Fiji Pluginss documentation!" href="index.html" />
<meta name="viewport" content="width=device-width,initial-scale=1.0">
<!--[if lt IE 9]>
<script type="text/javascript" src="_static/css3-mediaqueries.js"></script>
<![endif]-->
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="FijiInstallationInstructions.html" title="Instructions for the installation of a new Fiji version from scratch with all relevant TOMCAT plugins"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="Welcome to TOMCAT Fiji Pluginss documentation!"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">TOMCAT Fiji Plugins 0.1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#"><strong>Multiscale_Coords.ijm documentation</strong></a><ul>
<li><a class="reference internal" href="#introduction-purpose"><strong>Introduction &amp; Purpose</strong></a></li>
<li><a class="reference internal" href="#instructions-of-use"><strong>Instructions of use</strong></a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Welcome to TOMCAT Fiji Pluginss documentation!</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="FijiInstallationInstructions.html"
title="next chapter">Instructions for the installation of a new Fiji version from scratch with all relevant TOMCAT plugins</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/Multiscale_Coords.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="multiscale-coords-ijm-documentation">
<h1><strong>Multiscale_Coords.ijm documentation</strong><a class="headerlink" href="#multiscale-coords-ijm-documentation" title="Permalink to this headline"></a></h1>
<div class="section" id="introduction-purpose">
<h2><strong>Introduction &amp; Purpose</strong><a class="headerlink" href="#introduction-purpose" title="Permalink to this headline"></a></h2>
<p>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.</p>
<p>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.</p>
<p><em>Created by hector.dejea&#64;psi.ch in May 2017 extending and adapting localtomo_coords.txt from bernd.pinzer&#64;psi.ch (August 2011)</em></p>
</div>
<div class="section" id="instructions-of-use">
<h2><strong>Instructions of use</strong><a class="headerlink" href="#instructions-of-use" title="Permalink to this headline"></a></h2>
<ol class="arabic">
<li><p class="first">Open your LowRes stack of images with ImageJ.</p>
</li>
<li><p class="first">Initialise the plugin:</p>
<blockquote>
<div><ul class="simple">
<li><strong>Locally</strong>: ImageJ -&gt; Plugins -&gt; Macros -&gt; Run -&gt; Browse script</li>
<li><strong>Beamline</strong>: ImageJ -&gt; Plugins -&gt; TOMCAT -&gt; Multiscale Coords</li>
</ul>
</div></blockquote>
</li>
<li><dl class="first docutils">
<dt>A dialog asking for LowRes and HighRes acquisition parameters will appear. Fill up with the corresponding inputs:</dt>
<dd><ul class="first last simple">
<li><strong>LowRes imagePixelSize</strong>: pixel size (um) in your LowRes scan.</li>
<li><strong>LowRes XX center</strong>: XX motor position in your LowRes scan.</li>
<li><strong>LowRes ZZ center</strong>: ZZ motor position in your LowRes scan.</li>
<li><strong>LowRes Y position</strong>: Y motor position in your LowRes scan.</li>
<li><strong>HighRes FOV X</strong>: field of view in pixels in X (horizontal) of HighRes scan.</li>
<li><strong>HighRes FOV Y</strong>: field of view in pixels in Y (vertical) of HighRes scan.</li>
<li><strong>HighRes imagePixelSize</strong>: pixel size (um) in your HighRes scan.</li>
<li><strong>Camera movement X</strong>: 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.</li>
<li><strong>Camera movement Y</strong>: Following previous explanation, introduce here the camera movement in Y.</li>
<li><dl class="first docutils">
<dt><strong>Stitched scan</strong>: 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.</dt>
<dd><ul class="first last">
<li><strong>Overlap in X and Z (pixels)</strong>: amount of overlapping pixels in the X and Z directions. Currently, its not possible to have a different value for each direction.</li>
<li><strong>Overlap in Y (pixels)</strong>: amount of overlapping slices in the Y directions.</li>
<li><strong>Scans in X</strong>: size of the stitched scan grid in the X direction (the plugin assumes X to be vertical direction in reconstructed slices).</li>
<li><strong>Scans in Z</strong>: size of the stitched scan grid in the Z direction (the plugin assumes Z to be horizontal direction in reconstructed slices).</li>
<li><strong>Slices in Y</strong>: size in number of slices of the stitched scan.</li>
<li><strong>Selected Y slice as</strong>: select the viewed slice to be the first (top) or the middle of the scan. It is recommended to use first.</li>
</ul>
</dd>
</dl>
</li>
</ul>
</dd>
</dl>
</li>
</ol>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<ul class="last simple">
<li>If <em>LowRes ZZ center, LowRes XX center, LowRes Y position,</em> and <em>Camera movements</em> are left to 0, only the relative movements will be given.</li>
<li>If the value given to <em>Slices in Y</em> is smaller than the FOV Y in HighRes, the total FOV will be considered.</li>
</ul>
</div>
<p>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.</p>
<a class="reference internal image-reference" href="_images/Dialog1.png"><img alt="_images/Dialog1.png" src="_images/Dialog1.png" style="height: 8cm;" /></a>
<a class="reference internal image-reference" href="_images/DialogSt.png"><img alt="_images/DialogSt.png" src="_images/DialogSt.png" style="height: 8cm;" /></a>
<ol class="arabic simple" start="4">
<li>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.</li>
</ol>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">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.</p>
</div>
<a class="reference internal image-reference" href="_images/single.png"><img alt="_images/single.png" src="_images/single.png" style="height: 9cm;" /></a>
<a class="reference internal image-reference" href="_images/stitch.png"><img alt="_images/stitch.png" src="_images/stitch.png" style="height: 9cm;" /></a>
<a class="reference internal image-reference" href="_images/stitchfin.png"><img alt="_images/stitchfin.png" class="align-center" src="_images/stitchfin.png" style="height: 9cm;" /></a>
<ol class="arabic simple" start="5">
<li>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.</li>
</ol>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">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.</p>
</div>
<a class="reference internal image-reference" href="_images/finalsingle.png"><img alt="_images/finalsingle.png" class="align-center" src="_images/finalsingle.png" style="height: 8cm;" /></a>
<a class="reference internal image-reference" href="_images/finalstitch.png"><img alt="_images/finalstitch.png" class="align-center" src="_images/finalstitch.png" style="height: 8cm;" /></a>
<div class="toctree-wrapper compound">
</div>
</div>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="FijiInstallationInstructions.html" title="Instructions for the installation of a new Fiji version from scratch with all relevant TOMCAT plugins"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="Welcome to TOMCAT Fiji Pluginss documentation!"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">TOMCAT Fiji Plugins 0.1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2017, TOMCAT team.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.3.
</div>
</body>
</html>