duvals-triangle-plotter 1.0__tar.gz → 1.2__tar.gz

duvals_triangle_plotter-1.2/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: duvals-triangle-plotter
+Version: 1.2
+Summary: Duval's Triangle Plotter — Python library for generating Duval's Triangle plots for DGA
+Home-page: https://nagusubra.github.io/duvals-triangle-plotter/
+Author: Subramanian Narayanan
+Author-email: Subramanian Narayanan <snarayan@nagusubra.com>
+License-Expression: MIT
+Project-URL: Homepage, https://nagusubra.github.io/duvals-triangle-plotter/
+Project-URL: Documentation, https://nagusubra.github.io/duvals-triangle-plotter/
+Project-URL: Repository, https://github.com/nagusubra/duvals-triangle-plotter
+Project-URL: Bug Tracker, https://github.com/nagusubra/duvals-triangle-plotter/issues
+Project-URL: Changelog, https://github.com/nagusubra/duvals-triangle-plotter/blob/main/CHANGELOG.txt
+Keywords: duval,duvals-triangle,dga,dissolved-gas-analysis,transformer,power-transformer,fault-diagnosis,ternary-plot,plotly,visualization
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: plotly>=5.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+
+# Duval's Triangle Plotter
+
+Python library for generating [Duval's Triangle](https://nagusubra.github.io/duvals-triangle-plotter/) plots — a ternary diagnostic tool used in Dissolved Gas Analysis (DGA) for power transformer condition monitoring.
+
+## Installation
+
+```bash
+pip install duvals-triangle-plotter
+```
+
+## Quick Start
+
+```python
+import duvals_triangle_plotter as dtp
+
+trace = dtp.get_duval_points_traces(
+    [0.09], [0.0], [0.91], "2000-08-16"
+)
+fig = dtp.get_duvals_triangle_plot([trace], show_plot=True)
+```
+
+## Documentation
+
+Full documentation and API reference: [nagusubra.github.io/duvals-triangle-plotter](https://nagusubra.github.io/duvals-triangle-plotter/)
+
+## License
+
+MIT

duvals_triangle_plotter-1.2/README.md

@@ -0,0 +1,28 @@
+# Duval's Triangle Plotter
+
+Python library for generating [Duval's Triangle](https://nagusubra.github.io/duvals-triangle-plotter/) plots — a ternary diagnostic tool used in Dissolved Gas Analysis (DGA) for power transformer condition monitoring.
+
+## Installation
+
+```bash
+pip install duvals-triangle-plotter
+```
+
+## Quick Start
+
+```python
+import duvals_triangle_plotter as dtp
+
+trace = dtp.get_duval_points_traces(
+    [0.09], [0.0], [0.91], "2000-08-16"
+)
+fig = dtp.get_duvals_triangle_plot([trace], show_plot=True)
+```
+
+## Documentation
+
+Full documentation and API reference: [nagusubra.github.io/duvals-triangle-plotter](https://nagusubra.github.io/duvals-triangle-plotter/)
+
+## License
+
+MIT

duvals_triangle_plotter-1.2/duvals_triangle_plotter/__init__.py

@@ -0,0 +1,19 @@
+"""
+duvals_triangle_plotter — Python library for generating Duval's Triangle plots.
+
+Duval's Triangle is a ternary plot used in Dissolved Gas Analysis (DGA) to
+diagnose faults in power transformers based on relative concentrations of
+methane (CH4), acetylene (C2H2), and ethylene (C2H4).
+
+Public API
+----------
+get_duval_points_traces(methane_points_list, acetylene_points_list,
+                        ethylene_points_list, date)
+    Build a scatterternary trace dict from gas concentration data.
+
+get_duvals_triangle_plot(duval_points_list, show_plot=False,
+                         equipment_name="General Site")
+    Generate a complete Plotly Figure with fault regions and data traces.
+"""
+
+from .duvals_triangle_plotter import get_duval_points_traces, get_duvals_triangle_plot

duvals_triangle_plotter-1.2/duvals_triangle_plotter/constants.py

@@ -0,0 +1,132 @@
+"""
+Region definitions for Duval's Triangle.
+
+Each constant is a Plotly ``scatterternary`` trace that fills a polygon
+corresponding to a specific fault type identified by Dissolved Gas Analysis.
+
+The seven standard regions defined here are used by
+``get_duvals_triangle_plot`` to render the diagnostic zones on the ternary
+plot.  Coordinates represent relative percentages of methane (a-axis),
+acetylene (b-axis), and ethylene (c-axis) after normalising the three gas
+concentrations to 100 %.
+"""
+
+pd_region = {
+    # PD — Corona / Partial Discharges.
+    # Low-energy electrical discharges within gas-filled cavities in the
+    # insulation.  Typically the first sign of insulation aging.
+    "uid": "pd_region",
+    "a": [98, 1, 98],
+    "b": [0, 0, 2],
+    "c": [2, 0, 0],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "PD",
+    "type": "scatterternary",
+    "fillcolor": "#b3de69",
+    "name": "PD - Corona Partial Discharges"
+}
+
+d1_region = {
+    # D1 — Electrical Discharges of Low Energy.
+    # Low-energy sparking or arcing, often associated with poor connections or
+    # floating-potential components.
+    "uid": "d1_region",
+    "a": [0, 0, 64, 87],
+    "b": [1, 77, 13, 13],
+    "c": [0, 23, 23, 0],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "D1",
+    "type": "scatterternary",
+    "fillcolor": "#ffffb3",
+    "name": "D1 - Electrical Discharges of Low Energy"
+}
+
+d2_region = {
+    # D2 — Electrical Discharges of High Energy.
+    # High-energy arcing capable of producing significant volumes of fault gas
+    # and causing rapid insulation degradation.
+    "uid": "d2_region",
+    "a": [0, 0, 31, 47, 64],
+    "b": [77, 29, 29, 13, 13],
+    "c": [23, 71, 40, 40, 23],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "D2",
+    "type": "scatterternary",
+    "fillcolor": "#bebada",
+    "name": "D2 - Electrical Discharges of High Energy"
+}
+
+dt_region = {
+    # DT — Electrical and Thermal Fault (Mixed).
+    # A mixed-fault zone where both electrical discharges and thermal
+    # decomposition contribute to the gas profile.
+    "uid": "dt_region",
+    "a": [0, 0, 35, 46, 96, 87, 47, 31],
+    "b": [29, 15, 15, 4, 4, 13, 13, 29],
+    "c": [71, 85, 50, 50, 0, 0, 40, 40],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "DT",
+    "hoverlabel": {"font": {"color": "black"}},
+    "type": "scatterternary",
+    "fillcolor": "#fb8072",
+    "name": "DT - Electrical and Thermal Fault"
+}
+
+t1_region = {
+    # T1 — Thermal Faults, T < 300 C.
+    # Low-temperature thermal faults, typically from prolonged overload or
+    # inadequate cooling.
+    "uid": "t1_region",
+    "a": [76, 80, 98, 98, 96],
+    "b": [4, 0, 0, 2, 4],
+    "c": [20, 20, 2, 0, 0],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "T1",
+    "type": "scatterternary",
+    "fillcolor": "#80b1d3",
+    "name": "T1 - Thermal Faults, T<300C"
+}
+
+t2_region = {
+    # T2 — Thermal Faults, 300 C < T < 700 C.
+    # Medium-temperature thermal faults, often from localised hot spots in the
+    # core or windings.
+    "uid": "t2_region",
+    "a": [46, 50, 80, 76],
+    "b": [4, 0, 0, 4],
+    "c": [50, 50, 20, 20],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "T2",
+    "type": "scatterternary",
+    "fillcolor": "#fdb462",
+    "name": "T2 - Thermal Faults, 300C<T<700C"
+}
+
+t3_region = {
+    # T3 — Thermal Faults, T > 700 C.
+    # High-temperature thermal faults, typically from sustained arcing or
+    # severe core overheating.
+    "uid": "t3_region",
+    "a": [0, 0, 50, 35],
+    "b": [15, 0, 0, 15],
+    "c": [85, 1, 50, 50],
+    "fill": "toself",
+    "line": {"color": "#444"},
+    "mode": "lines",
+    "text": "T3",
+    "type": "scatterternary",
+    "fillcolor": "#8dd3c7",
+    "name": "T3 - Thermal Faults, T>700C"
+}

duvals_triangle_plotter-1.2/duvals_triangle_plotter/duvals_triangle_plotter.py

@@ -0,0 +1,142 @@
+import plotly.graph_objects as go
+from duvals_triangle_plotter.constants import pd_region, d1_region, d2_region, dt_region, t1_region, t2_region, t3_region
+
+
+def get_layout(equipment_name: str):
+    """Build a layout dictionary for the Duval's Triangle ternary plot.
+
+    Parameters
+    ----------
+    equipment_name : str
+        Name of the transformer or equipment displayed in the plot title.
+
+    Returns
+    -------
+    dict
+        Plotly layout configuration with ternary axes, margins, and title.
+
+    Examples
+    --------
+    >>> layout = get_layout("Transformer A")
+    >>> layout["title"]
+    "<b>Duval's Triangle (Dissolved Gas Analysis) for : Transformer A</b>"
+    """
+    layout = {
+                "title": "<b>Duval's Triangle (Dissolved Gas Analysis) for : {0}</b>".format(equipment_name),
+                "width": 1044*1.8,
+                "height": 545*1.8,
+                "ternary": {
+                                "sum": 100,
+                                "aaxis": {
+                                            "min": 0.01,
+                                            "ticks": "outside",
+                                            "title": "<b> CH4 (Methane) </b>",
+                                            "linewidth": 8,
+                                            "ticksuffix": "%",
+                                        },
+                                "baxis": {
+                                            "min": 0.01,
+                                            "ticks": "outside",
+                                            "title": "<b> C2H2 (Acetylene) </b>",
+                                            "linewidth": 8,
+                                            "ticksuffix": "%"
+                                        },
+                                "caxis": {
+                                            "min": 0.01,
+                                            "ticks": "outside",
+                                            "title": "<b> C2H4 (Ethylene) </b>",
+                                            "linewidth": 8,
+                                            "ticksuffix": "%"
+                                        }
+                },
+                "autosize": True,
+                "showlegend": True,
+                "margin": {"pad":100},
+            }
+    return layout
+
+
+def get_duval_points_traces(methane_points_list: list, acetylene_points_list: list, ethylene_points_list: list, date: str):
+    """Create a Plotly scatterternary trace from gas concentration data.
+
+    Parameters
+    ----------
+    methane_points_list : list of float
+        Concentration of methane (CH4) for each sample, in ppm.
+    acetylene_points_list : list of float
+        Concentration of acetylene (C2H2) for each sample, in ppm.
+    ethylene_points_list : list of float
+        Concentration of ethylene (C2H4) for each sample, in ppm.
+    date : str
+        Label or date associated with the samples (displayed in legend and hover).
+
+    Returns
+    -------
+    dict
+        A dict representing a Plotly ``scatterternary`` trace, ready to be
+        passed to ``get_duvals_triangle_plot``.
+
+    Examples
+    --------
+    >>> trace = get_duval_points_traces([0.09], [0.0], [0.91], "2000-08-16")
+    >>> trace["type"]
+    'scatterternary'
+    """
+    duval_points =  {
+                    "a": methane_points_list,
+                    "b": acetylene_points_list,
+                    "c": ethylene_points_list,
+                    "mode": "markers",
+                    "type": "scatterternary",
+                    "marker":   {
+                                    "size": 18,
+                                    "color": "black",
+                                    "symbol": 217,
+                                },
+                    "cliponaxis": True,
+                    "hovertemplate":  "Sample Date: {0}<br>".format(date) + "Methane (CH4): %{a:.2f}%<br>" + "Acetylene (C2H2): %{b:.2f}%<br>" + "Ethylene (C2H4): %{c:.2f}%<br>",
+                    "name": "Sample Date: {0}<br>".format(date)
+                }
+
+    return duval_points
+
+
+def get_duvals_triangle_plot(duval_points_list: list, show_plot:bool = False, equipment_name:str = "General Site"):
+    """Generate a complete Duval's Triangle Plotly Figure.
+
+    The figure overlays the seven standard fault regions (PD, D1, D2, DT, T1,
+    T2, T3) with the user-supplied data traces.
+
+    Parameters
+    ----------
+    duval_points_list : list of dict
+        One or more scatterternary trace dicts, typically created by
+        ``get_duval_points_traces``.
+    show_plot : bool, optional
+        If True, display the figure immediately in the browser (default False).
+    equipment_name : str, optional
+        Name of the equipment shown in the plot title (default "General Site").
+
+    Returns
+    -------
+    go.Figure
+        A Plotly Figure containing the Duval's Triangle plot with fault
+        regions and data points.
+
+    Examples
+    --------
+    >>> trace = get_duval_points_traces([0.09], [0.0], [0.91], "2000-08-16")
+    >>> fig = get_duvals_triangle_plot([trace], show_plot=False)
+    >>> isinstance(fig, go.Figure)
+    True
+    """
+    data = [pd_region, d1_region, d2_region, dt_region, t1_region, t2_region, t3_region]
+    data.extend(duval_points_list)
+
+    fig = go.Figure(data=data, layout = get_layout(equipment_name))
+    fig.update_layout(get_layout(equipment_name))
+
+    if show_plot:
+        fig.show()
+
+    return fig

duvals_triangle_plotter-1.2/duvals_triangle_plotter.egg-info/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: duvals-triangle-plotter
+Version: 1.2
+Summary: Duval's Triangle Plotter — Python library for generating Duval's Triangle plots for DGA
+Home-page: https://nagusubra.github.io/duvals-triangle-plotter/
+Author: Subramanian Narayanan
+Author-email: Subramanian Narayanan <snarayan@nagusubra.com>
+License-Expression: MIT
+Project-URL: Homepage, https://nagusubra.github.io/duvals-triangle-plotter/
+Project-URL: Documentation, https://nagusubra.github.io/duvals-triangle-plotter/
+Project-URL: Repository, https://github.com/nagusubra/duvals-triangle-plotter
+Project-URL: Bug Tracker, https://github.com/nagusubra/duvals-triangle-plotter/issues
+Project-URL: Changelog, https://github.com/nagusubra/duvals-triangle-plotter/blob/main/CHANGELOG.txt
+Keywords: duval,duvals-triangle,dga,dissolved-gas-analysis,transformer,power-transformer,fault-diagnosis,ternary-plot,plotly,visualization
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: plotly>=5.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+
+# Duval's Triangle Plotter
+
+Python library for generating [Duval's Triangle](https://nagusubra.github.io/duvals-triangle-plotter/) plots — a ternary diagnostic tool used in Dissolved Gas Analysis (DGA) for power transformer condition monitoring.
+
+## Installation
+
+```bash
+pip install duvals-triangle-plotter
+```
+
+## Quick Start
+
+```python
+import duvals_triangle_plotter as dtp
+
+trace = dtp.get_duval_points_traces(
+    [0.09], [0.0], [0.91], "2000-08-16"
+)
+fig = dtp.get_duvals_triangle_plot([trace], show_plot=True)
+```
+
+## Documentation
+
+Full documentation and API reference: [nagusubra.github.io/duvals-triangle-plotter](https://nagusubra.github.io/duvals-triangle-plotter/)
+
+## License
+
+MIT

{duvals_triangle_plotter-1.0 → duvals_triangle_plotter-1.2}/duvals_triangle_plotter.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE.txt
 MANIFEST.in
 README.md
+pyproject.toml
 setup.py
 duvals_triangle_plotter/__init__.py
 duvals_triangle_plotter/__main__.py

duvals_triangle_plotter-1.2/duvals_triangle_plotter.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+duvals-triangle-plotter = duvals_triangle_plotter.__main__:main

duvals_triangle_plotter-1.2/duvals_triangle_plotter.egg-info/requires.txt

@@ -0,0 +1 @@
+plotly>=5.0

{duvals_triangle_plotter-1.0 → duvals_triangle_plotter-1.2}/duvals_triangle_plotter.egg-info/top_level.txt

@@ -1 +1,3 @@
+dist
+docs
 duvals_triangle_plotter

duvals_triangle_plotter-1.2/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools>=64.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "duvals-triangle-plotter"
+dynamic = ["version"]
+description = "Duval's Triangle Plotter — Python library for generating Duval's Triangle plots for DGA"
+readme = "README.md"
+requires-python = ">=3.6"
+license = "MIT"
+authors = [
+    {name = "Subramanian Narayanan", email = "snarayan@nagusubra.com"},
+]
+keywords = [
+    "duval",
+    "duvals-triangle",
+    "dga",
+    "dissolved-gas-analysis",
+    "transformer",
+    "power-transformer",
+    "fault-diagnosis",
+    "ternary-plot",
+    "plotly",
+    "visualization",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Science/Research",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+dependencies = [
+    "plotly>=5.0",
+]
+
+[project.urls]
+Homepage = "https://nagusubra.github.io/duvals-triangle-plotter/"
+Documentation = "https://nagusubra.github.io/duvals-triangle-plotter/"
+Repository = "https://github.com/nagusubra/duvals-triangle-plotter"
+"Bug Tracker" = "https://github.com/nagusubra/duvals-triangle-plotter/issues"
+"Changelog" = "https://github.com/nagusubra/duvals-triangle-plotter/blob/main/CHANGELOG.txt"
+
+[project.scripts]
+duvals-triangle-plotter = "duvals_triangle_plotter.__main__:main"
+
+[tool.setuptools]
+packages = {find = {}}
+
+[tool.setuptools.package-data]
+duvals_triangle_plotter = ["*.py", "py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["test_duvals_triangle_plotter.py"]

{duvals_triangle_plotter-1.0 → duvals_triangle_plotter-1.2}/setup.py

@@ -2,11 +2,10 @@ from setuptools import setup, find_packages
 
 setup(
     name='duvals_triangle_plotter',
-    version='1.0',
+    version='1.2',
     packages=find_packages(),
     install_requires=[
         'plotly',
-        # Add any other dependencies here
     ],
     entry_points={
         'console_scripts': [
@@ -15,11 +14,15 @@ setup(
     },
     include_package_data=True,
     author='Subramanian Narayanan',
-    author_email='your.email@example.com',
-    description="Duval's Triangle Plotter - Python library for generating Duval's Triangle plots",
+    author_email='snarayan@nagusubra.com',
+    description="Duval's Triangle Plotter — Python library for generating Duval's Triangle plots for DGA",
     long_description=open('README.md').read(),
     long_description_content_type='text/markdown',
-    url='https://github.com/yourusername/duvals_triangle_plotter',
+    url='https://nagusubra.github.io/duvals-triangle-plotter/',
+    project_urls={
+        'Source Code': 'https://github.com/nagusubra/duvals-triangle-plotter',
+        'Bug Tracker': 'https://github.com/nagusubra/duvals-triangle-plotter/issues',
+    },
     license='MIT',
     classifiers=[
         'License :: OSI Approved :: MIT License',
@@ -28,5 +31,10 @@ setup(
         'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: 3.8',
         'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Topic :: Scientific/Engineering :: Visualization',
+        'Intended Audience :: Science/Research',
     ],
 )

duvals_triangle_plotter-1.0/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.1
-Name: duvals_triangle_plotter
-Version: 1.0
-Summary: Duval's Triangle Plotter - Python library for generating Duval's Triangle plots
-Home-page: https://github.com/yourusername/duvals_triangle_plotter
-Author: Subramanian Narayanan
-Author-email: your.email@example.com
-License: MIT
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: plotly
-
-# Duval's Triangle Plotter
-
-Duval's Triangle Plotter is a Python library for generating Duval's Triangle plots, which are commonly used in Dissolved Gas Analysis (DGA) for monitoring power transformers.
-
-## Introduction
-
-Duval's Triangle is a graphical representation used in DGA to analyze the concentration levels of different gases, such as methane, acetylene, and ethylene, dissolved in transformer oil. This project provides a Python library that allows users to easily create Duval's Triangle plots for their DGA data.
-
-## Features
-
-- Generate Duval's Triangle plots with customizable configurations.
-- Plot various regions on Duval's Triangle, such as PD (Partial Discharges), D1, D2, DT, T1, T2, and T3.
-- Customize layout, colors, and symbols for better visualization.
-
-## Getting Started
-
-### Installation
-```bash
-pip install duvals-triangle-plotter
-```
-
-### Usage
-```python
-import duvals_triangle_plotter as dtp
-
-duval_points = [
-    dtp.get_duval_points_traces([0.09], [0.0], [0.91], "2000-08-16")
-]
-
-dtp.get_duvals_triangle_plot(duval_points, show_plot=True)
-```

duvals_triangle_plotter-1.0/README.md

@@ -1,31 +0,0 @@
-# Duval's Triangle Plotter
-
-Duval's Triangle Plotter is a Python library for generating Duval's Triangle plots, which are commonly used in Dissolved Gas Analysis (DGA) for monitoring power transformers.
-
-## Introduction
-
-Duval's Triangle is a graphical representation used in DGA to analyze the concentration levels of different gases, such as methane, acetylene, and ethylene, dissolved in transformer oil. This project provides a Python library that allows users to easily create Duval's Triangle plots for their DGA data.
-
-## Features
-
-- Generate Duval's Triangle plots with customizable configurations.
-- Plot various regions on Duval's Triangle, such as PD (Partial Discharges), D1, D2, DT, T1, T2, and T3.
-- Customize layout, colors, and symbols for better visualization.
-
-## Getting Started
-
-### Installation
-```bash
-pip install duvals-triangle-plotter
-```
-
-### Usage
-```python
-import duvals_triangle_plotter as dtp
-
-duval_points = [
-    dtp.get_duval_points_traces([0.09], [0.0], [0.91], "2000-08-16")
-]
-
-dtp.get_duvals_triangle_plot(duval_points, show_plot=True)
-```

duvals_triangle_plotter-1.0/duvals_triangle_plotter/__init__.py

@@ -1 +0,0 @@
-from .duvals_triangle_plotter import get_duval_points_traces, get_duvals_triangle_plot

duvals_triangle_plotter-1.0/duvals_triangle_plotter/constants.py

@@ -1,115 +0,0 @@
-"""
-Constants for Duval's Triangle Plot Configuration
-"""
-
-pd_region = {
-                # Get configuration for the PD (Partial Discharges) region in Duval's Triangle plot.
-                
-                "uid": "pd_region", 
-                "a": [98, 1, 98], # methane
-                "b": [0, 0, 2],   # acetylene
-                "c": [2, 0, 0],   # ethylene
-                "fill": "toself", 
-                "line": {"color": "#444"}, 
-                "mode": "lines", 
-                "text": "PD", 
-                "type": "scatterternary", 
-                "fillcolor": "#b3de69",
-                "name": "PD - Corona Partial Discharges"
-            }
-
-d1_region = {
-            # Get configuration for the D1 (Electrical Discharges of Low Energy) region in Duval's Triangle plot.
-
-            "uid": "d1_region", 
-            "a": [0, 0, 64, 87],  # methane
-            "b": [1, 77, 13, 13], # acetylene
-            "c": [0, 23, 23, 0],  # ethylene
-            "fill": "toself", 
-            "line": {"color": "#444"}, 
-            "mode": "lines", 
-            "text": "D1", 
-            "type": "scatterternary", 
-            "fillcolor": "#ffffb3",
-            "name": "D1 - Electrical Discharges of Low Energy"
-        }
-
-d2_region = {
-            # Get configuration for the D2 (Electrical Discharges of High Energy) region in Duval's Triangle plot.
-            "uid": "d2_region", 
-            "a": [0, 0, 31, 47, 64],    # methane
-            "b": [77, 29, 29, 13, 13],  # acetylene
-            "c": [23, 71, 40, 40, 23],  # ethylene
-            "fill": "toself", 
-            "line": {"color": "#444"}, 
-            "mode": "lines", 
-            "text": "D2", 
-            "type": "scatterternary", 
-            "fillcolor": "#bebada",
-            "name": "D2 - Electrical Discharges of High Energy"
-        }
-
-dt_region = {
-            # Get configuration for the DT (Electrical and Thermal Fault) region in Duval's Triangle plot.
-
-            "uid": "dt_region", 
-            "a": [0, 0, 35, 46, 96, 87, 47, 31],    # methane
-            "b": [29, 15, 15, 4, 4, 13, 13, 29],    # acetylene
-            "c": [71, 85, 50, 50, 0, 0, 40, 40],    # ethylene
-            "fill": "toself", 
-            "line": {"color": "#444"}, 
-            "mode": "lines", 
-            "text": "DT",
-            "hoverlabel": {"font": {"color": "black"}},
-            "type": "scatterternary", 
-            "fillcolor": "#fb8072",
-            "name": "DT - Electrical and Thermal Fault"
-        }
-
-t1_region = {
-            # Get configuration for the T1 (Thermal Faults, T<300 C) region in Duval's Triangle plot.
-   
-            "uid": "t1_region", 
-            "a": [76, 80, 98, 98, 96],  # methane
-            "b": [4, 0, 0, 2, 4],       # acetylene
-            "c": [20, 20, 2, 0, 0],     # ethylene
-            "fill": "toself", 
-            "line": {"color": "#444"}, 
-            "mode": "lines", 
-            "text": "T1", 
-            "type": "scatterternary", 
-            "fillcolor": "#80b1d3",
-            "name": "T1 - Thermal Faults, T<300C"
-        }
-
-t2_region = {
-            # Get configuration for the T2 (Thermal Faults, 300 C<T<700 C) region in Duval's Triangle plot.
-            "uid": "t2_region", 
-            "a": [46, 50, 80, 76],      # methane
-            "b": [4, 0, 0, 4],          # acetylene
-            "c": [50, 50, 20, 20],      # ethylene
-            "fill": "toself", 
-            "line": {"color": "#444"}, 
-            "mode": "lines", 
-            "text": "T2", 
-            "type": "scatterternary", 
-            "fillcolor": "#fdb462",
-            "name": "T2 - Thermal Faults, 300C<T<700C"
-        }
-
-t3_region = {
-            # Get configuration for the T3 (Thermal Faults, T>700 C) region in Duval's Triangle plot.
-            
-            "uid": "t3_region", 
-            "a": [0, 0, 50, 35],    # methane
-            "b": [15, 0, 0, 15],    # acetylene
-            "c": [85, 1, 50, 50],   # ethylene
-            "fill": "toself", 
-            "line": {"color": "#444"}, 
-            "mode": "lines", 
-            "text": "T3", 
-            "type": "scatterternary",
-            "fillcolor": "#8dd3c7",
-            "name": "T3",
-            "name": "T3 - Thermal Faults, T>700C"
-        }

duvals_triangle_plotter-1.0/duvals_triangle_plotter/duvals_triangle_plotter.py

@@ -1,108 +0,0 @@
-import plotly.graph_objects as go
-from duvals_triangle_plotter.constants import pd_region, d1_region, d2_region, dt_region, t1_region, t2_region, t3_region
-
-def get_layout(equipment_name: str):
-
-    """
-    Generate layout configuration for Duval's Triangle plot.
-
-    Parameters:
-    - equipment_name (str): The name of the equipment for which the Duval's Triangle is plotted.
-
-    Returns:
-    dict: A dictionary containing layout configuration for the Duval's Triangle plot.
-    """
-
-    layout = {
-                "title": "<b>Duval's Triangle (Dissolved Gas Analysis) for : {0}</b>".format(equipment_name), 
-                "width": 1044*1.8,  # adjust respectively
-                "height": 545*1.8,  # adjust respectively
-                "ternary": {
-                                "sum": 100, 
-                                "aaxis": {
-                                            "min": 0.01, 
-                                            "ticks": "outside", 
-                                            "title": "<b> CH4 (Methane) </b>", 
-                                            "linewidth": 8, 
-                                            "ticksuffix": "%",
-                                        }, 
-                                "baxis": {
-                                            "min": 0.01, 
-                                            "ticks": "outside", 
-                                            "title": "<b> C2H2 (Acetylene) </b>", 
-                                            "linewidth": 8, 
-                                            "ticksuffix": "%"
-                                        }, 
-                                "caxis": {
-                                            "min": 0.01, 
-                                            "ticks": "outside", 
-                                            "title": "<b> C2H4 (Ethylene) </b>", 
-                                            "linewidth": 8, 
-                                            "ticksuffix": "%"
-                                        }
-                }, 
-                "autosize": True, 
-                "showlegend": True,
-                "margin": {"pad":100},
-            }
-    return layout
-
-def get_duval_points_traces(methane_points_list: list, acetylene_points_list: list, ethylene_points_list: list, date: str):
-    
-    """
-    Get traces for Duval's Triangle points.
-
-    Parameters:
-    - methane_points_list (list): List of methane points where each element is concentration level of methane in ppm.
-    - acetylene_points_list (list): List of acetylene points where each element is concentration level of acetylene in ppm.
-    - ethylene_points_list (list): List of ethylene points where each element is concentration level of ethylene in ppm.
-    - date (str): Date associated with the samples.
-
-    Returns:
-    dict: A dictionary containing traces for Duval's Triangle points.
-    """
-
-    duval_points =  {
-                    "a": methane_points_list,       # methane
-                    "b": acetylene_points_list,     # acetylene
-                    "c": ethylene_points_list,      # ethylene
-                    "mode": "markers", 
-                    "type": "scatterternary", 
-                    "marker":   {
-                                    "size": 18,     # adjust respectively
-                                    "color": "black", 
-                                    "symbol": 217,  # a different symbol number would give a different marker style
-                                },
-                    "cliponaxis": True,
-                    "hovertemplate":  "Sample Date: {0}<br>".format(date) + "Methane (CH4): %{a:.2f}%<br>" + "Acetylene (C2H2): %{b:.2f}%<br>" + "Ethylene (C2H4): %{c:.2f}%<br>",
-                    "name": "Sample Date: {0}<br>".format(date)
-                }
-    
-    return duval_points
-
-def get_duvals_triangle_plot(duval_points_list: list, show_plot:bool = False, equipment_name:str = "General Site"):
-    
-    """
-    Generate Duval's Triangle plot.
-
-    Parameters:
-    - duval_points_list (list): List of Duval's Triangle points.
-    - show_plot (bool): Flag to determine whether to display the plot.
-    - equipment_name (str): Name of the equipment for which the plot is generated.
-
-    Returns:
-    go.Figure: A Plotly Figure containing Duval's Triangle plot.
-    """
-    
-    # print("The data of recieved duval_points_list: ", duval_points_list)
-
-    data = [pd_region, d1_region, d2_region, dt_region, t1_region, t2_region, t3_region]
-    data.extend(duval_points_list)
-    
-    fig = go.Figure(data=data, layout = get_layout(equipment_name))
-    fig.update_layout(get_layout(equipment_name))
-    
-    if show_plot:
-        fig.show()
-    
-    return fig

duvals_triangle_plotter-1.0/duvals_triangle_plotter.egg-info/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.1
-Name: duvals-triangle-plotter
-Version: 1.0
-Summary: Duval's Triangle Plotter - Python library for generating Duval's Triangle plots
-Home-page: https://github.com/yourusername/duvals_triangle_plotter
-Author: Subramanian Narayanan
-Author-email: your.email@example.com
-License: MIT
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: plotly
-
-# Duval's Triangle Plotter
-
-Duval's Triangle Plotter is a Python library for generating Duval's Triangle plots, which are commonly used in Dissolved Gas Analysis (DGA) for monitoring power transformers.
-
-## Introduction
-
-Duval's Triangle is a graphical representation used in DGA to analyze the concentration levels of different gases, such as methane, acetylene, and ethylene, dissolved in transformer oil. This project provides a Python library that allows users to easily create Duval's Triangle plots for their DGA data.
-
-## Features
-
-- Generate Duval's Triangle plots with customizable configurations.
-- Plot various regions on Duval's Triangle, such as PD (Partial Discharges), D1, D2, DT, T1, T2, and T3.
-- Customize layout, colors, and symbols for better visualization.
-
-## Getting Started
-
-### Installation
-```bash
-pip install duvals-triangle-plotter
-```
-
-### Usage
-```python
-import duvals_triangle_plotter as dtp
-
-duval_points = [
-    dtp.get_duval_points_traces([0.09], [0.0], [0.91], "2000-08-16")
-]
-
-dtp.get_duvals_triangle_plot(duval_points, show_plot=True)
-```

duvals_triangle_plotter-1.0/duvals_triangle_plotter.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-duvals_triangle_plotter = duvals_triangle_plotter.__main__:main

duvals_triangle_plotter-1.0/duvals_triangle_plotter.egg-info/requires.txt

@@ -1 +0,0 @@
-plotly