mergeron 2025.739425.2__py3-none-any.whl → 2025.739439.3__py3-none-any.whl

mergeron/__init__.py

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

mergeron/core/guidelines_boundaries.py

@@ -233,7 +233,7 @@ class DiversionRatioBoundary:
     ) -> None:
         if not (isinstance(_value, decimal.Decimal | float) and 0 <= _value <= 1):
             raise ValueError(
-                "Margin-adjusted benchmark share ratio must lie between 0 and 1."
+                "Margin-adjusted benchmark diversion share must lie between 0 and 1."
             )
 
     recapture_ratio: float = field(
@@ -324,7 +324,7 @@ class DiversionRatioBoundary:
 
     def __attrs_post_init__(self, /) -> None:
         """Initialize boundary and area based on other attributes."""
-        share_ratio = critical_share_ratio(
+        share_ratio = critical_diversion_share(
             self.diversion_ratio, r_bar=self.recapture_ratio
         )
 
@@ -403,7 +403,7 @@ def guppi_from_delta(
     )
 
 
-def critical_share_ratio(
+def critical_diversion_share(
     _guppi_bound: float = 0.075,
     /,
     *,
@@ -425,7 +425,7 @@ def critical_share_ratio(
 
     Returns
     -------
-        Critical share ratio (share ratio bound) corresponding to the GUPPI bound
+        Critical diversion share (diversion share bound) corresponding to the GUPPI bound
         for given margin and recapture ratio.
 
     """
@@ -459,7 +459,7 @@ def share_from_guppi(
 
     """
     return gbfn.round_cust(
-        (_d0 := critical_share_ratio(_guppi_bound, m_star=m_star, r_bar=r_bar))
+        (_d0 := critical_diversion_share(_guppi_bound, m_star=m_star, r_bar=r_bar))
         / (1 + _d0)
     )
 

mergeron/core/guidelines_boundary_functions.py

@@ -228,7 +228,7 @@ def diversion_share_boundary_wtd_avg(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`)
+        Diversion share (:math:`\overline{d} / \overline{r}`)
     _r_val
         recapture ratio
     agg_method
@@ -461,7 +461,7 @@ def diversion_share_boundary_xact_avg(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _r_val
         Recapture ratio
     recapture_form
@@ -590,7 +590,7 @@ def diversion_share_boundary_min(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _r_val
         Recapture ratio.
     recapture_form
@@ -634,7 +634,7 @@ def diversion_share_boundary_max(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _
         Placeholder for recapture ratio included for consistency with other
         share-ratio boundary functions.

mergeron/core/guidelines_boundary_functions_extra.py

@@ -409,7 +409,7 @@ def diversion_share_boundary_xact_avg_mp(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`).
+        Diversion share (:math:`\overline{d} / \overline{r}`).
     _r_val
         Recapture ratio
     recapture_form
@@ -534,7 +534,7 @@ def _diversion_share_boundary_wtd_avg_autoroot(
     Parameters
     ----------
     _delta_star
-        Share ratio (:math:`\overline{d} / \overline{r}`)
+        Diversion share (:math:`\overline{d} / \overline{r}`)
     _r_val
         recapture ratio
     agg_method

mergeron/gen/__init__.py

@@ -579,14 +579,12 @@ class MarginSampleData:
     mnl_test_array: ArrayBoolean
     """Flags infeasible observations as False and rest as True
 
-    Applying restrictions from Bertrand-Nash oligopoly
-    with MNL demand results in draws of Firm 2 PCM falling
-    outside the feasible interval,:math:`[0, 1]`, depending
-    on the configuration of merging firm shares. Such draws
-    are are flagged as infeasible (False)in :code:`mnl_test_array` while
-    draws with PCM values within the feasible range are
-    flagged as True. Used from filtering-out draws with
-    infeasible PCM.
+    Applying restrictions from Bertrand-Nash oligopoly with MNL demand results
+    in some draws of Firm 2 PCM falling outside the feasible interval, :math:`[0, 1]`
+    for certain combinations of merging firms shares as initially drawn. Such draws
+    are flagged as infeasible (False) in :code:`mnl_test_array` while draws with
+    feaseible PCM values flagged True. This array is used to exclude infeasible draws
+    when imposing MNL demand in simulations.
     """
 
 

{mergeron-2025.739425.2.dist-info → mergeron-2025.739439.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mergeron
-Version: 2025.739425.2
+Version: 2025.739439.3
 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

{mergeron-2025.739425.2.dist-info → mergeron-2025.739439.3.dist-info}/RECORD

@@ -1,20 +1,20 @@
-mergeron/__init__.py,sha256=n2XQtW2eHeSFqmCYoKTCM5UPmaBRpJmHVLryZ8WVVRU,6751
+mergeron/__init__.py,sha256=enPqozqe88chTg0uWg_CNBOzm8KBsKCxEkRayBJCt3s,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=Q_udRryyqQAtoB7x2EYGOxI-8JNuyYgoDbFJ_EZAOnM,15606
-mergeron/core/guidelines_boundary_functions.py,sha256=qQbpiNUxsq9AE8SrS628yWlEzqBQdNoVIarFurhuGTY,30304
-mergeron/core/guidelines_boundary_functions_extra.py,sha256=hRhROaLJoRtTrtd-dNkpAGPOEeY1w_qXQHKIxfALaG4,22070
+mergeron/core/guidelines_boundaries.py,sha256=PvSOLB6KlXu9KX6NdpStuRluP6nrZqUzSHT6usa5600,15630
+mergeron/core/guidelines_boundary_functions.py,sha256=XdpgwOwcvRHcpzWsX1aMQP656hrMz5kNco4RoLrbCN8,30320
+mergeron/core/guidelines_boundary_functions_extra.py,sha256=g4V4-vxX8g6X-lXUVyU4-yPj5LTjCoRDPQUlbb2bBHY,22078
 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
 mergeron/data/ftc_merger_investigations_data.zip,sha256=tiB2TLFyS9LMSFIv8DBA_oEEx12DU4MyjHni4NlsRMU,24002
-mergeron/gen/__init__.py,sha256=3ToWbBcf8SF0r8wxoA3n2GHYYCv1DPvvRC2A7mu-YPE,23842
+mergeron/gen/__init__.py,sha256=apcCVC29yVjIM1yLM-wVpwrIwfi3BvJp_fPThe0Bgoc,23864
 mergeron/gen/data_generation.py,sha256=pdQl_uBENCjVt2aPtAcus2md4Qx-j5rOWGJJAzdnlO0,17617
 mergeron/gen/data_generation_functions.py,sha256=hXUq5D2CIUkM4_NdGXiOb4XATYwIUeUcCGadzQGDqLw,26126
 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.739425.2.dist-info/METADATA,sha256=iVXVUwjEb8kJSBdzyRO3D53xnIcRU03NHA-R61XPnT8,4270
-mergeron-2025.739425.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-mergeron-2025.739425.2.dist-info/RECORD,,
+mergeron-2025.739439.3.dist-info/METADATA,sha256=aEMS78D0BPKkDIbKkrtLkD8xRO4CWzJtC7oq580DpSg,4270
+mergeron-2025.739439.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+mergeron-2025.739439.3.dist-info/RECORD,,