icplot 0.1.4__tar.gz → 0.1.6__tar.gz

{icplot-0.1.4/src/icplot.egg-info → icplot-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: icplot
-Version: 0.1.4
+Version: 0.1.6
 Summary: Utilities for generating plots and graphics for technical reports.
 Author-email: "James Grogan, Irish Centre for High End Computing" <james.grogan@ichec.ie>
 Project-URL: Repository, https://git.ichec.ie/performance/toolshed/icplot
@@ -11,12 +11,14 @@ Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: System :: Distributed Computing
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: wand
 Requires-Dist: matplotlib
-Requires-Dist: iccore==0.1.9
+Requires-Dist: vtk
+Requires-Dist: moviepy
+Requires-Dist: iccore==0.1.13
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
@@ -28,6 +30,7 @@ Requires-Dist: pylint; extra == "test"
 Provides-Extra: cairo
 Requires-Dist: pycairo; extra == "cairo"
 Requires-Dist: CairoSVG; extra == "cairo"
+Dynamic: license-file
 
 # icplot
 
@@ -38,8 +41,9 @@ This is a library used at [The Irish Centre for High End Computing (ICHEC)](http
 The project has support for:
 
 * Coverting image formats between pdf, svg and png
-* Building pdf output from tex files, including tikz.
+* Building pdf and png output from tex files, including tikz.
 * Generating plots based on a serializable data model to support reproducible research
+* Generating mermaid plots
 
 To covert between image formats you can do:
 
@@ -53,6 +57,12 @@ To render a Tex tikz image as pdf and png you can do:
 icplot convert --source my_tikz.tex
 ```
 
+To render a Mermaid plot as png you can do:
+
+``` shell
+icplot convert --source my_mermaid.mmd
+```
+
 To generate a plot or collection of plots from a yaml description you can do:
 
 ``` shell

{icplot-0.1.4 → icplot-0.1.6}/README.md

@@ -7,8 +7,9 @@ This is a library used at [The Irish Centre for High End Computing (ICHEC)](http
 The project has support for:
 
 * Coverting image formats between pdf, svg and png
-* Building pdf output from tex files, including tikz.
+* Building pdf and png output from tex files, including tikz.
 * Generating plots based on a serializable data model to support reproducible research
+* Generating mermaid plots
 
 To covert between image formats you can do:
 
@@ -22,6 +23,12 @@ To render a Tex tikz image as pdf and png you can do:
 icplot convert --source my_tikz.tex
 ```
 
+To render a Mermaid plot as png you can do:
+
+``` shell
+icplot convert --source my_mermaid.mmd
+```
+
 To generate a plot or collection of plots from a yaml description you can do:
 
 ``` shell

icplot-0.1.6/pyproject.toml

@@ -0,0 +1,154 @@
+[project]
+name = "icplot"
+version = "0.1.6"
+authors = [
+  { name="James Grogan, Irish Centre for High End Computing", email="james.grogan@ichec.ie" },
+]
+description = "Utilities for generating plots and graphics for technical reports."
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Operating System :: OS Independent",
+    "Topic :: System :: Distributed Computing"
+]
+keywords = ["Publishing", "Technical Reports", "Graphics"]
+
+dependencies = ["wand",
+	       "matplotlib",
+               "vtk",
+               "moviepy",
+	       "iccore==0.1.13"]
+
+[project.urls]
+Repository = "https://git.ichec.ie/performance/toolshed/icplot"
+Homepage = "https://git.ichec.ie/performance/toolshed/icplot"
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+    "pytest-cov",
+    "pytest-sugar",
+    "black",
+    "mypy",
+    "flake8",
+    "pylint"
+]
+
+cairo = [
+   "pycairo",
+   "CairoSVG"
+]
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project.scripts]
+icplot = "icplot.main_cli:main_cli"
+
+[tool.setuptools.package-data]
+"icplot" = ["py.typed"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.mypy]
+ignore_missing_imports = true
+
+[tool.pylint.main]
+
+source-roots = ["src"]
+fail-under = 9.33
+
+[tool.pylint.basic]
+
+class-const-naming-style = "UPPER_CASE"
+class-naming-style = "PascalCase"
+const-naming-style = "UPPER_CASE"
+docstring-min-length = -1
+
+function-naming-style = "snake_case"
+method-naming-style = "snake_case"
+module-naming-style = "snake_case"
+variable-naming-style = "snake_case"
+
+no-docstring-rgx = "^_"
+
+[tool.pylint.design]
+# Maximum number of arguments for function / method.
+max-args = 6
+# Maximum number of attributes for a class (see R0902).
+max-attributes = 7
+# Minimum number of public methods for a class (see R0903).
+min-public-methods = 1
+
+[tool.pylint.logging]
+# The type of string formatting that logging methods do. `old` means using %
+# formatting, `new` is for `{}` formatting.
+logging-format-style = "old"
+
+# Disable the message, report, category or checker with the given id(s). You can
+# either give multiple identifiers separated by comma (,) or put this option
+# multiple times (only on the command line, not in the configuration file where
+# it should appear only once). You can also use "--disable=all" to disable
+# everything first and then re-enable specific checks. For example, if you want
+# to run only the similarities checker, you can use "--disable=all
+# --enable=similarities". If you want to run only the classes checker, but have
+# no Warning level messages displayed, use "--disable=all --enable=classes
+# --disable=W".
+disable = ["raw-checker-failed", "missing-module-docstring", "missing-function-docstring", "bad-inline-option", "locally-disabled", "file-ignored", "suppressed-message", "useless-suppression", "deprecated-pragma", "use-symbolic-message-instead", "use-implicit-booleaness-not-comparison-to-string", "use-implicit-booleaness-not-comparison-to-zero"]
+
+[tool.pytest.ini_options]
+testpaths = ["test",]
+log_cli = 1
+log_cli_level = "debug"
+addopts = "--cov=icplot --cov-report term --cov-fail-under=59 --cov-report xml:coverage.xml --cov-report html"
+
+[tool.tox]
+requires = ["tox"]
+env_list = ["format_check", "lint", "style", "type", "3.10", "3.13", "docs"]
+skip_missing_interpreters = true
+
+[tool.tox.env_run_base]
+description = "Run Unit and Integration Tests"
+deps = [".[test, cairo]"]
+commands = [["pytest", "test"]]
+
+[tool.tox.env.format_apply]
+description = "Run Format Apply"
+skip_install = true
+deps = ["black"]
+commands = [["black", "src"], ["black", "test"]]
+
+[tool.tox.env.format_check]
+description = "Run Format Check"
+skip_install = true
+deps = ["black"]
+commands = [
+         ["black", "--check", "--diff", "src"],
+         ["black", "--check", "--diff", "test"]]
+
+[tool.tox.env.lint]
+description = "Run Linter"
+deps = ["pylint"]
+commands = [["pylint", "src"]]
+
+[tool.tox.env.style]
+description = "Run Style Check"
+skip_install = true
+deps = ["flake8"]
+commands = [["flake8", "src"]]
+
+[tool.tox.env.type]
+description = "Run Type Checks"
+deps = ["mypy", ".[types]"]
+commands = [["mypy", "src"]]
+
+[tool.tox.env.docs]
+description = "Generate Documentation"
+changedir = "docs"
+deps = ["sphinx"]
+commands = [["sphinx-build","-W", "-b","html","-d","{envtmpdir}/doctrees","."," {envtmpdir}/html"]]

