-
-
Notifications
You must be signed in to change notification settings - Fork 18.4k
WEB: Adding new pandas website #28014
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 4 commits
192df97
14a606f
b682dfe
541d26d
b6de1d4
507eb7e
711fc8c
617cfb9
aa54548
8ae611d
e322c03
6063061
d163d73
cdc6a25
418ca78
1003e57
0fb3c58
5f82a92
f14ec6f
7083141
86d949e
a44581d
7303c30
c65a2b3
f4040c1
10ae55c
5106196
289a58a
6b2517a
a931535
7b3a93f
13825f0
aca4f52
fe8c211
916544f
532a2f7
d7436fe
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,83 @@ | ||
<!DOCTYPE html> | ||
<html> | ||
<head> | ||
<title>pandas</title> | ||
<link rel="stylesheet" | ||
href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css" | ||
integrity="sha384-Gn5384xqQ1aoWXA+058RXPxPg6fy4IWvTNh0E263XmFcJlSAwiGgFAW/dAiS6JXm" | ||
crossorigin="anonymous"> | ||
{% for stylesheet in static.css %} | ||
<link rel="stylesheet" | ||
href="{{ base_url }}{{ stylesheet }}"> | ||
{% endfor %} | ||
</head> | ||
<body> | ||
<header> | ||
<nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark"> | ||
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#nav-content" aria-controls="nav-content" aria-expanded="false" aria-label="Toggle navigation"> | ||
<span class="navbar-toggler-icon"></span> | ||
</button> | ||
|
||
<a class="navbar-brand" href="{{ base_url }}/"><img alt="" src="{{ base_url }}{{ static.logo }}"/></a> | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. this is not working at the moment (I think static.logo is not defined right now?) |
||
|
||
<div class="collapse navbar-collapse" id="nav-content"> | ||
<ul class="navbar-nav"> | ||
{% for item in navbar %} | ||
{% if not item.has_subitems %} | ||
<li class="nav-item"> | ||
<a class="nav-link" href="{% if not item.target.startswith("http") %}{{ base_url }}{% endif %}{{ item.target }}">{{ item.name }}</a> | ||
</li> | ||
{% else %} | ||
<li class="nav-item dropdown"> | ||
<a class="nav-link dropdown-toggle" | ||
data-toggle="dropdown" | ||
id="{{ item.slug }}" | ||
href="#" | ||
role="button" | ||
aria-haspopup="true" | ||
aria-expanded="false">{{ item.name }}</a> | ||
<div class="dropdown-menu" aria-labelledby="{{ item.slug }}"> | ||
{% for subitem in item.target %} | ||
<a class="dropdown-item" href="{% if not subitem.target.startswith("http") %}{{ base_url }}{% endif %}{{ subitem.target }}">{{ subitem.name }}</a> | ||
{% endfor %} | ||
</div> | ||
</li> | ||
{% endif %} | ||
{% endfor %} | ||
</ul> | ||
</div> | ||
</nav> | ||
</header> | ||
<main role="main"> | ||
<div class="container"> | ||
{% block body %}{% endblock %} | ||
</div> | ||
</main> | ||
<footer class="container pt-4 pt-md-5 border-top"> | ||
<p class="float-right"> | ||
<a href="#">Back to top</a> | ||
</p> | ||
<p> | ||
© 2009 - 2019, pandas team | ||
jorisvandenbossche marked this conversation as resolved.
Show resolved
Hide resolved
|
||
</p> | ||
</footer> | ||
|
||
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" | ||
integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" | ||
crossorigin="anonymous"></script> | ||
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.9/umd/popper.min.js" | ||
integrity="sha384-ApNbgh9B+Y1QKtv3Rn7W3mgPxhU9K/ScQsAP7hUibX39j7fakFPskvXusvfa0b4Q" | ||
crossorigin="anonymous"></script> | ||
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js" | ||
integrity="sha384-JZR6Spejh4U02d8jOt6vLEHfe/JQGiRRSQQxSfFWpi1MquVdAyjUar5+76PVCmYl" | ||
crossorigin="anonymous"></script> | ||
<script> | ||
$(function () { | ||
$('[data-toggle="tooltip"]').tooltip() | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can you add a comment for what those functions are needed? |
||
}) | ||
$(function () { | ||
$('[data-toggle="popover"]').popover() | ||
}) | ||
</script> | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. To add to a todo list: add google analytics |
||
</body> | ||
</html> |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
{% extends "layout.html" %} | ||
|
||
{% block body %} | ||
{% for post in blog.posts %} | ||
<div class="card"> | ||
<div class="card-body"> | ||
<h3 class="card-title"><a href="{{post.link }}" target="_blank">{{ post.title }}</a></h3> | ||
<h6 class="card-subtitle">Source: {{ post.feed }} | Author: {{ post.author }} | Published: {{ post.published.strftime("%b %d, %Y") }}</h6> | ||
<div class="card-text">{{ post.summary }}</div> | ||
<a class="card-link" href="{{post.link }}" target="_blank">Read</a> | ||
</div> | ||
</div> | ||
{% endfor %} | ||
{% endblock %} |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,86 @@ | ||
# About pandas | ||
|
||
## History of development | ||
|
||
In 2008, _pandas_ development began at [AQR Capital Management](http://www.aqr.com). | ||
By the end of 2009 it had been [open sourced](http://en.wikipedia.org/wiki/Open_source), | ||
and is actively supported today by a community of like-minded individuals around the world who | ||
contribute their valuable time and energy to help make open source _pandas_ | ||
possible. Thank you to [all of our contributors](team.html). | ||
|
||
Since 2015, _pandas_ is a [NumFOCUS sponsored project](https://numfocus.org/sponsored-projects). | ||
This will help ensure the success of development of _pandas_ as a world-class open-source project. | ||
|
||
### Timeline | ||
|
||
- **2008**: Development of _pandas_ started | ||
- **2009**: _pandas_ becomes open source | ||
- **2012**: First edition of _Python for Data Analysis_ is published | ||
- **2015**: _pandas_ becomes a [NumFOCUS sponsored project](https://numfocus.org/sponsored-projects) | ||
- **2018**: First in-person core developer sprint | ||
|
||
## Library Highlights | ||
|
||
- A fast and efficient **DataFrame** object for data manipulation with | ||
integrated indexing; | ||
|
||
- Tools for **reading and writing data** between in-memory data structures and | ||
different formats: CSV and text files, Microsoft Excel, SQL databases, and | ||
the fast HDF5 format; | ||
|
||
- Intelligent **data alignment** and integrated handling of **missing data**: | ||
gain automatic label-based alignment in computations and easily manipulate | ||
messy data into an orderly form; | ||
|
||
- Flexible **reshaping** and pivoting of data sets; | ||
|
||
- Intelligent label-based **slicing**, **fancy indexing**, and **subsetting** | ||
of large data sets; | ||
|
||
- Columns can be inserted and deleted from data structures for **size | ||
mutability**; | ||
|
||
- Aggregating or transforming data with a powerful **group by** engine | ||
allowing split-apply-combine operations on data sets; | ||
|
||
- High performance **merging and joining** of data sets; | ||
|
||
- **Hierarchical axis indexing** provides an intuitive way of working with | ||
high-dimensional data in a lower-dimensional data structure; | ||
|
||
- **Time series**-functionality: date range generation and frequency | ||
conversion, moving window statistics, moving window linear regressions, date | ||
shifting and lagging. Even create domain-specific time offsets and join time | ||
series without losing data; | ||
|
||
- Highly **optimized for performance**, with critical code paths written in | ||
[Cython](http://www.cython.org/) or C. | ||
|
||
- Python with *pandas* is in use in a wide variety of **academic and | ||
commercial** domains, including Finance, Neuroscience, Economics, | ||
Statistics, Advertising, Web Analytics, and more. | ||
|
||
## Mission | ||
|
||
_pandas_ aims to be the fundamental high-level building block for doing practical, | ||
real world data analysis in Python. | ||
Additionally, it has the broader goal of becoming the most powerful and flexible | ||
open source data analysis / manipulation tool available in any language. | ||
|
||
## Vision | ||
|
||
A world where data analytics and manipulation software is: | ||
|
||
- Accessible to everyone | ||
- Free for users to use and modify | ||
- Flexible | ||
- Powerful | ||
- Easy to use | ||
- Fast | ||
|
||
## Values | ||
|
||
Is in the core of _pandas_ to be respectful and welcoming with everybody, | ||
users, contributors and the broader community. Regardless of level of experience, | ||
gender, gender identity and expression, sexual orientation, disability, | ||
personal appearance, body size, race, ethnicity, age, religion, or nationality. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
# Citing pandas | ||
|
||
## Citing | ||
|
||
If you use _pandas_ for a scientific publication, we would appreciate citations to one of the following papers: | ||
|
||
- [Data structures for statistical computing in python](http://conference.scipy.org/proceedings/scipy2010/pdfs/mckinney.pdf), | ||
McKinney, Proceedings of the 9th Python in Science Conference, Volume 445, 2010. | ||
|
||
@inproceedings{mckinney2010data, | ||
title={Data structures for statistical computing in python}, | ||
author={Wes McKinney}, | ||
booktitle={Proceedings of the 9th Python in Science Conference}, | ||
volume={445}, | ||
pages={51--56}, | ||
year={2010}, | ||
organization={Austin, TX} | ||
} | ||
|
||
|
||
- [pandas: a foundational Python library for data analysis and statistics](https://www.scribd.com/document/71048089/pandas-a-Foundational-Python-Library-for-Data-Analysis-and-Statistics), | ||
McKinney, Python for High Performance and Scientific Computing, Volume 14, 2011. | ||
|
||
@article{mckinney2011pandas, | ||
title={pandas: a foundational Python library for data analysis and statistics}, | ||
author={Wes McKinney}, | ||
journal={Python for High Performance and Scientific Computing}, | ||
volume={14}, | ||
year={2011} | ||
} | ||
|
||
## Brand and logo | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Once we have a new logo, this probably deserves it's own apge |
||
|
||
When using the project name _pandas_, please use it in lower case, even at the beginning of a sentence. | ||
|
||
The official logo of _pandas_ is: | ||
|
||
 | ||
|
||
You can download a `svg` version of the logo [here]({{ base_url }}/static/img/pandas.svg). | ||
|
||
When using the logo, please follow the next directives: | ||
|
||
- Leave enough margin around the logo | ||
- Do not distort the logo by changing its proportions | ||
- Do not place text or other elements on top of the logo |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
# Contributor Code of Conduct | ||
|
||
As contributors and maintainers of this project, and in the interest of | ||
fostering an open and welcoming community, we pledge to respect all people who | ||
contribute through reporting issues, posting feature requests, updating | ||
documentation, submitting pull requests or patches, and other activities. | ||
|
||
We are committed to making participation in this project a harassment-free | ||
experience for everyone, regardless of level of experience, gender, gender | ||
identity and expression, sexual orientation, disability, personal appearance, | ||
body size, race, ethnicity, age, religion, or nationality. | ||
|
||
Examples of unacceptable behavior by participants include: | ||
|
||
* The use of sexualized language or imagery | ||
* Personal attacks | ||
* Trolling or insulting/derogatory comments | ||
* Public or private harassment | ||
* Publishing other's private information, such as physical or electronic | ||
addresses, without explicit permission | ||
* Other unethical or unprofessional conduct | ||
|
||
Project maintainers have the right and responsibility to remove, edit, or | ||
reject comments, commits, code, wiki edits, issues, and other contributions | ||
that are not aligned to this Code of Conduct, or to ban temporarily or | ||
permanently any contributor for other behaviors that they deem inappropriate, | ||
threatening, offensive, or harmful. | ||
|
||
By adopting this Code of Conduct, project maintainers commit themselves to | ||
fairly and consistently applying these principles to every aspect of managing | ||
this project. Project maintainers who do not follow or enforce the Code of | ||
Conduct may be permanently removed from the project team. | ||
|
||
This Code of Conduct applies both within project spaces and in public spaces | ||
when an individual is representing the project or its community. | ||
|
||
A working group of community members is committed to promptly addressing any | ||
reported issues. The working group is made up of pandas contributors and users. | ||
Instances of abusive, harassing, or otherwise unacceptable behavior may be | ||
reported by contacting the working group by e-mail ([email protected]). | ||
Messages sent to this e-mail address will not be publicly visible but only to | ||
the working group members. The working group currently includes | ||
|
||
<ul> | ||
{% for person in maintainers.coc %} | ||
<li>{{ person }}</li> | ||
{% endfor %} | ||
</ul> | ||
|
||
All complaints will be reviewed and investigated and will result in a response | ||
that is deemed necessary and appropriate to the circumstances. Maintainers are | ||
obligated to maintain confidentiality with regard to the reporter of an | ||
incident. | ||
|
||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], | ||
version 1.3.0, available at | ||
[http://contributor-covenant.org/version/1/3/0/][version], | ||
and the [Swift Code of Conduct][swift]. | ||
|
||
[homepage]: http://contributor-covenant.org | ||
[version]: http://contributor-covenant.org/version/1/3/0/ | ||
[swift]: https://swift.org/community/#code-of-conduct | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,38 @@ | ||
## Bug reports and enhancement requests | ||
|
||
Bug reports are an important part of making *pandas* more stable. Having | ||
a complete bug report will allow others to reproduce the bug and provide | ||
insight into fixing. See [this stackoverflow article](https://stackoverflow.com/help/mcve) | ||
and [this blogpost](http://matthewrocklin.com/blog/work/2018/02/28/minimal-bug-reports) | ||
for tips on writing a good bug report. | ||
|
||
Trying the bug-producing code out on the *master* branch is often a | ||
worthwhile exercise to confirm the bug still exists. It is also worth | ||
searching existing bug reports and pull requests to see if the issue has | ||
already been reported and/or fixed. | ||
|
||
Bug reports must: | ||
|
||
1. Include a short, self-contained Python snippet reproducing the | ||
problem. You can format the code nicely by using [GitHub Flavored | ||
Markdown \<http://github.github.com/github-flavored-markdown/\>](): | ||
|
||
```python | ||
>>> from pandas import DataFrame | ||
>>> df = DataFrame(...) | ||
... | ||
``` | ||
|
||
2. Include the full version string of *pandas* and its dependencies. | ||
You can use the built-in function: | ||
|
||
```python | ||
>>> import pandas as pd | ||
>>> pd.show_versions() | ||
``` | ||
|
||
3. Explain why the current behavior is wrong/not desired and what you | ||
expect instead. | ||
|
||
The issue will then show up to the *pandas* community and be open to | ||
comments/ideas from others. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.