Pandas.m — Pandas 1.4.3 Documentation

Skip to main content Back to top Ctrl+K

Site Navigation

• Getting started
• User Guide
• API reference
• Development
• Release notes

• GitHub
• Twitter
• Mastodon

Site Navigation

• Getting started
• User Guide
• API reference
• Development
• Release notes

• GitHub
• Twitter
• Mastodon

• Input/output
• General functions
• Series
• DataFrame
  • pandas.DataFrame
  • pandas.DataFrame.index
  • pandas.DataFrame.columns
  • pandas.DataFrame.dtypes
  • pandas.DataFrame.info
  • pandas.DataFrame.select_dtypes
  • pandas.DataFrame.values
  • pandas.DataFrame.axes
  • pandas.DataFrame.ndim
  • pandas.DataFrame.size
  • pandas.DataFrame.shape
  • pandas.DataFrame.memory_usage
  • pandas.DataFrame.empty
  • pandas.DataFrame.set_flags
  • pandas.DataFrame.astype
  • pandas.DataFrame.convert_dtypes
  • pandas.DataFrame.infer_objects
  • pandas.DataFrame.copy
  • pandas.DataFrame.bool
  • pandas.DataFrame.to_numpy
  • pandas.DataFrame.head
  • pandas.DataFrame.at
  • pandas.DataFrame.iat
  • pandas.DataFrame.loc
  • pandas.DataFrame.iloc
  • pandas.DataFrame.insert
  • pandas.DataFrame.__iter__
  • pandas.DataFrame.items
  • pandas.DataFrame.keys
  • pandas.DataFrame.iterrows
  • pandas.DataFrame.itertuples
  • pandas.DataFrame.pop
  • pandas.DataFrame.tail
  • pandas.DataFrame.xs
  • pandas.DataFrame.get
  • pandas.DataFrame.isin
  • pandas.DataFrame.where
  • pandas.DataFrame.mask
  • pandas.DataFrame.query
  • pandas.DataFrame.__add__
  • pandas.DataFrame.add
  • pandas.DataFrame.sub
  • pandas.DataFrame.mul
  • pandas.DataFrame.div
  • pandas.DataFrame.truediv
  • pandas.DataFrame.floordiv
  • pandas.DataFrame.mod
  • pandas.DataFrame.pow
  • pandas.DataFrame.dot
  • pandas.DataFrame.radd
  • pandas.DataFrame.rsub
  • pandas.DataFrame.rmul
  • pandas.DataFrame.rdiv
  • pandas.DataFrame.rtruediv
  • pandas.DataFrame.rfloordiv
  • pandas.DataFrame.rmod
  • pandas.DataFrame.rpow
  • pandas.DataFrame.lt
  • pandas.DataFrame.gt
  • pandas.DataFrame.le
  • pandas.DataFrame.ge
  • pandas.DataFrame.ne
  • pandas.DataFrame.eq
  • pandas.DataFrame.combine
  • pandas.DataFrame.combine_first
  • pandas.DataFrame.apply
  • pandas.DataFrame.map
  • pandas.DataFrame.applymap
  • pandas.DataFrame.pipe
  • pandas.DataFrame.agg
  • pandas.DataFrame.aggregate
  • pandas.DataFrame.transform
  • pandas.DataFrame.groupby
  • pandas.DataFrame.rolling
  • pandas.DataFrame.expanding
  • pandas.DataFrame.ewm
  • pandas.DataFrame.abs
  • pandas.DataFrame.all
  • pandas.DataFrame.any
  • pandas.DataFrame.clip
  • pandas.DataFrame.corr
  • pandas.DataFrame.corrwith
  • pandas.DataFrame.count
  • pandas.DataFrame.cov
  • pandas.DataFrame.cummax
  • pandas.DataFrame.cummin
  • pandas.DataFrame.cumprod
  • pandas.DataFrame.cumsum
  • pandas.DataFrame.describe
  • pandas.DataFrame.diff
  • pandas.DataFrame.eval
  • pandas.DataFrame.kurt
  • pandas.DataFrame.kurtosis
  • pandas.DataFrame.max
  • pandas.DataFrame.mean
  • pandas.DataFrame.median
  • pandas.DataFrame.min
  • pandas.DataFrame.mode
  • pandas.DataFrame.pct_change
  • pandas.DataFrame.prod
  • pandas.DataFrame.product
  • pandas.DataFrame.quantile
  • pandas.DataFrame.rank
  • pandas.DataFrame.round
  • pandas.DataFrame.sem
  • pandas.DataFrame.skew
  • pandas.DataFrame.sum
  • pandas.DataFrame.std
  • pandas.DataFrame.var
  • pandas.DataFrame.nunique
  • pandas.DataFrame.value_counts
  • pandas.DataFrame.add_prefix
  • pandas.DataFrame.add_suffix
  • pandas.DataFrame.align
  • pandas.DataFrame.at_time
  • pandas.DataFrame.between_time
  • pandas.DataFrame.drop
  • pandas.DataFrame.drop_duplicates
  • pandas.DataFrame.duplicated
  • pandas.DataFrame.equals
  • pandas.DataFrame.filter
  • pandas.DataFrame.first
  • pandas.DataFrame.head
  • pandas.DataFrame.idxmax
  • pandas.DataFrame.idxmin
  • pandas.DataFrame.last
  • pandas.DataFrame.reindex
  • pandas.DataFrame.reindex_like
  • pandas.DataFrame.rename
  • pandas.DataFrame.rename_axis
  • pandas.DataFrame.reset_index
  • pandas.DataFrame.sample
  • pandas.DataFrame.set_axis
  • pandas.DataFrame.set_index
  • pandas.DataFrame.tail
  • pandas.DataFrame.take
  • pandas.DataFrame.truncate
  • pandas.DataFrame.backfill
  • pandas.DataFrame.bfill
  • pandas.DataFrame.dropna
  • pandas.DataFrame.ffill
  • pandas.DataFrame.fillna
  • pandas.DataFrame.interpolate
  • pandas.DataFrame.isna
  • pandas.DataFrame.isnull
  • pandas.DataFrame.notna
  • pandas.DataFrame.notnull
  • pandas.DataFrame.pad
  • pandas.DataFrame.replace
  • pandas.DataFrame.droplevel
  • pandas.DataFrame.pivot
  • pandas.DataFrame.pivot_table
  • pandas.DataFrame.reorder_levels
  • pandas.DataFrame.sort_values
  • pandas.DataFrame.sort_index
  • pandas.DataFrame.nlargest
  • pandas.DataFrame.nsmallest
  • pandas.DataFrame.swaplevel
  • pandas.DataFrame.stack
  • pandas.DataFrame.unstack
  • pandas.DataFrame.swapaxes
  • pandas.DataFrame.melt
  • pandas.DataFrame.explode
  • pandas.DataFrame.squeeze
  • pandas.DataFrame.to_xarray
  • pandas.DataFrame.T
  • pandas.DataFrame.transpose
  • pandas.DataFrame.assign
  • pandas.DataFrame.compare
  • pandas.DataFrame.join
  • pandas.DataFrame.merge
  • pandas.DataFrame.update
  • pandas.DataFrame.asfreq
  • pandas.DataFrame.asof
  • pandas.DataFrame.shift
  • pandas.DataFrame.first_valid_index
  • pandas.DataFrame.last_valid_index
  • pandas.DataFrame.resample
  • pandas.DataFrame.to_period
  • pandas.DataFrame.to_timestamp
  • pandas.DataFrame.tz_convert
  • pandas.DataFrame.tz_localize
  • pandas.Flags
  • pandas.DataFrame.attrs
  • pandas.DataFrame.plot
  • pandas.DataFrame.plot.area
  • pandas.DataFrame.plot.bar
  • pandas.DataFrame.plot.barh
  • pandas.DataFrame.plot.box
  • pandas.DataFrame.plot.density
  • pandas.DataFrame.plot.hexbin
  • pandas.DataFrame.plot.hist
  • pandas.DataFrame.plot.kde
  • pandas.DataFrame.plot.line
  • pandas.DataFrame.plot.pie
  • pandas.DataFrame.plot.scatter
  • pandas.DataFrame.boxplot
  • pandas.DataFrame.hist
  • pandas.DataFrame.sparse.density
  • pandas.DataFrame.sparse.from_spmatrix
  • pandas.DataFrame.sparse.to_coo
  • pandas.DataFrame.sparse.to_dense
  • pandas.DataFrame.from_dict
  • pandas.DataFrame.from_records
  • pandas.DataFrame.to_orc
  • pandas.DataFrame.to_parquet
  • pandas.DataFrame.to_pickle
  • pandas.DataFrame.to_csv
  • pandas.DataFrame.to_hdf
  • pandas.DataFrame.to_sql
  • pandas.DataFrame.to_dict
  • pandas.DataFrame.to_excel
  • pandas.DataFrame.to_json
  • pandas.DataFrame.to_html
  • pandas.DataFrame.to_feather
  • pandas.DataFrame.to_latex
  • pandas.DataFrame.to_stata
  • pandas.DataFrame.to_gbq
  • pandas.DataFrame.to_records
  • pandas.DataFrame.to_string
  • pandas.DataFrame.to_clipboard
  • pandas.DataFrame.to_markdown
  • pandas.DataFrame.style
  • pandas.DataFrame.__dataframe__
