Release commit created with Cranko.

+++ cranko-release-info-v1 [[projects]] qnames = ["toasty", "pypa"] version = "0.15.0" age = 0 +++
WorldWideTelescope · Jan 14, 2022 · 2829fdf · 2829fdf
2 parents 0de6989 + 2b13d16
commit 2829fdf
Show file tree

Hide file tree

Showing 38 changed files with 1,043 additions and 545 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,20 @@
+# toasty 0.15.0 (2022-01-14)
+
+- Start adding metadata about data min/max values and suggested pixel range cuts
+  for tiled FITS data sets, for either TOAST or HiPS-based data processing (#71,
+  @imbasimba). This will allow the renderer to provide nice default settings
+  when opening up FITS datasets.
+- Add support for 32-bit integer FITS (#72, @imbasimba)
+- Allow Astropy's WCS code to fix non-standard FITS headers, which increases our
+  compatibility with more FITS datasets in the wild (#73, @imbasimba)
+- Add the `--fits-wcs` argument to `tile-study`, to apply coordinates to an RGB
+  image based on the data contained in a separate FITS file (#74, @pkgw). This
+  is especially useful if you have an image that Astrometry.Net can solve, since
+  that service produces small downloadable FITS files with its solution
+  information.
+- Reorganize the API docs a bit (#74, @pkgw)
+
+
 # toasty 0.14.0 (2021-12-13)
 
 - Expand the all-in-one FITS API, [`toasty.tile_fits`], to invoke the

diff --git a/ci/azure-build-and-test.yml b/ci/azure-build-and-test.yml
@@ -5,36 +5,36 @@ parameters:
   type: object
   default:
 
-  - name: linux_37
-    vmImage: ubuntu-20.04
-    vars:
-      PYTHON_SERIES: "3.7"
-
   - name: linux_38
     vmImage: ubuntu-20.04
     vars:
       PYTHON_SERIES: "3.8"
 
-  - name: macos_37
-    vmImage: macos-10.15
+  - name: linux_39
+    vmImage: ubuntu-20.04
     vars:
-      PYTHON_SERIES: "3.7"
+      PYTHON_SERIES: "3.9"
 
   - name: macos_38
     vmImage: macos-10.15
     vars:
       PYTHON_SERIES: "3.8"
 
-  - name: windows_37
-    vmImage: windows-2019
+  - name: macos_39
+    vmImage: macos-10.15
     vars:
-      PYTHON_SERIES: "3.7"
+      PYTHON_SERIES: "3.9"
 
   - name: windows_38
     vmImage: windows-2019
     vars:
       PYTHON_SERIES: "3.8"
 
+  - name: windows_39
+    vmImage: windows-2019
+    vars:
+      PYTHON_SERIES: "3.9"
+
 jobs:
 - ${{ each build in parameters.builds }}:
   - job: ${{ format('build_{0}', build.name) }}

diff --git a/docs/api.rst b/docs/api.rst
diff --git a/docs/api/toasty.builder.rst b/docs/api/toasty.builder.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.builder
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.cli.rst b/docs/api/toasty.cli.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.cli
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.collection.rst b/docs/api/toasty.collection.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.collection
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.fits_tiler.rst b/docs/api/toasty.fits_tiler.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.fits_tiler
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.image.rst b/docs/api/toasty.image.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.image
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.merge.rst b/docs/api/toasty.merge.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.merge
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.multi_tan.rst b/docs/api/toasty.multi_tan.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.multi_tan
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.openexr.rst b/docs/api/toasty.openexr.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.openexr
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.par_util.rst b/docs/api/toasty.par_util.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.par_util
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pipeline.astropix.rst b/docs/api/toasty.pipeline.astropix.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pipeline.astropix
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pipeline.azure_io.rst b/docs/api/toasty.pipeline.azure_io.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pipeline.azure_io
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pipeline.cli.rst b/docs/api/toasty.pipeline.cli.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pipeline.cli
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pipeline.djangoplicity.rst b/docs/api/toasty.pipeline.djangoplicity.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pipeline.djangoplicity
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pipeline.local_io.rst b/docs/api/toasty.pipeline.local_io.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pipeline.local_io
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pipeline.rst b/docs/api/toasty.pipeline.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pipeline
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.pyramid.rst b/docs/api/toasty.pyramid.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.pyramid
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.rst b/docs/api/toasty.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.samplers.rst b/docs/api/toasty.samplers.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.samplers
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.study.rst b/docs/api/toasty.study.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.study
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/api/toasty.toast.rst b/docs/api/toasty.toast.rst
@@ -0,0 +1,3 @@
+.. automodapi:: toasty.toast
+   :no-inheritance-diagram:
+   :no-inherited-members:
diff --git a/docs/cli/tile-study.rst b/docs/cli/tile-study.rst
@@ -18,6 +18,7 @@ Usage
       [--outdir DIR]
       [--name NAME]
       [--avm]
+      [--fits-wcs PATH]
       IMAGE-PATH
 
 See the :ref:`cli-std-image-options` section for documentation on those options.
@@ -48,6 +49,14 @@ requires the `pyavm`_ package to be installed on your system.
 
 .. _pyavm: https://astrofrog.github.io/pyavm/
 
+If the ``--fits-wcs`` argument is given, Toasty will attempt to load
+world-coordinate information from the headers of the named `FITS`_ file. It is
+up to you to ensure that information contained in that file corresponds to the
+main input image. This argument can be useful with the output from
+`Astrometry.Net`_, which generates WCS FITS files for the images it solves.
+
+.. _FITS: https://en.wikipedia.org/wiki/FITS
+.. _Astrometry.Net: https://astrometry.net/
 
 Notes
 =====

diff --git a/docs/index.rst b/docs/index.rst
@@ -16,7 +16,34 @@ maps can be viewed in software such as the AAS_ `WorldWide Telescope`_.
 
    manual
    cli
-   api
+
+
+Python API Reference
+====================
+
+.. toctree::
+   :maxdepth: 1
+
+   api/toasty
+   api/toasty.builder
+   api/toasty.cli
+   api/toasty.collection
+   api/toasty.fits_tiler
+   api/toasty.image
+   api/toasty.merge
+   api/toasty.multi_tan
+   api/toasty.openexr
+   api/toasty.par_util
+   api/toasty.pipeline
+   api/toasty.pipeline.astropix
+   api/toasty.pipeline.azure_io
+   api/toasty.pipeline.cli
+   api/toasty.pipeline.djangoplicity
+   api/toasty.pipeline.local_io
+   api/toasty.pyramid
+   api/toasty.samplers
+   api/toasty.study
+   api/toasty.toast
 
 
 Getting help

diff --git a/setup.py b/setup.py
@@ -39,7 +39,7 @@ def get_long_desc():
 
 setup_args = dict(
     name="toasty",  # cranko project-name
-    version="0.14.0",  # cranko project-version
+    version="0.15.0",  # cranko project-version
     description="Generate TOAST image tile pyramids from existing image data",
     long_description=get_long_desc(),
     long_description_content_type="text/markdown",
@@ -78,7 +78,7 @@ def get_long_desc():
         "reproject",
         "shapely",
         "tqdm>=4.0",
-        "wwt_data_formats>=0.10.2",
+        "wwt_data_formats>=0.12",
     ],
     extras_require={
         "test": [