smopt

Stiefel Manifold Optimization: Penalty-Free First-Order Solvers

smopt minimizes a smooth function, optionally plus a nonsmooth regularizer, over the matrices with orthonormal columns:

$$ \min_{X \in \mathbb{R}^{n\times p}} f(X) + r(X) \quad \text{subject to} \quad X^\top X = I_p. $$

The solvers are penalty-free first-order methods. Rather than retracting along geodesics, they work in the ambient space and dissolve the orthogonality constraint with a cheap feasibility restoring map, so an iteration costs little more than a gradient evaluation and a couple of small matrix products.

Everything numerical — the manifold geometry, the proximal operators, the Barzilai-Borwein step sizes and the solver loops themselves — is written in Fortran 77 and reached through f2py. Python supplies the objective through a callback and handles reporting. NumPy is the only runtime dependency; the extension links against nothing but the Fortran runtime.

Quick example

import numpy as np
from smopt import slpg_smooth, Stiefel

n, p = 1000, 10
M = Stiefel(n, p)
A = np.diag(np.arange(n, dtype=float))


def obj_fun(X):
    """Return the objective and its Euclidean gradient together."""
    AX = A @ X
    return float(np.sum(X * AX)), 2.0 * AX


X, out = slpg_smooth(obj_fun, M)
print(out["fval"], out["fea"])

Solvers

Name	Comment	Call
`slpg_smooth`	penalty-free first-order method for smooth problems	`slpg_smooth(obj_fun, M)`
`slpg`	penalty-free first-order method for nonsmooth problems	`slpg(obj_fun, M, prox=...)`
`slpg_l21`	penalty-free first-order method for $\ell_{2,1}$ regularized problems	`slpg_l21(obj_fun, M, gamma=...)`
`pencf`	constraint dissolving penalty method	`pencf(xinit, obj_fun, M)`

Every solver returns (X, out), where out carries the fvals, kkts and feas histories together with the final fval, kkt and fea.

Installation

pip install smopt

Requires Python 3.10+ and NumPy. See the full installation guide for uv, poetry, and source builds.

Building from source additionally needs a Fortran compiler; the wheels carry the Fortran runtime, so installing one does not.

Layout

src/
  smblas.f      dense kernels: matmul, Cholesky, Jacobi eigensolver, Gram-Schmidt
  smman.f       Stiefel geometry: C, JA, JC, the A map, the polar retraction
  smprox.f      proximal operators and the l_{2,1} multiplier
  smslpg.f      the SLPG solver drivers and the Arrow-Hurwicz inner iteration
  smpencf.f     the pencf driver
  _smopt.pyf    f2py signatures binding the above to Python
  smopt/        the thin Python layer: argument marshalling and reporting
tests/
  reference.py  a NumPy transcription of the algorithm, used as a test oracle

Documentation

Theory — the manifold, the constraint dissolving map, the algorithms
Quickstart — runnable examples
API Reference — class and function signatures and arguments
References — literature citations

Acknowledgement

