raw2mrc

raw2mrc(1) General Commands Manual raw2mrc(1)
NAME
 raw2mrc - Create an MRC image stack from raw image data.
SYNOPSIS
 raw2mrc [options] raw_image_files... MRC_output_file
DESCRIPTION
 raw2mrc can be used to create MRC image stacks from many types of raw
 binary image data. Command line options are used to specify the image
 size and to skip the input image header. Several raw images can be
 combined into one file by listing all of their filenames before the
 name of the output file, or providing them with multiple entries of the
 -input option. The environment variable IMOD_OUTPUT_FORMAT can be set
 to produced TIFF or HDF output.
OPTIONS
 Raw2mrc uses the PIP package for input (see the manual page for
 pip). Options can be specified either as command line arguments
 (with the -) or one per line in a command file (without the -).
 Options can be abbreviated to unique letters; the currently valid
 abbreviations for short names are shown in parentheses.
 -input (-in) OR -InputFile File name
 Input image file. Input files may also be entered after all
 arguments on the command line. Files entered with this option
 will be processed before files at the end of the command line,
 if any. (Successive entries accumulate)
 -output (-ou) OR -OutputFile File name
 Output image file. If this entry is omitted, the last non-
 option argument will be used for the output filename; otherwise,
 all non-option arguments will be used as input filenames.
 -x OR -XSize Integer
 Set the width of the image; this entry is required
 -y OR -YSize Integer
 Set the height of the input image; this entry is required
 -z OR -SectionsPerFile Integer
 Set the number of sections in each input image file, the default
 is 1.
 -t OR -DataType Text string
 Set the type of input data; the default is byte data. The
 allowed types are byte, short, ushort, long, ulong, float, dou-
 ble, and rgb. Where byte is 8-bit integer values, short is
 16-bit signed values, ushort is 16-bit unsigned values, long is
 32-bit signed values, ulong is 32-bit unsigned values, float and
 double are 32-bit and 64-bit floating point values and rgb is
 three byte values--one for each color.
 -s OR -SwapBytes
 Swap input bytes. Does not work for doubles.
 -o OR -OffsetToImageData Integer
 Set the offset value used at the beginning of the file, the
 default is 0.
 -oz OR -SkipBetweenSections Integer
 Set the offset value used at the end of each section, the
 default offset is 0.
 -f OR -FlipInY
 Flip the images around the X axis.
 -i OR -InvertInZ
 Produce an inverted output stack by both inverting the order in
 which files are processed and inverting the order of reading Z
 slices from each file.
 -iz OR -ReadInvertedInZ
 Invert the order of reading Z slices from each individual file.
 -d OR -DivideBy2
 Divide unsigned 16-bit values by 2, or divide any 32-bit inte-
 gers or 64-bit doubles being converted to 16 bits by 2. The
 default for unsigned short values is to subtract 32767, which
 allows all unsigned short values to be stored as signed short
 integers in the MRC file of mode 1. Use this option if you do
 not want negative numbers and do not care about the loss of pre-
 cision. If the values in the input files are all less than
 32768, then specify that the input data are short rather than
 ushort.
 -u OR -UnsignedOutput
 Store unsigned 16-bit values without modification in an MRC file
 of mode 6; or store doubles in mode 6 if the -c option is given
 also.
 -c OR -ConvertTo16BitInt
 Convert 32-bit integers or 64-bit doubles to 16-bit integers
 instead of to 32-bit floating-point numbers. If the type is
 long, you can use this option alone if values are between -32768
 and 32767; or you can use the option with .B -d to divide by 2
 if values are between -65536 and 65535. If you specify the type
 as ulong, then by default 32767 will be subtracted from the
 input values, so that values from 0 to 65534 can be stored as
 -32767 to 32767. Again, .B -d can be used to divide by 2
 instead, so that values from 0 to 65534 can be stored as 0 to
 32767. Also, .B -u can be used to store the numbers as unsigned
 integers in a file of mode 6. Thus, doubles with a range of 0 to
 131070 can be stored as unsigned 16-bit values using all of -c,
 -d, and -u. If values in the input files are all less than
 32768, then specify the type as long instead of ulong.
 -p OR -PixelSpacing Floating point
 Set the pixel spacing of the MRC file header to the given value,
 which should generally be a pixel size in Angstroms.
 -pz OR -ZPixelSpacing Floating point
 Set the Z pixel spacing of the MRC file header to the given
 value if it is different from the one given with the .B -p
 option.
 -help (-h) OR -Usage
 Print help output
 -StandardInput
 Read parameter entries from standard input
FILES
 If the output file already exists, it will be made a backup file by
 adding ~ to its name.
AUTHORS
 Jim Kremer, David Mastronarde
SEE ALSO
 tif2mrc
BUGS
 Email bug reports to mast at colorado dot edu.
IMOD 5.2.0 raw2mrc(1)