eulumdat-plot 1.0.1__tar.gz → 1.0.3__tar.gz

eulumdat_plot-1.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 123VincentB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eulumdat-plot
-Version: 1.0.1
+Version: 1.0.3
 Summary: Photometric polar diagram generator for EULUMDAT (.ldt) files — extension to eulumdat-py
 Author: 123VincentB
 License: MIT
@@ -21,6 +21,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: eulumdat-py>=1.0.0
 Requires-Dist: numpy>=1.21
 Requires-Dist: svgwrite>=1.4
@@ -37,12 +38,13 @@ Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: eulumdat-plot[full]; extra == "dev"
+Dynamic: license-file
 
 # eulumdat-plot
 
 [![PyPI](https://img.shields.io/pypi/v/eulumdat-plot)](https://pypi.org/project/eulumdat-plot/)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/eulumdat-plot)](https://pypi.org/project/eulumdat-plot/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/123VincentB/eulumdat-plot/blob/main/LICENSE)
+[![License: MIT](https://img.shields.io/github/license/123VincentB/eulumdat-plot)](https://github.com/123VincentB/eulumdat-plot/blob/main/LICENSE)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19096110.svg)](https://doi.org/10.5281/zenodo.19096110)
 
 Photometric polar diagram generator for EULUMDAT (`.ldt`) files —
@@ -61,7 +63,7 @@ on top of [`eulumdat-py`](https://pypi.org/project/eulumdat-py/).
 
 ---
 
-![Photometric diagram example](https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_01.png) ![Photometric diagram example](https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_02.png)
+<img src="https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_01.png" width="360"> <img src="https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_02.png" width="360">
 
 ---
 

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/README.md

@@ -2,7 +2,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/eulumdat-plot)](https://pypi.org/project/eulumdat-plot/)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/eulumdat-plot)](https://pypi.org/project/eulumdat-plot/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/123VincentB/eulumdat-plot/blob/main/LICENSE)
+[![License: MIT](https://img.shields.io/github/license/123VincentB/eulumdat-plot)](https://github.com/123VincentB/eulumdat-plot/blob/main/LICENSE)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19096110.svg)](https://doi.org/10.5281/zenodo.19096110)
 
 Photometric polar diagram generator for EULUMDAT (`.ldt`) files —
@@ -21,7 +21,7 @@ on top of [`eulumdat-py`](https://pypi.org/project/eulumdat-py/).
 
 ---
 
-![Photometric diagram example](https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_01.png) ![Photometric diagram example](https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_02.png)
+<img src="https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_01.png" width="360"> <img src="https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_02.png" width="360">
 
 ---
 

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eulumdat-plot"
-version = "1.0.1"
+version = "1.0.3"
 description = "Photometric polar diagram generator for EULUMDAT (.ldt) files — extension to eulumdat-py"
 readme = "README.md"
 license = { text = "MIT" }

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/src/eulumdat_plot/__init__.py

@@ -39,12 +39,14 @@ Public API
     Convert polar ``(r, θ)`` to NAT ``(x, y)`` Cartesian coordinates.
 """
 
-from .plot import plot_ldt
-from .renderer import Layout, make_svg, polar_to_nat
+from .plot import plot_ldt, plot_ldt_svg
+from .renderer import Layout, make_svg, make_svg_str, polar_to_nat
 
 __all__ = [
     "plot_ldt",
+    "plot_ldt_svg",
     "Layout",
     "make_svg",
+    "make_svg_str",
     "polar_to_nat",
 ]

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/src/eulumdat_plot/plot.py

@@ -52,7 +52,7 @@ try:
 except ImportError:
     _HAS_SCIPY = False
 
-from .renderer import Layout, NatCurve, make_svg, polar_to_nat
+from .renderer import Layout, NatCurve, make_svg, make_svg_str, polar_to_nat
 
 
 # ---------------------------------------------------------------------------
@@ -363,3 +363,83 @@ def plot_ldt(
         strokes_solid=strokes_solid,
         strokes_dotted=strokes_dotted,
     )
+
+
+def plot_ldt_svg(
+    ldt_path: str | Path,
+    *,
+    code: str = "",
+    layout: Optional[Layout] = None,
+    interpolate: bool = True,
+    interp_step_deg: float = 1.0,
+    interp_method: str = "linear",
+) -> str:
+    """
+    Same as :func:`plot_ldt` but returns the SVG as a string instead of
+    writing to disk.
+
+    Returns
+    -------
+    str
+        SVG document as a string (starts with ``<svg``).
+    """
+    ldt_path = Path(ldt_path)
+    if layout is None:
+        layout = Layout()
+
+    ldt = LdtReader.read(ldt_path)
+
+    I_C0   = _get_plane(ldt,   0.0)
+    I_C90  = _get_plane(ldt,  90.0)
+    I_C180 = _get_plane(ldt, 180.0)
+    I_C270 = _get_plane(ldt, 270.0)
+
+    available = [p for p in (I_C0, I_C90, I_C180, I_C270) if p is not None]
+    if not available:
+        raise ValueError(f"No usable C-plane data found in '{ldt_path}'.")
+
+    r_data_max = float(np.vstack(available).max())
+
+    g_deg = np.asarray(ldt.header.g_angles, dtype=float)
+    if interpolate and g_deg.size > 1:
+        g_deg, (I_C0, I_C90, I_C180, I_C270) = _resample(
+            g_deg, I_C0, I_C90, I_C180, I_C270,
+            step_deg=interp_step_deg,
+            method=interp_method,
+        )
+
+    curves_solid: List[NatCurve]  = []
+    curves_dotted: List[NatCurve] = []
+    colors_solid:  List[str]      = []
+    colors_dotted: List[str]      = []
+    strokes_solid:  List[float]   = []
+    strokes_dotted: List[float]   = []
+
+    def _register(arr_right, arr_left, *, solid: bool) -> None:
+        cr, cl = _build_nat_pair(g_deg, arr_right, arr_left)
+        for curve in (cr, cl):
+            if curve is None:
+                continue
+            if solid:
+                curves_solid.append(curve)
+                colors_solid.append("black")
+                strokes_solid.append(layout.stroke_curve_solid)
+            else:
+                curves_dotted.append(curve)
+                colors_dotted.append("black")
+                strokes_dotted.append(layout.stroke_curve_dotted)
+
+    _register(I_C0, I_C180, solid=True)
+    _register(I_C90, I_C270, solid=False)
+
+    return make_svg_str(
+        curves_solid=curves_solid,
+        curves_dotted=curves_dotted,
+        r_data_max=r_data_max,
+        code=code,
+        layout=layout,
+        colors_solid=colors_solid,
+        colors_dotted=colors_dotted,
+        strokes_solid=strokes_solid,
+        strokes_dotted=strokes_dotted,
+    )

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/src/eulumdat_plot/renderer.py

@@ -257,12 +257,12 @@ def _nice_levels(r_max: float) -> List[int]:
 # SVG renderer
 # ---------------------------------------------------------------------------
 
-def make_svg(
+def _build_drawing(
     curves_solid: List[NatCurve],
     curves_dotted: List[NatCurve],
     r_data_max: float,
     *,
-    outfile: str | Path = "photometric.svg",
+    filename: str = "_",
     code: str = "",
     layout: Optional[Layout] = None,
     debug: bool = False,
@@ -270,42 +270,8 @@ def make_svg(
     colors_dotted: Optional[List[str]] = None,
     strokes_solid: Optional[List[float]] = None,
     strokes_dotted: Optional[List[float]] = None,
-) -> Path:
-    """
-    Generate a Lumtopic-style photometric polar diagram as an SVG file.
-
-    Parameters
-    ----------
-    curves_solid :
-        Solid curves (typically C0 / C180), each as a list of
-        ``(x_nat, y_nat)`` points.
-    curves_dotted :
-        Dotted curves (typically C90 / C270), same format.
-    r_data_max :
-        Maximum intensity across all curves (cd/klm).
-        Drives the radial scale computation.
-    outfile :
-        Destination SVG path.  Default: ``"photometric.svg"``.
-    code :
-        Distribution code shown in the banner centre (e.g. ``"D53"``).
-        Pass an empty string to leave it blank.
-    layout :
-        Visual parameters.  If ``None``, :class:`Layout` defaults are used.
-    debug :
-        If ``True``, draw the plot area in blue and the curve bounding box
-        in green as diagnostic overlays.
-    colors_solid / colors_dotted :
-        Per-curve SVG stroke colours.  Defaults to black for all curves.
-    strokes_solid / strokes_dotted :
-        Per-curve stroke widths.  Defaults to ``layout.stroke_curve_solid``
-        and ``layout.stroke_curve_dotted`` respectively.
-
-    Returns
-    -------
-    :class:`pathlib.Path`
-        Absolute path to the generated SVG file.
-    """
-    outfile = Path(outfile)
+) -> "svgwrite.Drawing":
+    """Build and return the svgwrite Drawing object (without saving)."""
     if layout is None:
         layout = Layout()
 
@@ -395,7 +361,7 @@ def make_svg(
     # ------------------------------------------------------------------
     # 6. Assemble SVG
     # ------------------------------------------------------------------
-    dwg = svgwrite.Drawing(str(outfile), size=(W, H))
+    dwg = svgwrite.Drawing(filename, size=(W, H))
 
     # --- Clip path (plot area only) ---
     clip_id = "plot_clip"
@@ -508,5 +474,95 @@ def make_svg(
             stroke="green", stroke_width=5, fill="none",
         ))
 
+    return dwg
+
+
+def make_svg(
+    curves_solid: List[NatCurve],
+    curves_dotted: List[NatCurve],
+    r_data_max: float,
+    *,
+    outfile: str | Path = "photometric.svg",
+    code: str = "",
+    layout: Optional[Layout] = None,
+    debug: bool = False,
+    colors_solid: Optional[List[str]] = None,
+    colors_dotted: Optional[List[str]] = None,
+    strokes_solid: Optional[List[float]] = None,
+    strokes_dotted: Optional[List[float]] = None,
+) -> Path:
+    """
+    Generate a Lumtopic-style photometric polar diagram as an SVG file.
+
+    Parameters
+    ----------
+    curves_solid :
+        Solid curves (typically C0 / C180), each as a list of
+        ``(x_nat, y_nat)`` points.
+    curves_dotted :
+        Dotted curves (typically C90 / C270), same format.
+    r_data_max :
+        Maximum intensity across all curves (cd/klm).
+        Drives the radial scale computation.
+    outfile :
+        Destination SVG path.  Default: ``"photometric.svg"``.
+    code :
+        Distribution code shown in the banner centre (e.g. ``"D53"``).
+        Pass an empty string to leave it blank.
+    layout :
+        Visual parameters.  If ``None``, :class:`Layout` defaults are used.
+    debug :
+        If ``True``, draw the plot area in blue and the curve bounding box
+        in green as diagnostic overlays.
+    colors_solid / colors_dotted :
+        Per-curve SVG stroke colours.  Defaults to black for all curves.
+    strokes_solid / strokes_dotted :
+        Per-curve stroke widths.  Defaults to ``layout.stroke_curve_solid``
+        and ``layout.stroke_curve_dotted`` respectively.
+
+    Returns
+    -------
+    :class:`pathlib.Path`
+        Absolute path to the generated SVG file.
+    """
+    outfile = Path(outfile)
+    dwg = _build_drawing(
+        curves_solid, curves_dotted, r_data_max,
+        filename=str(outfile),
+        code=code, layout=layout, debug=debug,
+        colors_solid=colors_solid, colors_dotted=colors_dotted,
+        strokes_solid=strokes_solid, strokes_dotted=strokes_dotted,
+    )
     dwg.save()
     return outfile.resolve()
+
+
+def make_svg_str(
+    curves_solid: List[NatCurve],
+    curves_dotted: List[NatCurve],
+    r_data_max: float,
+    *,
+    code: str = "",
+    layout: Optional[Layout] = None,
+    debug: bool = False,
+    colors_solid: Optional[List[str]] = None,
+    colors_dotted: Optional[List[str]] = None,
+    strokes_solid: Optional[List[float]] = None,
+    strokes_dotted: Optional[List[float]] = None,
+) -> str:
+    """
+    Same as :func:`make_svg` but returns the SVG as a string instead of
+    writing to disk.
+
+    Returns
+    -------
+    str
+        SVG document as a string (starts with ``<svg``).
+    """
+    dwg = _build_drawing(
+        curves_solid, curves_dotted, r_data_max,
+        code=code, layout=layout, debug=debug,
+        colors_solid=colors_solid, colors_dotted=colors_dotted,
+        strokes_solid=strokes_solid, strokes_dotted=strokes_dotted,
+    )
+    return dwg.tostring()

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/src/eulumdat_plot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eulumdat-plot
-Version: 1.0.1
+Version: 1.0.3
 Summary: Photometric polar diagram generator for EULUMDAT (.ldt) files — extension to eulumdat-py
 Author: 123VincentB
 License: MIT
@@ -21,6 +21,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: eulumdat-py>=1.0.0
 Requires-Dist: numpy>=1.21
 Requires-Dist: svgwrite>=1.4
@@ -37,12 +38,13 @@ Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: eulumdat-plot[full]; extra == "dev"
+Dynamic: license-file
 
 # eulumdat-plot
 
 [![PyPI](https://img.shields.io/pypi/v/eulumdat-plot)](https://pypi.org/project/eulumdat-plot/)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/eulumdat-plot)](https://pypi.org/project/eulumdat-plot/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/123VincentB/eulumdat-plot/blob/main/LICENSE)
+[![License: MIT](https://img.shields.io/github/license/123VincentB/eulumdat-plot)](https://github.com/123VincentB/eulumdat-plot/blob/main/LICENSE)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19096110.svg)](https://doi.org/10.5281/zenodo.19096110)
 
 Photometric polar diagram generator for EULUMDAT (`.ldt`) files —
@@ -61,7 +63,7 @@ on top of [`eulumdat-py`](https://pypi.org/project/eulumdat-py/).
 
 ---
 
-![Photometric diagram example](https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_01.png) ![Photometric diagram example](https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_02.png)
+<img src="https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_01.png" width="360"> <img src="https://raw.githubusercontent.com/123VincentB/eulumdat-plot/main/docs/img/sample_02.png" width="360">
 
 ---
 

{eulumdat_plot-1.0.1 → eulumdat_plot-1.0.3}/src/eulumdat_plot.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 src/eulumdat_plot/__init__.py