# 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(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