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

mergeron/gen/{investigations_stats.py → enforcement_stats.py}

@@ -1,5 +1,5 @@
 """
-Methods to format and print summary data on merger enforcement patterns.
+Methods to format and print summary statistics on merger enforcement patterns.
 
 """
 
@@ -7,7 +7,7 @@ import enum
 import shutil
 import subprocess
 from collections.abc import Mapping, Sequence
-from importlib.metadata import version
+from importlib import resources
 from pathlib import Path
 from types import SimpleNamespace
 
@@ -17,12 +17,12 @@ from jinja2 import Environment, FileSystemLoader, Template, select_autoescape
 from numpy.typing import NDArray
 from scipy.interpolate import interp1d  # type: ignore
 
-from .. import _PKG_NAME, DATA_DIR  # noqa: TID252
+from .. import _PKG_NAME, DATA_DIR, VERSION  # noqa: TID252
 from ..core import ftc_merger_investigations_data as fid  # noqa: TID252
 from ..core.proportions_tests import propn_ci  # noqa: TID252
-from . import TF, TI, INVResolution
+from . import INVResolution
 
-__version__ = version(_PKG_NAME)
+__version__ = VERSION
 
 
 @enum.unique
@@ -108,38 +108,42 @@ class StatsContainer(SimpleNamespace):
 
 # Define the latex jinja environment
 # http://eosrei.net/articles/2015/11/latex-templates-python-and-jinja2-generate-pdfs
-latex_jinja_env = Environment(
-    block_start_string=R"((*",
-    block_end_string="*))",
-    variable_start_string=R"\JINVAR{",
-    variable_end_string="}",
-    comment_start_string=R"((#",  # r'#{',
-    comment_end_string=R"#))",  # '}',
-    line_statement_prefix="##",
-    line_comment_prefix="%#",
-    trim_blocks=True,
-    lstrip_blocks=True,
-    autoescape=select_autoescape(disabled_extensions=("tex.jinja2",)),
-    loader=FileSystemLoader(Path(__file__).parents[1] / "jinja_LaTex_templates"),
-)
+with resources.as_file(
+    resources.files(f"{_PKG_NAME}.data.jinja2_LaTeX_templates")
+) as _tmpl_folder:
+    latex_jinja_env = Environment(
+        block_start_string=R"((*",
+        block_end_string="*))",
+        variable_start_string=R"\JINVAR{",
+        variable_end_string="}",
+        comment_start_string=R"((#",  # r'#{',
+        comment_end_string=R"#))",  # '}',
+        line_statement_prefix="##",
+        line_comment_prefix="%#",
+        trim_blocks=True,
+        lstrip_blocks=True,
+        autoescape=select_autoescape(disabled_extensions=("tex.jinja2",)),
+        loader=FileSystemLoader(_tmpl_folder),
+    )
 
 # Place files related to rendering latex in output data directory
 if not (_out_path := DATA_DIR.joinpath(f"{_PKG_NAME}.cls")).is_file():
-    shutil.copyfile(
-        Path(__file__).parents[1].joinpath("jinja_LaTex_templates", "mergeron.cls"),
-        _out_path,
-    )
+    with resources.as_file(
+        resources.files(f"{_PKG_NAME}.data.jinja2_LaTeX_templates").joinpath(
+            "{_PKG_NAME}.cls"
+        )
+    ) as _in_path:
+        shutil.copy2(_in_path, _out_path)
 
 
 if not (_DOTTEX := DATA_DIR / Rf"{_PKG_NAME}_TikZTableSettings.tex").is_file():
     # Write to dottex
