Release 1.5.0

Bump version to 1.5.0, add changelog entry, and update documentation for the
changes since 1.4.9: motiongram/videogram output files renamed to h/v suffixes
(_mgh/_vgh, _mgv/_vgv) and the new axes=False option on silhouette_waterfall()
and pose_waterfall().

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: alexarje

CHANGELOG.md

@@ -9,6 +9,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.5.0] – 2026-06-27
+
+### Changed
+- **Motiongram/videogram output filenames** now use direction-of-movement suffixes: `_mgh`/`_vgh`
+  (horizontal) and `_mgv`/`_vgv` (vertical), replacing the axis-based `_mgy`/`_vgy` and
+  `_mgx`/`_vgx`. Applied to `motion()`, `motiongrams()`, `videograms()`, `motion_mp()`, and the
+  `ssm()` intermediates. The `show(key=...)` keys (`'horizontal'`/`'vertical'`,
+  `mgh`/`mgv`/`vgh`/`vgv`, and the legacy `mgx`/`mgy`/`vgx`/`vgy`) all still resolve correctly.
+
+### Added
+- `silhouette_waterfall()` and `pose_waterfall()` accept `axes=False` to render without any axes,
+  ticks, labels, panes, or title (a clean 3D image).
+
+---
+
 ## [1.4.9] – 2026-06-27
 
 ### Added
@@ -314,7 +329,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/fourMs/MGT-python/compare/v1.4.9...HEAD
+[Unreleased]: https://github.com/fourMs/MGT-python/compare/v1.5.0...HEAD
+[1.5.0]: https://github.com/fourMs/MGT-python/compare/v1.4.9...v1.5.0
 [1.4.9]: https://github.com/fourMs/MGT-python/compare/v1.4.8...v1.4.9
 [1.4.8]: https://github.com/fourMs/MGT-python/compare/v1.4.7...v1.4.8
 [1.4.7]: https://github.com/fourMs/MGT-python/compare/v1.4.6...v1.4.7

docs/quickstart.md

@@ -216,8 +216,8 @@ MGT-python creates several types of output files:
 
 ### Image Files
 - `*_average.png` - Average of all frames
-- `*_mgx.png` - Horizontal motiongram
-- `*_mgy.png` - Vertical motiongram
+- `*_mgh.png` - Horizontal motiongram
+- `*_mgv.png` - Vertical motiongram
 
 ### Data Files
 - `*_motion.csv` - Numerical motion data

docs/releases.md

@@ -1,6 +1,6 @@
 # Release Notes
 
-The current stable release is **MGT-python 1.4.9**.
+The current stable release is **MGT-python 1.5.0**.
 
 Install or upgrade from PyPI:
 
@@ -16,6 +16,12 @@ which is the single source of truth for release notes.
 
 ## Recent highlights
 
+### 1.5.0
+
+- Motiongram/videogram output files now use `_mgh`/`_vgh` (horizontal) and `_mgv`/`_vgv`
+  (vertical) suffixes instead of the axis-based `_mgx`/`_mgy`/`_vgx`/`_vgy`.
+- `silhouette_waterfall()` and `pose_waterfall()` gain `axes=False` for a clean, label-free 3D render.
+
 ### 1.4.9
 
 - `pose_waterfall()` gains `'markers'`, `'skeleton'`, and `'both'` styles (in addition to

docs/user-guide/video-analysis.md

@@ -117,6 +117,7 @@ mv.stroboscope(n_samples=12).show()
 
 # 3D silhouette waterfall — silhouette profile cascading along a time axis
 mv.silhouette_waterfall(n_samples=40, axis='horizontal').show()
+mv.silhouette_waterfall(axes=False).show()   # clean render, no axes/labels/title
 
 # Motion History Image — intensity = how recently motion happened (no silhouette needed)
 mv.motionhistory().show()
@@ -416,6 +417,7 @@ wf = mv.pose_waterfall(color_by='time')        # colour follows time along each
 wf = mv.pose_waterfall(markers=['left_wrist', 'right_wrist'], cmap='viridis')
 wf = mv.pose_waterfall(style='skeleton')       # skeleton joint lines at sampled time slices
 wf = mv.pose_waterfall(style='markers', n_samples=60)
+wf = mv.pose_waterfall(axes=False)             # clean render, no axes/labels
 wf.show()
 ```
 
@@ -430,6 +432,7 @@ wf.show()
 - `color_by`: `'marker'` (one colour per marker) or `'time'` (colour follows time). Defaults to `'marker'` for `'trajectories'` and to `'time'` for the slice styles.
 - `cmap`: matplotlib colormap (`'hsv'` default); `dpi` (default `200`); `lw` line width (default `1.0`)
 - `elev`/`azim`: 3D view angles (defaults `20` / `-60`)
+- `axes`: set to `False` to render without any axes, ticks, labels, or panes (a clean 3D image). Defaults to `True`. (`silhouette_waterfall()` accepts the same `axes` option.)
 - plus the usual `target_name`, `overwrite`, and forwarded `**pose_kwargs` (e.g. `model`, `device`)
 
 ---

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "musicalgestures"
-version = "1.4.9"
+version = "1.5.0"
 description = "Musical Gestures Toolbox for Python"
 readme = "README.md"
 license = {text = "GPL-3.0-or-later"}