• pandas arrays, scalars, and data types
• Index objects
• Date offsets
• Window
• GroupBy
• Resampling
• Style
• Plotting
• Options and settings
• Extensions
• Testing
• Missing values

• API reference
• DataFrame
• pandas.DataFrame.sum

pandas.DataFrame.sum# DataFrame.sum(axis=0, skipna=True, numeric_only=False, min_count=0, **kwargs)[source]#

Return the sum of the values over the requested axis.

This is equivalent to the method numpy.sum.

Parameters: axis{index (0), columns (1)}

Axis for the function to be applied on. For Series this parameter is unused and defaults to 0.

Warning

The behavior of DataFrame.sum with axis=None is deprecated, in a future version this will reduce over both axes and return a scalar To retain the old behavior, pass axis=0 (or do not pass axis).

Added in version 2.0.0.

skipnabool, default True

Exclude NA/null values when computing the result.

numeric_onlybool, default False

Include only float, int, boolean columns. Not implemented for Series.

min_countint, default 0

The required number of valid values to perform the operation. If fewer than min_count non-NA values are present the result will be NA.

**kwargs

Additional keyword arguments to be passed to the function.

Returns: Series or scalar

See also

Series.sum

Return the sum.

Series.min

Return the minimum.

Series.max

Return the maximum.

