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

mergeron-2025.739341.9.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.3
+Name: mergeron
+Version: 2025.739341.9
+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
+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.9.dist-info/RECORD

@@ -0,0 +1,20 @@
+mergeron/__init__.py,sha256=1fy_MtURkE0G64B516588FRg_-zlk10Z_SwEWNFEE3c,5773
+mergeron/core/__init__.py,sha256=NChJfOkahbGPa1Ll1fO3agY5-IoDlEra3xNkXPnKIVM,3259
+mergeron/core/empirical_margin_distribution.py,sha256=Gm3nLbovlqD7gk2lrBx_RWufj4MK5SkUQ_BUj-d9bhg,11484
+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=etTax-sBSn8DveF-IxuBJDdX0XSBD6oFU9vaZe6cYks,14387
+mergeron/gen/upp_tests.py,sha256=gRJISQ2jGmIDmFOvaTIkvYooI4mK-QbgkfgL46RrRio,7445
+mergeron/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+mergeron-2025.739341.9.dist-info/METADATA,sha256=mj88h8xd5Ni04z7kTP-rxpC0jCFNyK3Nqt_XzAM1Agw,3930
+mergeron-2025.739341.9.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+mergeron-2025.739341.9.dist-info/RECORD,,

{mergeron-2025.739319.3.dist-info → mergeron-2025.739341.9.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

mergeron/demo/__init__.py

@@ -1,3 +0,0 @@
-from .. import VERSION  # noqa: TID252
-
-__version__ = VERSION

mergeron/demo/visualize_empirical_margin_distribution.py

@@ -1,94 +0,0 @@
-"""
-Plot the empirical distribution derived using the Gaussian KDE with
-margin data downloaded from Prof. Damodaran's website at NYU.
-
-"""
-
-import warnings
-from pathlib import Path
-
-import numpy as np
-from matplotlib.ticker import StrMethodFormatter
-from numpy.random import PCG64DXSM, Generator, SeedSequence
-from scipy import stats  # type: ignore
-
-import mergeron.core.empirical_margin_distribution as emd
-from mergeron import WORK_DIR as PKG_WORK_DIR
-from mergeron.core.guidelines_boundary_functions import boundary_plot
-
-WORK_DIR = globals().get("WORK_DIR", PKG_WORK_DIR)
-"""Redefined, in case the user defines WORK_DIR betweeen module imports."""
-
-SAMPLE_SIZE = 10**6
-BIN_COUNT = 25
-margin_data, margin_data_stats = emd.margin_data_builder()
-
-margin_data_obs, margin_data_wts = margin_data[:, 0], margin_data[:, 1]
-
-print(repr(margin_data_obs))
-print(repr(margin_data_stats))
-
-plt, mgn_fig, mgn_ax, set_axis_def = boundary_plot(mktshare_plot_flag=False)
-mgn_fig.set_figheight(6.5)
-mgn_fig.set_figwidth(9.0)
-
-_, mgn_bins, _ = mgn_ax.hist(
-    x=margin_data_obs,
-    weights=margin_data_wts,
-    bins=BIN_COUNT,
-    alpha=0.4,
-    density=True,
-    label="Downloaded data",
-    color="#004488",  # Paul Tol's High Contrast Blue
-)
-
-with warnings.catch_warnings():
-    warnings.filterwarnings("ignore", category=UserWarning)
-    # Don't warn regarding the below; ticklabels have been fixed before this point
-    mgn_ax.set_yticklabels([
-        f"{float(_g.get_text()) * np.diff(mgn_bins)[-1]:.0%}"
-        for _g in mgn_ax.get_yticklabels()
-    ])
-
-mgn_kde = stats.gaussian_kde(
-    margin_data_obs, weights=margin_data_wts, bw_method="silverman"
-)
-mgn_kde.set_bandwidth(bw_method=mgn_kde.factor / 3.0)
-
-mgn_ax.plot(
-    (_xv := np.linspace(0, BIN_COUNT, 10**5) / BIN_COUNT),
-    mgn_kde(_xv),
-    color="#004488",
-    rasterized=True,
-    label="Estimated Density",
-)
-
-mgn_ax.hist(
-    x=mgn_kde.resample(
-        SAMPLE_SIZE, seed=Generator(PCG64DXSM(SeedSequence(pool_size=8)))
-    )[0],
-    color="#DDAA33",  # Paul Tol's High Contrast Yellow
-    alpha=0.6,
-    bins=BIN_COUNT,
-    density=True,
-    label="Generated data",
-)
-
-mgn_ax.legend(
-    loc="best",
-    fancybox=False,
-    shadow=False,
-    frameon=True,
-    facecolor="white",
-    edgecolor="white",
-    framealpha=1,
-    fontsize="small",
-)
-
-mgn_ax.set_xlim(0.0, 1.0)
-mgn_ax.xaxis.set_major_formatter(StrMethodFormatter("{x:>3.0%}"))
-mgn_ax.set_xlabel("Price Cost Margin", fontsize=10)
-mgn_ax.set_ylabel("Relative Frequency", fontsize=10)
-
-mgn_fig.tight_layout()
-plt.savefig(WORK_DIR / f"{Path(__file__).stem}.pdf")

mergeron-2025.739319.3.dist-info/METADATA

@@ -1,174 +0,0 @@
-Metadata-Version: 2.3
-Name: mergeron
-Version: 2025.739319.3
-Summary: Analyze merger enforcement policy using Python
-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,<4.0
-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.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3 :: Only
-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: matplotlib (>=3.8)
-Requires-Dist: mpmath (>=1.3)
-Requires-Dist: msgpack (>=1.0)
-Requires-Dist: msgpack-numpy (>=0.4)
-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)
-Requires-Dist: xlrd (>=2.0.1,<3.0.0)
-Requires-Dist: xlsxwriter (>=3.1)
-Description-Content-Type: text/x-rst
-
-mergeron: Merger Policy Analysis with Python
-============================================
-
-Usage
------
-
-*Visualizing Guidelines boundaries*
-
-.. code:: python
-
-    %matplotlib inline
-    from mergeron.core import guidelines_boundaries as gbl
-    from mergeron.core import guidelines_boundary_functions as gbf
-    from math import sqrt
-
-    delta_bound = 0.01
-    conc_boundary = gbl.ConcentrationBoundary(delta_bound, "ΔHHI")
-    share_boundary = gbl.ConcentrationBoundary(2 * sqrt(delta_bound / 2), "Combined share")
-
-    divr_boundary_a = gbl.DiversionRatioBoundary(
-        gbl.guppi_from_delta(delta_bound, m_star=1.0, r_bar=0.85),
-        agg_method=gbl.UPPAggrSelector.AVG
-    )
-
-    divr_boundary_i = gbl.DiversionRatioBoundary(
-        gbl.guppi_from_delta(delta_bound, m_star=1.0, r_bar=0.85),
-        agg_method=gbl.UPPAggrSelector.MIN
-    )
-
-    divr_boundary_x = gbl.DiversionRatioBoundary(
-        gbl.guppi_from_delta(delta_bound, m_star=1.0, r_bar=0.85),
-        agg_method=gbl.UPPAggrSelector.MAX
-    )
-
-
-Plots are written to PDF, typically, with ``backend="pgf"`` as the
-default backend in the function, ``gbf.boundary_plot``. Here, we set the
-backend to ``None`` to skip fine-tuning plots for PDF generation.
-
-.. code:: python
-
-    plt, fig, ax, layout_axis = gbf.boundary_plot(backend=None)
-
-    ax.set_title("Concentration and Diversion Ratio Boundaries")
-
-    ax.plot(conc_boundary.coordinates[:, 0], conc_boundary.coordinates[:, 1], color="black", linestyle="-", label="ΔHHI")
-    ax.plot(share_boundary.coordinates[:, 0], share_boundary.coordinates[:, 1], color="black", linestyle=":", label="Combined share")
-    ax.plot(divr_boundary_a.coordinates[:, 0], divr_boundary_a.coordinates[:, 1], "b-", label="Average Diversion Ratio")
-    ax.plot(divr_boundary_i.coordinates[:, 0], divr_boundary_i.coordinates[:, 1], "r-", label="Minimum Diversion Ratio")
-    ax.plot(divr_boundary_x.coordinates[:, 0], divr_boundary_x.coordinates[:, 1], "g-", label="Maximum Diversion Ratio")
-
-    _ = fig.legend(loc=(0.4, 0.7), frameon=False)
-
-
-*Analyzing FTC Merger Investigations Data*
-
-.. code:: python
-
-    from mergeron.core import ftc_merger_investigations_data as fid
-    import tabulate
-
-    inv_data = fid.construct_data(fid.INVDATA_ARCHIVE_PATH)
-
-
-We can now analyze counts of markets reported in the source data, by
-table number. Note that odd-numbered tables report FTC investigations
-data organized by HHI and ΔHHI, while even-numbered tables report by
-firm-count.
-
-.. code:: python
-
-    from mergeron.gen import enforcement_stats as esl
-
-    print("Enforcement Rates in Markets with Entry Barriers, 1996-2003 vs 2004-2011")
-    print()
-    counts_by_delta_1 = esl.enf_cnts_bydelta(
-        inv_data["1996-2003"]["ByHHIandDelta"]["Table 9.2"].data_array
-    )
-    counts_by_delta_2 = esl.enf_cnts_bydelta(
-        inv_data["2004-2011"]["ByHHIandDelta"]["Table 9.2"].data_array
-    )
-    observed_enforcement_rates = list(zip(
-        (
-            {_v: _k for _k, _v in fid.CONC_DELTA_DICT.items()}[i]
-            for i in counts_by_delta_1[:, 0]
-        ),
-        (
-            f"{_a[1] / _a[-1]: <12.2%}" if _a[-1] else "--"
-            for _a in counts_by_delta_1
-        ),
-        (
-            f"{_e[1] / _e[-1]: <12.2%}" if _e[-1] else "--"
-            for _e in counts_by_delta_2
-        ),
-    ))
-
-    observed_enforcement_rates.append([
-        "Total",
-        f"{counts_by_delta_1[:, 1].sum() / counts_by_delta_1[:, -1].sum(): <12.2%}",
-        f"{counts_by_delta_2[:, 1].sum() / counts_by_delta_2[:, -1].sum(): <12.2%}",
-    ])
-
-    print(tabulate.tabulate(
-        observed_enforcement_rates,
-        tablefmt="simple",
-        headers=("ΔHHI", "1996-2003", "2004-2011"),
-        stralign="center",
-        maxcolwidths=36,
-        maxheadercolwidths=36,
-    ))
-
-
-.. parsed-literal::
-
-    Enforcement Rates in Markets with Entry Barriers, 1996-2003 vs 2004-2011
-
-        ΔHHI        1996-2003    2004-2011
-    -------------  -----------  -----------
-       0 - 100         --         100.00%
-      100 - 200      33.33%       50.00%
-      200 - 300      33.33%       50.00%
-      300 - 500      75.00%       77.78%
-      500 - 800      59.09%       54.55%
-     800 - 1,200     93.33%       81.82%
-    1,200 - 2,500    90.91%       84.38%
-       2,500 +       96.00%       100.00%
-        Total        81.65%       82.86%
-
-
-Generating synthetic market data and analyzing enforcement rates
-
-
-

