OpenUniverse2024FITSImage

class snappl.image.OpenUniverse2024FITSImage(*args, imagehdu=1, noisehdu=2, flagshdu=3, **kwargs)[source]

Bases: CompressedFITSImage

Instantiate an image. You probably don’t want to do that.

This is an abstract base class that has limited functionality. You probably want to instantiate a subclass if you’re creating a new image.

If you’re trying to pull an image out of the database, then probably what you really want is to use the Image.get_image or Image.find_images class methods.

If you’re working with non-database images and are trying to get a pre-existing image, then probably what you really want to do is call the get_image() method of an ImageCollection object.

Parameters:

  • filepath (str or Path, default None) – Path of the image relative to the base path for images, unless less no_base_path is True, in which case this is the full absolute path to the image. For datbase images, you do not want to create a path yourself, but leave it at None and let the class create the filepath. See PathedObject.

  • full_filepath (str or Path, default None) – The full path to the image. If you’re using an Image subclass to deal with an image that’s not in the database, you probably want to set this to the absolute path of the image, and you probably want to set no_base_path to True, but you might also set base_path yourself and leave no_base_path at False.

  • base_path (str or Path, default None) – Always leave this at None for images associated with database, and the default will be used. Otherwise, the absolute path of the image is base_path / filepath (which should be exactly the same as full_filepath). Must be None if no_base_path is True.

  • base_dir (str or Path, default None) – Synonym for base_path

  • no_base_path (bool, default False) – For images associated with the database, leave this at False, and make filepath relative to the base path (which may be system dependent). For images that aren’t associated with the database, you can make this True and set filepath to be just the path to the image.

  • id (UUID or str that can be converted to UUID, default None) – Database ID of the image. This is only relevant if the image is in the l2image table of the Roman SNPIT internal database (but is required in that case).

  • provenance_id (UUID or str that can be converted to UUID, default NOne) – The id of the provenance of the image. Only relevant if the image is in the l2image table of the Roman SNPIT internal database (but is required in that case).

  • width (int, default None) – The width and height of the image in pixels if known.

  • height (int, default None) – The width and height of the image in pixels if known.

  • format (int, default -1) – Index into the table Image._format_def at the bottom of this file.

  • observation_id (str)

  • sca (int, default None)

  • ra (float, default None)

  • dec (float, default None)

  • (ra|dec)_corner_(00|01|10|11) (float, default None)

  • band (str, default None)

  • mjd (float, default None)

  • position_angle (float, default None)

  • exptime (float, default None)

  • sky_level (float, default None)

  • zeropoint (float, default None) – All of these are the values that should be set for these properties (see Image class docstring). If they are None, how they get populated depends on the image subclass. In many cases, they will be lazy-loaded from the header.

Attributes Summary

truthpath

this is OpenUniverse2024FITSImage-specific, use with care.

Attributes Documentation

truthpath

this is OpenUniverse2024FITSImage-specific, use with care.

Type:

Path to truth catalog. WARNING