mergeron 2025.739439.4__tar.gz → 2025.739439.7__tar.gz

{mergeron-2025.739439.4 → mergeron-2025.739439.7}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: mergeron
-Version: 2025.739439.4
+Version: 2025.739439.7
 Summary: Python for analyzing merger enforcement policy
 License: MIT
 Keywords: merger enforcement policy,merger guidelines,merger screening,enforcement presumptions,concentration standards,diversion ratio,upward pricing pressure,GUPPI
 Author: Murthy Kambhampaty
 Author-email: smk@capeconomics.com
-Requires-Python: >=3.12,<4.0
+Requires-Python: >=3.13,<4.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: End Users/Desktop
@@ -15,7 +15,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: aenum (>=3.1.16)
 Requires-Dist: attrs (>=25.3.0)
@@ -62,10 +61,10 @@ mergeron: Python for analyzing merger enforcement policy
 
 .. image:: https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json
    :target: https://python-poetry.org/
-.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
-   :target: https://github.com/astral-sh/ruff/
 .. image:: https://www.mypy-lang.org/static/mypy_badge.svg
    :target: https://mypy-lang.org/
+.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+   :target: https://github.com/astral-sh/ruff/
 .. image:: https://img.shields.io/badge/code%20style-black-000000
    :target: https://github.com/psf/black/
 .. image:: https://img.shields.io/badge/License-MIT-yellow

{mergeron-2025.739439.4 → mergeron-2025.739439.7}/pyproject.toml

@@ -15,8 +15,8 @@ keywords = [
     "upward pricing pressure",
     "GUPPI",
 ]
-version = "2025.739439.4"
-requires-python = ">=3.12,<4.0"
+version = "2025.739439.7"
+requires-python = ">=3.13,<4.0"
 
 # Classifiers list: https://pypi.org/classifiers/
 classifiers = [
@@ -28,7 +28,6 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: Implementation :: CPython",
-    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
 ]
 

{mergeron-2025.739439.4 → mergeron-2025.739439.7}/src/mergeron/__init__.py

@@ -15,7 +15,7 @@ from ruamel import yaml
 
 _PKG_NAME: str = Path(__file__).parent.name
 
-VERSION = "2025.739439.4"
+VERSION = "2025.739439.7"
 
 __version__ = VERSION
 

{mergeron-2025.739439.4 → mergeron-2025.739439.7}/src/mergeron/core/guidelines_boundary_functions.py

@@ -2,6 +2,7 @@
 
 import decimal
 from collections.abc import Callable
+from math import fma
 from types import ModuleType
 from typing import Literal, TypedDict
 
@@ -223,14 +224,14 @@ def diversion_share_boundary_wtd_avg(
     dps: int = 5,
 ) -> GuidelinesBoundary:
     R"""
-    Share combinations on the share-weighted average diversion ratio boundary.
+    Share combinations on the share-weighted average diversion share boundary.
 
     Parameters
     ----------
     _delta_star
-        Diversion share (:math:`\overline{d} / \overline{r}`)
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
-        recapture ratio
+        Recapture ratio.
     agg_method
         Whether "arithmetic mean", "geometric mean", or "distance".
     weighting
@@ -423,7 +424,7 @@ def diversion_share_boundary_xact_avg(
     dps: int = 5,
 ) -> GuidelinesBoundary:
     R"""
-    Share combinations for the exact average diversion/share-ratio boundary.
+    Share combinations for the exact average diversion share boundary.
 
     Notes
     -----