The algorithm ported here originates in the STOP toolbox by Nachuan Xiao, Lei Wang, Bin Gao, Xin Liu and Ya-xiang Yuan (https://stmopt.gitee.io/). smopt re-implements its numerics in Fortran 77 behind the same solver interface.

License

GNU General Public License v3 (GPLv3) — see LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

smopt-0.1.1-cp315-cp315t-win_amd64.whl (109.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tWindows x86-64

smopt-0.1.1-cp315-cp315t-musllinux_1_2_x86_64.whl (73.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmusllinux: musl 1.2+ x86-64

smopt-0.1.1-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (71.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmanylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp315-cp315t-macosx_15_0_arm64.whl (59.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmacOS 15.0+ ARM64

smopt-0.1.1-cp315-cp315-win_amd64.whl (108.8 kB view details)

Uploaded Aug 25, 2026 CPython 3.15Windows x86-64

smopt-0.1.1-cp315-cp315-musllinux_1_2_x86_64.whl (72.5 kB view details)

Uploaded Aug 25, 2026 CPython 3.15musllinux: musl 1.2+ x86-64

smopt-0.1.1-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (71.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.15manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp315-cp315-macosx_15_0_arm64.whl (58.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.15macOS 15.0+ ARM64

smopt-0.1.1-cp314-cp314t-win_amd64.whl (109.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tWindows x86-64

smopt-0.1.1-cp314-cp314t-musllinux_1_2_x86_64.whl (73.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmusllinux: musl 1.2+ x86-64

smopt-0.1.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (71.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmanylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp314-cp314t-macosx_15_0_arm64.whl (59.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmacOS 15.0+ ARM64

smopt-0.1.1-cp314-cp314-win_amd64.whl (108.8 kB view details)

Uploaded Aug 25, 2026 CPython 3.14Windows x86-64

smopt-0.1.1-cp314-cp314-musllinux_1_2_x86_64.whl (72.5 kB view details)

Uploaded Aug 25, 2026 CPython 3.14musllinux: musl 1.2+ x86-64

smopt-0.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (71.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp314-cp314-macosx_15_0_arm64.whl (58.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.14macOS 15.0+ ARM64

smopt-0.1.1-cp313-cp313-win_amd64.whl (106.2 kB view details)

Uploaded Aug 25, 2026 CPython 3.13Windows x86-64

smopt-0.1.1-cp313-cp313-musllinux_1_2_x86_64.whl (72.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

smopt-0.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (71.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp313-cp313-macosx_15_0_arm64.whl (58.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.13macOS 15.0+ ARM64

smopt-0.1.1-cp312-cp312-win_amd64.whl (106.2 kB view details)

Uploaded Aug 25, 2026 CPython 3.12Windows x86-64

smopt-0.1.1-cp312-cp312-musllinux_1_2_x86_64.whl (72.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

smopt-0.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (71.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp312-cp312-macosx_15_0_arm64.whl (58.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.12macOS 15.0+ ARM64

smopt-0.1.1-cp311-cp311-win_amd64.whl (105.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.11Windows x86-64

smopt-0.1.1-cp311-cp311-musllinux_1_2_x86_64.whl (71.8 kB view details)

Uploaded Aug 25, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

smopt-0.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (70.3 kB view details)

Uploaded Aug 25, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp311-cp311-macosx_15_0_arm64.whl (57.8 kB view details)

Uploaded Aug 25, 2026 CPython 3.11macOS 15.0+ ARM64

smopt-0.1.1-cp310-cp310-win_amd64.whl (103.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.10Windows x86-64

smopt-0.1.1-cp310-cp310-musllinux_1_2_x86_64.whl (69.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

smopt-0.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (68.0 kB view details)

Uploaded Aug 25, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

smopt-0.1.1-cp310-cp310-macosx_15_0_arm64.whl (56.0 kB view details)

Uploaded Aug 25, 2026 CPython 3.10macOS 15.0+ ARM64

File details

Details for the file smopt-0.1.1-cp315-cp315t-win_amd64.whl.

File metadata

Download URL: smopt-0.1.1-cp315-cp315t-win_amd64.whl
Upload date: Aug 25, 2026
Size: 109.7 kB
Tags: CPython 3.15t, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for smopt-0.1.1-cp315-cp315t-win_amd64.whl
Algorithm	Hash digest
SHA256	`de06394521ae7b34b5e138c8b574b99e40b4d357352b142c5efae0562510c8db`
MD5	`65a19ee36cc8241da4555dd3da4ee0ab`
BLAKE2b-256	`0444ba4756ee5e0ac6a424da1954dd2ea20186e7952e390ab67c0046b501fd44`

Algorithm	Hash digest
SHA256	`5919894bfb4fac753f5fcd3fa426007406ac4909f397c057e77d1753eb516f90`
MD5	`6160c4de1d5858870646a7f7971aed59`
BLAKE2b-256	`5e3be2932583eb1d0520dcf49fe6e4c4ead97afa8e68e7975a005ca5fc0f8681`

Algorithm	Hash digest
SHA256	`2746d65e83bb2ce7d41f6784edd4428eed16bb03e06c295ad92ef2128fefd237`
MD5	`6522a6ff73fc8d68ab8ce42feb9b860d`
BLAKE2b-256	`ed3de1b0b0aa5ea8135f3ac26ba379044c51c46f8eea913c968da737ad18abf3`

Algorithm	Hash digest
SHA256	`255128433751a4a63b97c71ef3f9b89e11bea41d364257984038184f59224127`
MD5	`31b538995009f44493a6b2a03ebb61fd`
BLAKE2b-256	`e7fd109d08af16a229302fd031ec87d8708f0e4bfb287206f5b9b5dbcbece470`

Algorithm	Hash digest
SHA256	`4c806d9b13d4a35d9ea4c0c65c8766806aa12aed3c07e4faecf6c021b3bbc611`
MD5	`b89a95622785e2278472cce41de02abf`
BLAKE2b-256	`61729f07821e1c6c7c1dbb22e9d0cfd1c2ba22a4f94b38f85eb735bc4fef1823`

Algorithm	Hash digest
SHA256	`eda7e494213f09d747b92f8df1c119c306d3de4ad62a27ee056c32950ec0ca71`
MD5	`b1a9a753906a7c55b261552a2eb7b053`
BLAKE2b-256	`f7fc1924a40e1f16f54864c5553756e0c3db015374e47be2add06e0c2a6ee848`

Algorithm	Hash digest
SHA256	`2044b0c612247f14d8f8e1b4b3f891a6e1c8c65512efd2cf6964b4ba29d08cae`
MD5	`82b7b9517f142a7e3e1312a7158f7b92`
BLAKE2b-256	`e7847c652dea82faa67365c42f634b3a8f06dbd76a90b7d8aaabbb4bf8ee0fc3`

Algorithm	Hash digest
SHA256	`6499f6d0e9ef4e2014d2878b5053ea43daedd778153617e1d875cb31f1c3e503`
MD5	`1b3f478e8ac5416009bbb996c11cbe0d`
BLAKE2b-256	`e606887fb4fc3f066f597dddd3a1b910e5c4c9284b7b4caa373c2df54bc32b75`

Algorithm	Hash digest
SHA256	`3b9c836f0b2597df763d16da4affc0204bfa9c023293b33bb7556f597d8e2790`
MD5	`7d6ffcc88f8f38d82acac989d845df24`
BLAKE2b-256	`dcbb1bf1c5583b1dd8d49b8c254b56bd43acdebdf6b70c7a07fd4e3483ddb043`

Algorithm	Hash digest
SHA256	`8efc05febd88ea28a15c25a9b82aff055332b20a4ec76b0ea7a7657be1deddf6`
MD5	`61492b5dc8c1dd88b9676ab1f5748bdb`
BLAKE2b-256	`8d41100c3efc90f637de0b0a472ebd4ea928854b0f0e7cabaf5f110d7a79aeb5`

Algorithm	Hash digest
SHA256	`2375980dae5098ea30a242b9f323d2ba2825a2d3c96077174b1dacfd59477b6f`
MD5	`742ee68d3aa14ce61a642b66a18e74fb`
BLAKE2b-256	`67627f12cc70b18254a76b36dcca201dc9740911f988f381e925b3e1d73d6ab8`

Algorithm	Hash digest
SHA256	`8430e1f6f615e5eb9c126cd4b73e38a98ac3d938169a5e73792696519be7b918`
MD5	`b77bd57da2071b2e698812b09dcd6c8e`
BLAKE2b-256	`a3a73e46b2b254577334bb955be8358646200069fbf6cbbd75fa57bb1f7b5b74`

Algorithm	Hash digest
SHA256	`a892b7b284664a6315bb86fa7aa2b2ac97257681363be21e666a386aa0b2efbf`
MD5	`1812ec65561bd95890a3888cfbbffdb3`
BLAKE2b-256	`a2a094253a4f9432933e119f2611ea783cc6b8bc470a01b8fc53fea2bdfa7ea4`

Algorithm	Hash digest
SHA256	`10c7fe4f4b80bb8d2c31491845a45c2899dc2f1ee8572eef8c62c5a54c3ba849`
MD5	`1bcc1ebd470b2d1e55f35be31b4da4d2`
BLAKE2b-256	`e34665b9a15e444475b19340d4b423f050af090a79c3821933786668fe56ab52`

Algorithm	Hash digest
SHA256	`e241547b01c3fedebacf36ff26cf69760d2a457dc7ebde6565a2b6193af6ebf5`
MD5	`c450e0f18ee5679bb1cd41b98d9d6adb`
BLAKE2b-256	`8df4746174dee469ceec4e31092137b5ab3d5197275e216b3c2f07a0b9cc0a68`

Algorithm	Hash digest
SHA256	`bb3793dfc51402c12d3d9dc6a3d2efe9a27d189c0ebf91b5776086ea6137d294`
MD5	`c93d05a5547635dc44fd405e0cb0c7dc`
BLAKE2b-256	`29ae05a0c0797a0795ee2ef9cebe1628298249bb0cc0223ea166b9b22d0129a4`

Algorithm	Hash digest
SHA256	`ed4946e9672c11ba0583ddb240eec9f2893cad2113a46d06639b0f04cf493e09`
MD5	`aba716f64e7a044528e9d9b620d4da88`
BLAKE2b-256	`830c71d3bbfd0b56fb5b3231ef6759a83e05927f4fbccf7711762fa7882913cb`

Algorithm	Hash digest
SHA256	`bb2cbea01f6173fcb5458ee41533578951c1273b1e94bb2853493bb8d73da1ee`
MD5	`7fbf17eb001ddebc3341e1b2948d1872`
BLAKE2b-256	`0bc5afc815df848cf693260a75cd30dadee4c49988e8b76bd867a81d73e5e071`

Algorithm	Hash digest
SHA256	`06297207940382955be076a1667e80825a298c857e855fe679083879e5f26645`
MD5	`669a30ea324a4c92c5487d49786e571e`
BLAKE2b-256	`dd32715e6abdb2c91f87d49c008fd10c22f4d1b5faca1863e283d9f47a3fd1b1`

Algorithm	Hash digest
SHA256	`fdbfe6f34e3ae98fbcc3b966a4d31ecdb0d73ceb902da25c5f3414148d7bbeba`
MD5	`edd520265f2dfbdfc693c9d2b5c5f2cf`
BLAKE2b-256	`d40f936389c4115221aeac49d24b2c01979a1a696fcd016360cce6535f6fc393`

Algorithm	Hash digest
SHA256	`f342b64e63019bf18b37997d66550344cf99113aa786b37f64cff965ab2a41c1`
MD5	`6d452f4301a1eb5eef9d5b6f24e1ccf2`
BLAKE2b-256	`3cbb1731c19c070aefab81a3d28524f8fa9f4ab95461efd154206f1ffe26d73f`

smopt 0.1.1

smopt

Quick example

Solvers

Installation

Layout

Documentation

Acknowledgement

License

Project links

Key dates

Owner

Credits

GitHub Statistics

License expression

Requires

Tags

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`a84753512ad4d199a04f21e93deea19fa7e6d9d75a2b074e62eb3ea257fa1220`
MD5	`fe10672b785404478519bd802229773b`
BLAKE2b-256	`803bf01e683fcb46345ec347179362e6f54b650a6a2dba6f427bb6f9eca1ce2b`

Algorithm	Hash digest
SHA256	`e9ba33d2262ab571c4260a0884749fb35b7351f42eb53f0ded66e4307b9df440`
MD5	`2de7688ec55b5c91b3661185acd60705`
BLAKE2b-256	`0e87a8e73fc1e9748078239a8422fea326d5911067a5b69883d66f97acb0377a`

Algorithm	Hash digest
SHA256	`e61a2119c4965d120afb36fd8fe9a91145d7d66607bb3f7f59d391841129c387`
MD5	`057c59c6368503f4e10c896960edb9a8`
BLAKE2b-256	`394aae026799503d2cdbea39829864dd4547b108fb83d41c2600aa4f9cf59707`

Algorithm	Hash digest
SHA256	`b8e666e4926935fea6bfe622201191ad4d332fc39f1a711ed162015e6fecc70e`
MD5	`88e54c0fd1496afde08fee3dabda89e8`
BLAKE2b-256	`43d9085d51c3ac42435d770813a205ad86e931ca37bf8bbfb881054d795f84d8`

Algorithm	Hash digest
SHA256	`e43596571dad9d00c12e9e0bca63082f2220f8d5293b269d515f1d7bf365bcf1`
MD5	`1d6498a5a1fe45ef00f0299aca3110d8`
BLAKE2b-256	`43445b576c6933aa00d1be855cc80d66263f7d885b39db84dbf76daa87691aee`

Algorithm	Hash digest
SHA256	`c86bbb83e16a8b7244a75dd9786204450e23ece469e17c392a4749e7fa4081cc`
MD5	`6f1bb60a70da08532fedc93127cf8a99`
BLAKE2b-256	`129e7a30abf3f4873b9f46236369776f070b7c76497aebcd8018c0d9a8969a2f`

Algorithm	Hash digest
SHA256	`0bc35574c011faf15acfca15ea157b225272f20a2ac36ee9e54720cbc3e3270b`
MD5	`a8b8455156db27a20d96b3309c3583be`
BLAKE2b-256	`b85869ec7bba5b6d27f28ab9f3642aa65990a13263ba4845c0ca2c368ed9679d`

Algorithm	Hash digest
SHA256	`22469273b2ab4c23de4a2cbb022dadeeb8804ee79fe3a9619efa41b5bd706bab`
MD5	`2acefe3457cb7271436cc6ab89d7b0b8`
BLAKE2b-256	`ab4952dbb4bd0da24ce0e622b698c191a868fa6b770303c10563038acee3f702`

Algorithm	Hash digest
SHA256	`ab5a28246bba385d2328c5a3b763a8335ed2f4a08912e26e55afaea011752900`
MD5	`8fb7b6c62b9a1c6c571e62aa2ac2e7df`
BLAKE2b-256	`7d76deea98a403b695172070771d93603925cbf2d71820608c40730bee3b3c54`

Algorithm	Hash digest
SHA256	`49dd4f716c6e1ed2a9c2598aece260c8a5adf7f1586715a15ce45f7bd62a1b03`
MD5	`05da69a98622ad1fddec9bcd89c57f6b`
BLAKE2b-256	`8946fe527e1619b1550cb43e170ffdabac2da4ab042eefc0058e2c442675e98b`