eulumdat-plot 1.0.2__py3-none-any.whl → 1.0.4__py3-none-any.whl

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/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/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.2.dist-info → eulumdat_plot-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eulumdat-plot
-Version: 1.0.2
+Version: 1.0.4
 Summary: Photometric polar diagram generator for EULUMDAT (.ldt) files — extension to eulumdat-py
 Author: 123VincentB
 License: MIT
@@ -21,12 +21,13 @@ 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
+Requires-Dist: vl-convert-python>=1.6
+Requires-Dist: Pillow>=9.0
 Provides-Extra: export
-Requires-Dist: vl-convert-python>=1.6; extra == "export"
-Requires-Dist: Pillow>=9.0; extra == "export"
 Provides-Extra: cubic
 Requires-Dist: scipy>=1.7; extra == "cubic"
 Provides-Extra: full
@@ -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 —
@@ -105,13 +107,16 @@ pip install "eulumdat-plot[full]"
 ## Quick start
 
 ```python
-from eulumdat_plot import plot_ldt
+from eulumdat_plot import plot_ldt, plot_ldt_svg
 
-# Generate an SVG next to the source file
-svg = plot_ldt("luminaire.ldt")
+# Generate an SVG file next to the source file
+path = plot_ldt("luminaire.ldt")
 
 # With a distribution code in the banner centre
-svg = plot_ldt("luminaire.ldt", code="D53")
+path = plot_ldt("luminaire.ldt", code="D53")
+
+# Get the SVG as a string (for inline HTML embedding, no file written)
+svg_str = plot_ldt_svg("luminaire.ldt")
 ```
 
 ## Scaling
@@ -167,6 +172,23 @@ def plot_ldt(
 | `interp_method`   | `"linear"`        | `"linear"` or `"cubic"` (requires scipy)     |
 | `debug`           | `False`           | Colour-code C-planes for visual validation   |
 
+### `plot_ldt_svg()`
+
+Same as `plot_ldt()` but returns the SVG as a **string** instead of writing to
+disk. Useful for inline HTML embedding (no temporary file created).
+
+```python
+def plot_ldt_svg(
+    ldt_path: str | Path,
+    *,
+    code: str = "",
+    layout: Layout | None = None,
+    interpolate: bool = True,
+    interp_step_deg: float = 1.0,
+    interp_method: str = "linear",
+) -> str
+```
+
 ### `Layout.for_size()`
 
 ```python
@@ -219,15 +241,20 @@ eulumdat-plot/
 └── README.md
 ```
 
-## EULUMDAT ecosystem
+## eulumdat-* ecosystem
+
+> **New to the ecosystem?** [eulumdat-quickstart](https://github.com/123VincentB/eulumdat-quickstart) — a step-by-step guide covering all 8 packages with working examples.
 
-| Package                                                            | Status  | Description                                  |
-| ------------------------------------------------------------------ | ------- | -------------------------------------------- |
-| [`eulumdat-py`](https://pypi.org/project/eulumdat-py/)             | v0.1.4  | Read / write EULUMDAT files                  |
-| [`eulumdat-symmetry`](https://pypi.org/project/eulumdat-symmetry/) | v1.0.0  | Symmetrise EULUMDAT files                    |
-| `eulumdat-plot`                                                    | v1.0.0  | Photometric polar diagram — **this package** |
-| `eulumdat-luminance`                                               | planned | Luminance table cd/m² (γ 55°–85°)            |
-| `eulumdat-ugr`                                                     | planned | UGR calculation (CIE 117, CIE 190)           |
+| Package | Description |
+|---|---|
+| [eulumdat-py](https://pypi.org/project/eulumdat-py/) | Read / write EULUMDAT files |
+| [eulumdat-symmetry](https://pypi.org/project/eulumdat-symmetry/) | Symmetrise and detect ISYM |
+| **`eulumdat-plot`** | **Polar intensity diagram (SVG/PNG) — this package** |
+| [eulumdat-luminance](https://pypi.org/project/eulumdat-luminance/) | Luminance table and polar diagram |
+| [eulumdat-ugr](https://pypi.org/project/eulumdat-ugr/) | UGR catalogue (CIE 117/190) |
+| [eulumdat-analysis](https://pypi.org/project/eulumdat-analysis/) | Beam half-angle, FWHM |
+| [eulumdat-report](https://pypi.org/project/eulumdat-report/) | Full photometric datasheet (HTML/PDF) |
+| [eulumdat-ies](https://pypi.org/project/eulumdat-ies/) | LDT ↔ IES LM-63-2002 conversion |
 
 ## Requirements
 

eulumdat_plot-1.0.4.dist-info/RECORD

@@ -0,0 +1,9 @@
+eulumdat_plot/__init__.py,sha256=CBuQ_h9whhzjHicXgDruduTsagbCbnzZJ459EpigZy8,1647
+eulumdat_plot/export.py,sha256=UOgugmd1jkFqoEkuQlY1dPatcMhv_JVQfV3Uv7oGkPg,4454
+eulumdat_plot/plot.py,sha256=a4zcg8yUbFLczenzYQ_CjplrKyr3VPi_GGN0nULjuaA,14881
+eulumdat_plot/renderer.py,sha256=YLM7D-_zRWNDPJbUoZz734_rdaSuRWIVRh-3emXlyHM,19609
+eulumdat_plot-1.0.4.dist-info/licenses/LICENSE,sha256=C7zou5wilUMnyyvwyhL_QY0gLMRKlRiAgqw7ViCxNtc,1068
+eulumdat_plot-1.0.4.dist-info/METADATA,sha256=MzLh5x4RA663ek2tRBIV87DYbi9IGzsaN8RQpdo1wic,10098
+eulumdat_plot-1.0.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+eulumdat_plot-1.0.4.dist-info/top_level.txt,sha256=AsBUEzqi7316GhS_tHqXncJ5_pUaXb0Gm2ozfpeNQBA,14
+eulumdat_plot-1.0.4.dist-info/RECORD,,

eulumdat_plot-1.0.4.dist-info/licenses/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.2.dist-info/RECORD

@@ -1,8 +0,0 @@
-eulumdat_plot/__init__.py,sha256=QiFUpZjjX7ZrVtJ4Q2be6BltzVp4tMa2xw23Zix_PmU,1579
-eulumdat_plot/export.py,sha256=UOgugmd1jkFqoEkuQlY1dPatcMhv_JVQfV3Uv7oGkPg,4454
-eulumdat_plot/plot.py,sha256=dIhPKN-Su6rdwWVstY2k7YzsG3PM6px1LpcmD1UK-N0,12475
-eulumdat_plot/renderer.py,sha256=3Oxc7jFhM6DLFwOwKuZW9zQEA0LmaYxT2sZ2VfPhv1U,17901
-eulumdat_plot-1.0.2.dist-info/METADATA,sha256=8gLBb8Xl-xv7aiWz9D_Oz3JHdEBj50i29D8bBa1ugik,9458
-eulumdat_plot-1.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-eulumdat_plot-1.0.2.dist-info/top_level.txt,sha256=AsBUEzqi7316GhS_tHqXncJ5_pUaXb0Gm2ozfpeNQBA,14
-eulumdat_plot-1.0.2.dist-info/RECORD,,