Release commit created with Cranko.

+++ cranko-release-info-v1
[[projects]]
qnames = ["toasty", "pypa"]
version = "0.12.0"
age = 0

+++

CHANGELOG.md

@@ -1,3 +1,32 @@
+# toasty 0.12.0 (2021-11-01)
+
+- Both toasty's AstroPix/Djangoplicity pipeline and the `wwt_data_formats`
+ module had WCS handling bugs that canceled each other out. The data-formats
+ bug was fixed in release 0.10.2 of that package, which caused the Toasty bug
+ to become apparent. Fix that (reported by @astrodavid10, #65; fixed by @pkgw,
+ #66).
+- Fixed and features needed to process the SELENE Kaguya TC dataset (@pkgw,
+ #63). Unfortunately these changes are lacking corresponding documentation:
+ - Add a U8 image mode.
+ - Add APIs to filter out out subtrees when sampling TOAST pyramids.
+ - Add proper support for the planetary TOAST coordinate system, which is
+ rotated 180 degrees in longitude from the celestial one.
+ - Add support for JPEG2000 images.
+ - Add support for chunked TOAST tiling.
+ - Add a chunked plate-carree TOAST sampler.
+ - Fix out-of-date data when updating PIL-based images.
+ - Improve multiprocessing implementations to avoid race conditions on exit and
+ operate more robustly in multi-node (HPC) contexts.
+ - Add the ability for `toasty transform` (and underlying APIs) to emit the
+ transformed data into a separate pyramid; i.e. create a tree of only JPG
+ files from a tree of NPY files.
+ - Add `toasty transform u8-to-rgb`
+ - Don't create every directory when removing lockfiles
+- Fix FITS file update on Windows (#67, @imbasimba)
+- Improve FITS heuristics to ignore binary tables and other HDUs without a
+ defined shape (#62, @imbasimba).
+
+
 # toasty 0.11.0 (2021-09-17)
 
 - Fix up `toasty tile-study` to handle FITS files properly (@pkgw, #61). The

README.md

@@ -80,7 +80,7 @@ and [PyPI](https://pypi.org/project/toasty/#history).
 - [pytest] to run the test suite
 - [PyYAML]
 - [tqdm]
-- [wwt_data_formats] >= 0.7
+- [wwt_data_formats] >= 0.10.2
 
 [Astronomy Visualization Metadata]: https://virtualastronomy.org/avm_metadata.php
 [astropy]: https://www.astropy.org/

ci/azure-build-and-test.yml

@@ -97,6 +97,7 @@ jobs:
  \conda install -y \
  cython \
  filelock \
+ glymur \
  healpy \
  numpy \
  openexr-python \

docs/api/toasty.image.ImageMode.rst

@@ -15,6 +15,7 @@ ImageMode
  ~ImageMode.F64
  ~ImageMode.RGB
  ~ImageMode.RGBA
+ ~ImageMode.U8
 
  .. rubric:: Methods Summary
 
@@ -31,6 +32,7 @@ ImageMode
  .. autoattribute:: F64
  .. autoattribute:: RGB
  .. autoattribute:: RGBA
+ .. autoattribute:: U8
 
  .. rubric:: Methods Documentation
 

docs/api/toasty.samplers.ChunkedPlateCarreeSampler.rst

@@ -0,0 +1,29 @@
+ChunkedPlateCarreeSampler
+=========================
+
+.. currentmodule:: toasty.samplers
+
+.. autoclass:: ChunkedPlateCarreeSampler
+ :show-inheritance:
+
+ .. rubric:: Attributes Summary
+
+ .. autosummary::
+
+ ~ChunkedPlateCarreeSampler.n_chunks
+
+ .. rubric:: Methods Summary
+
+ .. autosummary::
+
+ ~ChunkedPlateCarreeSampler.filter
+ ~ChunkedPlateCarreeSampler.sampler
+
+ .. rubric:: Attributes Documentation
+
+ .. autoattribute:: n_chunks
+
+ .. rubric:: Methods Documentation
+
+ .. automethod:: filter
+ .. automethod:: sampler

docs/api/toasty.toast.ToastCoordinateSystem.rst

@@ -0,0 +1,19 @@
+ToastCoordinateSystem
+=====================
+
+.. currentmodule:: toasty.toast
+
+.. autoclass:: ToastCoordinateSystem
+ :show-inheritance:
+
+ .. rubric:: Attributes Summary
+
+ .. autosummary::
+
+ ~ToastCoordinateSystem.ASTRONOMICAL
+ ~ToastCoordinateSystem.PLANETARY
+
+ .. rubric:: Attributes Documentation
+
+ .. autoattribute:: ASTRONOMICAL
+ .. autoattribute:: PLANETARY

docs/api/toasty.toast.count_tiles_matching_filter.rst

@@ -0,0 +1,6 @@
+count_tiles_matching_filter
+===========================
+
+.. currentmodule:: toasty.toast
+
+.. autofunction:: count_tiles_matching_filter

docs/api/toasty.toast.create_single_tile.rst

@@ -0,0 +1,6 @@
+create_single_tile
+==================
+
+.. currentmodule:: toasty.toast
+
+.. autofunction:: create_single_tile

docs/api/toasty.toast.generate_tiles_filtered.rst

@@ -0,0 +1,6 @@
+generate_tiles_filtered
+=======================
+
+.. currentmodule:: toasty.toast
+
+.. autofunction:: generate_tiles_filtered

docs/api/toasty.toast.sample_layer_filtered.rst

@@ -0,0 +1,6 @@
+sample_layer_filtered
+=====================
+
+.. currentmodule:: toasty.toast
+
+.. autofunction:: sample_layer_filtered

docs/api/toasty.toast.toast_tile_get_coords.rst

@@ -0,0 +1,6 @@
+toast_tile_get_coords
+=====================
+
+.. currentmodule:: toasty.toast
+
+.. autofunction:: toast_tile_get_coords

setup.py

@@ -9,107 +9,101 @@
 import os
 from setuptools import setup, Extension
 
+
 def get_long_desc():
  in_preamble = True
  lines = []
 
- with open('README.md', 'rt', encoding='utf8') as f:
+ with open("README.md", "rt", encoding="utf8") as f:
  for line in f:
  if in_preamble:
- if line.startswith('<!--pypi-begin-->'):
+ if line.startswith("<!--pypi-begin-->"):
  in_preamble = False
  else:
- if line.startswith('<!--pypi-end-->'):
+ if line.startswith("<!--pypi-end-->"):
  break
  else:
  lines.append(line)
 
- lines.append('''
+ lines.append(
+ """
 
 For more information, including installation instructions, please visit [the
 project homepage].
 
 [the project homepage]: https://toasty.readthedocs.io/
-''')
- return ''.join(lines)
+"""
+ )
+ return "".join(lines)
 
 
 setup_args = dict(
- name = 'toasty', # cranko project-name
- version = '0.11.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',
- url = 'https://toasty.readthedocs.io/',
- license = 'MIT',
- platforms = 'Linux, Mac OS X',
-
- author = 'Chris Beaumont, AAS WorldWide Telescope Team',
- author_email = '[email protected]',
-
- classifiers = [
- 'Intended Audience :: Science/Research',
- 'License :: OSI Approved :: MIT License',
- 'Operating System :: OS Independent',
- 'Programming Language :: Python :: 2.7',
- 'Programming Language :: Python :: 3.6',
- 'Programming Language :: Python :: 3.7',
- 'Programming Language :: Python :: 3.8',
- 'Topic :: Scientific/Engineering :: Astronomy',
- 'Topic :: Scientific/Engineering :: Visualization',
+ name="toasty", # cranko project-name
+ version="0.12.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",
+ url="https://toasty.readthedocs.io/",
+ license="MIT",
+ platforms="Linux, Mac OS X",
+ author="Chris Beaumont, AAS WorldWide Telescope Team",
+ author_email="[email protected]",
+ classifiers=[
+ "Intended Audience :: Science/Research",
+ "License :: OSI Approved :: MIT License",
+ "Operating System :: OS Independent",
+ "Programming Language :: Python :: 2.7",
+ "Programming Language :: Python :: 3.6",
+ "Programming Language :: Python :: 3.7",
+ "Programming Language :: Python :: 3.8",
+ "Topic :: Scientific/Engineering :: Astronomy",
+ "Topic :: Scientific/Engineering :: Visualization",
  ],
-
- packages = [
- 'toasty',
- 'toasty.pipeline',
- 'toasty.tests',
+ packages=[
+ "toasty",
+ "toasty.pipeline",
+ "toasty.tests",
  ],
- include_package_data = True,
-
- entry_points = {
- 'console_scripts': [
- 'toasty=toasty.cli:entrypoint',
+ include_package_data=True,
+ entry_points={
+ "console_scripts": [
+ "toasty=toasty.cli:entrypoint",
  ],
  },
-
- install_requires = [
- 'filelock>=3',
- 'numpy>=1.7',
- 'pillow>=7.0',
- 'PyYAML>=5.0',
- 'tqdm>=4.0',
- 'wwt_data_formats>=0.10.0',
+ install_requires=[
+ "filelock>=3",
+ "numpy>=1.7",
+ "pillow>=7.0",
+ "PyYAML>=5.0",
+ "tqdm>=4.0",
+ "wwt_data_formats>=0.10.2",
  ],
-
- extras_require = {
- 'test': [
- 'coveralls',
- 'pytest-cov',
+ extras_require={
+ "test": [
+ "coveralls",
+ "pytest-cov",
  ],
- 'docs': [
- 'astropy',
- 'astropy-sphinx-theme',
- 'numpydoc',
- 'sphinx',
- 'sphinx-automodapi',
+ "docs": [
+ "astropy",
+ "astropy-sphinx-theme",
+ "numpydoc",
+ "sphinx",
+ "sphinx-automodapi",
  ],
  },
-
- cmdclass = {
- 'build_ext': build_ext,
+ cmdclass={
+ "build_ext": build_ext,
  },
-
- ext_modules = [
- Extension('toasty._libtoasty', ['toasty/_libtoasty.pyx']),
+ ext_modules=[
+ Extension("toasty._libtoasty", ["toasty/_libtoasty.pyx"]),
  ],
-
- include_dirs = [
+ include_dirs=[
  np.get_include(),
- ]
+ ],
 )
 
-for e in setup_args['ext_modules']:
- e.cython_directives = {'language_level': '3'}
+for e in setup_args["ext_modules"]:
+ e.cython_directives = {"language_level": "3"}
 
-if __name__ == '__main__':
+if __name__ == "__main__":
  setup(**setup_args)

toasty/builder.py

@@ -85,8 +85,8 @@ def prepare_study_tiling(self, image):
  tiling : `toasty.study.StudyTiling`
  The prepared tiling information
 
- Remarks
- -------
+ Notes
+ -----
  After calling this method, you should set up the WCS for the tiled
  imagery, using :meth:`default_tiled_study_astrometry` as a backstop if
  no real information is available. Then use :meth:`execute_study_tiling`