-    with _DOTTEX.open("w", encoding="UTF-8") as _table_helper_dottex:
-        _table_helper_dottex.write(
-            latex_jinja_env.get_template("setup_tikz_tables.tex.jinja2").render(
-                tmpl_data=StatsContainer()
-            )
+    with resources.as_file(
+        resources.files(f"{_PKG_NAME}.data.jinja2_LaTeX_templates").joinpath(
+            "setup_tikz_tables.tex"
         )
-        print("\n", file=_table_helper_dottex)
+    ) as _tex_path:
+        shutil.copy2(_tex_path, _DOTTEX)
 
 
 # Parameters and functions to interpolate selected HHI and ΔHHI values
@@ -172,7 +176,7 @@ HMG_PRESUMPTION_ZONE_DICT = {
 }
 
 ZONE_VALS = np.unique(
-    np.row_stack([
+    np.vstack([
         tuple(HMG_PRESUMPTION_ZONE_DICT[_k].values())
         for _k in HMG_PRESUMPTION_ZONE_DICT
     ]),
@@ -375,7 +379,7 @@ def table_no_lku(
     /,
 ) -> str:
     if _table_ind_group not in (
-        _igl := [_data_array_dict_sub[_v].ind_grp for _v in _data_array_dict_sub]
+        _igl := [_data_array_dict_sub[_v].industry_group for _v in _data_array_dict_sub]
     ):
         raise ValueError(
             f"Invalid value for industry group, {f'"{_table_ind_group}"'}."
@@ -386,19 +390,17 @@ def table_no_lku(
         _t
         for _t in _data_array_dict_sub
         if all((
-            _data_array_dict_sub[_t].ind_grp == _table_ind_group,
-            _data_array_dict_sub[_t].evid_cond == _table_evid_cond,
+            _data_array_dict_sub[_t].industry_group == _table_ind_group,
+            _data_array_dict_sub[_t].additional_evidence == _table_evid_cond,
         ))
     )
 
     return _tno
 
 
-def invres_cnts_byfirmcount(
-    _cnts_array: NDArray[np.integer[TI]], /
-) -> NDArray[np.int64]:
+def invres_cnts_byfirmcount(_cnts_array: NDArray[np.int64], /) -> NDArray[np.int64]:
     _ndim_in = 1
-    return np.row_stack([
+    return np.vstack([
         np.concatenate([
             (f,),
             np.einsum("ij->j", _cnts_array[_cnts_array[:, 0] == f][:, _ndim_in:]),
@@ -407,9 +409,9 @@ def invres_cnts_byfirmcount(
     ])
 
 
-def invres_cnts_bydelta(_cnts_array: NDArray[np.integer[TI]], /) -> NDArray[np.int64]:
+def invres_cnts_bydelta(_cnts_array: NDArray[np.int64], /) -> NDArray[np.int64]:
     _ndim_in = 2
-    return np.row_stack([
+    return np.vstack([
         np.concatenate([
             (f,),
             np.einsum("ij->j", _cnts_array[_cnts_array[:, 1] == f][:, _ndim_in:]),
@@ -418,9 +420,7 @@ def invres_cnts_bydelta(_cnts_array: NDArray[np.integer[TI]], /) -> NDArray[np.i
     ])
 
 
-def invres_cnts_byconczone(
-    _cnts_array: NDArray[np.integer[TI]], /
-) -> NDArray[np.int64]:
+def invres_cnts_byconczone(_cnts_array: NDArray[np.int64], /) -> NDArray[np.int64]:
     # Prepare to tag clearance stats by presumption zone
     _hhi_zone_post_ranged = hhi_zone_post_ranger(_cnts_array[:, 0] / 1e4)
     _hhi_delta_ranged = hhi_delta_ranger(_cnts_array[:, 1] / 1e4)
@@ -453,7 +453,7 @@ def invres_cnts_byconczone(
 
             _conc_test = _level_test & _delta_test
 
-            _cnts_byhhipostanddelta = np.row_stack((
+            _cnts_byhhipostanddelta = np.vstack((
                 _cnts_byhhipostanddelta,
                 np.array(
                     (
@@ -475,7 +475,7 @@ def invres_cnts_byconczone(
             ])
         ).prod(axis=1) == 1
 
-        _cnts_byconczone = np.row_stack((
+        _cnts_byconczone = np.vstack((
             _cnts_byconczone,
             np.concatenate(
                 (
@@ -492,7 +492,7 @@ def invres_cnts_byconczone(
 
 
 def latex_tbl_invres_stats_1dim(
-    _inparr: NDArray[np.floating[TF] | np.integer[TI]],
+    _inparr: NDArray[np.float64 | np.int64],
     _totals_row: int | None = None,
     /,
     *,
@@ -527,7 +527,7 @@ def latex_tbl_invres_stats_1dim(
     if sort_order == SortSelector.REV:
         _inparr = _inparr[::-1]
 
-    _inparr = np.row_stack((_inparr, _in_totals_row))
+    _inparr = np.vstack((_inparr, _in_totals_row))
 
     _stats_hdr_list, _stats_dat_list = [], []
     for _stats_row in _inparr:
@@ -544,7 +544,7 @@ def latex_tbl_invres_stats_1dim(
 
 
 def latex_tbl_invres_stats_byzone(
-    _inparr: NDArray[np.floating[TF] | np.integer[TI]],
+    _inparr: NDArray[np.float64 | np.int64],
     _totals_row: int | None = None,
     /,
     *,
@@ -559,7 +559,7 @@ def latex_tbl_invres_stats_byzone(
         _zone_str_keys = _zone_str_keys[:-1][::-1] + [_zone_str_keys[-1]]
 
     if _totals_row is None:
-        _inparr = np.row_stack((
+        _inparr = np.vstack((
             _inparr,
             np.concatenate((
                 [fid.TTL_KEY, -1, -1],
@@ -611,8 +611,8 @@ def latex_tbl_invres_stats_byzone(
 
 
 def _stats_formatted_row(
-    _stats_row_cnt: NDArray[np.integer[TI]],
-    _stats_row_tot: NDArray[np.integer[TI]],
+    _stats_row_cnt: NDArray[np.int64],
+    _stats_row_tot: NDArray[np.int64],
     _return_type_sel: StatsReturnSelector,
     /,
 ) -> list[list[str]]:
@@ -691,19 +691,21 @@ def render_table_pdf(
         )
         print("\n", file=_table_coll_file)
 
-    _run_rc = subprocess.run(
-        f"latexmk -f -quiet -synctex=0 -interaction=nonstopmode -file-line-error -pdflua {_table_coll_path}".split(),  # noqa: S603
+    _run_rc = subprocess.run(  # noqa: S603
+        f"latexmk -f -quiet -synctex=0 -interaction=nonstopmode -file-line-error -pdflua {_table_coll_path}".split(),
         check=True,
         cwd=DATA_DIR,
     )
     if _run_rc:
-        subprocess.run(
-            "latexmk -quiet -c".split(),  # noqa: S603
-            check=True,
-            cwd=DATA_DIR,
-        )
+        subprocess.run("latexmk -quiet -c".split(), check=True, cwd=DATA_DIR)  # noqa: S603
     del _run_rc
 
     print(
         f"Tables rendered to path, {f"{Path(DATA_DIR / _table_coll_path).with_suffix(".pdf")}"}"
     )
+
+
+if __name__ == "__main__":
+    print(
+        "This module provides methods to format and print summary statistics on merger enforcement patterns.."
+    )

mergeron/gen/market_sample.py

@@ -5,18 +5,16 @@ Methods to generate data for analyzing merger enforcement policy.
 
 from __future__ import annotations
 
-from importlib.metadata import version
-
 from attrs import define
 from numpy.random import SeedSequence
 
-from .. import _PKG_NAME  # noqa: TID252
-from ..core import guidelines_boundaries as gbl  # noqa: TID252
+from .. import VERSION  # noqa: TID252
+from ..core.guidelines_boundaries import HMGThresholds  # noqa: TID252
 from . import MarketSpec, UPPTestRegime
 from .data_generation import gen_market_sample
 from .upp_tests import SaveData, invres_cnts, save_data_to_hdf5, sim_invres_cnts_ll
 
-__version__ = version(_PKG_NAME)
+__version__ = VERSION
 
 
 @define(slots=False)
@@ -50,7 +48,7 @@ class MarketSample(MarketSpec):
 
     def estimate_invres_counts(
         self,
-        _invres_parm_vec: gbl.HMGThresholds,
+        _invres_parm_vec: HMGThresholds,
         _upp_test_regime: UPPTestRegime,
         /,
         *,
@@ -73,7 +71,5 @@ class MarketSample(MarketSpec):
             self.invres_counts = invres_cnts(
                 self.data, _invres_parm_vec, _upp_test_regime
             )
-            if save_data_to_file:
-                save_data_to_hdf5(
-                    self.invres_counts, save_data_to_file=save_data_to_file
-                )
+        if save_data_to_file:
+            save_data_to_hdf5(self.invres_counts, save_data_to_file=save_data_to_file)

mergeron/gen/upp_tests.py

@@ -1,24 +1,22 @@
 """
-Methods to estimate intrinsic clearnace rates and intrinsic enforcement rates
+Methods to compute intrinsic clearance rates and intrinsic enforcement rates
 from generated market data.
 
 """
 
 from collections.abc import Sequence
 from contextlib import suppress
-from importlib.metadata import version
 from pathlib import Path
 from typing import Literal, TypeAlias, TypedDict
 
 import numpy as np
 import tables as ptb  # type: ignore
+from icecream import ic  # type: ignore
 from joblib import Parallel, cpu_count, delayed  # type: ignore
 from numpy.random import SeedSequence
 from numpy.typing import NDArray
 
-from mergeron.core.pseudorandom_numbers import TF, TI
-
-from .. import _PKG_NAME, RECConstants, UPPAggrSelector  # noqa: TID252
+from .. import VERSION, RECConstants, UPPAggrSelector  # noqa: TID252
 from ..core import guidelines_boundaries as gbl  # noqa: TID252
 from . import (
     EMPTY_ARRAY_DEFAULT,
@@ -31,10 +29,9 @@ from . import (
     UPPTestsRaw,
 )
 from . import data_generation as dgl
-from . import investigations_stats as isl
-
-__version__ = version(_PKG_NAME)
+from . import enforcement_stats as esl
 
+__version__ = VERSION
 
 ptb.parameters.MAX_NUMEXPR_THREADS = 8
 ptb.parameters.MAX_BLOSC_THREADS = 4
@@ -45,11 +42,11 @@ SaveData: TypeAlias = Literal[False] | tuple[Literal[True], ptb.File, ptb.Group]
 class INVRESCntsArgs(TypedDict, total=False):
     "Keyword arguments of function, :code:`sim_invres_cnts`"
 
-    saved_array_name_suffix: str
-    save_data_to_file: SaveData
     sample_size: int
     seed_seq_list: list[SeedSequence] | None
     nthreads: int
+    save_data_to_file: SaveData
+    saved_array_name_suffix: str
 
 
 def sim_invres_cnts_ll(
@@ -58,11 +55,11 @@ def sim_invres_cnts_ll(
     _sim_test_regime: UPPTestRegime,
     /,
     *,
-    saved_array_name_suffix: str = "",
-    save_data_to_file: SaveData = False,
     sample_size: int = 10**6,
     seed_seq_list: list[SeedSequence] | None = None,
     nthreads: int = 16,
+    save_data_to_file: SaveData = False,
+    saved_array_name_suffix: str = "",
 ) -> UPPTestsCounts:
     """A function to parallelize data-generation and testing
 
@@ -171,11 +168,11 @@ def sim_invres_cnts(
     _sim_test_regime: UPPTestRegime,
     /,
     *,
-    saved_array_name_suffix: str = "",
-    save_data_to_file: SaveData = False,
     sample_size: int = 10**6,
     seed_seq_list: list[SeedSequence] | None = None,
     nthreads: int = 16,
+    save_data_to_file: SaveData = False,
+    saved_array_name_suffix: str = "",
 ) -> UPPTestsCounts:
     # Generate market data
     _market_data_sample = dgl.gen_market_sample(
@@ -235,7 +232,7 @@ def invres_cnts(
         for _firm_cnt in 2 + np.arange(_max_firm_count):
             _firm_count_test = _fcounts == _firm_cnt
 
-            _invres_cnts_sim_byfirmcount_array = np.row_stack((
+            _invres_cnts_sim_byfirmcount_array = np.vstack((
                 _invres_cnts_sim_byfirmcount_array,
                 np.array([
                     _firm_cnt,
@@ -257,12 +254,12 @@ def invres_cnts(
         _invres_cnts_sim_byfirmcount_array[0] = 2
 
     # Clearance/enfrocement counts --- by delta
-    _hhi_delta_ranged = isl.hhi_delta_ranger(_hhi_delta)
+    _hhi_delta_ranged = esl.hhi_delta_ranger(_hhi_delta)
     _invres_cnts_sim_bydelta_array = -1 * np.ones(_stats_rowlen, np.int64)
-    for _hhi_delta_lim in isl.HHI_DELTA_KNOTS[:-1]:
+    for _hhi_delta_lim in esl.HHI_DELTA_KNOTS[:-1]:
         _hhi_delta_test = _hhi_delta_ranged == _hhi_delta_lim
 
-        _invres_cnts_sim_bydelta_array = np.row_stack((
+        _invres_cnts_sim_bydelta_array = np.vstack((
             _invres_cnts_sim_bydelta_array,
             np.array([
                 _hhi_delta_lim,
@@ -280,13 +277,13 @@ def invres_cnts(
 
     # Clearance/enfrocement counts --- by zone
     try:
-        _hhi_zone_post_ranged = isl.hhi_zone_post_ranger(_hhi_post)
+        _hhi_zone_post_ranged = esl.hhi_zone_post_ranger(_hhi_post)
     except ValueError as _err:
-        print(_hhi_post)
+        ic(_hhi_post)
         raise _err
 
     _stats_byconczone_sim = -1 * np.ones(_stats_rowlen + 1, np.int64)
-    for _hhi_zone_post_knot in isl.HHI_POST_ZONE_KNOTS[:-1]:
+    for _hhi_zone_post_knot in esl.HHI_POST_ZONE_KNOTS[:-1]:
         _level_test = _hhi_zone_post_ranged == _hhi_zone_post_knot
 
         for _hhi_zone_delta_knot in [0, 100, 200]:
@@ -298,7 +295,7 @@ def invres_cnts(
 
             _conc_test = _level_test & _delta_test
 
-            _stats_byconczone_sim = np.row_stack((
+            _stats_byconczone_sim = np.vstack((
                 _stats_byconczone_sim,
                 np.array([
                     _hhi_zone_post_knot,
@@ -313,7 +310,7 @@ def invres_cnts(
                 ]),
             ))
 
-    _invres_cnts_sim_byconczone_array = isl.invres_cnts_byconczone(
+    _invres_cnts_sim_byconczone_array = esl.invres_cnts_byconczone(
         _stats_byconczone_sim[1:]
     )
     del _stats_byconczone_sim
@@ -472,11 +469,11 @@ def initialize_hd5(
         _h5_path.unlink()
     _h5_file = ptb.open_file(_h5_path, mode="w", title=_h5_title)
     _save_data_to_file: tuple[Literal[True], ptb.File, str] = (True, _h5_file, "/")
-    _next_subgroup_name = "invres_{}_{}_{}_{}".format(
+    _next_subgroup_name_root = "invres_{}_{}_{}_{}".format(
         _hmg_pub_year,
         *(getattr(_test_regime, _f.name).name for _f in _test_regime.__attrs_attrs__),
     )
-    return _save_data_to_file, _next_subgroup_name
+    return _save_data_to_file, _next_subgroup_name_root
 
 
 def save_data_to_hdf5(
@@ -504,7 +501,7 @@ def save_data_to_hdf5(
 
 
 def save_array_to_hdf5(
-    _array_obj: NDArray[np.floating[TF] | np.integer[TI] | np.bool_],
+    _array_obj: NDArray[np.float64 | np.int64 | np.bool_],
     _array_name: str,
     _h5_group: ptb.Group,
     _h5_file: ptb.File,
@@ -525,3 +522,9 @@ def save_array_to_hdf5(
         filters=ptb.Filters(complevel=3, complib="blosc:lz4hc", fletcher32=True),
     )
     _h5_array[:] = _array_obj
+
+
+if __name__ == "__main__":
+    print(
+        "This module defines classes with methods for generating UPP test arrays and UPP test-counts arrays on given data."
+    )

mergeron-2024.739079.9.dist-info/METADATA

@@ -0,0 +1,109 @@
+Metadata-Version: 2.1
+Name: mergeron
+Version: 2024.739079.9
+Summary: Merger Policy Analysis 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 :: 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: google-re2 (>=1.1)
+Requires-Dist: icecream (>=2.1.0)
+Requires-Dist: jinja2 (>=3.1)
+Requires-Dist: joblib (>=1.3)
+Requires-Dist: lxml (>=5.0)
+Requires-Dist: matplotlib (>=3.8)
+Requires-Dist: mpmath (>=1.3)
+Requires-Dist: msgpack (>=1.0)
+Requires-Dist: msgpack-numpy (>=0.4)
+Requires-Dist: numpy (>=1.26,<2.0)
+Requires-Dist: openpyxl (>=3.1.2)
+Requires-Dist: pendulum (>=3.0.0)
+Requires-Dist: requests (>=2.31)
+Requires-Dist: requests-toolbelt (>=1.0.0)
+Requires-Dist: scipy (>=1.12)
+Requires-Dist: sympy (>=1.12)
+Requires-Dist: tables (>=3.8)
+Requires-Dist: types-beautifulsoup4 (>=4.11.2)
+Requires-Dist: types-requests (>=2.31.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 using Python
+=============================================
+
+Download and analyze merger investigations data published by the U.S. Federal Trade Commission in various reports on extended merger investigations during 1996 to 2011. Model the sets of mergers conforming to various U.S. Horizontal Merger Guidelines standards. Analyze intrinsic clearance rates and intrinsic enforcement rates under Guidelines standards using generated data with specified distributions of market shares, price-cost margins, firm counts, and prices, optionally imposing restrictions impled by statutory filing thresholds and/or Bertrand-Nash oligopoly with MNL demand.
+
+Intrinsic clearance and enforcement rates are distinguished from *observed* clearance and enforcement rates in that the former do not reflect the effects of screening and deterrence as do the latter.
+
+
+Introduction
+------------
+
+Classes for specifying concentration standards (`mergeron.core.guidelines_boundaries.ConcentrationBoundary`) and diversion-ratio standards (`mergeron.core.guidelines_boundaries.DiversionRatioBoundary`), with automatic generation of boundary (as an array of share-pairs) and area, are provided in `mergeron.core.guidelines_boundaries`. This module also includes a function for generating plots of concentation and diversion-ratio boundaries, and functions for mapping GUPPI standards to concentration (ΔHHI) standards, and vice-versa.
+
+Methods for generating industry data under various distributions of shares, margins, and prices are included in, `mergeron.gen.data_generation`. Shares are drawn with uniform distribution with :math:`s_1 + s_2 \leqslant 1` and an unspecified number of firms. Alternatively, shares may be drawn from the Dirichlet distribution. When drawing shares from the Dirichlet distribution, the user can specify a fixed number for firms or provide a vector of weights specifying the frequency distribution over sequential firm counts, e.g., :code:`[133, 184, 134, 52, 32, 10, 12, 4, 3]` to specify shares drawn from Dirichlet distributions with 2 to 10 pre-merger firms distributed as in data for FTC merger investigations during 1996--2003 (See, for example, Table 4.1 of `FTC, Horizontal Merger Investigations Data, Fiscal Years 1996--2003 (Revised: August 31, 2004) <"https://www.ftc.gov/sites/default/files/documents/reports/horizontal-merger-investigation-data-fiscal-years-1996-2003/040831horizmergersdata96-03.pdf>`_). The user can specify recapture rates as, "proportional", "inside-out" --- i.e., consistent with merging-firms' in-market shares and a default recapture rate) --- or "outside-in" --- i.e., purchase probabilities are drawn at random for :math:`N+1` goods, from which are derived market shares and recapture rates for the :math:`N` goods in the putative market. Documentation on specifying the sampling strategy for market shares is at `mergeron.gen.ShareSpec`. Price-cost-margins may be specified as symmetric, i.i.d., or subject to equilibrium conditions for (profit-mazimization in) Bertrand-Nash oligopoly with MNL demand (see, `mergeron.gen.PCMSpec`). Prices may be specified as symmetric or asymmetric, and in the latter case, the direction of correlation between merging firm prices, if any, can also be specified (see, `mergeron.gen.PriceSpec`). Two alternative approaches for modeling statutory filing requirements (HSR filing thresholds) are implemented (see, `mergeron.gen.SSZConstants`). The full specification of a market sample is given in a `mergeron.gen.market_sample.MarketSample` object. Data are drawn by invoking `mergeron.gen.market_sample.MarketSample.generate_sample` which adds a `data` property of class, `mergeron.gen.MarketDataSample`. Enforcement or clearance counts are computed by invoking `mergeron.gen.market_sample.MarketSample.estimate_invres_counts`, which adds an `invres_counts` property of class `mergeron.gen.UPPTestsCounts`. For fast, parallel generation of enforcement or clearance counts over large market data samples that ordinarily would exceed available limits on machine memory, the user can invoke the method `estimate_invres_counts` on a `mergeron.gen.market_sample.MarketSample` object without first invoking `generate_sample`. Note, however, that this strategy discards the market sample in the interests of conserving memory and maintaining high performance.
+
+Methods for printing enforcement statistics based on FTC investigations data and test data are printed to screen or rendered to LaTex files (for processing into publication-quality tables) using methods provided in `mergeron.gen.enforcement_stats`.
+
+Programs demonstrating the analysis and reporting facilites provided by the sub-package, `mergeron.demo`.
+
+This package exposes methods employed for generating random numbers with selected continuous distribution over specified parameters, and with CPU multithreading on machines with multiple virtual, logical, or physical CPU cores. To access these directly:
+
+.. code-block:: python
+
+    import mergeron.core.pseudorandom_numbers as prng
+
+Also included are methods for estimating confidence intervals for proportions and for contrasts (differences) in proportions. (Although coded from scratch using the source literature, the APIs implemented in the module included here are designed for consistency with the APIs in, `statsmodels.stats.proportion` from the package, `statsmodels` (https://pypi.org/project/statsmodels/).) To access these directly:
+
+.. code-block:: python
+
+    import mergeron.core.proportions_tests as prci
+
+A recent version of Paul Tol's python module, `tol_colors.py` is redistributed within this package. Other than re-formatting and type annotation, the `mergeron.ext.tol_colors` module is re-distributed as downloaded from, https://personal.sron.nl/~pault/data/tol_colors.py. The `tol_colors.py` module is distributed under the Standard 3-clause BSD license. To access the `mergeron.ext.tol_colors` module directly:
+
+.. code-block:: python
+
+    import mergeron.ext.tol_colors as ptc
+
+Documentation for this package is in the form of the API Reference. Documentation for individual functions and classes is accessible within a python shell. For example:
+
+.. code-block:: python
+
+    import mergeron.core.market_sample as market_sample
+
+    help(market_sample.MarketSample)
+
+
+.. image:: https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json
+   :alt: Poetry
+   :target: https://python-poetry.org/
+
+.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+   :alt: Ruff
+   :target: https://github.com/astral-sh/ruff
+
+.. image:: https://www.mypy-lang.org/static/mypy_badge.svg
+   :alt: Checked with mypy
+   :target: https://mypy-lang.org/
+
+.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
+   :alt: License: MIT
+   :target: https://opensource.org/licenses/MIT
+

mergeron-2024.739079.9.dist-info/RECORD

@@ -0,0 +1,36 @@
+mergeron/License.txt,sha256=7iX-y0EyjkbVJKJLS4ZKzuuE1wd0lryfsD_IytLG8lQ,1246
+mergeron/__init__.py,sha256=to9InGF69DIyenwmER8bPN-LoZLc-W8D7kS-Qc_CFdg,1647
+mergeron/core/__init__.py,sha256=KtjBlZOl7jwBCAUhrTJB9PdrN39YLYytNiSUSM_gRmA,62
+mergeron/core/damodaran_margin_data.py,sha256=pjI1rSK_O1-3Oel5b9KXH6ctnInjX1Vii7fypt00gV8,8541
+mergeron/core/excel_helper.py,sha256=WxLJoSuX0RMK4xGzGKZSIVULSk1tdSLepgHPmj7M3yc,7605
+mergeron/core/ftc_merger_investigations_data.py,sha256=ZaV2DO7UZabV8eX0Ubq_ToIor7tIRzcvYC54ADliuTk,27931
+mergeron/core/guidelines_boundaries.py,sha256=__OHme8aGtwOgRXKp56WdX7k4vssAVQ8Ub54XwpS7mg,15621
+mergeron/core/guidelines_boundary_functions.py,sha256=rXjncqTn7NPgI2KY9Wuv3WNrsjmv74hpH9-mUI56NgQ,29714
+mergeron/core/guidelines_boundary_functions_extra.py,sha256=TYq3M5onfAIAY-35Q_SaSVF0Upa9hCSKIQkY-KCGzwM,11393
+mergeron/core/proportions_tests.py,sha256=akq0Xhdgtst4RAT42_E5cBD_kATq_V4bQeBznmzRSLg,15267
+mergeron/core/pseudorandom_numbers.py,sha256=k3sDs_NJ2jXlkIWKQ6iiTB5n_QS0RoJ-sqzvFYkC7pY,9277
+mergeron/data/__init__.py,sha256=KtjBlZOl7jwBCAUhrTJB9PdrN39YLYytNiSUSM_gRmA,62
+mergeron/data/damodaran_margin_data.xls,sha256=Qggl1p5nkOMJI8YUXhkwXQRz-OhRSqBTzz57N0JQyYA,79360
+mergeron/data/damodaran_margin_data_dict.msgpack,sha256=sr6s4L69kposEpzGI7jpPb4ULz0UpY-bEYfeNi6UlRA,57621
+mergeron/data/ftc_invdata.msgpack,sha256=WBFHgi7Ld4R-h2zL2Zc3TOIlKqVrbVFMH1LoI4-T-M0,264664
+mergeron/data/jinja2_LaTeX_templates/clrrate_cis_summary_table_template.tex.jinja2,sha256=ae4JiciU-pt8YAM8mRbsmt4W6ePuN1y1NPCWD95oXIo,4833
+mergeron/data/jinja2_LaTeX_templates/ftcinvdata_byhhianddelta_table_template.tex.jinja2,sha256=ODEurkC0UHuWpjRUiQpeW85njSeUEUJYRdYg8gqoEq0,3642
+mergeron/data/jinja2_LaTeX_templates/ftcinvdata_summary_table_template.tex.jinja2,sha256=h8_DEE0iskT9tnga5lZtxcoevN7pY4iKF-maErt4UU4,2906
+mergeron/data/jinja2_LaTeX_templates/ftcinvdata_summarypaired_table_template.tex.jinja2,sha256=Ox0ctiyW_hoOPzoWskOpuygomuV6XWhLeLo40KGRy2U,5224
+mergeron/data/jinja2_LaTeX_templates/mergeron.cls,sha256=AV2mk4-uERvAuMkE95Ka7el6LZsb0JZKP4ieiNCnfMU,4562
+mergeron/data/jinja2_LaTeX_templates/mergeron_table_collection_template.tex.jinja2,sha256=nr6xUI0_2KHG4Sz9k1JFVQjs2h9qS9BGt1MeE6Tygs8,2429
+mergeron/data/jinja2_LaTeX_templates/setup_tikz_tables.tex,sha256=1hw3RINDtBrh9ZEToMIiNFIu9rozcPwRly69-5O_0UQ,3207
+mergeron/demo/__init__.py,sha256=KtjBlZOl7jwBCAUhrTJB9PdrN39YLYytNiSUSM_gRmA,62
+mergeron/demo/visualize_empirical_margin_distribution.py,sha256=v1xFJumBX2Ooye82kSSgly-_GpFVkYSDqBwM__rcmZY,2363
+mergeron/ext/__init__.py,sha256=KtjBlZOl7jwBCAUhrTJB9PdrN39YLYytNiSUSM_gRmA,62
+mergeron/ext/tol_colors.py,sha256=eJUtikxlgR3WjBwpkLh-tvB9QBanSvDXt8kp8pmONXU,22277
+mergeron/gen/__init__.py,sha256=mlZn8gud6bxP_XKSQY2c-u-C85A8U7VxUKLiXu2hMw0,16280
+mergeron/gen/_data_generation_functions.py,sha256=7fP4mSVaN36FBhPKSf1y_TbxfRUe-I7fgqdBt74oaCA,21029
+mergeron/gen/data_generation.py,sha256=gDvCZYJwGpQnokcygM7IRzHBpE5rYI2J5I8uu0_wQyE,8727
+mergeron/gen/enforcement_stats.py,sha256=1Mrx2p2-tXN9RdUQgRyk25xPvwh42EtjUHQgHMdCbmQ,22952
+mergeron/gen/market_sample.py,sha256=4AxzF8WYPsfZaWGMtm0LMkLrEPSgRUNXd_z_ddP9-vE,2303
+mergeron/gen/upp_tests.py,sha256=U2smV53VBnORIQpn3KCSdneSyegrq4dq-zT_6Eg-PIE,17302
+mergeron/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+mergeron-2024.739079.9.dist-info/METADATA,sha256=ynMO8-jtC9cvQ6Zg7myjoGcf9yHwf6n9bV8No2vc910,8690
+mergeron-2024.739079.9.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+mergeron-2024.739079.9.dist-info/RECORD,,