mergeron 2025.739319.3__py3-none-any.whl → 2025.739341.8__py3-none-any.whl

mergeron/gen/data_generation_functions.py

@@ -1,6 +1,4 @@
-"""
-Non-public functions called in data_generation.py
-"""
+"""Non-public functions called in data_generation.py."""
 
 from __future__ import annotations
 
@@ -28,13 +26,13 @@ from ..core.pseudorandom_numbers import (  # noqa: TID252
 from . import (
     DEFAULT_BETA_BND_DIST_PARMS,
     DEFAULT_FCOUNT_WTS,
-    MarginDataSample,
+    MarginSampleData,
     PCMDistribution,
     PCMRestriction,
     PCMSpec,
-    PriceDataSample,
+    PriceSampleData,
     PriceSpec,
-    ShareDataSample,
+    ShareSampleData,
     ShareSpec,
     SHRDistribution,
     SSZConstant,
@@ -50,8 +48,8 @@ def gen_share_data(
     _mktshr_rng_seed_seq: SeedSequence,
     _nthreads: int,
     /,
-) -> ShareDataSample:
-    """Helper function for generating share data.
+) -> ShareSampleData:
+    """Generate share data.
 
     Parameters
     ----------
@@ -66,10 +64,9 @@ def gen_share_data(
 
     Returns
     -------
-        Arrays representing shares, diversion ratios, etc. structured as a :ShareDataSample:
+        Arrays representing shares, diversion ratios, etc. structured as a :ShareSampleData:
 
     """
-
     dist_type_mktshr, firm_count_prob_wts, dist_parms_mktshr, recapture_form = (
         getattr(_share_spec, _f)
         for _f in ("dist_type", "firm_counts_weights", "dist_parms", "recapture_form")
@@ -101,7 +98,7 @@ def gen_share_data(
     frmshr_array = mkt_share_sample.mktshr_array[:, :2]
     r_bar_ = _share_spec.recapture_ratio or DEFAULT_REC_RATIO
     if recapture_form == RECForm.INOUT:
-        mkt_share_sample = ShareDataSample(
+        mkt_share_sample = ShareSampleData(
             mkt_share_sample.mktshr_array,
             mkt_share_sample.fcounts,
             mkt_share_sample.nth_firm_share,
@@ -117,7 +114,7 @@ def gen_market_shares_uniform(
     _mktshr_rng_seed_seq: SeedSequence,
     _nthreads: int,
     /,
-) -> ShareDataSample:
+) -> ShareSampleData:
     """Generate merging-firm shares from Uniform distribution on the 3-D simplex.
 
     Parameters
@@ -136,7 +133,6 @@ def gen_market_shares_uniform(
         market shares and other market statistics for each draw (market)
 
     """
-
     frmshr_array: ArrayDouble = np.empty((_s_size, 2), float)
 
     MultithreadedRNG(
@@ -170,7 +166,7 @@ def gen_market_shares_uniform(
     nth_firm_share_.fill(np.nan)
     aggregate_purchase_prob_.fill(np.nan)
 
-    return ShareDataSample(
+    return ShareSampleData(
         mktshr_array_, fcounts_, nth_firm_share_, aggregate_purchase_prob_
     )
 
@@ -185,7 +181,7 @@ def _gen_market_shares_dirichlet_multimarket(
     _mktshr_rng_seed_seq: SeedSequence,
     _nthreads: int = NTHREADS,
     /,
-) -> ShareDataSample:
+) -> ShareSampleData:
     """Dirichlet-distributed shares with multiple firm-counts.
 
     Firm-counts may be specified as having Uniform distribution over the range
@@ -221,7 +217,6 @@ def _gen_market_shares_dirichlet_multimarket(
         array of market shares and other market statistics
 
     """
-
     _firm_count_wts = (
         DEFAULT_FCOUNT_WTS
         if _firm_count_wts is None or not len(_firm_count_wts)
@@ -310,7 +305,7 @@ def _gen_market_shares_dirichlet_multimarket(
             )
         )
 
-    return ShareDataSample(
+    return ShareSampleData(
         mktshr_array_, fcounts_, nth_firm_share_, aggregate_purchase_prob_
     )
 
@@ -322,7 +317,7 @@ def gen_market_shares_dirichlet(
     _mktshr_rng_seed_seq: SeedSequence,
     _nthreads: int,
     /,
-) -> ShareDataSample:
+) -> ShareSampleData:
     """Dirichlet-distributed shares with fixed firm-count.
 
     Parameters
@@ -349,7 +344,6 @@ def gen_market_shares_dirichlet(
         array of market shares and other market statistics
 
     """
-
     if not isinstance(_dir_alphas, np.ndarray):
         _dir_alphas = np.array(_dir_alphas)
 
@@ -394,7 +388,7 @@ def gen_market_shares_dirichlet(
         aggregate_purchase_prob_ = 1 - mktshr_array[:, [-1]]  # type: ignore
         mktshr_array = mktshr_array[:, :-1] / aggregate_purchase_prob_
 
-    return ShareDataSample(
+    return ShareSampleData(
         mktshr_array,
         (mktshr_array.shape[-1] * np.ones((_s_size, 1))).astype(np.int64),
         mktshr_array[:, [-1]],
@@ -410,7 +404,7 @@ def gen_divr_array(
     /,
 ) -> ArrayDouble:
     """
-    Given merging-firm shares and related parameters, return diverion ratios.
+    Given merging-firm shares and related parameters, return diversion ratios.
 
     If recapture is specified as :attr:`mergeron.RECForm.OUTIN`, then the
     choice-probability for the outside good must be supplied.
@@ -442,7 +436,6 @@ def gen_divr_array(
         Merging-firm diversion ratios for mergers in the sample.
 
     """
-
     divr_array: ArrayDouble
     if _recapture_form == RECForm.FIXED:
         divr_array = _recapture_ratio * _frmshr_array[:, ::-1] / (1 - _frmshr_array)  # type: ignore
@@ -468,7 +461,7 @@ def gen_divr_array(
     return divr_array
 
 
-def gen_margin_price_data(  # noqa: PLR0914
+def gen_margin_price_data(
     _frmshr_array: ArrayDouble,
     _nth_firm_share: ArrayDouble,
     _aggregate_purchase_prob: ArrayDouble,
@@ -479,7 +472,7 @@ def gen_margin_price_data(  # noqa: PLR0914
     _pr_rng_seed_seq: SeedSequence | None,
     _nthreads: int,
     /,
-) -> tuple[MarginDataSample, PriceDataSample]:
+) -> tuple[MarginSampleData, PriceSampleData]:
     """Generate margin and price data for mergers in the sample.
 
     Parameters
@@ -519,8 +512,7 @@ def gen_margin_price_data(  # noqa: PLR0914
     -------
         Simulated margin- and price-data arrays for mergers in the sample.
     """
-
-    margin_data = MarginDataSample(
+    margin_data = MarginSampleData(
         np.empty_like(_frmshr_array), np.ones(len(_frmshr_array)) == 0
     )
 
@@ -590,7 +582,7 @@ def gen_margin_price_data(  # noqa: PLR0914
                 )
                 mnl_test_array = (pcm_array[:, [1]] >= 0) & (pcm_array[:, [1]] <= 1)
 
-            margin_data = MarginDataSample(pcm_array[:, :2], mnl_test_array)
+            margin_data = MarginSampleData(pcm_array[:, :2], mnl_test_array)
             del price_array_here
         case _:
             raise ValueError(
@@ -649,11 +641,11 @@ def gen_margin_price_data(  # noqa: PLR0914
             # Otherwise, all draws meet the filing test
             hsr_filing_test = np.ones(len(_frmshr_array), dtype=bool)
 
-    # Assume that if minimum mergeing-firm share is 10%, merger filing required
+    # Assume that if minimum merging-firm share is 10%, merger filing required
     # under value-of-transactions test or merger triggers post-consummation review
     hsr_filing_test |= _frmshr_array.min(axis=1) >= test_rev_ratio_inv
 
-    return margin_data, PriceDataSample(price_array, hsr_filing_test)
+    return margin_data, PriceSampleData(price_array, hsr_filing_test)
 
 
 def _gen_margin_data(
@@ -664,7 +656,7 @@ def _gen_margin_data(
     _pcm_rng_seed_seq: SeedSequence,
     _nthreads: int,
     /,
-) -> MarginDataSample:
+) -> MarginSampleData:
     dist_type_pcm, dist_parms_pcm, pcm_restriction_ = (
         getattr(_pcm_spec, _f) for _f in ("dist_type", "dist_parms", "pcm_restriction")
     )
@@ -745,14 +737,14 @@ def _gen_margin_data(
     else:
         mnl_test_array = np.ones(len(pcm_array), dtype=bool)
 
-    return MarginDataSample(pcm_array, mnl_test_array)
+    return MarginSampleData(pcm_array, mnl_test_array)
 
 
 def _beta_located(
     _mu: float | ArrayDouble, _sigma: float | ArrayDouble, /
 ) -> ArrayDouble:
     """
-    Given mean and stddev, return shape parameters for corresponding Beta distribution
+    Given mean and stddev, return shape parameters for corresponding Beta distribution.
 
     Solve the first two moments of the standard Beta to get the shape parameters.
 
@@ -768,20 +760,18 @@ def _beta_located(
         shape parameters for Beta distribution
 
     """
-
     mul = -1 + _mu * (1 - _mu) / _sigma**2
     return np.array([_mu * mul, (1 - _mu) * mul], float)
 
 
 def beta_located_bound(_dist_parms: ArrayDouble, /) -> ArrayDouble:
     R"""
-    Return shape parameters for a non-standard beta, given the mean, stddev, range
-
+    Return shape parameters for a non-standard beta, given mean, stddev, and range.
 
     Recover the r.v.s as
     :math:`\min + (\max - \min) \cdot \symup{Β}(a, b)`,
     with `a` and `b` calculated from the specified mean (:math:`\mu`) and
-    variance (:math:`\sigma`). [8]_
+    variance (:math:`\sigma`). [#]_
 
     Parameters
     ----------
@@ -798,8 +788,7 @@ def beta_located_bound(_dist_parms: ArrayDouble, /) -> ArrayDouble:
 
     References
     ----------
-    .. [8] NIST, Beta Distribution. https://www.itl.nist.gov/div898/handbook/eda/section3/eda366h.htm
+    .. [#] NIST, Beta Distribution. https://www.itl.nist.gov/div898/handbook/eda/section3/eda366h.htm
     """  # noqa: RUF002
-
     bmu, bsigma, bmin, bmax = _dist_parms
     return _beta_located((bmu - bmin) / (bmax - bmin), bsigma / (bmax - bmin))

mergeron/gen/enforcement_stats.py

@@ -1,7 +1,4 @@
-"""
-Methods to format and print summary statistics on merger enforcement patterns.
-
-"""
+"""Methods to format and print summary statistics on merger enforcement patterns."""
 
 import enum
 from collections.abc import Mapping
@@ -19,6 +16,8 @@ __version__ = VERSION
 @this_yaml.register_class
 @enum.unique
 class IndustryGroup(str, Enameled):
+    """Industry group of reported markets."""
+
     ALL = "All Markets"
     GRO = "Grocery Markets"
     OIL = "Oil Markets"
@@ -34,21 +33,25 @@ class IndustryGroup(str, Enameled):
 @this_yaml.register_class
 @enum.unique
 class OtherEvidence(str, Enameled):
-    UR = "Unrestricted on additional evidence"
-    HD = "Hot Documents Identified"
-    HN = "No Hot Documents Identified"
-    HU = "No Evidence on Hot Documents"
-    CN = "No Strong Customer Complaints"
-    CS = "Strong Customer Complaints"
-    CU = "No Evidence on Customer Complaints"
-    ED = "Entry Difficult"
-    EE = "Entry Easy"
-    NE = "No Entry Evidence"
+    """Additional evidence available, if any, for reported markets."""
+
+    HOT = "Hot Documents Identified"
+    NHT = "No Hot Documents Identified"
+    HTU = "No Evidence on Hot Documents"
+    NCC = "No Strong Customer Complaints"
+    SCC = "Strong Customer Complaints"
+    CCU = "No Evidence on Customer Complaints"
+    END = "Entry Difficult"
+    EEY = "Entry Easy"
+    EEU = "No Entry Evidence"
+    UNR = "Unrestricted on additional evidence"
 
 
 @this_yaml.register_class
 @enum.unique
 class StatsGrpSelector(str, Enameled):
+    """Measure used to summarize investigations data."""
+
     FC = "ByFirmCount"
     HD = "ByHHIandDelta"
     DL = "ByDelta"
@@ -58,6 +61,8 @@ class StatsGrpSelector(str, Enameled):
 @this_yaml.register_class
 @enum.unique
 class StatsReturnSelector(str, Enameled):
+    """Statistics to report on investigations data."""
+
     CNT = "count"
     RPT = "rate, point"
     RIN = "rate, interval"
@@ -66,6 +71,8 @@ class StatsReturnSelector(str, Enameled):
 @this_yaml.register_class
 @enum.unique
 class SortSelector(str, Enameled):
+    """Sort order for reporting investigations data."""
+
     UCH = "unchanged"
     REV = "reversed"
 
@@ -128,7 +135,7 @@ ZONE_DETAIL_STRINGS_DELTA = {
 
 
 def enf_cnts_obs_by_group(
-    _invdata_array_dict: Mapping[str, Mapping[str, Mapping[str, fid.INVTableData]]],
+    _invdata_array_dict: fid.INVData,
     _study_period: str,
     _table_ind_grp: IndustryGroup,
     _table_evid_cond: OtherEvidence,
@@ -136,6 +143,28 @@ def enf_cnts_obs_by_group(
     _enf_spec: INVResolution,
     /,
 ) -> ArrayBIGINT:
+    """Summarize investigations data by reporting group.
+
+    Parameters
+    ----------
+    _invdata_array_dict
+        raw investigations data
+    _study_period
+        study period
+    _table_ind_grp
+        industry group
+    _table_evid_cond
+        additional evidence
+    _stats_group
+        grouping measure
+    _enf_spec
+        enforcement specification (see, :class:`mergeron.gen.INVResolution`)
+
+    Returns
+    -------
+    ArrayBIGINT
+        Counts of markets resolved as enforced, cleared, or both, respectively.
+    """
     if _stats_group == StatsGrpSelector.HD:
         raise ValueError(
             f"Clearance/enforcement statistics, '{_stats_group}' not valied here."
@@ -164,13 +193,34 @@ def enf_cnts_obs_by_group(
 
 
 def enf_cnts_obs_byfirmcount(
-    _data_array_dict: Mapping[str, Mapping[str, Mapping[str, fid.INVTableData]]],
+    _data_array_dict: fid.INVData,
     _data_period: str = "1996-2003",
     _table_ind_group: IndustryGroup = IndustryGroup.ALL,
-    _table_evid_cond: OtherEvidence = OtherEvidence.UR,
-    _enf_spec: INVResolution = INVResolution.CLRN,
+    _table_evid_cond: OtherEvidence = OtherEvidence.UNR,
+    _enf_spec: INVResolution = INVResolution.ENFT,
     /,
 ) -> ArrayBIGINT:
+    """Summarize investigations data by firm count.
+
+    Parameters
+    ----------
+    _data_array_dict
+        raw investigations data
+    _data_period
+        data period
+    _table_ind_group
+        industry group
+    _table_evid_cond
+        additional evidence
+    _enf_spec
+        enforcement specification (see, :class:`mergeron.gen.INVResolution`)
+
+    Returns
+    -------
+    ArrayBIGINT
+        Counts of markets resolved as enforced, cleared, or both, respectively,
+        reported by number of pre-merger firms.
+    """
     if _data_period not in _data_array_dict:
         raise ValueError(
             f"Invalid value of data period, {f'"{_data_period}"'}."
@@ -197,13 +247,34 @@ def enf_cnts_obs_byfirmcount(
 
 
 def enf_cnts_obs_byhhianddelta(
-    _data_array_dict: Mapping[str, Mapping[str, Mapping[str, fid.INVTableData]]],
+    _data_array_dict: fid.INVData,
     _data_period: str = "1996-2003",
     _table_ind_group: IndustryGroup = IndustryGroup.ALL,
-    _table_evid_cond: OtherEvidence = OtherEvidence.UR,
-    _enf_spec: INVResolution = INVResolution.CLRN,
+    _table_evid_cond: OtherEvidence = OtherEvidence.UNR,
+    _enf_spec: INVResolution = INVResolution.ENFT,
     /,
 ) -> ArrayBIGINT:
+    """Summarize investigations data by HHI and ΔHHI.
+
+    Parameters
+    ----------
+    _data_array_dict
+        raw investigations data
+    _data_period
+        data period
+    _table_ind_group
+        industry group
+    _table_evid_cond
+        additional evidence
+    _enf_spec
+        enforcement specification (see, :class:`mergeron.gen.INVResolution`)
+
+    Returns
+    -------
+    ArrayBIGINT
+        Counts of markets resolved as enforced, cleared, or both, respectively,
+        reported by HHI and ΔHHI.
+    """
     if _data_period not in _data_array_dict:
         raise ValueError(
             f"Invalid value of data period, {f'"{_data_period}"'}."
@@ -232,9 +303,19 @@ def enf_cnts_obs_byhhianddelta(
 def table_no_lku(
     _data_array_dict_sub: Mapping[str, fid.INVTableData],
     _table_ind_group: IndustryGroup = IndustryGroup.ALL,
-    _table_evid_cond: OtherEvidence = OtherEvidence.UR,
+    _table_evid_cond: OtherEvidence = OtherEvidence.UNR,
     /,
 ) -> str:
+    """Lookup table number based on industry group and additional evidence."""
+    if _table_evid_cond not in (
+        _egl := [
+            _data_array_dict_sub[_v].additional_evidence for _v in _data_array_dict_sub
+        ]
+    ):
+        raise ValueError(
+            f"Invalid value for additional evidence, {f'"{_table_evid_cond}"'}."
+            f"Must be one of {_egl!r}"
+        )
     if _table_ind_group not in (
         _igl := [_data_array_dict_sub[_v].industry_group for _v in _data_array_dict_sub]
     ):
@@ -256,6 +337,18 @@ def table_no_lku(
 
 
 def enf_cnts_byfirmcount(_cnts_array: ArrayBIGINT, /) -> ArrayBIGINT:
+    """Summarize investigations data by firm count.
+
+    Parameters
+    ----------
+    _cnts_array
+        raw investigations data array
+
+    Returns
+    -------
+    ArrayBIGINT
+        Subtotals for columns other than the first, grouped by the first column.
+    """
     if not _cnts_array[:, 0].any():
         return np.array([], int)
 
@@ -272,6 +365,20 @@ def enf_cnts_byfirmcount(_cnts_array: ArrayBIGINT, /) -> ArrayBIGINT:
 
 
 def enf_cnts_bydelta(_cnts_array: ArrayBIGINT, /) -> ArrayBIGINT:
+    """Summarize investigations data by ΔHHI.
+
+    Parameters
+    ----------
+    _cnts_array
+        raw investigations data array
+
+    Returns
+    -------
+    ArrayBIGINT
+        Subtotals for columns higher than the second, grouped by the second column.
+    """
+    if not _cnts_array[:, 1].any():
+        return np.array([], int)
     ndim_in = 2
     return np.vstack([
         np.concatenate([
@@ -285,9 +392,23 @@ def enf_cnts_bydelta(_cnts_array: ArrayBIGINT, /) -> ArrayBIGINT:
 
 
 def enf_cnts_byconczone(_cnts_array: ArrayBIGINT, /) -> ArrayBIGINT:
+    """Summarize investigations data by concentration zone, as defined in the Guidelines.
+
+    Includes sub-total detail for "Moderately Concentrated" and "Unconcentrated" markets.
+
+    Parameters
+    ----------
+    _cnts_array
+        raw investigations data array
+
+    Returns
+    -------
+    ArrayBIGINT
+        Subtotals range of HHI and ΔHHI, with detail
+    """
     if not _cnts_array[:, 0].any() or np.isnan(_cnts_array[:, 0]).all():
         return np.array([], int)
-    # Step 1: Tag and agg. from HHI-post and Delta to zone triple
+    # Step 1: Tag and agg. from HHI-post and ΔHHI to zone triple
     # NOTE: Although you could just map and not (partially) aggregate in this step,
     # the mapped array is a copy, and is larger without partial aggregation, so
     # aggregation reduces the footprint of this step in memory. Although this point

mergeron/gen/upp_tests.py

@@ -1,8 +1,4 @@
-"""
-Methods to compute intrinsic clearance rates and intrinsic enforcement rates
-from generated market data.
-
-"""
+"""Methods to compute intrinsic enforcement/clearance rates from generated market data."""
 
 from collections.abc import Sequence
 from typing import TypedDict
@@ -28,20 +24,20 @@ __version__ = VERSION
 
 
 class INVRESCntsArgs(TypedDict, total=False):
-    "Keyword arguments of function, :code:`sim_enf_cnts`"
+    """Keyword arguments of function, :code:`sim_enf_cnts`."""
 
     sample_size: int
     seed_seq_list: Sequence[SeedSequence] | None
     nthreads: int
 
 
-def compute_upp_test_counts(  # noqa: PLR0914
+def compute_upp_test_counts(
     _market_data_sample: MarketSampleData,
     _upp_test_parms: gbl.HMGThresholds,
     _upp_test_regime: UPPTestRegime,
     /,
 ) -> UPPTestsCounts:
-    """Estimate enforcement and clearance counts from market data sample
+    """Estimate enforcement and clearance counts from market data sample.
 
     Parameters
     ----------
@@ -64,7 +60,6 @@ def compute_upp_test_counts(  # noqa: PLR0914
         Enforced and cleared counts
 
     """
-
     g_bar_, divr_bar_, cmcr_bar_, ipr_bar_ = (
         getattr(_upp_test_parms, _f) for _f in ("guppi", "divr", "cmcr", "ipr")
     )

mergeron-2025.739341.8.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.3
+Name: mergeron
+Version: 2025.739341.8
+Summary: Python for analyzing merger enforcement policy
+License: MIT
+Keywords: merger policy analysis,merger guidelines,merger screening,policy presumptions,concentration standards,upward pricing pressure,GUPPI
+Author: Murthy Kambhampaty
+Author-email: smk@capeconomics.com
+Requires-Python: >=3.12
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Dist: aenum (>=3.1.15,<4.0.0)
+Requires-Dist: attrs (>=23.2)
+Requires-Dist: bs4 (>=0.0.1)
+Requires-Dist: certifi (>=2023.11.17)
+Requires-Dist: h5py (>=3.13.0,<4.0.0)
+Requires-Dist: jinja2 (>=3.1)
+Requires-Dist: joblib (>=1.3)
+Requires-Dist: linuxdoc (>=20240924,<20240925)
+Requires-Dist: lxml (>=5.3.1,<6.0.0)
+Requires-Dist: matplotlib (>=3.8)
+Requires-Dist: mpmath (>=1.3)
+Requires-Dist: python-calamine (>=0.3.1,<0.4.0)
+Requires-Dist: ruamel-yaml (>=0.18.10,<0.19.0)
+Requires-Dist: scipy (>=1.12)
+Requires-Dist: sympy (>=1.12)
+Requires-Dist: types-beautifulsoup4 (>=4.11.2)
+Requires-Dist: urllib3 (>=2.2.2,<3.0.0)
+Project-URL: Documentation, https://capeconomics.github.io/mergeron/
+Project-URL: Repository, https://github.com/capeconomics/mergeron.git
+Description-Content-Type: text/x-rst
+
+mergeron: Python for analyzing merger enforcement policy
+========================================================
+
+
+.. image:: https://img.shields.io/pypi/v/mergeron
+   :alt: PyPI - Package Version
+   :target: https://pypi.python.org/pypi/mergeron/
+.. image:: https://img.shields.io/pypi/pyversions/mergeron
+   :alt: PyPI - Python Version
+   :target: https://pypi.python.org/pypi/mergeron/
+.. image:: https://img.shields.io/pypi/status/mergeron
+   :alt: PyPI - Package status
+   :target: https://pypi.python.org/pypi/mergeron/
+
+|
+
+.. 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/badge/code%20style-black-000000
+   :target: https://github.com/psf/black
+.. image:: https://img.shields.io/badge/License-MIT-yellow
+   :alt: License: MIT
+   :target: https://opensource.org/licenses/MIT
+
+
+*Visualize* the sets of mergers falling within specified concentration and diversion-ratio thresholds.  *Analyze* merger investigations data published by the U.S. Federal Trade Commission in various reports on extended merger investigations (Second Requests) during 1996 to 2011.
+*Generate* data under specified distributions of firm counts, market shares, price-cost margins, and prices, optionally imposing equilibrium conditions for Bertrand oligopoly with MNL demand and or restrictions implied by statutory filing thresholds. *Compute* intrinsic enforcement rates or
+intrinsic clearance rates using the generated data, given thresholds for
+concentration;
+diversion ratio;
+gross upward pricing pressure (GUPPI);
+critical marginal cost reduction (CMCR); and
+illustrative price rise (IPR).
+
+Installation
+------------
+
+To install the package, use the following shell command:
+
+.. code:: bash
+
+    pip install mergeron
+
+
+Documentation 
+-------------
+
+Usage guide and API reference available `here <https://capeconomics.github.io/mergeron/>`_.
+

mergeron-2025.739341.8.dist-info/RECORD

@@ -0,0 +1,20 @@
+mergeron/__init__.py,sha256=teyW3ktycQTdjw8WVqhlwrk9xi9LOI05KgKWLuCHJ9E,5773
+mergeron/core/__init__.py,sha256=NChJfOkahbGPa1Ll1fO3agY5-IoDlEra3xNkXPnKIVM,3259
+mergeron/core/empirical_margin_distribution.py,sha256=qfCsalO3EnsGclYeFxCgRu_-shbXP5kYIMf328lLC80,11455
+mergeron/core/ftc_merger_investigations_data.py,sha256=k4TDkP1rDBmN4uKOYF0SUvSRkYmyVhbsBvLUKDYJqOo,28537
+mergeron/core/guidelines_boundaries.py,sha256=Ct6JiuFjSVuCz-m-yeUc50xTC7F4tLgsyqXitb_nObI,15551
+mergeron/core/guidelines_boundary_functions.py,sha256=ycz0W5tV9oJ9vVH83IVaprOW4RmG68q8t1QROkQcwxU,29048
+mergeron/core/guidelines_boundary_functions_extra.py,sha256=bFRpPGKPHhuhXI67GlEOKtQrNo7WVTK7yMd9NlHCc-M,22095
+mergeron/core/pseudorandom_numbers.py,sha256=-mPveXjJJ446NrBMAmWIa2jI6j0Px0xcCJTGEEsn3bo,10149
+mergeron/data/__init__.py,sha256=CbqheFSkXEe7NOfuAV-NLaaEiNzl9pVCndGjtUUOj9g,1846
+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=vr4B3AynBeohLPYeb6kD_iPdEOtta-dUfA7_Bi-l-jI,23649
+mergeron/gen/data_generation.py,sha256=M7RBJO8distfdFPFQcQM4Mpfi2Etxy9HEw5EoyjWDow,17347
+mergeron/gen/data_generation_functions.py,sha256=f6aLBg6JNqOoBq57k3ovevgvtaLfIAfT-ATzZl11CEA,26076
+mergeron/gen/enforcement_stats.py,sha256=-vxB6U0dyXRmPZzhJ-8LyPESMycbnG4Tf95ydneIgjQ,14246
+mergeron/gen/upp_tests.py,sha256=gRJISQ2jGmIDmFOvaTIkvYooI4mK-QbgkfgL46RrRio,7445
+mergeron/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+mergeron-2025.739341.8.dist-info/METADATA,sha256=Toe2o1UJ7X-jQh2qAqL7AIqzLQa6lNKlbVmtYFja6rs,3906
+mergeron-2025.739341.8.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+mergeron-2025.739341.8.dist-info/RECORD,,

{mergeron-2025.739319.3.dist-info → mergeron-2025.739341.8.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.1
+Generator: poetry-core 2.1.2
 Root-Is-Purelib: true
 Tag: py3-none-any