rwls 0.0.1__py3-none-any.whl

rwls/__init__.py

@@ -0,0 +1,11 @@
+"""Regime-weighted least squares (RWLS) for regime-dependent factor models.
+
+Latent market regimes are identified with a multivariate Gaussian hidden Markov
+model fitted to common factor returns. Each asset's factor loadings and residual
+variance are then estimated separately for every regime by weighted least squares,
+with each observation weighted by its posterior regime probability.
+
+This release reserves the package name. The implementation is under development.
+"""
+
+__version__ = "0.0.1"

rwls-0.0.1.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: rwls
+Version: 0.0.1
+Summary: Regime-weighted least squares: regime-dependent factor models estimated with hidden Markov posterior probabilities.
+Author: Francisco Ibanez
+License-Expression: MIT
+License-File: LICENSE
+Keywords: factor models,financial econometrics,hidden Markov model,regime switching,weighted least squares
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# rwls
+
+Regime-weighted least squares (RWLS) for estimating regime-dependent factor models.
+
+## The estimator
+
+Factor models usually assume that an asset's exposures to common risk factors are
+constant. In practice, betas, factor premia and idiosyncratic risk shift with
+market conditions. RWLS estimates a separate factor model for every asset in every
+latent market regime, without fitting a regime-switching model asset by asset.
+
+Estimation proceeds in two stages:
+
+1. **Regime identification.** A multivariate Gaussian hidden Markov model is fitted
+   to a small set of common factor returns `f_t`. Its posterior probabilities
+   `γ_t(s) = P(S_t = s | data)` measure how strongly each period belongs to each
+   regime `s`.
+
+2. **Regime-weighted regressions.** For each asset `i` and regime `s`, the
+   loadings solve a weighted least-squares problem in which each observation is
+   weighted by its posterior regime probability:
+
+   ```
+   (α_is, β_is) = argmin  Σ_t γ_t(s) · (r_it − α − β′ f_t)²
+   ```
+
+   The regime-specific residual variance is measured on the regime's effective
+   sample, the posterior mass `Σ_t γ_t(s)`:
+
+   ```
+   σ²_is = Σ_t γ_t(s) · e_it² / (Σ_t γ_t(s) − k)
+   ```
+
+   where `k` is the number of regression coefficients.
+
+Every observation contributes to every regime in proportion to the evidence that
+it belongs there. Assets are not hard-classified, and no observation is discarded.
+Because all assets share the same factor history and weights, the regressions
+for a whole cross-section are solved jointly. The cost of adding an asset is one
+weighted regression per regime, which makes the approach practical for universes
+of thousands of securities.
+
+## From loadings to regime-conditional moments
+
+Combined with the regime-conditional factor means `λ_s` and covariances `Ω_s`
+from the hidden Markov model, the loadings imply asset-level moments in each
+regime:
+
+```
+μ_s = α_s + B_s λ_s
+Σ_s = B_s Ω_s B_s′ + diag(σ²_s)
+```
+
+Weighting these by forecast regime probabilities gives the asset return
+distribution as a Gaussian mixture. Its mean and covariance are available in
+closed form.
+
+## Planned scope
+
+- Hidden Markov regime identification on factor returns, with state alignment
+  across refits and one-step regime forecasts.
+- Vectorized RWLS estimation for large cross-sections, with effective sample
+  sizes and sampling covariances of the regime-specific loadings.
+- Regime-conditional and mixture moments of asset returns.
+- Simulation tools for regime-switching factor models, for Monte Carlo
+  evaluation of the estimators.
+
+Applications include conditional beta estimation, regime-dependent risk models
+and portfolio construction. Portfolio optimization is one use of the estimated
+moments, not the purpose of the package.
+
+## Status
+
+Under development. This release reserves the package name; the implementation
+will follow in a later version.
+
+## License
+
+MIT

rwls-0.0.1.dist-info/RECORD

@@ -0,0 +1,5 @@
+rwls/__init__.py,sha256=7uNJ0gJ1gvIgoUFtu15ffQEIwOISuPxp_h-SQWdNC38,498
+rwls-0.0.1.dist-info/METADATA,sha256=vG8QuNdKIMGy1HEDf1XnyRfikT3g-mrVJos6f41B0r0,3683
+rwls-0.0.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+rwls-0.0.1.dist-info/licenses/LICENSE,sha256=Qa-xO-3w0_VuWuAQtw8tI8IxGP5dP74YBvN8HFaLb2E,1073
+rwls-0.0.1.dist-info/RECORD,,

rwls-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

rwls-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Francisco Ibanez
+
+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.