@@ -461,9 +462,9 @@ def diversion_share_boundary_xact_avg(
     Parameters
     ----------
     _delta_star
-        Diversion share (:math:`\overline{d} / \overline{r}`).
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
-        Recapture ratio
+        Recapture ratio.
     recapture_form
         Whether recapture-ratio is MNL-consistent ("inside-out") or has fixed
         value for both merging firms ("proportional").
@@ -590,7 +591,7 @@ def diversion_share_boundary_min(
     Parameters
     ----------
     _delta_star
-        Diversion share (:math:`\overline{d} / \overline{r}`).
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
         Recapture ratio.
     recapture_form
@@ -634,7 +635,7 @@ def diversion_share_boundary_max(
     Parameters
     ----------
     _delta_star
-        Diversion share (:math:`\overline{d} / \overline{r}`).
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _
         Placeholder for recapture ratio included for consistency with other
         share-ratio boundary functions.
@@ -695,7 +696,7 @@ def lerp[LerpT: (float, MPFloat, ArrayDouble, ArrayBIGINT)](
     _x1: LerpT, _x2: LerpT, _r: float | MPFloat = 0.25, /
 ) -> LerpT:
     R"""
-    From the function of the same name in the C++ standard [#]_.
+    From the function of the same name in the C++ standard [#]_. Also, [#]_.
 
     Constructs the weighted average, :math:`w_1 x_1 + w_2 x_2`, where
     :math:`w_1 = 1 - r` and :math:`w_2 = r`.
@@ -703,9 +704,9 @@ def lerp[LerpT: (float, MPFloat, ArrayDouble, ArrayBIGINT)](
     Parameters
     ----------
     _x1, _x2
-        bounds :math:`x_1, x_2` to interpolate between.
+        Interpolation bounds :math:`x_1, x_2`.
     _r
-        interpolation weight :math:`r` assigned to :math:`x_2`
+        Interpolation weight :math:`r` assigned to :math:`x_2`
 
     Returns
     -------
@@ -722,15 +723,20 @@ def lerp[LerpT: (float, MPFloat, ArrayDouble, ArrayBIGINT)](
 
     .. [#] C++ Reference, https://en.cppreference.com/w/cpp/numeric/lerp
 
+    .. [#] Harris, Mark (2015). "GPU Pro Tip: Lerp faster in C++". nvidia.com (Jun 10, 2015). Online at:
+        https://developer.nvidia.com/blog/lerp-faster-cuda/
+
+
     """
-    if not 0 <= _r <= 1:
-        raise ValueError("Specified interpolation weight must lie in [0, 1].")
-    elif _r == 0:
-        return _x1
-    elif _r == 1:
-        return _x2
-    else:
-        return _r * _x2 + (1 - _r) * _x1
+    match _r:
+        case 0:
+            return _x1
+        case 1:
+            return _x2
+        case _:
+            if not 0 <= _r <= 1:
+                raise ValueError("Specified interpolation weight must lie in [0, 1].")
+            return fma(_x2, _r, fma(_x1, -_r, _x1))
 
 
 def round_cust(

{mergeron-2025.739439.4 → mergeron-2025.739439.7}/src/mergeron/core/guidelines_boundary_functions_extra.py

@@ -108,9 +108,9 @@ def diversion_share_boundary_qdtr_wtd_avg(
     Parameters
     ----------
     _delta_star
-        corollary to GUPPI bound (:math:`\overline{g} / (m^* \cdot \overline{r})`)
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
-        recapture ratio
+        Recapture ratio.
     weighting
         Whether "own-share" or "cross-product-share" (or None for simple, unweighted average)
     recapture_form
@@ -229,9 +229,9 @@ def diversion_share_boundary_distance(
     Parameters
     ----------
     _delta_star
-        corollary to GUPPI bound (:math:`\overline{g} / (m^* \cdot \overline{r})`)
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
-        recapture ratio
+        Recapture ratio.
     agg_method
         Whether "arithmetic mean" or "distance".
     weighting
@@ -409,9 +409,9 @@ def diversion_share_boundary_xact_avg_mp(
     Parameters
     ----------
     _delta_star
-        Diversion share (:math:`\overline{d} / \overline{r}`).
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
-        Recapture ratio
+        Recapture ratio.
     recapture_form
         Whether recapture-ratio is MNL-consistent ("inside-out") or has fixed
         value for both merging firms ("proportional").
@@ -529,14 +529,14 @@ def _diversion_share_boundary_wtd_avg_autoroot(
     dps: int = 5,
 ) -> GuidelinesBoundary:
     R"""
-    Share combinations on the share-weighted average diversion ratio boundary.
+    Share combinations on the share-weighted average diversion share boundary.
 
     Parameters
     ----------
     _delta_star
-        Diversion share (:math:`\overline{d} / \overline{r}`)
+        Diversion share, :math:`\overline{d} / \overline{r}` or :math:`\overline{g} / (m^* \cdot \overline{r})`.
     _r_val
-        recapture ratio
+        Recapture ratio.
     agg_method
         Whether "arithmetic mean", "geometric mean", or "distance".
     weighting

{mergeron-2025.739439.4 → mergeron-2025.739439.7}/README.rst

@@ -22,10 +22,10 @@ mergeron: Python for analyzing merger enforcement policy
 
 .. image:: https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json
    :target: https://python-poetry.org/
-.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
-   :target: https://github.com/astral-sh/ruff/
 .. image:: https://www.mypy-lang.org/static/mypy_badge.svg
    :target: https://mypy-lang.org/
+.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+   :target: https://github.com/astral-sh/ruff/
 .. image:: https://img.shields.io/badge/code%20style-black-000000
    :target: https://github.com/psf/black/
 .. image:: https://img.shields.io/badge/License-MIT-yellow