chore: release 1.9.0 — version bump, CHANGELOG promotion, PyPI install docs

Bump pyproject + __init__ fallback + CITATION.cff to 1.9.0 (2026-05-22); promote CHANGELOG [Unreleased] -> [1.9.0]. Minor bump: new public allow_legacy_pickle keyword + legacy-NPZ refuse-by-default behaviour change (precedent: 1.6.0 minor for keyword additions). Also correct README + installation.rst, which wrongly said pre-release/not-on-PyPI (pybmodes 1.8.1 is already published); restore PyPI-first install guidance.

Author: SMI-Lab-Inha

CHANGELOG.md

@@ -8,6 +8,10 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+(nothing yet)
+
+## [1.9.0] — 2026-05-22
+
 Static-review follow-up on top of 1.8.1. No numerical change; the only
 public-API change is one new opt-in keyword (``allow_legacy_pickle``).
 Security, release-integrity, validation-coverage, and source-quality

CITATION.cff

@@ -22,8 +22,8 @@ authors:
     email: jaehoon.seo@inha.ac.kr
     affiliation: "Marine Structural Mechanics and Integrity Lab (SMI Lab), Inha University"
     orcid: "https://orcid.org/0000-0003-1047-2119" 
-version: 1.8.1
-date-released: "2026-05-21"
+version: 1.9.0
+date-released: "2026-05-22"
 license: Apache-2.0
 repository-code: "https://github.com/SMI-Lab-Inha/pyBModes"
 url: "https://github.com/SMI-Lab-Inha/pyBModes"

README.md

@@ -43,21 +43,19 @@ python -m http.server -d docs/_build/html
 
 ## Install
 
-> **PyPI status: pre-release.** The `pybmodes` distribution is not yet published to PyPI — that's tracked as a 1.x release-gate item. Until the first PyPI release lands, install from source:
-
 ```bash
-git clone https://github.com/SMI-Lab-Inha/pyBModes.git
-cd pyBModes
-pip install -e ".[dev,plots]"
+pip install pybmodes
 ```
 
-Once published, the canonical install will be the standard one:
+That installs the runtime core (`numpy` + `scipy`). Add an extra for optional features — `[plots]`, `[windio]`, `[notebook]`, `[docs]` (matrix below). For a source / editable checkout (contributors, or tracking `master`):
 
 ```bash
-pip install pybmodes        # (post-PyPI-release; not available yet)
+git clone https://github.com/SMI-Lab-Inha/pyBModes.git
+cd pyBModes
+pip install -e ".[dev,plots]"
 ```
 
-Take care that **`pybmodes` is a different project from `pyModeS`** (an ADS-B / Mode-S decoder). When the PyPI release lands the project name on PyPI will be `pybmodes` (lowercase, no S); double-check the package name + the GitHub `SMI-Lab-Inha/pyBModes` repo URL before installing.
+Take care that **`pybmodes` is a different project from `pyModeS`** (an ADS-B / Mode-S decoder). The PyPI name is `pybmodes` (lowercase, no S); double-check the package name + the GitHub `SMI-Lab-Inha/pyBModes` repo URL before installing.
 
 See [`https://pybmodes.readthedocs.io/en/latest/installation.html`](https://pybmodes.readthedocs.io/en/latest/installation.html) for the full Windows + conda quickstart and the optional-extras matrix (`[plots]`, `[windio]`, `[notebook]`, `[docs]`).
 

docs/installation.rst

@@ -7,40 +7,15 @@ notebook execution, WindIO ingestion, this documentation site —
 is gated behind an extra so the default install footprint stays
 small.
 
-.. note::
-
-   **PyPI status: pre-release.** ``pybmodes`` is not yet published to
-   PyPI — that is tracked as a 1.x release-gate item. Until the first
-   release lands, install **from source** (below); the *From PyPI*
-   section applies once publishing is live.
-
-From source (editable)
-----------------------
-
-The supported path today, for users and contributors alike:
-
-.. code-block:: bash
-
-   git clone https://github.com/SMI-Lab-Inha/pyBModes.git
-   cd pyBModes
-   pip install -e ".[dev,plots]"
-
-``-e`` installs in editable mode — changes to ``src/pybmodes/*.py``
-take effect on the next import without re-installing. End users who
-don't need the test/lint extras can install the runtime core alone
-with ``pip install .``.
-
-From PyPI (after the first release)
------------------------------------
-
-Once ``pybmodes`` is published to PyPI, the standard install will be:
+From PyPI
+---------
 
 .. code-block:: bash
 
    pip install pybmodes
 
-That will pull in the runtime dependencies (``numpy>=1.26``,
-``scipy>=1.11``) and expose:
+This pulls in the runtime dependencies (``numpy>=1.26``,
+``scipy>=1.11``) and exposes:
 
 - The Python package: ``import pybmodes``
 - The CLI: ``pybmodes`` on ``PATH`` (seven subcommands — see
@@ -53,9 +28,25 @@ To pin a specific release in a requirements file or a
 
 .. code-block:: text
 
-   pybmodes ==1.7.0       # exact pin
-   pybmodes ~=1.7         # latest 1.7.x, blocks 2.x
-   pybmodes >=1.7,<2      # 1.7+ but never a major bump
+   pybmodes ==1.9.0       # exact pin
+   pybmodes ~=1.9         # latest 1.9.x, blocks 2.x
+   pybmodes >=1.9,<2      # 1.9+ but never a major bump
+
+From source (editable)
+----------------------
+
+For contributors and anyone tracking ``master``:
+
+.. code-block:: bash
+
+   git clone https://github.com/SMI-Lab-Inha/pyBModes.git
+   cd pyBModes
+   pip install -e ".[dev,plots]"
+
+``-e`` installs in editable mode — changes to ``src/pybmodes/*.py``
+take effect on the next import without re-installing. End users who
+don't need the test/lint extras can install the runtime core alone
+with ``pip install .``.
 
 Optional extras
 ---------------

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pybmodes"
-version = "1.8.1"
+version = "1.9.0"
 description = "Python finite-element library for wind turbine blade and tower modal analysis (OpenFAST/ElastoDyn)"
 readme = "README.md"
 license = { file = "LICENSE" }

src/pybmodes/__init__.py

@@ -178,7 +178,7 @@
 try:
     __version__ = version("pybmodes")
 except PackageNotFoundError:
-    __version__ = "1.8.1-dev"
+    __version__ = "1.9.0-dev"
 
 __all__ = [
     "CheckOptions",