pyobs-core 2.0.0.dev97__tar.gz → 2.0.0.dev99__tar.gz

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyobs-core
-Version: 2.0.0.dev97
+Version: 2.0.0.dev99
 Summary: robotic telescope software
 Author-email: Tim-Oliver Husser <thusser@uni-goettingen.de>
 License-Expression: MIT

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/annotation/circle.py

@@ -16,7 +16,7 @@ class Circle(ImageProcessor):
     This processor uses Pillow to render a circle on a
     :class:`pyobs.images.Image`. The center coordinates ``(x, y)`` and the ``radius``
     can be provided as numbers or strings that are resolved by
-    :class:`pyobs.utils.image.PillowHelper`. If ``wcs=True``, the center coordinates
+    the internal ``PillowHelper``. If ``wcs=True``, the center coordinates
     are interpreted in world coordinates (e.g., sky coordinates) and converted to
     pixel coordinates using the image’s WCS, if available.
 
@@ -37,9 +37,9 @@ class Circle(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
-    - Converts the input image to a Pillow image using :class:`pyobs.utils.image.PillowHelper`.
+    Circle behavior
+    ---------------
+    - Converts the input image to a Pillow image using the internal ``PillowHelper``.
     - Resolves ``x``, ``y`` via ``PillowHelper.position(image, x, y, wcs)`` and ``radius`` via
       ``PillowHelper.value(image, radius)``.
     - Converts ``fill`` and ``outline`` to Pillow-compatible color values via
@@ -49,13 +49,13 @@ class Circle(ImageProcessor):
       ``PillowHelper.to_image(image, im)``.
     - If both ``fill`` and ``outline`` are ``None``, the rendered output will be unchanged.
 
-    Input/Output
-    ------------
+    Circle input/output
+    -------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (copied) with the circle drawn onto the pixel data.
 
-    Configuration (YAML)
-    --------------------
+    Circle configuration (YAML)
+    ---------------------------
     Draw a red outlined circle:
 
     .. code-block:: yaml

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/annotation/crosshair.py

@@ -34,9 +34,9 @@ class Crosshair(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
-    - Converts the input to a Pillow image via :class:`pyobs.utils.image.PillowHelper.from_image`.
+    Crosshair behavior
+    ------------------
+    - Converts the input to a Pillow image via ``PillowHelper.from_image``.
     - Resolves the center position with ``PillowHelper.position(image, x, y, wcs)`` and the color
       with ``PillowHelper.color(color)``.
     - Draws:
@@ -47,13 +47,13 @@ class Crosshair(ImageProcessor):
     - Converts the Pillow image back to a :class:`pyobs.images.Image` via
       ``PillowHelper.to_image(image, im)``.
 
-    Input/Output
-    ------------
+    Crosshair input/output
+    ----------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (copied) with the crosshair drawn onto the pixel data.
 
-    Configuration (YAML)
-    --------------------
+    Crosshair configuration (YAML)
+    ------------------------------
     Pixel coordinates:
 
     .. code-block:: yaml
@@ -80,7 +80,7 @@ class Crosshair(ImageProcessor):
     - When ``wcs=True``, only ``x`` and ``y`` are interpreted in world coordinates; ``radius``
       is treated as a pixel length.
     - Color representation and supported coordinate/value formats depend on
-      :class:`pyobs.utils.image.PillowHelper`.
+      the internal ``PillowHelper``.
     - The line width scales with radius and is not independently configurable.
     """
 

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/annotation/text.py

@@ -44,9 +44,9 @@ class Text(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
-    - Converts the input image to a Pillow image via :class:`pyobs.utils.image.PillowHelper.from_image`.
+    Text behavior
+    -------------
+    - Converts the input image to a Pillow image via ``PillowHelper.from_image``.
     - Resolves the position with ``PillowHelper.position(image, x, y, wcs)`` and the fill color with
       ``PillowHelper.color(fill)``.
     - Attempts to format ``text`` using ``self._text.format(**image.header)``; if a placeholder key
@@ -57,13 +57,13 @@ class Text(ImageProcessor):
     - Converts the Pillow image back to a :class:`pyobs.images.Image` with
       ``PillowHelper.to_image(image, im)``.
 
-    Input/Output
-    ------------
+    Text input/output
+    -----------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (copied) with the text drawn onto the pixel data.
 
-    Configuration (YAML)
-    --------------------
+    Text configuration (YAML)
+    -------------------------
     Draw static text in pixel coordinates:
 
     .. code-block:: yaml
@@ -112,7 +112,7 @@ class Text(ImageProcessor):
     -----
     - Header-based formatting uses Python’s ``str.format`` mechanism with ``image.header`` as
       the source of values. Missing keys are ignored and the unformatted text is used.
-    - Color representation and supported value formats depend on :class:`pyobs.utils.image.PillowHelper`.
+    - Color representation and supported value formats depend on the internal ``PillowHelper``.
     - The ``anchor`` option controls how the text is positioned relative to ``(x, y)``; refer to
       Pillow’s documentation for the available anchor codes.
     - If no font is provided, Pillow’s default font is used. When a TrueType font is specified,

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/astrometry/dotnet.py

@@ -19,8 +19,8 @@ class AstrometryDotNet(Astrometry):
     This processor submits sources extracted from a
     :class:`pyobs.images.Image` to an astrometry.net service, obtains a WCS solution,
     and writes it back to the image’s FITS header. The solver endpoint is configured
-    via ``url`` and the request content is built by
-    :class:`pyobs.images.processors.astrometry._DotNetRequestBuilder`.
+    via ``url`` and the request content is built by the internal ``_DotNetRequestBuilder``
+    helper.
 
     :param str url: Base URL of the astrometry.net service endpoint.
     :param int source_count: Number of detected sources to include in the request
@@ -45,14 +45,14 @@ class AstrometryDotNet(Astrometry):
 
     Behavior
     --------
-    - Constructs a request from the input image using
-      :class:`pyobs.images.processors.astrometry._DotNetRequestBuilder(source_count, radius)`.
-    - Logs request metadata via :class:`pyobs.images.processors.astrometry._RequestLogger`.
+    - Constructs a request from the input image using the internal
+      ``_DotNetRequestBuilder(source_count, radius)``.
+    - Logs request metadata via the internal ``_RequestLogger``.
     - Sends the request to the configured service with ``request.send(url, timeout)``.
     - On success, receives solver output and writes the resulting WCS into a copy of
-      the input image using :class:`pyobs.images.processors.astrometry._ResponseImageWriter`.
+      the input image using the internal ``_ResponseImageWriter``.
     - Logs the outcome, including WCS information, and returns the result image.
-    - On failure, raises the underlying :class:`pyobs.images.exceptions.ImageError`. When run as
+    - On failure, raises the underlying :class:`~pyobs.utils.exceptions.ImageError`. When run as
       a pipeline step with ``on_error="error"``, the pipeline calls ``handle_error``, which sets
       ``WCSERR=1`` in the FITS header, logs a warning, and returns the original image unchanged.
 

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/calibration/calibration.py

@@ -22,15 +22,15 @@ class Calibration(ImageProcessor):
     This processor locates appropriate master calibration frames
     (bias, dark, flat) based on the input image metadata, applies calibration to the
     image, and annotates the FITS header with provenance and reduction information.
-    Calibration frames are looked up via an :class:`pyobs.archive.Archive` and are
+    Calibration frames are looked up via an :class:`~pyobs.robotic.utils.archive.Archive` and are
     cached in a class-wide cache to reduce repeated lookups. If required calibration
     frames cannot be found, the original image is returned unchanged.
 
     :param dict | Archive archive: Archive configuration or an already constructed
-                                  :class:`pyobs.archive.Archive` instance used to
+                                  :class:`~pyobs.robotic.utils.archive.Archive` instance used to
                                   locate master calibration frames. If a dictionary
                                   is provided, it is instantiated via
-                                  :func:`pyobs.utils.classes.get_object`.
+                                  :func:`~pyobs.object.get_object`.
     :param int max_cache_size: Maximum number of master frames kept in the shared
                                calibration cache. Default: ``20``.
     :param bool require_bias: If ``True``, a master bias must be found; otherwise
@@ -60,7 +60,7 @@ class Calibration(ImageProcessor):
       and ``DATE-OBS`` must be present.
     - Attempts to retrieve required masters (bias, dark, flat) from a class-wide cache.
       On cache miss, queries the configured archive via
-      :meth:`pyobs.pipeline.Pipeline.find_master`, matching:
+      :meth:`~pyobs.utils.pipeline.Pipeline.find_master`, matching:
 
       - Instrument: exact value of ``INSTRUME``.
       - Binning: string formatted as ``"{XBINNING}x{XBINNING}"`` (square binning assumed).
@@ -69,7 +69,7 @@ class Calibration(ImageProcessor):
 
     - If any required master is missing, logs a warning and returns the original image
       unchanged.
-    - Applies calibration using :class:`pyobs.images.processors.calibration._CCDDataCalibrator`
+    - Applies calibration using the internal ``_CCDDataCalibrator`` helper
       with the found master frames (``None`` for any non-required step to be skipped).
     - Copies provenance into the output FITS header:
 

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/detection/daophot.py

@@ -47,12 +47,12 @@ class DaophotSourceDetection(SourceDetection):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processors.detection.SourceDetection`.
 
-    Behavior
-    --------
+    Daophot Source Detection behavior
+    ---------------------------------
     - If the input image has no data (``image.safe_data is None``), a warning is logged
       and the image is returned unchanged.
     - Background is estimated and subtracted using
-      :class:`pyobs.images.processors.detection._DaoBackgroundRemover`
+      the internal ``_DaoBackgroundRemover`` helper
       with the configured ``bkg_sigma``, ``bkg_box_size``, and ``bkg_filter_size``.
     - Robust statistics are computed on the background-corrected data via
       :func:`astropy.stats.sigma_clipped_stats` (with ``sigma=3.0``) to obtain
@@ -63,18 +63,18 @@ class DaophotSourceDetection(SourceDetection):
     - DAOStarFinder execution is offloaded to a thread executor to avoid blocking
       the event loop.
     - The resulting :class:`astropy.table.Table` is converted to a pyobs
-      :class:`pyobs.images.catalog._SourceCatalog`, FITS 1-based origin convention is
+      the internal ``_SourceCatalog`` helper, FITS 1-based origin convention is
       applied to coordinates, and the catalog is attached to the image with the keys
       ``["x", "y", "flux", "peak"]``.
 
-    Input/Output
-    ------------
+    Daophot Source Detection input/output
+    -------------------------------------
     - Input: :class:`pyobs.images.Image` with 2D pixel data.
     - Output: :class:`pyobs.images.Image` with a source catalog attached. Pixel data
       are unchanged; catalog entries typically include positions and flux measures.
 
-    Configuration (YAML)
-    --------------------
+    Daophot Source Detection configuration (YAML)
+    ---------------------------------------------
     Minimal example:
 
     .. code-block:: yaml
@@ -101,7 +101,7 @@ class DaophotSourceDetection(SourceDetection):
       noise; very low values may increase false positives.
     - The background remover’s exact behavior (e.g., clipping strategy, box tiling,
       and filtering) is defined by
-      :class:`pyobs.images.processors.detection._DaoBackgroundRemover`.
+      the internal ``_DaoBackgroundRemover`` helper.
     - Very bright/saturated sources or artifacts (cosmic rays, bleed trails) may
       produce spurious detections; consider pre-masking if necessary.
     """

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/detection/pysep.py

@@ -49,8 +49,8 @@ class SepSourceDetection(SourceDetection):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processors.detection.SourceDetection`.
 
-    Behavior
-    --------
+    Sep Source Detection behavior
+    -----------------------------
     - If the input image has no data (``image.safe_data is None``), a warning is logged
       and the image is returned unchanged.
     - A mask is obtained from ``image.mask`` if available; otherwise a zero-valued
@@ -64,9 +64,9 @@ class SepSourceDetection(SourceDetection):
       ``deblend_nthresh=self.deblend_nthresh``, ``deblend_cont=self.deblend_cont``,
       ``clean=self.clean``, ``clean_param=self.clean_param``, and the computed mask.
       Extraction is offloaded to a thread executor to avoid blocking the event loop.
-    - The resulting array is converted to a pyobs :class:`_SourceCatalog`, initial
+    - The resulting array is converted using the internal ``_SourceCatalog`` helper, initial
       detection flags are filtered, and additional SEP-based measurements are computed
-      via :class:`PySepStatsCalculator`. The detector gain is taken from the FITS
+      via ``PySepStatsCalculator``. The detector gain is taken from the FITS
       header key ``DET-GAIN`` if present; otherwise gain-dependent metrics may be
       limited or use defaults.
     - Post-processing includes filtering by detection flags, wrapping rotation angles
@@ -76,14 +76,14 @@ class SepSourceDetection(SourceDetection):
       ``["x", "y", "peak", "flux", "fwhm", "a", "b", "theta", "ellipticity", "tnpix", "kronrad", "fluxrad25",
       "fluxrad50", "fluxrad75", "xwin", "ywin"]``.
 
-    Input/Output
-    ------------
+    Sep Source Detection input/output
+    ---------------------------------
     - Input: :class:`pyobs.images.Image` with 2D pixel data; optional mask and header.
     - Output: :class:`pyobs.images.Image` with a source catalog attached. Pixel data
       are unchanged; the FITS header may be read for gain (``DET-GAIN``).
 
-    Configuration (YAML)
-    --------------------
+    Sep Source Detection configuration (YAML)
+    -----------------------------------------
     Minimal example:
 
     .. code-block:: yaml
@@ -113,7 +113,7 @@ class SepSourceDetection(SourceDetection):
     - Background parameters (``bw``, ``bh``, ``fw``, ``fh``) are fixed in this wrapper;
       adjust here if you need finer control for highly structured backgrounds.
     - If ``DET-GAIN`` is absent, gain-dependent uncertainties and radii may be limited
-      or use defaults in :class:`PySepStatsCalculator`.
+      or use defaults in ``PySepStatsCalculator``.
     """
 
     __module__ = "pyobs.images.processors.detection"

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/detection/simpledisk.py

@@ -33,8 +33,8 @@ class SimpleDisk(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
+    Simple Disk behavior
+    --------------------
     - Chooses the image plane: uses the first channel (``image.data[0, :, :]``) if the
       image is color, otherwise uses the full 2D array.
     - Creates a binary mask with ``mask = data > threshold``.
@@ -49,14 +49,14 @@ class SimpleDisk(ImageProcessor):
       - ``keyword_x`` = x (column index, zero-based)
       - ``keyword_radius`` = radius (float, pixels)
 
-    Input/Output
-    ------------
+    Simple Disk input/output
+    ------------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (copied) with new FITS header entries for
       center coordinates and radius; pixel data are unchanged.
 
-    Configuration (YAML)
-    --------------------
+    Simple Disk configuration (YAML)
+    --------------------------------
     Basic detection with a custom threshold:
 
     .. code-block:: yaml

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/addfitsheaders.py

@@ -43,8 +43,8 @@ class AddFitsHeaders(ImageProcessor):
         Whether to overwrite existing keywords when they already exist in the header.
         Default: ``True``.
 
-    Behavior
-    --------
+    Add Fits Headers behavior
+    -------------------------
     - For each specified header card, the processor will add the keyword and value
       to the image's FITS header. If the keyword is already present:
 
@@ -56,13 +56,13 @@ class AddFitsHeaders(ImageProcessor):
     - FITS keyword names should follow FITS conventions (typically up to 8 ASCII
       characters, uppercase) to ensure compatibility with FITS tools.
 
-    Input/Output
-    ------------
+    Add Fits Headers input/output
+    -----------------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` with updated FITS headers.
 
-    Configuration (YAML)
-    --------------------
+    Add Fits Headers configuration (YAML)
+    -------------------------------------
     Simple mapping:
 
     .. code-block:: yaml

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/download.py

@@ -71,8 +71,8 @@ class Download(ImageProcessor):
     :param kwargs:
         Additional keyword arguments forwarded to :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
+    Download behavior
+    -----------------
     - Performs an HTTP GET request to ``url`` using :class:`aiohttp.ClientSession`.
     - If the URL ends with ``.fits``, the image is constructed with :meth:`pyobs.images.Image.from_bytes`,
       preserving existing FITS headers.
@@ -82,13 +82,13 @@ class Download(ImageProcessor):
       - The processor sets ``DATE-OBS`` to the current ISO timestamp and ``EXPTIME`` to ``0`` in the header.
     - The input parameter ``image`` to ``__call__`` is ignored (no-op); a new image object is returned.
 
-    Input/Output
-    ------------
+    Download input/output
+    ---------------------
     - Input: :class:`pyobs.images.Image` (ignored).
     - Output: :class:`pyobs.images.Image` constructed from the downloaded bytes.
 
-    Configuration (YAML)
-    --------------------
+    Download configuration (YAML)
+    -----------------------------
     .. code-block:: yaml
 
        class: pyobs.images.processors.image.Download

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/flip.py

@@ -30,16 +30,16 @@ class Flip(ImageProcessor):
          ``x -> (width - 1 - x)`` when ``flip_x`` is ``True`` and
          ``y -> (height - 1 - y)`` when ``flip_y`` is ``True``.
 
-    Input/Output
-    ------------
+    Flip input/output
+    -----------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` with pixel data flipped according to the configured axes.
       The output image has the same shape and dtype as the input. Header metadata (including WCS)
       are preserved and not modified by this processor; workflows relying on orientation-sensitive
       metadata may need to update them downstream.
 
-    Configuration (YAML)
-    --------------------
+    Flip configuration (YAML)
+    -------------------------
     Instantiate and configure via YAML, for example:
 
     .. code-block:: yaml

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/grayscale.py

@@ -27,22 +27,22 @@ class Grayscale(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
-    - Calls :meth:`pyobs.images.Image.to_grayscale(r, g, b)` on the input image and returns
+    Grayscale behavior
+    ------------------
+    - Calls :meth:`~pyobs.images.Image.to_grayscale` on the input image and returns
       the resulting image.
     - The weights need not sum to 1.0; they are used as provided for a linear combination.
     - Header metadata are preserved by the underlying conversion method.
     - Typical input layout for color images is channel-first ``(C, H, W)`` with ``C=3`` (RGB).
 
-    Input/Output
-    ------------
+    Grayscale input/output
+    ----------------------
     - Input: :class:`pyobs.images.Image` (color image with 3 channels).
     - Output: :class:`pyobs.images.Image` (single-channel grayscale image, shape dependent
-      on the implementation of :meth:`to_grayscale`).
+      on the implementation of :meth:`~pyobs.images.Image.to_grayscale`).
 
-    Configuration (YAML)
-    --------------------
+    Grayscale configuration (YAML)
+    ------------------------------
     Default Rec. 709 weights:
 
     .. code-block:: yaml

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/httpserver.py

@@ -21,7 +21,7 @@ class HttpServer(ImageProcessor):
     - ``GET /``: A simple HTML page embedding the image.
     - ``GET /<filename>``: The raw encoded image bytes.
 
-    Images are encoded using :func:`pyobs.images.processors.image.saveimage.SaveImage.encode_image`
+    Images are encoded using :meth:`~pyobs.images.processors.image.SaveImage.encode_image`
     based on the configured ``filename`` extension or an explicitly provided ``format``.
 
     :param str filename: The filename to serve the image as, which also determines the path
@@ -36,26 +36,26 @@ class HttpServer(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
+    Http Server behavior
+    --------------------
     - On the first call, starts an :class:`aiohttp.web.TCPSite` bound to ``url:port`` and
       registers two routes:
       - ``GET /<filename>`` returns the currently stored image bytes with content type ``image/*``.
       - ``GET /`` returns a minimal HTML page embedding the image via ``<img src="<filename>">``.
     - Encodes the input image using
-      :func:`pyobs.images.processors.image.saveimage.SaveImage.encode_image(image, filename, format)`
+      :meth:`~pyobs.images.processors.image.SaveImage.encode_image`
       and stores it as the "current" image to be served by the endpoints.
     - Subsequent calls update the stored image; clients fetching ``/<filename>`` will receive
       the latest version.
     - If no image has been processed yet, ``GET /<filename>`` responds with 404 Not Found.
 
-    Input/Output
-    ------------
+    Http Server input/output
+    ------------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (unchanged), while the encoded bytes are exposed via HTTP.
 
-    Configuration (YAML)
-    --------------------
+    Http Server configuration (YAML)
+    --------------------------------
     Serve a JPEG on localhost:
 
     .. code-block:: yaml
@@ -91,7 +91,7 @@ class HttpServer(ImageProcessor):
     - The response content type is ``image/*``; some clients may expect a specific MIME type
       if the chosen format is known (e.g., ``image/jpeg`` or ``image/png``).
     - If the encoding fails (e.g., due to unsupported format), the underlying encoder may raise
-      an exception; those propagate from :func:`SaveImage.encode_image`.
+      an exception; those propagate from :meth:`~pyobs.images.processors.image.SaveImage.encode_image`.
     """
 
     __module__ = "pyobs.images.processors.image"

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/normalize.py

@@ -28,8 +28,8 @@ class Normalize(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
+    Normalize behavior
+    ------------------
     - Creates a copy of the input image and replaces its ``data`` with a normalized
       ``numpy.uint8`` array.
     - If ``vmin``/``vmax`` are ``None``, they are computed over the entire array
@@ -39,13 +39,13 @@ class Normalize(ImageProcessor):
       is used for all channels (no per-channel normalization).
     - Header metadata are preserved; only the pixel data and dtype change.
 
-    Input/Output
-    ------------
+    Normalize input/output
+    ----------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (copied) with data normalized to ``uint8``.
 
-    Configuration (YAML)
-    --------------------
+    Normalize configuration (YAML)
+    ------------------------------
     Automatic bounds:
 
     .. code-block:: yaml

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/save.py

@@ -15,15 +15,15 @@ class Save(ImageProcessor):
     Save an image to the virtual file system and optionally broadcast a NewImageEvent.
 
     This processor formats a destination filename using a
-    :class:`pyobs.utils.formatter.FilenameFormatter` (configured via ``filename``),
+    :class:`~pyobs.utils.fits.FilenameFormatter` (configured via ``filename``),
     writes the image to the pyobs virtual file system (``vfs``), and, if enabled,
-    broadcasts a :class:`NewImageEvent` via the communication interface (``comm``).
+    broadcasts a :class:`~pyobs.events.NewImageEvent` via the communication interface (``comm``).
     The original image is returned unchanged.
 
     :param str filename: Filename template for saving the image. The actual path is produced by
-                         :meth:`pyobs.images.Image.format_filename` using a
-                         :class:`FilenameFormatter`. Default: ``"/pyobs/image.fits"``.
-    :param bool broadcast: If ``True``, broadcast a :class:`NewImageEvent` after saving the image.
+                         :meth:`~pyobs.images.Image.format_filename` using a
+                         :class:`~pyobs.utils.fits.FilenameFormatter`. Default: ``"/pyobs/image.fits"``.
+    :param bool broadcast: If ``True``, broadcast a :class:`~pyobs.events.NewImageEvent` after saving the image.
                            Default: ``False``.
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
@@ -34,18 +34,19 @@ class Save(ImageProcessor):
     - Broadcasting requires a communication interface (``self.comm``) and successful registration
       of ``NewImageEvent`` in ``open()``.
     - The broadcasted event’s ``image_type`` is derived from the FITS header key ``IMAGETYP``.
-      This key must be present and convertible to :class:`ImageType`; otherwise, an exception may be raised.
+      This key must be present and convertible to :class:`~pyobs.utils.enums.ImageType`;
+      otherwise, an exception may be raised.
 
-    Input/Output
-    ------------
+    Save input/output
+    -----------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (unchanged), with side effects:
 
       - Image is saved to the virtual file system.
       - Optional event broadcast after saving.
 
-    Configuration (YAML)
-    --------------------
+    Save configuration (YAML)
+    -------------------------
     Save and broadcast new images:
 
     .. code-block:: yaml
@@ -66,7 +67,7 @@ class Save(ImageProcessor):
     -----
     - Ensure the image header contains a valid ``IMAGETYP`` if broadcasting is enabled.
     - The actual filename may include formatted components depending on your
-      :class:`FilenameFormatter` and :meth:`pyobs.images.Image.format_filename` implementation.
+      :class:`~pyobs.utils.fits.FilenameFormatter` and :meth:`~pyobs.images.Image.format_filename` implementation.
     - Errors raised by the virtual file system (e.g., write failures) or communication subsystem
       (e.g., event dispatch errors) propagate to the caller.
     """

{pyobs_core-2.0.0.dev97 → pyobs_core-2.0.0.dev99}/pyobs/images/processors/image/saveimage.py

@@ -16,14 +16,14 @@ class SaveImage(ImageProcessor):
     Save an image as an encoded byte stream (e.g., JPEG, PNG) via the virtual file system.
 
     This processor formats a destination filename using a
-    :class:`pyobs.utils.formatter.FilenameFormatter`, encodes the input
+    :class:`~pyobs.utils.fits.FilenameFormatter`, encodes the input
     :class:`pyobs.images.Image` to the desired image format using Pillow, and writes
     the resulting bytes to the pyobs virtual file system (``vfs``). The original image
     object is returned unchanged.
 
     :param str filename: Filename template for saving the encoded image. The actual path is
                          produced by :meth:`pyobs.images.Image.format_filename` using a
-                         :class:`FilenameFormatter`. The file extension is used to infer
+                         :class:`~pyobs.utils.fits.FilenameFormatter`. The file extension is used to infer
                          the image format if ``format`` is not provided. Default: ``"/pyobs/image.jpg"``.
     :param str format: Explicit image format to use for encoding (e.g., ``"JPEG"``, ``"PNG"``,
                        ``"TIFF"``). If ``None``, the format is inferred from the filename extension.
@@ -31,27 +31,27 @@ class SaveImage(ImageProcessor):
     :param kwargs: Additional keyword arguments forwarded to
                    :class:`pyobs.images.processor.ImageProcessor`.
 
-    Behavior
-    --------
+    Save Image behavior
+    -------------------
     - Computes the target path via ``image.format_filename(self._formatter)``.
     - Encodes the image to bytes using :meth:`SaveImage.encode_image`, which leverages Pillow:
 
       - If ``format`` is ``None``, the format is inferred from the filename extension
         (uppercased) with a special case mapping ``JPG -> JPEG``.
       - Conversion from :class:`pyobs.images.Image` to a Pillow image is performed by
-        :class:`pyobs.utils.image.PillowHelper`.
+        the internal ``PillowHelper``.
 
     - Writes the encoded bytes to the virtual file system using ``self.vfs.write_bytes(filename, data)``.
     - Returns the original image without modification.
 
-    Input/Output
-    ------------
+    Save Image input/output
+    -----------------------
     - Input: :class:`pyobs.images.Image`
     - Output: :class:`pyobs.images.Image` (unchanged), with side effect of writing encoded
       bytes to the virtual file system at the formatted path.
 
-    Configuration (YAML)
-    --------------------
+    Save Image configuration (YAML)
+    -------------------------------
     Save as JPEG inferred from extension:
 
     .. code-block:: yaml