mergeron.core.ftc_merger_investigations_data

Methods to parse FTC Merger Investigations Data, downloading source documents as needed.

Notes

Reported row and column totals from source data are not stored.

Module Contents

mergeron.core.ftc_merger_investigations_data.WORK_DIR[source]

Redefined, in case the user defines WORK_DIR betweeen module imports.

mergeron.core.ftc_merger_investigations_data.FID_WORK_DIR[source]
mergeron.core.ftc_merger_investigations_data.INVDATA_ARCHIVE_PATH[source]
mergeron.core.ftc_merger_investigations_data.TABLE_NO_RE[source]
mergeron.core.ftc_merger_investigations_data.TABLE_TYPES = ('ByHHIandDelta', 'ByFirmCount')[source]
mergeron.core.ftc_merger_investigations_data.CONC_TABLE_ALL = 'Table 3.1'[source]
mergeron.core.ftc_merger_investigations_data.CNT_TABLE_ALL = 'Table 4.1'[source]
mergeron.core.ftc_merger_investigations_data.TTL_KEY = 86825[source]
mergeron.core.ftc_merger_investigations_data.CONC_HHI_DICT[source]
mergeron.core.ftc_merger_investigations_data.CONC_DELTA_DICT[source]
mergeron.core.ftc_merger_investigations_data.CNT_FCOUNT_DICT[source]
mergeron.core.ftc_merger_investigations_data.invert_map(_dict)[source]

Invert mapping, mapping values to keys of the original mapping.

mergeron.core.ftc_merger_investigations_data.construct_data(_archive_path=INVDATA_ARCHIVE_PATH, *, flag_backward_compatibility=True, flag_pharma_for_exclusion=True, rebuild_data=False)[source]

Construct FTC merger investigations data for added non-overlapping periods.

FTC merger investigations data are reported in cumulative periods, e.g., 1996-2003 and 1996-2011, but the analyst may want data reported in non-overlapping periods, e.g., 2004-2011. Given the way in which FTC had reported merger investigations data, the above example is the only instance in which the 1996-2003 data can be subtracted from the cumulative data to extract merger investigations data for the later period. See also, Kwoka, Sec. 2.3.3. [1]

Parameters:
_archive_path : pathlib.Path

Path to file container for serialized constructed data

flag_backward_compatibility : bool

Flag whether the reported data should be treated as backward-compatible

flag_pharma_for_exclusion : bool

Flag whether data for Pharmaceuticals is included in, the set of industry groups with consistent reporting in both early and late periods

Returns:

A dictionary of merger investigations data keyed to reporting periods

Return type:

mergeron.core.INVData

References

mergeron.core.ftc_merger_investigations_data.invdata_build_aggregate_table(_data_typesub, _aggr_table_list)[source]

Aggregate selected FTC merger investigations data tables within a given time period.