Merging changes from 'stwcs_hdrlet' branch (r18787 - r13909) into trunk. This version of STWCS (0.9.1) provides support for headerlets based on 'Headerlet Design' wiki document, and includes TEAL interfaces for all public headerlet functions. It also moves the TEAL interface for 'updatewcs' from 'astrodither' to this package. The TEAL interaces have been included as a new 'gui' sub-package in order to keep them separate from the remainder of the package's functionality.

git-svn-id: http://svn.stsci.edu/svn/ssb/stsci_python/stsci_python/trunk/stwcs@13910 fe389314-cf27-0410-b35b-8c050e845b92

18 files changed, 162 insertions, 0 deletions

diff --git a/lib/stwcs/gui/pars/apply_headerlet.cfg b/lib/stwcs/gui/pars/apply_headerlet.cfg
new file mode 100644
index 0000000..ae97297
--- /dev/null
+++ b/lib/stwcs/gui/pars/apply_headerlet.cfg
@@ -0,0 +1,10 @@
+_task_name_ = apply_headerlet
+filename = ""
+hdrlet = ""
+attach = True
+primary = True
+archive = True
+force = False
+wcskey = ""
+wcsname = ""
+verbose = False
diff --git a/lib/stwcs/gui/pars/apply_headerlet.cfgspc b/lib/stwcs/gui/pars/apply_headerlet.cfgspc
new file mode 100644
index 0000000..240dcec
--- /dev/null
+++ b/lib/stwcs/gui/pars/apply_headerlet.cfgspc
@@ -0,0 +1,12 @@
+_task_name_ = string_kw(default="apply_headerlet")
+filename = string_kw(default="", comment="Input file name")
+hdrlet = string_kw(default="", comment="Headerlet FITS filename")
+attach = boolean_kw(default=True, comment= "Append headerlet to FITS file as new extension?")
+primary = boolean_kw(default=True, triggers="_rule1_", comment="Replace PRIMARY WCS with headerlet WCS?")
+archive = boolean_kw(default=True, active_if="_rule1_", comment="Save PRIMARY WCS as new headerlet extension?")
+force = boolean_kw(default=False, active_if="_rule1_", comment="If distortions do not match, force update anyway?")
+wcskey = option_kw("A","B","C","D","E","F","G","H","I","J","K","L","M","N","P","Q","R","S","T","U","V","W","X","Y","Z","", default="", inactive_if="_rule1_", comment="Apply headerlet as alternate WCS with this letter")
+wcsname = string_kw(default="", inactive_if="_rule1_", comment="Apply headerlet as alternate WCS with this name")
+verbose = boolean_kw(default=False, comment= "Print logging messages?")
+[ _RULES_ ]
+_rule1_ = string_kw(default=True, code='tyfn={"yes":True, "no":False}; OUT = tyfn[VAL]')
diff --git a/lib/stwcs/gui/pars/archive_headerlet.cfg b/lib/stwcs/gui/pars/archive_headerlet.cfg
new file mode 100644
index 0000000..815ce96
--- /dev/null
+++ b/lib/stwcs/gui/pars/archive_headerlet.cfg
@@ -0,0 +1,13 @@
+_task_name_ = archive_headerlet
+filename = ""
+hdrname = ""
+sciext = "SCI"
+wcsname = ""
+wcskey = "PRIMARY"
+destim = ""
+sipname = ""
+npolfile = ""
+d2imfile = ""
+author = ""
+descrip = ""
+history = ""
diff --git a/lib/stwcs/gui/pars/archive_headerlet.cfgspc b/lib/stwcs/gui/pars/archive_headerlet.cfgspc
new file mode 100644
index 0000000..d049769
--- /dev/null
+++ b/lib/stwcs/gui/pars/archive_headerlet.cfgspc
@@ -0,0 +1,13 @@
+_task_name_ = string_kw(default="archive_headerlet")
+filename = string_kw(default="", comment="Input file name")
+hdrname = string_kw(default="", comment="Unique name(HDRNAME) for headerlet")
+sciext = string_kw(default="SCI", comment="EXTNAME of extension with WCS")
+wcsname = string_kw(default="", comment="Name of WCS to be archived")
+wcskey = option_kw("A","B","C","D","E","F","G","H","I","J","K","L","M","N","P","Q","R","S","T","U","V","W","X","Y","Z","PRIMARY", default="PRIMARY", comment="Archive the WCS with this letter")
+destim = string_kw(default="", comment="Rootname of image to which this headerlet applies ")
+sipname = string_kw(default="", comment="Name for source of polynomial distortion keywords")
+npolfile = string_kw(default="", comment="Name for source of non-polynomial residuals")
+d2imfile = string_kw(default="", comment="Name for source of detector correction table")
+author = string_kw(default="", comment="Author name for creator of headerlet")
+descrip = string_kw(default="", comment="Short description of headerlet solution")
+history = string_kw(default="", comment="Name of ASCII file containing history for headerlet")
diff --git a/lib/stwcs/gui/pars/attach_headerlet.cfg b/lib/stwcs/gui/pars/attach_headerlet.cfg
new file mode 100644
index 0000000..772a66d
--- /dev/null
+++ b/lib/stwcs/gui/pars/attach_headerlet.cfg
@@ -0,0 +1,3 @@
+_task_name_ = attach_headerlet
+filename = ""
+hdrlet = ""
diff --git a/lib/stwcs/gui/pars/attach_headerlet.cfgspc b/lib/stwcs/gui/pars/attach_headerlet.cfgspc
new file mode 100644
index 0000000..03dcf0f
--- /dev/null
+++ b/lib/stwcs/gui/pars/attach_headerlet.cfgspc
@@ -0,0 +1,3 @@
+_task_name_ = string_kw(default="attach_headerlet")
+filename = string_kw(default="", comment="FITS image file name")
+hdrlet = string_kw(default="", comment="Headerlet FITS filename")
diff --git a/lib/stwcs/gui/pars/delete_headerlet.cfg b/lib/stwcs/gui/pars/delete_headerlet.cfg
new file mode 100644
index 0000000..f43befa
--- /dev/null
+++ b/lib/stwcs/gui/pars/delete_headerlet.cfg
@@ -0,0 +1,5 @@
+_task_name_ = delete_headerlet
+filename = ""
+hdrname = ""
+hdrext = None
+distname = ""
diff --git a/lib/stwcs/gui/pars/delete_headerlet.cfgspc b/lib/stwcs/gui/pars/delete_headerlet.cfgspc
new file mode 100644
index 0000000..5695130
--- /dev/null
+++ b/lib/stwcs/gui/pars/delete_headerlet.cfgspc
@@ -0,0 +1,5 @@
+_task_name_ = string_kw(default="delete_headerlet")
+filename = string_kw(default="", comment="FITS image file name")
+hdrname = string_kw(default="", comment="Delete headerlet with this HDRNAME")
+hdrext = integer_or_none_kw(default=None, comment="Delete headerlet from this extension")
+distname = string_kw(default="", comment="Delete *ALL* with this DISTNAME")
diff --git a/lib/stwcs/gui/pars/extract_headerlet.cfg b/lib/stwcs/gui/pars/extract_headerlet.cfg
new file mode 100644
index 0000000..eaf4eff
--- /dev/null
+++ b/lib/stwcs/gui/pars/extract_headerlet.cfg
@@ -0,0 +1,7 @@
+_task_name_ = extract_headerlet
+filename = ""
+output = ""
+extnum = None
+hdrname = ""
+clobber = True
+verbose = False
diff --git a/lib/stwcs/gui/pars/extract_headerlet.cfgspc b/lib/stwcs/gui/pars/extract_headerlet.cfgspc
new file mode 100644
index 0000000..3b173c2
--- /dev/null
+++ b/lib/stwcs/gui/pars/extract_headerlet.cfgspc
@@ -0,0 +1,7 @@
+_task_name_ = string_kw(default="extract_headerlet")
+filename = string_kw(default="", comment="Input file name")
+output = string_kw(default="", comment="Output headerlet FITS filename")
+extnum = integer_or_none_kw(default=None, comment="FITS extension number of headerlet")
+hdrname = string_kw(default="", comment="Unique name(HDRNAME) for headerlet")
+clobber = boolean_kw(default=True, comment= "Overwrite existing headerlet FITS file?")
+verbose = boolean_kw(default=False, comment= "Print logging messages?")
diff --git a/lib/stwcs/gui/pars/headerlet_summary.cfg b/lib/stwcs/gui/pars/headerlet_summary.cfg
new file mode 100644
index 0000000..7203552
--- /dev/null
+++ b/lib/stwcs/gui/pars/headerlet_summary.cfg
@@ -0,0 +1,8 @@
+_task_name_ = headerlet_summary
+filename = ""
+columns = None
+pad = 2
+maxwidth = None
+output = ""
+clobber = True
+quiet = False
diff --git a/lib/stwcs/gui/pars/headerlet_summary.cfgspc b/lib/stwcs/gui/pars/headerlet_summary.cfgspc
new file mode 100644
index 0000000..ce65930
--- /dev/null
+++ b/lib/stwcs/gui/pars/headerlet_summary.cfgspc
@@ -0,0 +1,8 @@
+_task_name_ = string_kw(default="headerlet_summary")
+filename = string_kw(default="", comment="FITS image file name")
+columns = string_kw(default="", comment="Headerlet keyword(s) to be reported")
+pad = integer_kw(default=2, comment="Number of spaces between output columns")
+maxwidth = integer_or_none_kw(default=None, comment="Max width for each column")
+output = string_kw(default="", comment="Name of output file for summary")
+clobber = boolean_kw(default=True, comment="Overwrite previously written summary?")
+quiet = boolean_kw(default=False, comment="Suppress output of summary to STDOUT?")
diff --git a/lib/stwcs/gui/pars/restore_headerlet.cfg b/lib/stwcs/gui/pars/restore_headerlet.cfg
new file mode 100644
index 0000000..a6230a4
--- /dev/null
+++ b/lib/stwcs/gui/pars/restore_headerlet.cfg
@@ -0,0 +1,9 @@
+_task_name_ = restore_headerlet
+filename = ""
+archive = True
+force = False
+distname = ""
+primary = None
+sciext = "SCI"
+hdrname = ""
+hdrext = None
diff --git a/lib/stwcs/gui/pars/restore_headerlet.cfgspc b/lib/stwcs/gui/pars/restore_headerlet.cfgspc
new file mode 100644
index 0000000..3e713ce
--- /dev/null
+++ b/lib/stwcs/gui/pars/restore_headerlet.cfgspc
@@ -0,0 +1,11 @@
+_task_name_ = string_kw(default="restore_headerlet")
+filename = string_kw(default="", comment="Input file name")
+archive = boolean_kw(default=True, comment= "Create headerlets from WCSs being replaced?")
+force = boolean_kw(default=False, comment="If distortions do not match, force update anyway?")
+distname = string_kw(default="", triggers="_rule1_", comment="Restore ALL headerlet extensions with this DISTNAME")
+primary = integer_or_none_kw(default=None, inactive_if="_rule1_", comment="Headerlet extension to restore as new primary WCS")
+sciext = string_kw(default="SCI", inactive_if="_rule1_", comment="EXTNAME of extension with WCS")
+hdrname = string_kw(default="", active_if="_rule1_", comment="HDRNAME of headerlet extension to be restored")
+hdrext = integer_or_none_kw(default=None, active_if="_rule1_", comment="Extension number for headerlet to be restored")
+[ _RULES_ ]
+_rule1_ = string_kw(default=True, code='from stwcs import wcsutil;from stwcs.wcsutil import headerlet;OUT = headerlet.is_par_blank(VAL)')
diff --git a/lib/stwcs/gui/pars/updatewcs.cfg b/lib/stwcs/gui/pars/updatewcs.cfg
new file mode 100644
index 0000000..35360f2
--- /dev/null
+++ b/lib/stwcs/gui/pars/updatewcs.cfg
@@ -0,0 +1,8 @@
+_task_name_ = updatewcs
+input = "*flt.fits"
+extname = "SCI"
+vacorr = True
+tddcorr = True
+npolcorr = True
+d2imcorr = True
+checkfiles = True
diff --git a/lib/stwcs/gui/pars/updatewcs.cfgspc b/lib/stwcs/gui/pars/updatewcs.cfgspc
new file mode 100644
index 0000000..1ce03bf
--- /dev/null
+++ b/lib/stwcs/gui/pars/updatewcs.cfgspc
@@ -0,0 +1,8 @@
+_task_name_ = string_kw(default="updatewcs")
+input = string_kw(default="", comment="Input files (name, suffix, or @list)")
+extname = string_kw(default="SCI", comment="EXTNAME of extensions to be archived")
+vacorr = boolean_kw(default=True, comment= "Apply vecocity aberration correction?")
+tddcorr = boolean_kw(default=True, comment= "Apply time dependent distortion correction?")
+npolcorr = boolean_kw(default=True, comment= "Apply lookup table distortion?")
+d2imcorr = boolean_kw(default=True, comment= "Apply detector to image correction?")
+checkfiles = boolean_kw(default=True, comment= "Check format of input files?")
diff --git a/lib/stwcs/gui/pars/write_headerlet.cfg b/lib/stwcs/gui/pars/write_headerlet.cfg
new file mode 100644
index 0000000..7dfa3aa
--- /dev/null
+++ b/lib/stwcs/gui/pars/write_headerlet.cfg
@@ -0,0 +1,16 @@
+_task_name_ = write_headerlet
+filename = ""
+hdrname = ""
+wcskey = "PRIMARY"
+wcsname = ""
+author = ""
+descrip = ""
+history = ""
+output = ""
+clobber = True
+sciext = "SCI"
+destim = ""
+sipname = ""
+npolfile = ""
+d2imfile = ""
+attach = True
diff --git a/lib/stwcs/gui/pars/write_headerlet.cfgspc b/lib/stwcs/gui/pars/write_headerlet.cfgspc
new file mode 100644
index 0000000..41527ab
--- /dev/null
+++ b/lib/stwcs/gui/pars/write_headerlet.cfgspc
@@ -0,0 +1,16 @@
+_task_name_ = string_kw(default="write_headerlet")
+filename = string_kw(default="", comment="Input file name")
+hdrname = string_kw(default="", comment="Unique name(HDRNAME) for headerlet[REQUIRED]")
+wcskey = option_kw("A","B","C","D","E","F","G","H","I","J","K","L","M","N","P","Q","R","S","T","U","V","W","X","Y","Z","PRIMARY", default="PRIMARY", comment="Create headerlet from WCS with this letter")
+wcsname = string_kw(default="", comment="Create headerlet from WCS with this name")
+author = string_kw(default="", comment="Author name for creator of headerlet")
+descrip = string_kw(default="", comment="Short description of headerlet solution")
+history = string_kw(default="", comment="Name of ASCII file containing history for headerlet")
+output = string_kw(default="", comment="Filename for headerlet FITS file")
+clobber = boolean_kw(default=True, comment= "Overwrite existing headerlet FITS file?")
+sciext = string_kw(default="SCI", comment="EXTNAME of extension with WCS")
+destim = string_kw(default="", comment="Rootname of image to which this headerlet applies ")
+sipname = string_kw(default="", comment="Name for source of polynomial distortion keywords")
+npolfile = string_kw(default="", comment="Name for source of non-polynomial residuals")
+d2imfile = string_kw(default="", comment="Name for source of detector correction table")
+attach = boolean_kw(default=True, comment="Create output headerlet FITS file?")