{icplot-0.1.4 → icplot-0.1.6}/src/icplot/cairo_interface.py

@@ -2,7 +2,7 @@ from pathlib import Path
 
 import cairo
 
-from .geometry import Scene, Rectangle
+from .scene import Scene, Rectangle
 
 
 def draw_rect(cr, rect: Rectangle):

{icplot-0.1.4 → icplot-0.1.6}/src/icplot/convert.py

@@ -1,8 +1,12 @@
+"""
+Module supporting conversion between various formats
+"""
+
 import logging
 import os
 from pathlib import Path
 
-from icplot import tex
+from icplot import tex, mermaid
 from icplot.tex import TexBuildSettings
 from icplot.image_utils import pdf_to_png, svg_to_pdf, svg_to_png
 
@@ -10,7 +14,9 @@ from icplot.image_utils import pdf_to_png, svg_to_pdf, svg_to_png
 logger = logging.getLogger(__name__)
 
 
-def convert(source: Path, target: Path, build_dir: Path):
+def convert(
+    source: Path, target: Path, build_dir: Path, extra_config: Path | None = None
+):
     """
     Convert the file at source outputing at target and using
     the source and target file extensions as format hints.
@@ -36,5 +42,10 @@ def convert(source: Path, target: Path, build_dir: Path):
             target = Path(os.getcwd())
         settings = TexBuildSettings(source, build_dir, target)
         tex.build(settings)
+    elif source.suffix == ".mmd":
+        if not target:
+            target = Path(os.getcwd())
+        settings = TexBuildSettings(source, build_dir, target)
+        mermaid.convert(source, target, extra_config)
 
     logger.info("Finished conversion")

{icplot-0.1.4 → icplot-0.1.6}/src/icplot/gantt/gantt.py

@@ -1,3 +1,7 @@
+"""
+This module represents a gantt chard
+"""
+
 from datetime import datetime
 
 from pydantic import BaseModel
@@ -8,6 +12,9 @@ from icplot.color import Color
 
 
 class GanttChart(BaseModel, frozen=True):
+    """
+    A gantt chart
+    """
 
     milestones: list[Milestone] = []
     title: str = ""

{icplot-0.1.4 → icplot-0.1.6}/src/icplot/gantt/gantt_renderer.py

@@ -1,5 +1,5 @@
 from iccore.project import Milestone
-from icplot.geometry import Scene, SceneItem, Rectangle
+from icplot.scene import Scene, SceneItem, Rectangle
 
 from .gantt import GanttChart
 
@@ -25,10 +25,11 @@ def _render_milestone(
     return rect
 
 
-def _render_milestones(gantt: GanttChart):
+def _render_milestones(gantt: GanttChart) -> list[SceneItem]:
 
+    scene_items: list = []
     if not gantt.milestones:
-        return
+        return scene_items
 
     milestones = gantt.milestones
     # milestones.sort(key=lambda x: x.start_date, reverse=True)
@@ -44,7 +45,7 @@ def _render_milestones(gantt: GanttChart):
     chart_range = (start_date, end_date)
     yloc = 0.0
     bar_height = gantt.bar_max_height * gantt.height
-    scene_items = []
+
     for milestone in milestones:
         item = _render_milestone(gantt, milestone, chart_range, yloc)
         scene_items.append(item)

icplot-0.1.6/src/icplot/geometry.py

@@ -0,0 +1,151 @@
+"""
+Module for primitive geometries. This is used to keep dependencies simple,
+consider a real geometry library like cgal for more complex or performance
+dependent work.
+"""
+
+from __future__ import annotations
+import copy
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Vector:
+    """
+    A 3d spatial vector
+    """
+
+    x: float
+    y: float = 0.0
+    z: float = 0.0
+
+    def scale(self, factor: float) -> Vector:
+        return Vector(self.x * factor, self.y * factor, self.z * factor)
+
+
+@dataclass(frozen=True)
+class Point:
+    """
+    A location in 3d space
+    """
+
+    x: float
+    y: float = 0.0
+    z: float = 0.0
+
+    def translate(self, v: Vector) -> Point:
+        return Point(self.x + v.x, self.y + v.y, self.z + v.z)
+
+
+@dataclass(frozen=True)
+class Shape:
+    """
+    A shape in 3d space, defaults to having a normal to Z
+    """
+
+    loc: Point
+    normal: Vector = Vector(0.0, 0.0, 1.0)
+
+
+@dataclass(frozen=True)
+class Quad(Shape):
+    """
+    A regular quadrilateral in 3d space, defaults to be normal to Z
+    """
+
+    width: float = 1.0
+    height: float = 1.0
+
+    @property
+    def points(self) -> list[Point]:
+        p = copy.deepcopy(self.loc)
+        return [
+            p,
+            p.translate(Vector(self.width)),
+            p.translate(Vector(self.width, self.height)),
+            p.translate(Vector(0.0, self.height)),
+        ]
+
+    def translate(self, v: Vector) -> Quad:
+        return Quad(self.loc.translate(v), self.normal, self.width, self.height)
+
+
+@dataclass(frozen=True)
+class Cuboid(Shape):
+    """
+    A regular cuboid
+    """
+
+    loc: Point
+    width: float = 1.0
+    height: float = 1.0
+    depth: float = 1.0
+
+    def translate(self, v: Vector) -> Cuboid:
+        return Cuboid(
+            self.loc.translate(v), self.normal, self.width, self.height, self.depth
+        )
+
+    @property
+    def points(self) -> list[Point]:
+
+        base = Quad(self.loc, self.normal, self.width, self.height)
+        top = base.translate(self.normal.scale(self.depth))
+        return base.points + top.points
+
+
+@dataclass(frozen=True)
+class Cylinder(Shape):
+    """
+    A cylinder
+    """
+
+    diameter: float = 1.0
+    length: float = 1.0
+
+    @property
+    def start(self) -> Point:
+        return self.loc
+
+    @property
+    def end(self) -> Point:
+        return self.loc.translate(self.normal.scale(self.length))
+
+
+@dataclass(frozen=True)
+class Revolution(Shape):
+    """
+    A revolved profile sitting on the plane given by the loc
+    and normal and revolved about the normal.
+    """
+
+    diameter: float = 1.0
+    length: float = 1.0
+    profile: str = "arc"
+
+
+@dataclass(frozen=True)
+class CuboidGrid:
+    """
+    A irregular grid composed of cuboids. Can be useful for
+    generating topological meshes like OpenFoam's blockMesh.
+    """
+
+    x_locs: list[float]
+    y_locs: list[float]
+    z_locs: list[float]
+
+    @property
+    def cuboids(self) -> list[Cuboid]:
+        ret = []
+
+        for kdx, z in enumerate(self.z_locs[:-1]):
+            for jdx, y in enumerate(self.y_locs[:-1]):
+                for idx, x in enumerate(self.x_locs[:-1]):
+                    width = self.x_locs[idx + 1] - x
+                    height = self.y_locs[jdx + 1] - y
+                    depth = self.z_locs[kdx + 1] - z
+                    ret.append(
+                        Cuboid(Point(x, y, z), width=width, height=height, depth=depth)
+                    )
+        return ret

{icplot-0.1.4 → icplot-0.1.6}/src/icplot/graph/axis.py

@@ -28,7 +28,7 @@ class PlotAxis(BaseModel, frozen=True):
     """
 
     label: str = ""
