mergeron.gen.enforcement_stats¶

Methods to format and print summary statistics on merger enforcement patterns.

Module Contents¶

class mergeron.gen.enforcement_stats.IndustryGroup[source]¶

Bases: str, mergeron.Enameled

Industry group of reported markets.

ALL = 'All Markets'[source]¶

GRO = 'Grocery Markets'[source]¶

OIL = 'Oil Markets'[source]¶

CHM = 'Chemical Markets'[source]¶

PHM = 'Pharmaceuticals Markets'[source]¶

HOS = 'Hospital Markets'[source]¶

EDS = 'Electronically-Controlled Devices and Systems Markets'[source]¶

BRD = 'Branded Consumer Goods Markets'[source]¶

OTH = '"Other" Markets'[source]¶

IIC = 'Industries in Common'[source]¶

class mergeron.gen.enforcement_stats.OtherEvidence[source]¶

Bases: str, mergeron.Enameled

Additional evidence available, if any, for reported markets.

HOT = 'Hot Documents Identified'[source]¶

NHT = 'No Hot Documents Identified'[source]¶

HTU = 'No Evidence on Hot Documents'[source]¶

NCC = 'No Strong Customer Complaints'[source]¶

SCC = 'Strong Customer Complaints'[source]¶

CCU = 'No Evidence on Customer Complaints'[source]¶

END = 'Entry Difficult'[source]¶

EEY = 'Entry Easy'[source]¶

EEU = 'No Entry Evidence'[source]¶

UNR = 'Unrestricted on additional evidence'[source]¶

class mergeron.gen.enforcement_stats.StatsGrpSelector[source]¶

Bases: str, mergeron.Enameled

Measure used to summarize investigations data.

FC = 'ByFirmCount'[source]¶

HD = 'ByHHIandDelta'[source]¶

DL = 'ByDelta'[source]¶

ZN = 'ByConcZone'[source]¶

class mergeron.gen.enforcement_stats.StatsReturnSelector[source]¶

Bases: str, mergeron.Enameled

Statistics to report on investigations data.

CNT = 'count'[source]¶

RPT = 'rate, point'[source]¶

RIN = 'rate, interval'[source]¶

class mergeron.gen.enforcement_stats.SortSelector[source]¶

Bases: str, mergeron.Enameled

Sort order for reporting investigations data.

UCH = 'unchanged'[source]¶

REV = 'reversed'[source]¶

mergeron.gen.enforcement_stats.HHI_DELTA_KNOTS[source]¶

mergeron.gen.enforcement_stats.HHI_POST_ZONE_KNOTS[source]¶

mergeron.gen.enforcement_stats.HMG_PRESUMPTION_ZONE_MAP : dict[int, dict[int, tuple[int, int, int]]][source]¶

mergeron.gen.enforcement_stats.ZONE_VALS[source]¶

mergeron.gen.enforcement_stats.ZONE_STRINGS[source]¶

mergeron.gen.enforcement_stats.ZONE_DETAIL_STRINGS_HHI[source]¶

mergeron.gen.enforcement_stats.ZONE_DETAIL_STRINGS_DELTA[source]¶

mergeron.gen.enforcement_stats.enf_cnts_obs_by_group(_invdata_array_dict, _study_period, _table_ind_grp, _table_evid_cond, _stats_group, _enf_spec, /)[source]¶

Summarize investigations data by reporting group.

Parameters:¶

_invdata_array_dict : mergeron.core.INVData¶

raw investigations data

_study_period : str¶

study period

_table_ind_grp : IndustryGroup¶

industry group

_table_evid_cond : OtherEvidence¶

additional evidence

_stats_group : StatsGrpSelector¶

grouping measure

_enf_spec : mergeron.gen.INVResolution¶

enforcement specification (see, mergeron.gen.INVResolution)

Returns:¶

Counts of markets resolved as enforced, cleared, or both, respectively.

Return type:¶

ArrayBIGINT

mergeron.gen.enforcement_stats.enf_cnts_obs_byfirmcount(_data_array_dict, _data_period='1996-2003', _table_ind_group=IndustryGroup.ALL, _table_evid_cond=OtherEvidence.UNR, _enf_spec=INVResolution.ENFT, /)[source]¶

Summarize investigations data by firm count.

Parameters:¶

_data_array_dict : mergeron.core.INVData¶

raw investigations data

_data_period : str¶

data period

_table_ind_group : IndustryGroup¶

industry group

_table_evid_cond : OtherEvidence¶

additional evidence

_enf_spec : mergeron.gen.INVResolution¶

enforcement specification (see, mergeron.gen.INVResolution)

Returns:¶

Counts of markets resolved as enforced, cleared, or both, respectively, reported by number of pre-merger firms.

Return type:¶

ArrayBIGINT

mergeron.gen.enforcement_stats.enf_cnts_obs_byhhianddelta(_data_array_dict, _data_period='1996-2003', _table_ind_group=IndustryGroup.ALL, _table_evid_cond=OtherEvidence.UNR, _enf_spec=INVResolution.ENFT, /)[source]¶

Summarize investigations data by HHI and ΔHHI.

Parameters:¶

_data_array_dict : mergeron.core.INVData¶

raw investigations data

_data_period : str¶

data period

_table_ind_group : IndustryGroup¶

industry group

_table_evid_cond : OtherEvidence¶

additional evidence

_enf_spec : mergeron.gen.INVResolution¶

enforcement specification (see, mergeron.gen.INVResolution)

Returns:¶

Counts of markets resolved as enforced, cleared, or both, respectively, reported by HHI and ΔHHI.

Return type:¶

ArrayBIGINT

mergeron.gen.enforcement_stats.table_no_lku(_data_array_dict_sub, _table_ind_group=IndustryGroup.ALL, _table_evid_cond=OtherEvidence.UNR, /)[source]¶

Lookup table number based on industry group and additional evidence.

mergeron.gen.enforcement_stats.enf_cnts_byfirmcount(_cnts_array, /)[source]¶

Summarize investigations data by firm count.

Parameters:¶

_cnts_array : mergeron.ArrayBIGINT¶

raw investigations data array

Returns:¶

Subtotals for columns other than the first, grouped by the first column.

Return type:¶

ArrayBIGINT

mergeron.gen.enforcement_stats.enf_cnts_bydelta(_cnts_array, /)[source]¶

Summarize investigations data by ΔHHI.

Parameters:¶

_cnts_array : mergeron.ArrayBIGINT¶

raw investigations data array

Returns:¶

Subtotals for columns higher than the second, grouped by the second column.

Return type:¶

ArrayBIGINT

mergeron.gen.enforcement_stats.enf_cnts_byconczone(_cnts_array, /)[source]¶

Summarize investigations data by concentration zone, as defined in the Guidelines.

Includes sub-total detail for “Moderately Concentrated” and “Unconcentrated” markets.

Parameters:¶

_cnts_array : mergeron.ArrayBIGINT¶

raw investigations data array

Returns:¶

Subtotals range of HHI and ΔHHI, with detail

Return type:¶

ArrayBIGINT