pandas.concat¶

pandas.concat(objs,axis=0,join='outer',join_axes=None,ignore_index=False,keys=None,levels=None,names=None,verify_integrity=False,copy=True)[source]¶

Concatenate pandas objects along a particular axis with optional set logicalong the other axes. Can also add a layer of hierarchical indexing on theconcatenation axis, which may be useful if the labels are the same (oroverlapping) on the passed axis number

Parameters:

objs : a sequence or mapping of Series, DataFrame, or Panel objects If a dict is passed, the sorted keys will be used as thekeysargument, unless it is passed, in which case the values will beselected (see below). Any None objects will be dropped silently unlessthey are all None in which case a ValueError will be raised axis : {0/’index’, 1/’columns’}, default 0 The axis to concatenate along join : {‘inner’, ‘outer’}, default ‘outer’ How to handle indexes on other axis(es) join_axes : list of Index objects Specific indexes to use for the other n - 1 axes instead of performinginner/outer set logic ignore_index : boolean, default False If True, do not use the index values along the concatenation axis. Theresulting axis will be labeled 0, ..., n - 1. This is useful if you areconcatenating objects where the concatenation axis does not havemeaningful indexing information. Note the index values on the otheraxes are still respected in the join. keys : sequence, default None If multiple levels passed, should contain tuples. Constructhierarchical index using the passed keys as the outermost level levels : list of sequences, default None Specific levels (unique values) to use for constructing aMultiIndex. Otherwise they will be inferred from the keys names : list, default None Names for the levels in the resulting hierarchical index verify_integrity : boolean, default False Check whether the new concatenated axis contains duplicates. This canbe very expensive relative to the actual data concatenation copy : boolean, default True If False, do not copy data unnecessarily

Returns:

concatenated : type of objects

Notes

The keys, levels, and names arguments are all optional