mergeron 2024.738972.0__py3-none-any.whl → 2024.738973.0__py3-none-any.whl

mergeron/core/{guidelines_boundaries_specialized_functions.py → guidelines_boundary_functions_extra.py}

@@ -1,8 +1,9 @@
 """
 Specialized methods for defining and analyzing boundaries for Guidelines standards.
 
-These methods provide improved precision or demonstrate additional methods, but tend
-to have poor performance
+These methods (functions) provide rely on scipy of sympy for core computations,
+and may provide improved precision than core functions, but tend to have
+poor performance
 
 """
 
@@ -18,7 +19,8 @@ from scipy.spatial.distance import minkowski as distance_function  # type: ignor
 from sympy import lambdify, simplify, solve, symbols
 
 from .. import _PKG_NAME  # noqa: TID252
-from .guidelines_boundaries import GuidelinesBoundary, _shrratio_boundary_intcpt, lerp
+from . import GuidelinesBoundary
+from .guidelines_boundary_functions import _shrratio_boundary_intcpt, lerp
 
 __version__ = version(_PKG_NAME)
 
@@ -34,7 +36,39 @@ class GuidelinesBoundaryCallable:
     s_naught: float = 0
 
 
-def delta_hhi_boundary_qdtr(_dh_val: float = 0.01, /) -> GuidelinesBoundaryCallable:
+def dh_area_quad(_dh_val: float = 0.01, /, *, prec: int = 9) -> float:
+    """
+    Area under the ΔHHI boundary.
+
+    When the given ΔHHI bound matches a Guidelines safeharbor,
+    the area under the boundary is half the intrinsic clearance rate
+    for the ΔHHI safeharbor.
+
+    Parameters
+    ----------
+    _dh_val
+        Merging-firms' ΔHHI bound.
+    prec
+        Specified precision in decimal places.
+
+    Returns
+    -------
+        Area under ΔHHI boundary.
+
+    """
+
+    _dh_val = mpf(f"{_dh_val}")
+    _s_naught = (1 - mp.sqrt(1 - 2 * _dh_val)) / 2
+
+    return round(
+        float(
+            _s_naught + mp.quad(lambda x: _dh_val / (2 * x), [_s_naught, 1 - _s_naught])
+        ),
+        prec,
+    )
+
+
+def hhi_delta_boundary_qdtr(_dh_val: float = 0.01, /) -> GuidelinesBoundaryCallable:
     """
     Generate the list of share combination on the ΔHHI boundary.
 

mergeron/gen/__init__.py

@@ -223,15 +223,6 @@ class SSZConstants(float, enum.ReprEnum):
 
 
 # Validators for selected attributes of MarketSpec
-def _sample_size_validator(
-    _object: MarketSpec, _attribute: Attribute[int], _value: int, /
-) -> None:
-    if _value < 10**6:
-        raise ValueError(
-            f"Sample size must be no less than {10**6:,d}; got, {_value:,d}."
-        )
-
-
 def _share_spec_validator(
     _instance: MarketSpec, _attribute: Attribute[ShareSpec], _value: ShareSpec, /
 ) -> None:

{mergeron-2024.738972.0.dist-info → mergeron-2024.738973.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mergeron
-Version: 2024.738972.0
+Version: 2024.738973.0
 Summary: Analysis of standards defined in Horizontal Merger Guidelines
 License: MIT
 Keywords: merger policy analysis,merger guidelines,merger screening,policy presumptions,concentration standards,upward pricing pressure,GUPPI

{mergeron-2024.738972.0.dist-info → mergeron-2024.738973.0.dist-info}/RECORD

@@ -1,18 +1,19 @@
 mergeron/License.txt,sha256=7iX-y0EyjkbVJKJLS4ZKzuuE1wd0lryfsD_IytLG8lQ,1246
 mergeron/__init__.py,sha256=_0Bt2k2P8MPlF_WagQKGspaSODn-pkqib0uvSd4gys4,1019
 mergeron/core/InCommon RSA Server CA cert chain.pem,sha256=W8TqydgY8jphQ4fr6WMdT6jLwqFjHLpx8fFr3LXub4s,4292
-mergeron/core/__init__.py,sha256=NWalI-uDifb8Y8bDN4BFNH2IoCAx3C60_Dz3bwbxveY,2085
+mergeron/core/__init__.py,sha256=9_FKQ5f8hJhmv6BfaSNrjKr8dEw8Twd4X3j3i6NvHOs,2257
 mergeron/core/damodaran_margin_data.py,sha256=DHTQdFjuZ5Yl3Dbq0db0QR4FHUqJpZj4yi5zdUncLtg,8166
 mergeron/core/excel_helper.py,sha256=XfdKNOEdB5zNJl8LguVyAcDjr5y2wapKDbNgAx6r-es,7831
 mergeron/core/ftc_invdata.msgpack,sha256=WBFHgi7Ld4R-h2zL2Zc3TOIlKqVrbVFMH1LoI4-T-M0,264664
 mergeron/core/ftc_merger_investigations_data.py,sha256=wHF1dKAqWlh1hMvaQv2uOCAKAHnuPvCGnmaOB3CJO9I,26929
-mergeron/core/guidelines_boundaries.py,sha256=h--dAO449VyhhVJ-GjzQ56L-Bq_Zz-PXonBHKRsBQmE,37554
-mergeron/core/guidelines_boundaries_specialized_functions.py,sha256=OiTu_MIvw_f93ESpTpMBL6rVqTLPyqE-fhf62mgGNxA,10620
+mergeron/core/guidelines_boundaries.py,sha256=haMNATCWKkAjFCQTChHPqfgKq4DTM5SZb9R9RIXoCT0,12542
+mergeron/core/guidelines_boundary_functions.py,sha256=Pmg73eXu1HUh4UW8s-wgep8udWXZqX3t266Yp3uSi70,25313
+mergeron/core/guidelines_boundary_functions_extra.py,sha256=NOdxBgoP32RdXwY41vjGuo9VH80hCIv7jRYi5UhFgxQ,11423
 mergeron/core/proportions_tests.py,sha256=tCrbya1el5u1OFOXphODP6yWOGywuNY6z9LBTsNRKzM,15320
 mergeron/core/pseudorandom_numbers.py,sha256=uBK_fnhkOSkqnK4gEU8b3r_9B6r-vKmXZ64HViraTK8,9446
 mergeron/ext/__init__.py,sha256=iyfxkX3-SoMS4ZQZKHKPn8JEMN536vpty9oSZf0LHv8,115
 mergeron/ext/tol_colors.py,sha256=wFOHZXWZonbp9mhmSGu9mVujBYhdTsvx9_WikMpoCmo,22229
-mergeron/gen/__init__.py,sha256=GSFduoVwk0dOqogqX-YdWMtlxSM6G3tyFqf6U43okV4,16268
+mergeron/gen/__init__.py,sha256=-yewgOkVtKpXmc6HhGwJjbMkpWOk9ODYd_DEmoYnS50,16022
 mergeron/gen/_data_generation_functions.py,sha256=QLxeS35D3bqQjjDabq1QncqwptMaHBrtmZ-_JUo6SG4,23202
 mergeron/gen/data_generation.py,sha256=7teP8OKgKp08riX2Yu7flMEvN6a_eNXJllv_Hdkt7W8,8842
 mergeron/gen/investigations_stats.py,sha256=4-AY_zhqKSlGE8sQciuYxzg2U4efQs2014dydmWUFz4,22802
@@ -26,6 +27,6 @@ mergeron/jinja_LaTex_templates/mergeron.cls,sha256=AV2mk4-uERvAuMkE95Ka7el6LZsb0
 mergeron/jinja_LaTex_templates/mergeron_table_collection_template.tex.jinja2,sha256=nr6xUI0_2KHG4Sz9k1JFVQjs2h9qS9BGt1MeE6Tygs8,2429
 mergeron/jinja_LaTex_templates/setup_tikz_tables.tex.jinja2,sha256=WKVxtp3eoMchfGliQAJMj4w2FtBkWG5z2V3-hBYUYUQ,3292
 mergeron/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-mergeron-2024.738972.0.dist-info/METADATA,sha256=qJ2QkDvJJZ5L6ETVxFB7KX_uB0FktsbTovnSj7GSiMQ,6925
-mergeron-2024.738972.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-mergeron-2024.738972.0.dist-info/RECORD,,
+mergeron-2024.738973.0.dist-info/METADATA,sha256=VCkVedkcxNum0AjN3whp7lnAE3cJit1fAzOVh5OTxrU,6925
+mergeron-2024.738973.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+mergeron-2024.738973.0.dist-info/RECORD,,