spmkit 0.1.0__tar.gz

spmkit-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+---
+name: Reporte de bug
+about: Informar un problema para ayudarnos a mejorar spmkit
+title: "[BUG] "
+labels: bug
+---
+
+**Descripción**
+Qué pasó y qué esperabas que pasara.
+
+**Pasos para reproducir**
+1. ...
+2. ...
+
+**Archivo de ejemplo**
+Si es posible, adjunta un archivo sintético mínimo que reproduzca el bug
+(no subas datos del instrumento sin permiso).
+
+**Entorno**
+- spmkit: (ej. `spmkit --version`)
+- SO: (ej. macOS 14, Ubuntu 22.04)
+- Python: (ej. 3.12)
+- Instalación: `pip` / `uv`, con extras `[...]`
+
+**Traza / salida**
+```
+pega aquí el error
+```

spmkit-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Solicitud de feature
+about: Proponer una idea o mejora para spmkit
+title: "[FEATURE] "
+labels: enhancement
+---
+
+**¿Qué problema resuelve?**
+Describe el caso de uso científico o de flujo de trabajo.
+
+**Propuesta**
+Qué te gustaría que hiciera spmkit.
+
+**Alternativas**
+Otras formas en que lo resuelves hoy (ej. Gwyddion, scripts).
+
+**Contexto**
+Instrumento, formato de archivo, técnica (AFM/KPFM/nanomecánica), etc.

spmkit-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,26 @@
+## Descripción
+
+Qué cambia y por qué.
+
+## Tipo de cambio
+
+- [ ] Bugfix
+- [ ] Nueva feature
+- [ ] Soporte de formato/instrumento
+- [ ] Documentación
+- [ ] Refactor / mantenimiento
+
+## Checklist
+
+- [ ] `ruff check src tests` pasa
+- [ ] `black --check src tests` pasa
+- [ ] `mypy src` pasa
+- [ ] `pytest` pasa
+- [ ] Agregué/actualicé tests (y `tests/validation/` si toqué manejo de datos)
+- [ ] La lógica de análisis vive en `core/` (CLI/GUI solo orquestan)
+- [ ] No subo datos del instrumento
+
+## Notas de validación científica
+
+Si cambiaste parsers/conversión/orientación, ¿cómo verificaste que sigue
+siendo correcto?

spmkit-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Create venv
+        run: uv venv --python 3.12
+      - name: Install dev deps
+        run: uv pip install -e ".[dev]"
+      - name: Ruff (lint)
+        run: uv run ruff check src tests
+      - name: Black (format check)
+        run: uv run black --check src tests
+      - name: Mypy (types)
+        run: uv run mypy src
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Create venv (Python ${{ matrix.python-version }})
+        run: uv venv --python ${{ matrix.python-version }}
+      - name: Install package + test deps
+        run: uv pip install -e ".[dev,hdf5,gwy,report]"
+      - name: Run tests (core + ciencia; los de GUI se omiten sin Qt)
+        run: uv run pytest

spmkit-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish to PyPI
+
+# Publica en PyPI al crear un Release de GitHub, usando Trusted Publishing
+# (OIDC, sin tokens). Requiere configurar el publisher en pypi.org una vez:
+#   PyPI → tu cuenta → Publishing → Add pending publisher
+#     Project: spmkit · Owner: kegouro · Repo: spmkit
+#     Workflow: publish.yml · Environment: pypi
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Build sdist + wheel
+        run: uv build
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # necesario para Trusted Publishing (OIDC)
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

spmkit-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# OS
+.DS_Store
+
+# Reference material (datos de instrumento, no versionar grandes binarios)
+reference/
+
+# IDE
+.idea/
+.vscode/
+
+# Capturas de UI (preview local)
+ui_preview/

spmkit-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.11.2
+    hooks:
+      - id: mypy
+        additional_dependencies: ["numpy>=1.24"]
+        args: [--ignore-missing-imports]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=2000]

