======
wf3rej
======

This calls the wf3rej executable. Use this function to facilitate batch runs or for the TEAL interface.

Example
-------

In Python without TEAL:

>>> from wfc3tools import wf3rej
>>> wf3rej.wf3rej(filename)

In Python with TEAL:

>>> from stsci.tools import teal
>>> from wfc3tools import wf3rej
>>> teal.teal('wf3rej')

In Pyraf:

>>> import wfc3tools
>>> epar wf3rej


Parameters
----------

input : str, Name of input files

      - a single filename (``iaa012wdq_raw.fits``)
      - a Python list of filenames
      - a partial filename with wildcards (``\*raw.fits``)
      - filename of an ASN table (``\*asn.fits``)
      - an at-file (``@input``) 

output : str, Name of the output FITS file.

crrejtab : string, reference file name

scalense :   string, scale factor applied to noise

initgues :   string, intial value estimate scheme (min|med)

skysub :     string, how to compute the sky (none|mode|mean)

crsigmas :   string, rejection levels in each iteration

crradius :   float, cosmic ray expansion radius in pixels

crthresh :   float, rejection propagation threshold

badinpdq :   int, data quality flag bits to reject

crmask :     bool, flag CR in input DQ imageS?

shadcorr :   bool, perform shading shutter correction?

verbose : bool, optional,  Print verbose time stamps?


**The wf3rej executable can also be called directly from the OS command line prompt:**

>>> wf3rej.e input output [-options]

Input can be a single file, or a comma-delimited list of files.

Where the OS options include:

* t: print the timestamps
* v: verbose
* shadcorr: perform shading shutter correction?
* crmask: flag CR in input DQ images?
* table <filename>: the crrejtab filename
* scale <number>: scale factor for noise
* init <med|min>: initial value estimate scheme
* sky <none|median|mode>: how to compute sky
* sigmas: rejection leves for each iteration
* radius <number>: CR expansion radius
* thresh <number> : rejection propagation threshold
* pdq <number>: data quality flag bits to reject


