summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorlim <lim@stsci.edu>2012-07-11 12:46:50 -0400
committerlim <lim@stsci.edu>2012-07-11 12:46:50 -0400
commit896f9128ccb2c2ff66ee3ca7f43c89c7db187ad6 (patch)
treefe518475b999e41b7fa2cfd7d255b2668e16799b /doc
parentaf6579480e6823ffd2ecdabf2dfa04e8112e6d18 (diff)
downloadstsci.sphere-896f9128ccb2c2ff66ee3ca7f43c89c7db187ad6.tar.gz
skyline member no longer has chip gap to simplify polygon op
git-svn-id: http://svn.stsci.edu/svn/ssb/stsci_python/stsci_python/branches/sphere@17820 fe389314-cf27-0410-b35b-8c050e845b92 Former-commit-id: 4414ce549adc9d1db30e4e0e8627d42ff5ad6444
Diffstat (limited to 'doc')
-rw-r--r--doc/source/user.rst13
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/source/user.rst b/doc/source/user.rst
index 60b77d8..40dff39 100644
--- a/doc/source/user.rst
+++ b/doc/source/user.rst
@@ -192,10 +192,14 @@ What is a skyline member?
Each member in `~sphere.skyline.SkyLine.members` belongs to the
`~sphere.skyline.SkyLineMember` class, which contains image name (with path if
-given), science extension, and WCS object and polygon of that extension.
+given), science extension(s), and composite WCS and polygon of the extension(s).
+All skylines start out with a single member from a single image. When operations
+are used to find composite or intersecting skylines, the resulting skyline can
+have multiple members.
-For example, an ACS/WFC full-frame image would give 2 members, one from EXT 1
-and another from EXT 4.
+For example, a skyline from an ACS/WFC full-frame image would give 1 member,
+which is a composite of extensions 1 and 4. A skyline from the union of 2 such
+images would have 2 members, and so forth.
Creating skylines
`````````````````
@@ -224,7 +228,8 @@ following (which are still accessible indirectly via
In addition, `~sphere.skyline.SkyLine` also has these operations available:
- `~sphere.skyline.SkyLine.to_wcs`: Return a composite HST WCS object defined
- by all the members.
+ by all the members. In a skyline resulting from intersection, this does
+ *not* return the WCS of the intersecting polygons.
- `~sphere.skyline.SkyLine.add_image`: Return a new skyline that is the union
of two skylines. This should be used, *not* `SkyLine.union` (which is