Repository files navigation

Latest Release
Package Status
License
Build Status
Coverage
Downloads
Gitter

pandas is a Python package providing fast, flexible, and expressive datastructures designed to make working with "relational" or "labeled" data botheasy and intuitive. It aims to be the fundamental high-level building block fordoing practical,real world data analysis in Python. Additionally, it hasthe broader goal of becomingthe most powerful and flexible open source dataanalysis / manipulation tool available in any language. It is already well onits way towards this goal.

Here are just a few of the things that pandas does well:

• Easy handling ofmissing data (represented asNaN) in floating point as well as non-floating point data
• Size mutability: columns can beinserted anddeleted from DataFrame and higher dimensionalobjects
• Automatic and explicitdata alignment: objects canbe explicitly aligned to a set of labels, or the user can simplyignore the labels and letSeries,DataFrame, etc. automaticallyalign the data for you in computations
• Powerful, flexiblegroup by functionality to performsplit-apply-combine operations on data sets, for both aggregatingand transforming data
• Make iteasy to convert ragged,differently-indexed data in other Python and NumPy data structuresinto DataFrame objects
• Intelligent label-basedslicing,fancyindexing, andsubsetting oflarge data sets
• Intuitivemerging andjoining datasets
• Flexiblereshaping andpivoting ofdata sets
• Hierarchical labeling of axes (possible to have multiplelabels per tick)
• Robust IO tools for loading data fromflat files(CSV and delimited),Excel files,databases,and saving/loading data from the ultrafastHDF5 format
• Time series-specific functionality: date rangegeneration and frequency conversion, moving window statistics,moving window linear regressions, date shifting and lagging, etc.

The source code is currently hosted on GitHub at:https://github.com/pandas-dev/pandas

Binary installers for the latest released version are available at thePythonpackage index and on conda.

# condaconda install pandas

# or PyPIpip install pandas

• NumPy: 1.13.3 or higher
• python-dateutil: 2.5.0 or higher
• pytz: 2015.4 or higher

See thefull installation instructionsfor recommended and optional dependencies.

To install pandas from source you need Cython in addition to the normaldependencies above. Cython can be installed from pypi:

pip install cython

In thepandas directory (same one where you found this file aftercloning the git repo), execute:

python setup.py install

or for installing indevelopment mode:

python setup.py develop

Alternatively, you can usepip if you want all the dependencies pulledin automatically (the-e option is for installing it indevelopmentmode):

pip install -e.

See the full instructions forinstalling from source.

BSD 3

The official documentation is hosted on PyData.org:https://pandas.pydata.org/pandas-docs/stable

Work onpandas started at AQR (a quantitative hedge fund) in 2008 andhas been under active development since then.

For usage questions, the best place to go to isStackOverflow.Further, general questions and discussions can also take place on thepydata mailing list.

Most development discussion is taking place on github in this repo. Further, thepandas-dev mailing list can also be used for specialized discussions or design issues, and aGitter channel is available for quick development related questions.

All contributions, bug reports, bug fixes, documentation improvements, enhancements and ideas are welcome.

A detailed overview on how to contribute can be found in thecontributing guide. There is also anoverview on GitHub.

If you are simply looking to start working with the pandas codebase, navigate to theGitHub "issues" tab and start looking through interesting issues. There are a number of issues listed underDocs andgood first issue where you could start out.

You can also triage issues which may include reproducing bug reports, or asking for vital information such as version numbers or reproduction instructions. If you would like to start triaging issues, one easy way to get started is tosubscribe to pandas on CodeTriage.

Or maybe through using pandas you have an idea of your own or are looking for something in the documentation and thinking ‘this can be improved’...you can do something about it!

Feel free to ask questions on themailing list or onGitter.