e2proc2d

usage: e2proc2d.py [options] <inputfile> ... <inputfile> <outputfile>

	MRC stack files MUST use the .mrcs extension to be treated as a set of 2-D images (or you must 
	use one of the --threed* options)

	If there is more than one input file, then outputfile is a pattern, where @
	in the pattern is replaced by the input file base name (minus any extension).

	Generic 2-D image processing and file format conversion program. Acts on stacks of 2-D images
	(multiple images in one file). All EMAN2 recognized file formats accepted (see Wiki for list).

	You can create a new 2-D or 3-D image from scratch instead of reading from a file by specifying 
	':<nx>:<ny>:<expression_in_x_y>' or ':<nx>:<ny>:<nz>:<expression_in_x_y_z>' as an input filename,
	where 0 <= x < nx, 0 <= y < ny, 0 <= z < nz, and the expression can be just a number.

	If performing certain operations which do not require an output file, specify "none" as the output file.

	Examples:

	convert IMAGIC format test.hed to HDF format:
	e2proc2d.py test.hed test.hdf

	convert all MRC format files in current directory to HDF format:
	e2proc2d.py *.mrc @.hdf

	convert a 'set' (.lst file) to an MRC stack file:
	e2proc2d.py sets/myset.lst myset.mrcs

	create a new image, initialized with 1.0, then mask it:
	e2proc2d.py :128:128:1 mymask.hdf --process mask.soft:outer_radius=50

	apply a 10 A low-pass filter to a stack of particles downsample the particles by a factor of 2
	and write output to a new file.
	e2proc2d.py ptcl.hdf ptcl.filt.hdf --process filter.lowpass.gauss:cutoff_freq=0.1 --meanshrink 2

	'e2help.py processors -v 2' for a detailed list of available procesors
	

Option Type Description
--version None show program's version number and exit
--apix float A/pixel for S scaling
--average None Averages all input images (without alignment) and writes a single output image
--avgseq int Averages sets of N sequential frames. eg - if N=4 and the input contains 100 images, the output would be 25 images
--averager str If --average is specified, this is the averager to use (e2help.py averager). Default=mean
--calcsf str calculate a radial structure factor for the image and write it to the output file, must specify apix. divide into <n> angular bins
--calccont None Compute the low resolution azimuthal contrast of each image and put it in the header as eval_contrast_lowres. Larger values imply more 'interesting' images.
--clip str Specify the output size in pixels xsize,ysize[,xcenter,ycenter], images can be made larger or smaller.
--exclude str Excludes image numbers, either a list of comma separated values, or a filename with one number per line, first image == 0
--fftavg str Incoherent Fourier average of all images and write a single power spectrum image
--process str apply a processor named 'processorname' with all its parameters/values.
--mult float Multiply image by a constant. mult=-1 to invert contrast.
--add float Adds a constant 'f' to the densities
--addfile str Adds the volume to another volume of identical size
--first int the first image in the input to process [0 - n-1])
--last int the last image in the input to process
--list str Works only on the image numbers in LIST file
--select str Works only on the images in named selection set from bdb:select
--randomn int Selects a random subset of N particles from the file to operate on.
--inplace None Output overwrites input, USE SAME FILENAME, DO NOT 'clip' images.
--interlv str Specifies a 2nd input file. Output will be 2 files interleaved.
--extractboxes None Extracts box locations from the image header to produce a set of .box files for only the particles in the .lst files
--meanshrink float Reduce an image size by an integral (1.5 also allowed) scaling factor using average. eg - 2 will reduce image size to 1/2. Clip is not required.
--medianshrink int Reduce an image size by an integral scaling factor, uses median filter. eg - 2 will reduce image size to 1/2. Clip is not required.
--fouriershrink float Reduce an image size by an arbitrary scaling factor by clipping in Fourier space. eg - 2 will reduce image size to 1/2.
--mraprep None this is an experimental option
--compressbits int HDF only. Bits to keep for compression. -1 for no compression
--outmode str All EMAN2 programs write images with 4-byte floating point values when possible by default. This allows specifying an alternate format when supported (float, int8, int16, int32, uint8, uint16, uint32). Values are rescaled to fill MIN-MAX range.
--outnorescale None If specified, floating point values will not be rescaled when writing data as integers. Values outside of range are truncated.
--mrc16bit None (deprecated, use --outmode instead) output as 16 bit MRC file
--mrc8bit None (deprecated, use --outmode instead) output as 8 bit MRC file
--fixintscaling str When writing to an 8 or 16 bit integer format the data must be scaled. 'noscale' will assume the pixel values are already correct, 'full' will insure the full range of values are included in the output, 'sane' will pick a good range, a number will set the range to mean+=sigma*number
--multfile str Multiplies the volume by another volume of identical size. This can be used to apply masks, etc.
--norefs None Skip any input images which are marked as references (usually used with classes.*)
--outtype str output image format, 'mrc', 'imagic', 'hdf', etc. if specify spidersingle will output single 2D image rather than 2D stack.
--radon None Do Radon transform
--randomize str Randomly rotate/translate the image. Specify: da,dxy,flip da is a uniform distribution over +-da degrees, dxy is a uniform distribution on x/y, if flip is 1, random handedness changes will occur
--rotavg None Compute the 1-D rotational average of each image as a final step before writing the output
--rotate float Rotate clockwise (in degrees)
--rfp None this is an experimental option
--fp int This generates rotational/translational 'footprints' for each input particle, the number indicates which algorithm to use (0-6)
--scale float Scale by specified scaling factor. Clip must also be specified to change the dimensions of the output map.
--anisotropic str Anisotropic scaling, stretches on one axis and compresses the orthogonal axis. Specify amount,angle. See e2evalrefine
--selfcl int Output file will be a 180x180 self-common lines map for each image.
--setsfpairs None Applies the radial structure factor of the 1st image to the 2nd, the 3rd to the 4th, etc
--split int Splits the input file into a set of n output files
--translate str Translate by x,y pixels
--headertransform int This will take the xform.align2d header value from each particle, and apply it. Pass 0 to perform the transform or 1 to perform the inverse.
--verbose, -v int verbose level [0-9], higher number means higher level of verboseness
--plane str Change the plane of image processing, useful for processing 3D mrcs as 2D images.
--writejunk None Writes the image even if its sigma is 0.
--swap None Swap the byte order
--threed2threed None Process 3D image as a stack of 2D slices, then output as a 3D image
--threed2twod None Process 3D image as a stack of 2D slices, then output as a 2D stack
--twod2threed None Process a stack of 2D images, then output as a 3D image.
--unstacking None Process a stack of 2D images, then output as a series of numbered single image files
--ppid int Set the PID of the parent process, used for cross platform PPID
--step str Specify <init>,<step>. Processes only a subset of the input data. For example, 0,2 would process only the even numbered particles
--eer2x None Render EER file on 8k grid.
--eer4x None Render EER file on 16k grid.
--parallel, -P str Run in parallel, specify type:n=<proc>:option:option

For more information go to emanwiki/EMAN2/Programs/e2proc2d.