etomo(1) General Commands Manual etomo(1)
NAME
etomo - A GUI program to run IMOD and PEET batch programs
SYNOPSIS
etomo [option ...] [data_file ...]
DESCRIPTION
ETomo is an interface for running a subset of IMOD and PEET commands.
It can be run interactively, with automation, or with a combination of
the two. ETomo contains interfaces for a variety of projects:
tomographic reconstructions, joining tomograms, subvolume averaging,
aligning serial sections, blending montages, nonlinear anisotropic
diffusion, running processes using IMOD's parallel processing
capabilies, flattening tomograms, and testing a GPU.
Automation
Automating Etomo functionality can be done with Etomo parameters and/or
directives. For more information on directives, run imodhelp and choose
"Directives for batch processing and Etomo templates" on the IMOD Help
Index page.
OPTIONS
--h OR --help
Output usage message.
--computersection [Ialternative_computer_section]
Used to customize which sections from the cpu.adoc will be
loaded into the CPU and GPU tables. When not in use, "Computer"
sections will be loaded. If the value is omitted, nothing will
be loaded from the cpu.adoc into the CPU and GPU tables.
--listen
Forces all 3dmods to be run with the -L option. This only has
an effect on Windows computers because -L is always used on
Linux and Mac.
--moveb
Moves the B axis window to the left of the A axis window when a
major resizing event occurs.
--namingstyle 0|1|2
Sets the file name style for a new dataset. Overrides the
IMOD_OUTPUT_FORMAT environment variable for file name style
only. This does not affect the file format - just the file
names. 0: the old non-standard file name. 1:the standard mrc
extension. 2:The standard hdf extension.
--queuesection [Ialternative_queue_section]
Used to customize which sections from the cpu.adoc will be
loaded into the Queue table. When not in use, "Queue" sections
will be loaded. If the value is omitted, nothing will be loaded
from the cpu.adoc into the Queue table.
--timestamp
Send timestamps to standard error before and after processes are
run.
--userTemplateLoc "directory_path"
Adds a second User Template directory, in addition to one set in
the Settings dialog.
AUTOMATION OPTIONS - DIRECTIVE FILE
--directive "directive_file.adoc"
Causes automation to be performed based on a file called
directive_file.adoc. No interface will come up and some
command-line automation options will have no effect.
Command-line automation options that can be used with these
options:
--axis
--cpus
--dataset
--fiducial
--frame
--gpus
These options are automatically set to true when --directive is
used:
--fg
--headless
--create
--exit
The directive file must end in ".adoc" and conform to autodoc
syntax.
--fromBRT
Used when batchruntomo calls Etomo. Prevents Etomo from calling
batchruntomo for validation. Not used for calling Etomo from
the command line. When this option is used values from
batchDefaults.adoc will be used in addition to any templates
that are set.
AUTOMATION OPTIONS - COMMAND LINE
--axis single|dual
Sets the Axis Type in the Setup Tomogram dialog during
automation.
--cpus [ignored]
Turns on the Parallel Processing checkbox in the Setup Tomogram
dialog.
--create
Runs Create Com Scripts in the Setup Tomogram dialog during
automation.
--dataset tilt_series_file
Deprecated. Same as rawimagestack.
--rawimagestack tilt_series_file
Sets Raw Image Stack in the Setup Tomogram dialog during
automation. The value should be set to a file containing a tilt
series. The file must be in the local directory unless a file
path is included or the --dir option is used.
--dir "directory_path"
For automation. The absolute or relative directory containing
the file or dataset specified with the --dataset option.
--exit During automation, exit after the Setup Tomogram dialog has
completed.
--fg Causes Etomo to be run in the foreground rather then in the
background. This is useful when running Etomo with automation
from a script because a script will not wait until a background
command has completed.
--fiducial Floating point
Sets the Fiducial Diameter in the Setup Tomogram dialog during
automation.
--frame single|montage
Sets the Frame Type in the Setup Tomogram dialog during
automation.
--gpus [ignored]
Selects the Graphics Card Processing checkbox in the Setup
Tomogram dialog.
--scan Runs Scan Header in the Setup Tomogram dialog during automation.
EXTENSIONS
--plugin
For loading built-in plugins. Will be expanded as necessary.
Currently causes the etomo.plugin.demo package to be loaded in
preference to external plugins implementing the same interface.
DIAGNOSTIC OPTIONS
--actions
Send actions and file name to Etomo's _err.log. File names
which do not contain an extension or are entirely numeric will
be excluded.
--debug [-1|0|1|2|3|4]
Send extra information to Etomo's _err.log.
The optional parameter has the following meaning:
-1 - limited output
0 - no debug output
1 - default debug output
2 - more information
3 - extensive information - log will be very large
4 - may degrade performance
--grabit [c|p]
Grabit causes etomo to run as a command line program. The
purpose of grabit is to allow specific elements of etomo
functionality to be tried out. Currently it can only try out
message processing so its possible that the parameters will
change in the future. When grabit is used the file names at the
end of the command line will be assumed to contain program
output file(s) to be processed by etomo's message processor.
The result will be printed out. Etomo will exit after doing
this. The parameter is optional. Without a parameter it will
create a generic message processor default settings.
Optional Parameter:
b - batchruntomo but with logging off - has a special error
tag
c - copytomocoms - multi-line warning and info messages
p - parallel processing with no multi-line messages
--ignoresettings
ETomo will not load from or save to the .etomo configuration
file.
--memory [interval_in_minutes]
Send memory usage statements to Etomo's _err.log before and
after processes are run. nterval_in_minutes is the interval at
which to send additional memory usage statements.
--selftest
Causes Etomo to do some internal testing. ETomo may run more
slowly.
DEVELOPMENT AND TESTING OPTIONS
--autoclose3dmod
Instead of popping up a message asking to close an open 3dmod
instance, Etomo automatically closes it. Used for automated
user interface testing.
--headless
No interface will come up. Used for unit testing.
--ignoreloc
The interface will come up in the default location rather then
the location saved in .etomo. Used for automated user interface
testing.
--names
The names of screen elements are sent to Etomo's _out.log. Used
for automated user interface testing.
--newstuff
May cause Etomo to run with unreleased functionality.
--noload
Suppresses the computer and queue load updates.
--test Used for unit testing and automated user interface testing.
DEPRECATED OPTIONS
--demo Deprecated
FILES
Data Files
dataset.edf
Tomographic reconstruction data file.
dataset.ejf
Data file for joining tomograms.
dataset.epe
Subvolume averaging (PEET) data file.
dataset.epp
Data file for generic parallel process and nonlinear anisotropic
diffusion interfaces.
dataset.ess
Data file for aligning serial sections and blending montages.
Log Files
$HOME/.etomologs/etomo_err_timestamp.log
Contains the log. The location is configurable (see man
imodenv).
etomo_err.log
Contains the location of the log. Placed in the directory from
which Etomo is run.
etomo_out.log
Contains the output of the --names parameter. May also contain
diagnostic messages. Placed in the directory from which Etomo
is run.
AUTHOR
Sue Held
SEE ALSO
imodenv, uitest, 3dmod, imodhelp(1).
IMOD 2/12/2009 etomo(1)