mergeron 2025.739439.4__py3-none-any.whl → 2025.739439.7__py3-none-any.whl

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/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/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.dist-info → mergeron-2025.739439.7.dist-info}/METADATA

@@ -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.dist-info → mergeron-2025.739439.7.dist-info}/RECORD

@@ -1,10 +1,10 @@
-mergeron/__init__.py,sha256=DkjEtEBsfI3wGBKXxoK8Rdch2WGvotv0rA_7b_21RNs,6751
+mergeron/__init__.py,sha256=IiCnxgPoGTxGfs7Z74pv6xAfnTSXSISfl7Ed_mrS224,6751
 mergeron/core/__init__.py,sha256=4Y_q-Qu7gXENVKHS-lNebn5mPZDy9oPHFwUV7fAW9Nw,3269
 mergeron/core/empirical_margin_distribution.py,sha256=61U-KLB563BPWM5zWyWp82c4PhcsAG-IKI0WWYGjBKg,11740
 mergeron/core/ftc_merger_investigations_data.py,sha256=oM4cs2PnyeSwyV1LOE_EYCUEzCKPm7lnCGxLIc6JQY8,28820
 mergeron/core/guidelines_boundaries.py,sha256=PvSOLB6KlXu9KX6NdpStuRluP6nrZqUzSHT6usa5600,15630
-mergeron/core/guidelines_boundary_functions.py,sha256=hJD6JoMBcjTqq0zJI1a7PG1Mcrp5G5R0cHYEg9aCZmo,30320
-mergeron/core/guidelines_boundary_functions_extra.py,sha256=g4V4-vxX8g6X-lXUVyU4-yPj5LTjCoRDPQUlbb2bBHY,22078
+mergeron/core/guidelines_boundary_functions.py,sha256=nStdhnxtvWJJ0jOR-5mPydDE3KMFf6rrfrT3IQUjjGY,30759
+mergeron/core/guidelines_boundary_functions_extra.py,sha256=DqwAsZ-ynbRAJE3rzAELCJEWyOtor3rvYUUUDTQpD7M,22243
 mergeron/core/pseudorandom_numbers.py,sha256=-mPveXjJJ446NrBMAmWIa2jI6j0Px0xcCJTGEEsn3bo,10149
 mergeron/data/__init__.py,sha256=SAFkR23RBM0zwGam2TeWmw08oHAKmU2YF-Nygj73ies,1845
 mergeron/data/damodaran_margin_data_serialized.zip,sha256=Wc1v9buSrYTWWAravG8W9nPbgsU07zMtSAR2RvMQU5s,623482
@@ -15,6 +15,6 @@ mergeron/gen/data_generation_functions.py,sha256=hXUq5D2CIUkM4_NdGXiOb4XATYwIUeU
 mergeron/gen/enforcement_stats.py,sha256=etTax-sBSn8DveF-IxuBJDdX0XSBD6oFU9vaZe6cYks,14387
 mergeron/gen/upp_tests.py,sha256=gRJISQ2jGmIDmFOvaTIkvYooI4mK-QbgkfgL46RrRio,7445
 mergeron/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-mergeron-2025.739439.4.dist-info/METADATA,sha256=w-4gkqcsE6KJYRoE0Mi-oxclDYioc4_KyYRimHIcr1o,4270
-mergeron-2025.739439.4.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-mergeron-2025.739439.4.dist-info/RECORD,,
+mergeron-2025.739439.7.dist-info/METADATA,sha256=Y-j9QMbM5qpsUVI_83FmBiTQdp--Xaw9IGVw4NjvEVc,4219
+mergeron-2025.739439.7.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+mergeron-2025.739439.7.dist-info/RECORD,,