Series.idxmin

Return the index of the minimum.

Series.idxmax

Return the index of the maximum.

DataFrame.sum

Return the sum over the requested axis.

DataFrame.min

Return the minimum over the requested axis.

DataFrame.max

Return the maximum over the requested axis.

DataFrame.idxmin

Return the index of the minimum over the requested axis.

DataFrame.idxmax

Return the index of the maximum over the requested axis.

Examples

>>> idx = pd.MultiIndex.from_arrays([ ... ['warm', 'warm', 'cold', 'cold'], ... ['dog', 'falcon', 'fish', 'spider']], ... names=['blooded', 'animal']) >>> s = pd.Series([4, 2, 0, 8], name='legs', index=idx) >>> s blooded animal warm dog 4 falcon 2 cold fish 0 spider 8 Name: legs, dtype: int64 >>> s.sum() 14

By default, the sum of an empty or all-NA Series is 0.

>>> pd.Series([], dtype="float64").sum() # min_count=0 is the default 0.0

This can be controlled with the min_count parameter. For example, if you’d like the sum of an empty series to be NaN, pass min_count=1.

>>> pd.Series([], dtype="float64").sum(min_count=1) nan

Thanks to the skipna parameter, min_count handles all-NA and empty series identically.

>>> pd.Series([np.nan]).sum() 0.0 >>> pd.Series([np.nan]).sum(min_count=1) nan On this page

• DataFrame.sum()

Show Source