mergeron.core.ftc_merger_investigations_data

Methods to load and augmentFTC Merger Investigations Data.

Details on downloading and processing the data are specified in the “private” module, _process_ftc_merger_investigations_data.

Notes

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

Module Contents

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.