spmkit-0.1.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+Todos los cambios notables de este proyecto se documentan aquí.
+El formato sigue [Keep a Changelog](https://keepachangelog.com/es/1.1.0/) y
+el versionado es [SemVer](https://semver.org/lang/es/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-15
+
+### Añadido
+- Lectura de NanoSurf `.nid` (validada contra Gwyddion) y `.nhf`; interop
+  Gwyddion `.gwy` (lectura/escritura vía `gwyfile`).
+- Análisis: rugosidad ISO 25178, nivelación, perfiles de línea, KPFM (CPD /
+  función de trabajo) y nanomecánica (Hertz/Sneddon, mapas de módulo/adhesión).
+- Visualización: figuras de publicación con colormaps científicos (incluido el
+  dorado estilo NanoSurf), barra de escala, editor WYSIWYG con textos
+  arrastrables y rango de color `vmin/vmax`.
+- Comparación multi-archivo (2–4) con colorbar y escala compartidas.
+- Reportes HTML, procesamiento por lotes, exportación CSV/JSON/HDF5/PNG/SVG/PDF.
+- GUI por pestañas (Visor · Nanomecánica · Editor · Comparar) con tema
+  claro/oscuro persistente, atajos de teclado, recientes, drag & drop y
+  diálogo de bienvenida.
+- CLI `spmkit` (info, roughness, analyze, nanomech, batch, figure, convert, gui).
+
+### Validado
+- Lectura del `.nid` exacta a precisión de máquina contra el export `.gwy` del
+  lab; orientación de imagen consistente con Gwyddion/NanoSurf.
+
+[Unreleased]: https://github.com/kegouro/spmkit/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/kegouro/spmkit/releases/tag/v0.1.0

spmkit-0.1.0/CITATION.cff

@@ -0,0 +1,28 @@
+cff-version: 1.2.0
+title: "spmkit: Analizador open-source de datos AFM/KPFM"
+message: "Si usas este software en tu investigación, por favor cítalo."
+type: software
+authors:
+  - family-names: Labarca
+    given-names: José
+    affiliation: "Universidad Técnica Federico Santa María (UTFSM)"
+  - family-names: Corrales
+    given-names: Tomás
+    affiliation: "Universidad Técnica Federico Santa María (UTFSM)"
+    orcid: ""
+abstract: >-
+  spmkit es una herramienta open-source para el análisis de datos de
+  microscopía de sonda de barrido (SPM), incluyendo AFM y KPFM. Lee
+  formatos NanoSurf (.nid, .nhf), calcula rugosidad, perfiles de línea,
+  estadísticas KPFM (CPD) y exporta a formatos abiertos (CSV, HDF5, JSON).
+keywords:
+  - AFM
+  - KPFM
+  - SPM
+  - NanoSurf
+  - microscopy
+  - roughness
+license: MIT
+version: 0.1.0
+date-released: "2026-06-14"
+repository-code: "https://github.com/kegouro/spmkit"

spmkit-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contribuir a spmkit
+
+¡Gracias por tu interés! spmkit es desarrollado por el SPM Lab de la UTFSM y
+recibe contribuciones de la comunidad.
+
+## Preparar el entorno
+
+```bash
+git clone https://github.com/kegouro/spmkit
+cd spmkit
+uv pip install -e ".[dev,gui,hdf5,gwy,report,test-gui]"   # o pip
+pre-commit install
+```
+
+> Los tests de la GUI requieren los extras `gui` + `test-gui` (PyQt6 + pytest-qt)
+> y un entorno con Qt; en CI se omiten automáticamente (la ciencia sí se prueba).
+
+## Principios de diseño
+
+spmkit separa estrictamente tres capas (ver [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)):
+
+- **`core/`** — puro Python, sin dependencias de UI. Toda la ciencia vive aquí.
+- **`cli/`** y **`gui/`** — solo orquestan/presentan; nunca implementan análisis
+  ni tocan parsers directamente.
+
+Si agregas análisis, va en `core/` con su test. La CLI/GUI solo lo invocan.
+
+## Antes de abrir un PR
+
+Todo lo que corre CI debe pasar localmente:
+
+```bash
+ruff check src tests      # lint
+black --check src tests   # formato
+mypy src                  # tipos
+pytest                    # tests (+ cobertura)
+```
+
+- **Tests con datos**: usa datos sintéticos (ver `tests/conftest.py`). No
+  subas archivos del instrumento (`reference/` está en `.gitignore`).
+- **Confianza científica**: si tocas el manejo de datos (parsers, conversión
+  de unidades, orientación), agrega o actualiza una prueba en
+  `tests/validation/` y documenta el porqué. Ver [docs/VALIDATION.md](docs/VALIDATION.md).
+- Mantén el estilo del código vecino (nombres, docstrings en español).
+
+## Formatos e instrumentos nuevos
+
+Para soportar un formato, agrega un parser en `core/io/` que devuelva un
+`SPMData`, regístralo en `core/io/registry.py` y valídalo contra una
+referencia conocida (otra herramienta o un archivo de especificación).
+
+## Reportar bugs / pedir features
+
+Usa las plantillas de issues. Incluye versión de spmkit, SO, y pasos para
+reproducir (o un archivo sintético mínimo).

spmkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SPM Lab UTFSM - Prof. Tomás Corrales, José Labarca
+
+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.

spmkit-0.1.0/Makefile

@@ -0,0 +1,34 @@
+.PHONY: help install dev test lint format type check gui clean
+
+help:  ## Muestra esta ayuda
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+		awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-12s\033[0m %s\n", $$1, $$2}'
+
+install:  ## Instala el paquete (núcleo + CLI)
+	uv pip install -e .
+
+dev:  ## Instala con extras de desarrollo y hooks
+	uv pip install -e ".[dev,gui,hdf5]"
+	pre-commit install
+
+test:  ## Corre los tests con cobertura
+	pytest
+
+lint:  ## Linting con ruff
+	ruff check src tests
+
+format:  ## Formatea con black + ruff
+	black src tests
+	ruff check src tests --fix
+
+type:  ## Chequeo de tipos con mypy
+	mypy src
+
+check: lint type test  ## Lint + tipos + tests (lo que corre CI)
+
+gui:  ## Lanza la interfaz gráfica
+	spmkit gui
+
+clean:  ## Limpia cachés y artefactos
+	rm -rf .pytest_cache .mypy_cache .ruff_cache htmlcov .coverage dist build
+	find . -type d -name __pycache__ -exec rm -rf {} +

spmkit-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: spmkit
+Version: 0.1.0
+Summary: Analizador open-source de datos AFM/KPFM para microscopía de sonda de barrido (SPM)
+Project-URL: Homepage, https://github.com/kegouro/spmkit
+Project-URL: Repository, https://github.com/kegouro/spmkit
+Project-URL: Issues, https://github.com/kegouro/spmkit/issues
+Author: Tomás Corrales
+Author-email: José Labarca <joselabarcabaeza11@hotmail.com>
+Maintainer: SPM Lab UTFSM
+License: MIT
+License-File: LICENSE
+Keywords: afm,kpfm,microscopy,nanosurf,nid,roughness,spm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.24
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Provides-Extra: all
+Requires-Dist: cmcrameri>=1.7; extra == 'all'
+Requires-Dist: gwyfile>=0.3; extra == 'all'
+Requires-Dist: h5py>=3.8; extra == 'all'
+Requires-Dist: jinja2>=3.1; extra == 'all'
+Requires-Dist: matplotlib-scalebar>=0.8; extra == 'all'
+Requires-Dist: matplotlib>=3.8; extra == 'all'
+Requires-Dist: nsfopen>=2.2; extra == 'all'
+Requires-Dist: pyqt6>=6.6; extra == 'all'
+Requires-Dist: pyqtgraph>=0.13; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Provides-Extra: gui
+Requires-Dist: cmcrameri>=1.7; extra == 'gui'
+Requires-Dist: matplotlib-scalebar>=0.8; extra == 'gui'
+Requires-Dist: matplotlib>=3.8; extra == 'gui'
+Requires-Dist: pyqt6>=6.6; extra == 'gui'
+Requires-Dist: pyqtgraph>=0.13; extra == 'gui'
+Provides-Extra: gwy
+Requires-Dist: gwyfile>=0.3; extra == 'gwy'
+Provides-Extra: hdf5
+Requires-Dist: h5py>=3.8; extra == 'hdf5'
+Provides-Extra: nanosurf
+Requires-Dist: nsfopen>=2.2; extra == 'nanosurf'
+Provides-Extra: report
+Requires-Dist: cmcrameri>=1.7; extra == 'report'
+Requires-Dist: jinja2>=3.1; extra == 'report'
+Requires-Dist: matplotlib-scalebar>=0.8; extra == 'report'
+Requires-Dist: matplotlib>=3.8; extra == 'report'
+Provides-Extra: test-gui
+Requires-Dist: pytest-qt>=4.4; extra == 'test-gui'
+Provides-Extra: viz
+Requires-Dist: cmcrameri>=1.7; extra == 'viz'
+Requires-Dist: matplotlib-scalebar>=0.8; extra == 'viz'
+Requires-Dist: matplotlib>=3.8; extra == 'viz'
+Description-Content-Type: text/markdown
+
+# spmkit
+
+[![CI](https://github.com/kegouro/spmkit/actions/workflows/ci.yml/badge.svg)](https://github.com/kegouro/spmkit/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/spmkit.svg)](https://pypi.org/project/spmkit/)
+[![Python](https://img.shields.io/pypi/pyversions/spmkit.svg)](https://pypi.org/project/spmkit/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
+Analizador **open-source** de datos de microscopía de sonda de barrido (SPM),
+con foco en **AFM** y **KPFM**. Desarrollado en el **SPM Lab de la UTFSM**.
+
+Lee formatos NanoSurf (`.nid`, `.nhf`) y Gwyddion (`.gwy`), calcula rugosidad,
+perfiles de línea, KPFM (CPD / función de trabajo) y nanomecánica, y exporta a
+formatos abiertos (CSV, HDF5, JSON, figuras). Incluye CLI y una GUI científica
+(PyQt6 + pyqtgraph).
+
+![spmkit GUI](docs/images/screenshot_viewer.png)
+
+> _Captura con datos sintéticos de ejemplo._
+
+## Tabla de contenidos
+
+- [Capacidades](#capacidades) · [Instalación](#instalación) · [Uso rápido](#uso-rápido)
+- [Formatos](#formatos-soportados) · [Arquitectura](#arquitectura) ·
+  [Validación científica](docs/VALIDATION.md) · [Desarrollo](#desarrollo) ·
+  [Contribuir](CONTRIBUTING.md) · [Citación](#citación)
+
+## Arquitectura
+
+Separación estricta en tres capas. CLI y GUI **solo** usan la API pública del
+`core`; nunca tocan parsers ni implementan análisis.
+
+```
+┌───────────────┐     ┌───────────────┐
+│   cli/        │     │   gui/        │   ← capas de presentación
+│ (typer+rich)  │     │ (PyQt6+pg)    │
+└───────┬───────┘     └───────┬───────┘
+        │   importan funciones del core   │
+        └───────────────┬─────────────────┘
+                        ▼
+        ┌───────────────────────────────┐
+        │            core/              │   ← puro Python, sin UI
+        │  io · models · analysis · export │
+        └───────────────────────────────┘
+                        ▲
+        .nid / .nhf  ───┘  (archivos del instrumento)
+```
+
+## Instalación
+
+```bash
+# Recomendado: con uv
+uv pip install spmkit            # núcleo + CLI
+uv pip install "spmkit[gui]"     # + interfaz gráfica (PyQt6, incluye viz)
+uv pip install "spmkit[viz]"     # + figuras de publicación (matplotlib, colormaps, scale bar)
+uv pip install "spmkit[gwy]"     # + interop Gwyddion (.gwy)
+uv pip install "spmkit[hdf5]"    # + lectura/exportación HDF5
+uv pip install "spmkit[report]"  # + reportes HTML/PDF
+uv pip install "spmkit[nanosurf]"# + lector .nhf validado (NSFopen)
+uv pip install "spmkit[all]"     # todo
+
+# Desarrollo (desde el repo)
+uv pip install -e ".[dev,gui,hdf5,gwy,report]"
+pre-commit install
+```
+
+> También funciona con `pip` clásico (`pip install spmkit`). El build backend es
+> `hatchling`, moderno y compatible.
+
+## Uso rápido
+
+### CLI
+
+```bash
+spmkit info scan.nid                          # metadatos y canales
+spmkit roughness scan.nid -c Z-Axis           # rugosidad (ISO 25178)
+spmkit analyze scan.nid -o ./results/         # pipeline completo → CSV+JSON
+spmkit nanomech spec.nid --tip-radius 10e-9   # ajuste Hertz → módulo de Young
+spmkit batch ./carpeta/ -o resumen.csv        # procesa una carpeta completa
+spmkit figure scan.nid -o fig.svg --colormap batlow   # figura de publicación
+spmkit convert scan.nid scan.gwy              # convierte a Gwyddion (.gwy)
+spmkit gui                                     # interfaz gráfica
+```
+
+### Como librería
+
+```python
+from spmkit import load
+from spmkit.core.analysis import leveling, roughness, profiles, kpfm
+
+data = load("scan.nid")
+print(data.names)                       # ['Z-Axis', 'CPD', 'Amplitude', ...]
+
+ch    = data["Z-Axis"]
+flat  = leveling.plane_fit(ch)          # corrige inclinación
+stats = roughness.statistics(flat)      # Sa, Sq, Sz, Ssk, Sku
+print(stats.Sq, stats.unit)
+
+line  = profiles.line(flat, (0, 0), (100, 100))   # perfil de línea
+cpd   = kpfm.statistics(data["CPD"], tip_work_function=5.0)
+```
+
+## Capacidades
+
+- **Lectura**: NanoSurf `.nid` (validado), `.nhf` (HDF5) y Gwyddion `.gwy`.
+- **Análisis**: rugosidad ISO 25178, nivelación, perfiles, KPFM (CPD/función de
+  trabajo) y **nanomecánica** (curvas fuerza-distancia, Hertz/Sneddon → módulo
+  de Young, punto de contacto, adhesión).
+- **Interop Gwyddion**: lee/escribe `.gwy` (pure-Python) y abre el archivo en
+  Gwyddion con un clic.
+- **Figuras de publicación**: editor WYSIWYG (título, ejes, colormaps
+  científicos, barra de escala, anotaciones arrastrables) → PNG/SVG/PDF.
+- **Quality of life**: procesamiento por lotes, reportes HTML/PDF, archivos
+  recientes, drag & drop, tema claro/oscuro.
+
+## Formatos soportados
+
+| Formato | Extensión | Estado |
+|---------|-----------|--------|
+| NanoSurf clásico | `.nid` | ✅ Lectura completa (validado) |
+| NanoSurf HDF5 | `.nhf` | 🧪 Experimental (`[hdf5]` o `[nanosurf]`) |
+| Gwyddion | `.gwy` | ✅ Lectura y escritura (`[gwy]`) |
+| Exportación | `.csv`, `.json`, `.h5`, `.png/.svg/.pdf` | ✅ |
+
+## Desarrollo
+
+```bash
+pytest                  # tests + cobertura
+ruff check src tests    # lint
+black src tests         # formato
+mypy src                # tipos
+```
+
+## Citación
+
+Si usas spmkit en tu investigación, cítalo según [`CITATION.cff`](CITATION.cff).
+
+## Licencia
+
+MIT © 2026 SPM Lab UTFSM — Prof. Tomás Corrales, José Labarca.