soiltextureplot 0.1.0__tar.gz → 0.1.3__tar.gz

soiltextureplot-0.1.3/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: soiltextureplot
+Version: 0.1.3
+Summary: Soil texture triangle plotting and classification
+Author-email: Amninder Singh <amnindersingh13@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/singhamninder/soiltextureplot
+Project-URL: Bug Tracker, https://github.com/singhamninder/soiltextureplot/issues
+Keywords: soil,texture,triangle,plot,classification,ternary
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: numpy>=1.23.0
+Requires-Dist: matplotlib>=3.7.0
+Requires-Dist: mpltern>=1.0.0
+Provides-Extra: app
+Requires-Dist: streamlit>=1.57.0; extra == "app"
+Dynamic: license-file
+
+# Soil Texture Plot
+
+[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://soiltextureplot.streamlit.app/)
+
+This repository contains codebase for soil texture classification and visualization using ternary diagrams. It provides tools to plot soil texture data on texture triangles and classify soil samples according to different classification systems.
+
+## Features
+
+- **Ternary Plotting**: Visualize soil texture data on interactive ternary diagrams
+- **Multiple Classification Systems**: Support for USDA and HYPRES soil texture classification systems
+- **Interactive Web App**: Streamlit-based application for easy data upload and visualization
+- **Flexible Data Input**: Support for CSV files with customizable column mapping
+- **Point Classification**: Automatic classification of soil samples into texture classes
+- **Customizable Visualization**: Control point sizes, colors, and labels
+
+## Dependencies
+
+- streamlit
+- pandas
+- numpy
+- matplotlib
+- mpltern
+
+## Development
+
+```bash
+# Setup
+uv sync --group dev
+
+# Install git pre-commit hook
+uv run pre-commit install
+
+# Run all pre-commit checks on the repository
+uv run pre-commit run --all-files
+
+# Run one hook manually (example: ruff)
+uv run pre-commit run ruff --all-files
+
+# CI-style check-only quality commands (no auto-fixes)
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check src app
+
+# Run tests
+uv run pytest
+
+# Build
+uv build
+
+# Publish (after updating version in pyproject.toml)
+uv publish
+```
+
+## Release Automation (GitHub Actions)
+
+Publishing is automated via tag-triggered workflows:
+
+- `v*rc*` tags publish to TestPyPI
+- `v*.*.*` tags are evaluated for PyPI; tags containing `rc` are skipped by workflow condition
+
+Both workflows verify that the git tag version matches `uv version --short` before publishing.
+Both workflows also run isolated wheel and source-distribution smoke tests (`import soiltextureplot`) before upload.
+
+### Trusted publishing prerequisites
+
+Before pushing release tags, configure trusted publishing:
+
+1. In GitHub, create environments named `pypi` and `testpypi` under repository settings.
+2. In PyPI project settings, add a trusted publisher matching this repository and the `publish-pypi.yml` workflow.
+3. In TestPyPI project settings, add a trusted publisher matching this repository and the `publish-testpypi.yml` workflow.
+
+### Prerelease to TestPyPI
+
+```bash
+# Example: bump to prerelease version
+uv version 0.1.2rc1
+git add pyproject.toml uv.lock
+git commit -m "Bump version to 0.1.2rc1"
+git push origin dev
+
+# After merge to main, create and push prerelease tag from main
+git checkout main
+git pull
+git tag -a v0.1.2rc1 -m "Release v0.1.2rc1"
+git push origin v0.1.2rc1
+```
+
+Smoke test from TestPyPI:
+
+```bash
+uv run --with "soiltextureplot==0.1.2rc1" --no-project -- python -c "import soiltextureplot"
+```
+
+### Stable release to PyPI
+
+```bash
+# Example: bump stable version
+uv version --bump patch
+git add pyproject.toml uv.lock
+git commit -m "Bump version"
+git push origin dev
+
+# After merge to main, create and push stable tag from main
+git checkout main
+git pull
+git tag -a v0.1.2 -m "Release v0.1.2"
+git push origin v0.1.2
+```
+
+Smoke test from PyPI:
+
+```bash
+uv run --with soiltextureplot --no-project -- python -c "import soiltextureplot"
+```
+
+## Notebook Workflows (Pilot)
+
+During the Marimo pilot, both notebook paths are supported:
+
+- Jupyter notebook remains available at `texture_plot.ipynb`
+- Marimo notebook copy is available at `notebooks/texture_plot_marimo.py`
+- Keep existing `nbqa` checks for `.ipynb` files during this phase
+
+Run the Marimo notebook:
+
+```bash
+uv run marimo edit notebooks/texture_plot_marimo.py
+```
+
+Run the existing Jupyter notebook:
+
+```bash
+uv run jupyter notebook texture_plot.ipynb
+```
+
+
+## Web Application
+
+The web app allows you to:
+- Upload CSV files with soil texture data
+- Map columns to sand, silt, and clay percentages
+- Visualize data on interactive texture triangles
+- Customize plot appearance
+
+## Supported Classification Systems
+
+### USDA (United States Department of Agriculture)
+The standard USDA soil texture classification system with 12 texture classes.
+
+### HYPRES (HYdraulic PRoperties of European Soils)
+A European framework for classifying soils based on their hydrologic properties.
+
+## Data Format
+
+Your CSV file should contain soil texture data with percentages of sand, silt, and clay. The percentages should sum to 100% for each sample.
+
+Example data format:
+
+```csv
+sample_id,sand,silt,clay
+S1,65,20,15
+S2,70,24,6
+S3,75,21,4
+```
+
+## Acknowledgments
+
+- Built using [mpltern](https://github.com/yuzie007/mpltern) for ternary plotting
+- Inspired by soil science classification standards
+- Streamlit for the web interface

soiltextureplot-0.1.3/README.md

@@ -0,0 +1,170 @@
+# Soil Texture Plot
+
+[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://soiltextureplot.streamlit.app/)
+
+This repository contains codebase for soil texture classification and visualization using ternary diagrams. It provides tools to plot soil texture data on texture triangles and classify soil samples according to different classification systems.
+
+## Features
+
+- **Ternary Plotting**: Visualize soil texture data on interactive ternary diagrams
+- **Multiple Classification Systems**: Support for USDA and HYPRES soil texture classification systems
+- **Interactive Web App**: Streamlit-based application for easy data upload and visualization
+- **Flexible Data Input**: Support for CSV files with customizable column mapping
+- **Point Classification**: Automatic classification of soil samples into texture classes
+- **Customizable Visualization**: Control point sizes, colors, and labels
+
+## Dependencies
+
+- streamlit
+- pandas
+- numpy
+- matplotlib
+- mpltern
+
+## Development
+
+```bash
+# Setup
+uv sync --group dev
+
+# Install git pre-commit hook
+uv run pre-commit install
+
+# Run all pre-commit checks on the repository
+uv run pre-commit run --all-files
+
+# Run one hook manually (example: ruff)
+uv run pre-commit run ruff --all-files
+
+# CI-style check-only quality commands (no auto-fixes)
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check src app
+
+# Run tests
+uv run pytest
+
+# Build
+uv build
+
+# Publish (after updating version in pyproject.toml)
+uv publish
+```
+
+## Release Automation (GitHub Actions)
+
+Publishing is automated via tag-triggered workflows:
+
+- `v*rc*` tags publish to TestPyPI
+- `v*.*.*` tags are evaluated for PyPI; tags containing `rc` are skipped by workflow condition
+
+Both workflows verify that the git tag version matches `uv version --short` before publishing.
+Both workflows also run isolated wheel and source-distribution smoke tests (`import soiltextureplot`) before upload.
+
+### Trusted publishing prerequisites
+
+Before pushing release tags, configure trusted publishing:
+
+1. In GitHub, create environments named `pypi` and `testpypi` under repository settings.
+2. In PyPI project settings, add a trusted publisher matching this repository and the `publish-pypi.yml` workflow.
+3. In TestPyPI project settings, add a trusted publisher matching this repository and the `publish-testpypi.yml` workflow.
+
+### Prerelease to TestPyPI
+
+```bash
+# Example: bump to prerelease version
+uv version 0.1.2rc1
+git add pyproject.toml uv.lock
+git commit -m "Bump version to 0.1.2rc1"
+git push origin dev
+
+# After merge to main, create and push prerelease tag from main
+git checkout main
+git pull
+git tag -a v0.1.2rc1 -m "Release v0.1.2rc1"
+git push origin v0.1.2rc1
+```
+
+Smoke test from TestPyPI:
+
+```bash
+uv run --with "soiltextureplot==0.1.2rc1" --no-project -- python -c "import soiltextureplot"
+```
+
+### Stable release to PyPI
+
+```bash
+# Example: bump stable version
+uv version --bump patch
+git add pyproject.toml uv.lock
+git commit -m "Bump version"
+git push origin dev
+
+# After merge to main, create and push stable tag from main
+git checkout main
+git pull
+git tag -a v0.1.2 -m "Release v0.1.2"
+git push origin v0.1.2
+```
+
+Smoke test from PyPI:
+
+```bash
+uv run --with soiltextureplot --no-project -- python -c "import soiltextureplot"
+```
+
+## Notebook Workflows (Pilot)
+
+During the Marimo pilot, both notebook paths are supported:
+
+- Jupyter notebook remains available at `texture_plot.ipynb`
+- Marimo notebook copy is available at `notebooks/texture_plot_marimo.py`
+- Keep existing `nbqa` checks for `.ipynb` files during this phase
+
+Run the Marimo notebook:
+
+```bash
+uv run marimo edit notebooks/texture_plot_marimo.py
+```
+
+Run the existing Jupyter notebook:
+
+```bash
+uv run jupyter notebook texture_plot.ipynb
+```
+
+
+## Web Application
+
+The web app allows you to:
+- Upload CSV files with soil texture data
+- Map columns to sand, silt, and clay percentages
+- Visualize data on interactive texture triangles
+- Customize plot appearance
+
+## Supported Classification Systems
+
+### USDA (United States Department of Agriculture)
+The standard USDA soil texture classification system with 12 texture classes.
+
+### HYPRES (HYdraulic PRoperties of European Soils)
+A European framework for classifying soils based on their hydrologic properties.
+
+## Data Format
+
+Your CSV file should contain soil texture data with percentages of sand, silt, and clay. The percentages should sum to 100% for each sample.
+
+Example data format:
+
+```csv
+sample_id,sand,silt,clay
+S1,65,20,15
+S2,70,24,6
+S3,75,21,4
+```
+
+## Acknowledgments
+
+- Built using [mpltern](https://github.com/yuzie007/mpltern) for ternary plotting
+- Inspired by soil science classification standards
+- Streamlit for the web interface

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3}/pyproject.toml

@@ -1,17 +1,18 @@
 [build-system]
-requires = ["setuptools>=61.0"]
+requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "soiltextureplot"
-version = "0.1.0"
+version = "0.1.3"
 description = "Soil texture triangle plotting and classification"
 readme = "README.md"
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [
     { name = "Amninder Singh", email = "amnindersingh13@gmail.com"},
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.12"
 dependencies = [
   "pandas>=1.5.0",
   "numpy>=1.23.0",
@@ -22,11 +23,7 @@ keywords = ["soil", "texture", "triangle", "plot", "classification", "ternary"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Science/Research",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Topic :: Scientific/Engineering",
 ]
@@ -35,5 +32,24 @@ classifiers = [
 "Homepage" = "https://github.com/singhamninder/soiltextureplot"
 "Bug Tracker" = "https://github.com/singhamninder/soiltextureplot/issues"
 
-[tool.setuptools]
-packages = ["soiltextureplot"]
+[project.optional-dependencies]
+app = [
+    "streamlit>=1.57.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+soiltextureplot = ["data/*.csv"]
+
+[dependency-groups]
+dev = [
+  "pytest>=7.4",
+  "pytest-cov>=4.1",
+  "ruff>=0.4",
+  "nbqa>=1.9.1",
+  "marimo>=0.17.6",
+  "ty>=0.0.34",
+  "pre-commit>=4.3.0",
+]

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/classifier.py

@@ -22,6 +22,7 @@ class PolygonClassifier:
     _class_order : List[str]
         Ordered list of class names for consistency.
     """
+
     system: TextureSystem
     _paths: Dict[str, Path]
     _class_order: List[str]
@@ -57,10 +58,7 @@ class PolygonClassifier:
         return cls(system=system, _paths=paths, _class_order=class_order)
 
     def classify_points(
-        self,
-        clay: np.ndarray,
-        sand: np.ndarray,
-        silt: np.ndarray
+        self, clay: np.ndarray, sand: np.ndarray, silt: np.ndarray
     ) -> np.ndarray:
         """
         Classify many points at once.

soiltextureplot-0.1.3/src/soiltextureplot/data/example_soil_data.csv

@@ -0,0 +1,6 @@
+sample_id,sand,silt,clay,BD
+S1,65,20,15,1.002
+S2,70,24,6,1.277
+S3,75,21,4,1.008
+S4,80,16,4,1.927
+S5,35,45,20,1.774

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/datasets.py

@@ -1,4 +1,4 @@
-from typing import Dict, List, Annotated
+from typing import Dict, List
 
 # Type alias for texture definitions: Name -> List of Polygon Vertices (Clay, Sand, Silt)
 TextureClasses = Dict[str, List[List[float]]]

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/plotting.py

@@ -1,18 +1,39 @@
-import numpy as np
+from typing import Any, List, Optional, Protocol, Tuple, Union, cast
+
 import matplotlib.pyplot as plt
+import mpltern  # noqa: F401  # Registers the "ternary" Matplotlib projection.
+import numpy as np
 import pandas as pd
-
-from typing import Optional, Union, List, Tuple
-from matplotlib.figure import Figure
+from matplotlib import colormaps
 from matplotlib.axes import Axes
 from matplotlib.colors import Colormap
+from matplotlib.figure import Figure
 from matplotlib.ticker import AutoMinorLocator, MultipleLocator
-from matplotlib import colormaps
 
 from .systems import TextureSystem
 from .utils import calculate_centroid
 
 
+class TernaryAxisLike(Protocol):
+    """Typed subset of mpltern axis API used in this module."""
+
+    taxis: Any
+    laxis: Any
+    raxis: Any
+    transData: Any
+    transTernaryAxes: Any
+
+    def scatter(self, *args: Any, **kwargs: Any) -> Any: ...
+
+    def fill(self, *args: Any, **kwargs: Any) -> list[Any]: ...
+
+    def text(self, *args: Any, **kwargs: Any) -> Any: ...
+
+    def set_title(self, *args: Any, **kwargs: Any) -> Any: ...
+
+    def grid(self, *args: Any, **kwargs: Any) -> Any: ...
+
+
 def plot_triangle_with_points(
     df: pd.DataFrame,
     system: TextureSystem,
@@ -53,23 +74,22 @@ def plot_triangle_with_points(
     ax : Axes
         The matplotlib Axes object (ternary projection).
     """
-    import mpltern  # imported here so core doesn’t hard‑depend for non‑plot use
 
     fig = plt.figure(figsize=(7, 6))
-    ax = fig.add_subplot(projection="ternary", ternary_sum=100.0)
+    ax = cast(TernaryAxisLike, fig.add_subplot(projection="ternary", ternary_sum=100.0))
 
     _plot_background_classes(ax, system, cmap=cmap)
 
     # coordinates in ternary order (clay, sand, silt)
     t = df["clay"].to_numpy()
-    l = df["sand"].to_numpy()
+    left = df["sand"].to_numpy()
     r = df["silt"].to_numpy()
 
     sizes = _compute_sizes(df, size_by, size_min, size_max)
 
     ax.scatter(
         t,
-        l,
+        left,
         r,
         c=color_points,
         alpha=0.7,
@@ -78,7 +98,7 @@ def plot_triangle_with_points(
     )
 
     if show_labels and "sample_id" in df.columns:
-        for (_, row), tt, ll, rr in zip(df.iterrows(), t, l, r):
+        for (_, row), tt, ll, rr in zip(df.iterrows(), t, left, r):
             ax.text(
                 tt,
                 ll,
@@ -92,13 +112,13 @@ def plot_triangle_with_points(
 
     ax.set_title(f"{system.name} Soil Texture Triangle", weight="bold", pad=20)
     fig.tight_layout()
-    return fig, ax
+    return fig, cast(Axes, ax)
 
 
 def _plot_background_classes(
-    ax: Axes,
+    ax: TernaryAxisLike,
     system: TextureSystem,
-    cmap: Optional[Union[str, List[str], Colormap]] = None
+    cmap: Optional[Union[str, List[str], Colormap]] = None,
 ) -> None:
     """
     Plots the texture class polygons in the background.
@@ -139,10 +159,11 @@ def _plot_background_classes(
 
     # Cycle through colors if not enough are provided for the polygons.
     # This is a safeguard, though resampled() should give the correct number.
+    assert colors is not None
     if len(colors) < num_polygons:
         color_cycle = cycle(colors)
     else:
-        color_cycle = colors  # type: ignore
+        color_cycle = colors
 
     for (name, vertices), color in zip(system.polygons.items(), color_cycle):
         tn0, tn1, tn2 = np.array(vertices).T  # clay, sand, silt
@@ -225,7 +246,7 @@ def _compute_sizes(
     df: pd.DataFrame,
     size_by: Optional[str],
     size_min: Optional[float],
-    size_max: Optional[float]
+    size_max: Optional[float],
 ) -> Union[float, np.ndarray]:
     """Helper to compute point sizes based on a column."""
     if size_min is None:

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/systems.py

@@ -1,5 +1,6 @@
 from dataclasses import dataclass
-from typing import List, Dict, Mapping, Any, Optional
+from typing import Any, Dict, Mapping
+
 from . import datasets
 
 
@@ -17,6 +18,7 @@ class TextureSystem:
     meta : Mapping[str, Any]
         Metadata about the system (description, citation, etc.).
     """
+
     name: str
     polygons: Mapping[str, Any]
     meta: Mapping[str, Any]

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/triangle.py

@@ -1,15 +1,14 @@
-import numpy as np
-import pandas as pd
-
 from dataclasses import dataclass, field
 from pathlib import Path as PathLibPath
-from typing import Optional, Union, TYPE_CHECKING
-from matplotlib.figure import Figure
+from typing import TYPE_CHECKING, Optional, Union
+
+import pandas as pd
 from matplotlib.axes import Axes
+from matplotlib.figure import Figure
 
-from .systems import get_texture_system, TextureSystem
-from .classifier import PolygonClassifier
 from . import plotting
+from .classifier import PolygonClassifier
+from .systems import TextureSystem, get_texture_system
 
 if TYPE_CHECKING:
     # Avoid circular import at runtime by only importing for type checking if needed
@@ -28,6 +27,7 @@ class SoilTextureTriangle:
     df : pd.DataFrame, optional
         Initial DataFrame. Can be set later via load functions.
     """
+
     system_name: str = "USDA"
     df: Optional[pd.DataFrame] = field(default=None, repr=False)
 

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/utils.py

@@ -37,10 +37,7 @@ def calculate_centroid(vertices: np.ndarray) -> np.ndarray:
 
 
 def ternary_to_cartesian(
-    clay: np.ndarray,
-    sand: np.ndarray,
-    silt: np.ndarray,
-    ternary_sum: float = 100.0
+    clay: np.ndarray, sand: np.ndarray, silt: np.ndarray, ternary_sum: float = 100.0
 ) -> np.ndarray:
     """
     Convert ternary coordinates (clay, sand, silt) to 2D Cartesian (x, y).

soiltextureplot-0.1.3/src/soiltextureplot.egg-info/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: soiltextureplot
+Version: 0.1.3
+Summary: Soil texture triangle plotting and classification
+Author-email: Amninder Singh <amnindersingh13@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/singhamninder/soiltextureplot
+Project-URL: Bug Tracker, https://github.com/singhamninder/soiltextureplot/issues
+Keywords: soil,texture,triangle,plot,classification,ternary
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: numpy>=1.23.0
+Requires-Dist: matplotlib>=3.7.0
+Requires-Dist: mpltern>=1.0.0
+Provides-Extra: app
+Requires-Dist: streamlit>=1.57.0; extra == "app"
+Dynamic: license-file
+
+# Soil Texture Plot
+
+[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://soiltextureplot.streamlit.app/)
+
+This repository contains codebase for soil texture classification and visualization using ternary diagrams. It provides tools to plot soil texture data on texture triangles and classify soil samples according to different classification systems.
+
+## Features
+
+- **Ternary Plotting**: Visualize soil texture data on interactive ternary diagrams
+- **Multiple Classification Systems**: Support for USDA and HYPRES soil texture classification systems
+- **Interactive Web App**: Streamlit-based application for easy data upload and visualization
+- **Flexible Data Input**: Support for CSV files with customizable column mapping
+- **Point Classification**: Automatic classification of soil samples into texture classes
+- **Customizable Visualization**: Control point sizes, colors, and labels
+
+## Dependencies
+
+- streamlit
+- pandas
+- numpy
+- matplotlib
+- mpltern
+
+## Development
+
+```bash
+# Setup
+uv sync --group dev
+
+# Install git pre-commit hook
+uv run pre-commit install
+
+# Run all pre-commit checks on the repository
+uv run pre-commit run --all-files
+
+# Run one hook manually (example: ruff)
+uv run pre-commit run ruff --all-files
+
+# CI-style check-only quality commands (no auto-fixes)
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check src app
+
+# Run tests
+uv run pytest
+
+# Build
+uv build
+
+# Publish (after updating version in pyproject.toml)
+uv publish
+```
+
+## Release Automation (GitHub Actions)
+
+Publishing is automated via tag-triggered workflows:
+
+- `v*rc*` tags publish to TestPyPI
+- `v*.*.*` tags are evaluated for PyPI; tags containing `rc` are skipped by workflow condition
+
+Both workflows verify that the git tag version matches `uv version --short` before publishing.
+Both workflows also run isolated wheel and source-distribution smoke tests (`import soiltextureplot`) before upload.
+
+### Trusted publishing prerequisites
+
+Before pushing release tags, configure trusted publishing:
+
+1. In GitHub, create environments named `pypi` and `testpypi` under repository settings.
+2. In PyPI project settings, add a trusted publisher matching this repository and the `publish-pypi.yml` workflow.
+3. In TestPyPI project settings, add a trusted publisher matching this repository and the `publish-testpypi.yml` workflow.
+
+### Prerelease to TestPyPI
+
+```bash
+# Example: bump to prerelease version
+uv version 0.1.2rc1
+git add pyproject.toml uv.lock
+git commit -m "Bump version to 0.1.2rc1"
+git push origin dev
+
+# After merge to main, create and push prerelease tag from main
+git checkout main
+git pull
+git tag -a v0.1.2rc1 -m "Release v0.1.2rc1"
+git push origin v0.1.2rc1
+```
+
+Smoke test from TestPyPI:
+
+```bash
+uv run --with "soiltextureplot==0.1.2rc1" --no-project -- python -c "import soiltextureplot"
+```
+
+### Stable release to PyPI
+
+```bash
+# Example: bump stable version
+uv version --bump patch
+git add pyproject.toml uv.lock
+git commit -m "Bump version"
+git push origin dev
+
+# After merge to main, create and push stable tag from main
+git checkout main
+git pull
+git tag -a v0.1.2 -m "Release v0.1.2"
+git push origin v0.1.2
+```
+
+Smoke test from PyPI:
+
+```bash
+uv run --with soiltextureplot --no-project -- python -c "import soiltextureplot"
+```
+
+## Notebook Workflows (Pilot)
+
+During the Marimo pilot, both notebook paths are supported:
+
+- Jupyter notebook remains available at `texture_plot.ipynb`
+- Marimo notebook copy is available at `notebooks/texture_plot_marimo.py`
+- Keep existing `nbqa` checks for `.ipynb` files during this phase
+
+Run the Marimo notebook:
+
+```bash
+uv run marimo edit notebooks/texture_plot_marimo.py
+```
+
+Run the existing Jupyter notebook:
+
+```bash
+uv run jupyter notebook texture_plot.ipynb
+```
+
+
+## Web Application
+
+The web app allows you to:
+- Upload CSV files with soil texture data
+- Map columns to sand, silt, and clay percentages
+- Visualize data on interactive texture triangles
+- Customize plot appearance
+
+## Supported Classification Systems
+
+### USDA (United States Department of Agriculture)
+The standard USDA soil texture classification system with 12 texture classes.
+
+### HYPRES (HYdraulic PRoperties of European Soils)
+A European framework for classifying soils based on their hydrologic properties.
+
+## Data Format
+
+Your CSV file should contain soil texture data with percentages of sand, silt, and clay. The percentages should sum to 100% for each sample.
+
+Example data format:
+
+```csv
+sample_id,sand,silt,clay
+S1,65,20,15
+S2,70,24,6
+S3,75,21,4
+```
+
+## Acknowledgments
+
+- Built using [mpltern](https://github.com/yuzie007/mpltern) for ternary plotting
+- Inspired by soil science classification standards
+- Streamlit for the web interface

soiltextureplot-0.1.3/src/soiltextureplot.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+src/soiltextureplot/__init__.py
+src/soiltextureplot/classifier.py
+src/soiltextureplot/datasets.py
+src/soiltextureplot/plotting.py
+src/soiltextureplot/systems.py
+src/soiltextureplot/triangle.py
+src/soiltextureplot/utils.py
+src/soiltextureplot.egg-info/PKG-INFO
+src/soiltextureplot.egg-info/SOURCES.txt
+src/soiltextureplot.egg-info/dependency_links.txt
+src/soiltextureplot.egg-info/requires.txt
+src/soiltextureplot.egg-info/top_level.txt
+src/soiltextureplot/data/example_soil_data.csv
+tests/test_smoke.py

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot.egg-info/requires.txt

@@ -2,3 +2,6 @@ pandas>=1.5.0
 numpy>=1.23.0
 matplotlib>=3.7.0
 mpltern>=1.0.0
+
+[app]
+streamlit>=1.57.0

soiltextureplot-0.1.3/tests/test_smoke.py

@@ -0,0 +1,60 @@
+import matplotlib
+
+matplotlib.use("Agg")
+
+import matplotlib.pyplot as plt
+import pandas as pd
+from matplotlib.axes import Axes
+from matplotlib.figure import Figure
+
+from soiltextureplot import (
+    PolygonClassifier,
+    TextureSystem,
+    get_texture_system,
+    plot_triangle_with_points,
+)
+from soiltextureplot.systems import list_texture_systems
+from soiltextureplot.triangle import SoilTextureTriangle
+
+
+def _sample_df() -> pd.DataFrame:
+    return pd.DataFrame(
+        {
+            "sample_id": ["S1", "S2", "S3"],
+            "sand": [65.0, 70.0, 35.0],
+            "silt": [20.0, 24.0, 45.0],
+            "clay": [15.0, 6.0, 20.0],
+        }
+    )
+
+
+def test_imports_and_public_symbols_smoke() -> None:
+    assert PolygonClassifier is not None
+    assert TextureSystem is not None
+    assert get_texture_system is not None
+    assert plot_triangle_with_points is not None
+    assert SoilTextureTriangle is not None
+
+
+def test_system_registry_smoke() -> None:
+    systems = list_texture_systems()
+    assert "USDA" in systems
+    assert "HYPRES" in systems
+    assert get_texture_system("USDA").name == "USDA"
+
+
+def test_classification_smoke() -> None:
+    tri = SoilTextureTriangle(system_name="USDA").load_dataframe(_sample_df())
+    out = tri.classify()
+    assert "texture_class" in out.columns
+    assert len(out) == 3
+    assert out["texture_class"].notna().all()
+
+
+def test_plot_smoke() -> None:
+    df = _sample_df()
+    system = get_texture_system("USDA")
+    fig, ax = plot_triangle_with_points(df=df, system=system)
+    assert isinstance(fig, Figure)
+    assert isinstance(ax, Axes)
+    plt.close(fig)

soiltextureplot-0.1.0/PKG-INFO

@@ -1,106 +0,0 @@
-Metadata-Version: 2.4
-Name: soiltextureplot
-Version: 0.1.0
-Summary: Soil texture triangle plotting and classification
-Author-email: Amninder Singh <amnindersingh13@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2025 Amninder Singh
-        
-        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 OR ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/singhamninder/soiltextureplot
-Project-URL: Bug Tracker, https://github.com/singhamninder/soiltextureplot/issues
-Keywords: soil,texture,triangle,plot,classification,ternary
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-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
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pandas>=1.5.0
-Requires-Dist: numpy>=1.23.0
-Requires-Dist: matplotlib>=3.7.0
-Requires-Dist: mpltern>=1.0.0
-Dynamic: license-file
-
-# Soil Texture Plot
-
-[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://soiltextureplot.streamlit.app/)
-
-This repository contains codebase for soil texture classification and visualization using ternary diagrams. It provides tools to plot soil texture data on texture triangles and classify soil samples according to different classification systems.
-
-## Features
-
-- **Ternary Plotting**: Visualize soil texture data on interactive ternary diagrams
-- **Multiple Classification Systems**: Support for USDA and HYPRES soil texture classification systems
-- **Interactive Web App**: Streamlit-based application for easy data upload and visualization
-- **Flexible Data Input**: Support for CSV files with customizable column mapping
-- **Point Classification**: Automatic classification of soil samples into texture classes
-- **Customizable Visualization**: Control point sizes, colors, and labels
-
-## Dependencies
-
-- streamlit
-- pandas
-- numpy
-- matplotlib
-- mpltern
-
-
-## Web Application
-
-The web app allows you to:
-- Upload CSV files with soil texture data
-- Map columns to sand, silt, and clay percentages
-- Visualize data on interactive texture triangles
-- Customize plot appearance
-
-## Supported Classification Systems
-
-### USDA (United States Department of Agriculture)
-The standard USDA soil texture classification system with 12 texture classes.
-
-### HYPRES (HYdraulic PRoperties of European Soils)
-A European framework for classifying soils based on their hydrologic properties.
-
-## Data Format
-
-Your CSV file should contain soil texture data with percentages of sand, silt, and clay. The percentages should sum to 100% for each sample.
-
-Example data format:
-
-```csv
-sample_id,sand,silt,clay
-S1,65,20,15
-S2,70,24,6
-S3,75,21,4
-```
-
-## Acknowledgments
-
-- Built using [mpltern](https://github.com/yuzie007/mpltern) for ternary plotting
-- Inspired by soil science classification standards
-- Streamlit for the web interface

soiltextureplot-0.1.0/README.md

@@ -1,58 +0,0 @@
-# Soil Texture Plot
-
-[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://soiltextureplot.streamlit.app/)
-
-This repository contains codebase for soil texture classification and visualization using ternary diagrams. It provides tools to plot soil texture data on texture triangles and classify soil samples according to different classification systems.
-
-## Features
-
-- **Ternary Plotting**: Visualize soil texture data on interactive ternary diagrams
-- **Multiple Classification Systems**: Support for USDA and HYPRES soil texture classification systems
-- **Interactive Web App**: Streamlit-based application for easy data upload and visualization
-- **Flexible Data Input**: Support for CSV files with customizable column mapping
-- **Point Classification**: Automatic classification of soil samples into texture classes
-- **Customizable Visualization**: Control point sizes, colors, and labels
-
-## Dependencies
-
-- streamlit
-- pandas
-- numpy
-- matplotlib
-- mpltern
-
-
-## Web Application
-
-The web app allows you to:
-- Upload CSV files with soil texture data
-- Map columns to sand, silt, and clay percentages
-- Visualize data on interactive texture triangles
-- Customize plot appearance
-
-## Supported Classification Systems
-
-### USDA (United States Department of Agriculture)
-The standard USDA soil texture classification system with 12 texture classes.
-
-### HYPRES (HYdraulic PRoperties of European Soils)
-A European framework for classifying soils based on their hydrologic properties.
-
-## Data Format
-
-Your CSV file should contain soil texture data with percentages of sand, silt, and clay. The percentages should sum to 100% for each sample.
-
-Example data format:
-
-```csv
-sample_id,sand,silt,clay
-S1,65,20,15
-S2,70,24,6
-S3,75,21,4
-```
-
-## Acknowledgments
-
-- Built using [mpltern](https://github.com/yuzie007/mpltern) for ternary plotting
-- Inspired by soil science classification standards
-- Streamlit for the web interface

soiltextureplot-0.1.0/soiltextureplot.egg-info/PKG-INFO

@@ -1,106 +0,0 @@
-Metadata-Version: 2.4
-Name: soiltextureplot
-Version: 0.1.0
-Summary: Soil texture triangle plotting and classification
-Author-email: Amninder Singh <amnindersingh13@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2025 Amninder Singh
-        
-        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 OR ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/singhamninder/soiltextureplot
-Project-URL: Bug Tracker, https://github.com/singhamninder/soiltextureplot/issues
-Keywords: soil,texture,triangle,plot,classification,ternary
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-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
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pandas>=1.5.0
-Requires-Dist: numpy>=1.23.0
-Requires-Dist: matplotlib>=3.7.0
-Requires-Dist: mpltern>=1.0.0
-Dynamic: license-file
-
-# Soil Texture Plot
-
-[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://soiltextureplot.streamlit.app/)
-
-This repository contains codebase for soil texture classification and visualization using ternary diagrams. It provides tools to plot soil texture data on texture triangles and classify soil samples according to different classification systems.
-
-## Features
-
-- **Ternary Plotting**: Visualize soil texture data on interactive ternary diagrams
-- **Multiple Classification Systems**: Support for USDA and HYPRES soil texture classification systems
-- **Interactive Web App**: Streamlit-based application for easy data upload and visualization
-- **Flexible Data Input**: Support for CSV files with customizable column mapping
-- **Point Classification**: Automatic classification of soil samples into texture classes
-- **Customizable Visualization**: Control point sizes, colors, and labels
-
-## Dependencies
-
-- streamlit
-- pandas
-- numpy
-- matplotlib
-- mpltern
-
-
-## Web Application
-
-The web app allows you to:
-- Upload CSV files with soil texture data
-- Map columns to sand, silt, and clay percentages
-- Visualize data on interactive texture triangles
-- Customize plot appearance
-
-## Supported Classification Systems
-
-### USDA (United States Department of Agriculture)
-The standard USDA soil texture classification system with 12 texture classes.
-
-### HYPRES (HYdraulic PRoperties of European Soils)
-A European framework for classifying soils based on their hydrologic properties.
-
-## Data Format
-
-Your CSV file should contain soil texture data with percentages of sand, silt, and clay. The percentages should sum to 100% for each sample.
-
-Example data format:
-
-```csv
-sample_id,sand,silt,clay
-S1,65,20,15
-S2,70,24,6
-S3,75,21,4
-```
-
-## Acknowledgments
-
-- Built using [mpltern](https://github.com/yuzie007/mpltern) for ternary plotting
-- Inspired by soil science classification standards
-- Streamlit for the web interface

soiltextureplot-0.1.0/soiltextureplot.egg-info/SOURCES.txt

@@ -1,15 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-soiltextureplot/__init__.py
-soiltextureplot/classifier.py
-soiltextureplot/datasets.py
-soiltextureplot/plotting.py
-soiltextureplot/systems.py
-soiltextureplot/triangle.py
-soiltextureplot/utils.py
-soiltextureplot.egg-info/PKG-INFO
-soiltextureplot.egg-info/SOURCES.txt
-soiltextureplot.egg-info/dependency_links.txt
-soiltextureplot.egg-info/requires.txt
-soiltextureplot.egg-info/top_level.txt

{soiltextureplot-0.1.0 → soiltextureplot-0.1.3/src}/soiltextureplot/__init__.py

@@ -21,8 +21,8 @@ utils
 """
 
 from .classifier import PolygonClassifier
-from .systems import TextureSystem, get_texture_system
 from .plotting import plot_triangle_with_points
+from .systems import TextureSystem, get_texture_system
 
 __all__ = [
     "PolygonClassifier",