-    ticks: Range | None = None
+    ticks: Range | list[int] | None = None
     scale: str = "linear"
     text_fontsize: int = 10
     tick_fontsize: int = 10
@@ -38,5 +38,7 @@ class PlotAxis(BaseModel, frozen=True):
     @property
     def resolved_ticks(self) -> list:
         if self.ticks:
-            return self.ticks.eval()
+            if isinstance(self.ticks, Range):
+                return self.ticks.eval()
+            return self.ticks
         return []

{icplot-0.1.4 → icplot-0.1.6}/src/icplot/graph/matplotlib.py

@@ -31,10 +31,7 @@ def str_exact_values_formatter(x, pos):
     then when using plain formatter values less than 1 come out as 0. A way around
     this is this custom formatter.
     """
-    if x.is_integer():
-        return str(int(x))
-    else:
-        return str(x)
+    return str(int(x)) if x.is_integer else str(x)
 
 
 def _set_legend_decorations(axs, plot):
@@ -80,9 +77,9 @@ def _set_y_axes_decorations(y_axes: list[PlotAxis], axs):
         if y_axis.max_ticks:
             axs[idx].yaxis.set_major_locator(plt.MaxNLocator(y_axis.max_ticks))
         for key, item in y_axis.limits.items():
-            if key == "bottom" or key == "ymin":
+            if key in ("bottom", "ymin"):
                 axs[idx].set_ylim(ymin=item)
-            elif key == "top" or key == "ymax":
+            elif key in ("top", "ymax"):
                 axs[idx].set_ylim(ymax=item)