mergeron-2025.739319.3.dist-info/RECORD

@@ -1,22 +0,0 @@
-mergeron/__init__.py,sha256=28Yan2f3uiw5fugxpGMd8mwr0JyWS9tYjkoDXTiAE-U,5549
-mergeron/core/__init__.py,sha256=BzL_bXHyOQG8cvo76OP3K48LkeHQCJQN7ZFPRhoOdcE,2850
-mergeron/core/empirical_margin_distribution.py,sha256=PwAxOLc7zgL4OHVH1kQRtxP7m5XAVUPtMVomM2uvnKM,9527
-mergeron/core/ftc_merger_investigations_data.py,sha256=DYqtyxGPnpGyaWbQ8dPHmHmQBOeHbmU5h9snk-YwSN4,28575
-mergeron/core/guidelines_boundaries.py,sha256=hZ3Fiobb9KXCBybQjb_xJj4q_-r8ClmxRjd6Scv7Km4,15238
-mergeron/core/guidelines_boundary_functions.py,sha256=wQdIQcEga888vVe3cAwYsDa7HTaxgqe3RbV48UklmzQ,29064
-mergeron/core/guidelines_boundary_functions_extra.py,sha256=i2CmEpYRUVnMbPakSjlyWodMP11JW-rkVImhKOQlV6g,22355
-mergeron/core/pseudorandom_numbers.py,sha256=YqcVwU-Pgc0F_pKzG9Osn14RnIuYOwE-q7GVDpCUtpI,9998
-mergeron/data/__init__.py,sha256=4yOOvERJ28JIT5KRkIa_t2y9aYmuFdStPM4P38BsufM,1806
-mergeron/data/damodaran_margin_data.xls,sha256=Qggl1p5nkOMJI8YUXhkwXQRz-OhRSqBTzz57N0JQyYA,79360
-mergeron/data/ftc_merger_investigations_data.zip,sha256=tiB2TLFyS9LMSFIv8DBA_oEEx12DU4MyjHni4NlsRMU,24002
-mergeron/demo/__init__.py,sha256=KtjBlZOl7jwBCAUhrTJB9PdrN39YLYytNiSUSM_gRmA,62
-mergeron/demo/visualize_empirical_margin_distribution.py,sha256=N8pYTl11ngG-W5WOjjYDigCIZs5LPVrUNxdgEHLwTHE,2584
-mergeron/gen/__init__.py,sha256=6UZ7u1a2rw9iSaGjnpNf1E9IXukHPU9iIDaauruQ7-g,23450
-mergeron/gen/data_generation.py,sha256=a9RZxlcwN7jInxSTomCZUVKPsIE_YUMSfRabizYN62U,17147
-mergeron/gen/data_generation_functions.py,sha256=8UkO3GBqTTrfFSsxiJ9Z-AbxR7XiKv6QJBkd07sx1f0,26123
-mergeron/gen/enforcement_stats.py,sha256=wtWMbMHK_G3yw4zaNQR9fdmu8crbzeFKjBvY-b1mom4,11132
-mergeron/gen/upp_tests.py,sha256=qCyIMY8fuaRqGobwlcu3SPpIlD-dDNdM53qC8CTx59k,7480
-mergeron/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-mergeron-2025.739319.3.dist-info/METADATA,sha256=yoBYK3tulJtDDc4oFIYM93okbyqEN73Kiv97hk1JVKc,6056
-mergeron-2025.739319.3.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-mergeron-2025.739319.3.dist-info/RECORD,,