seaborn README

The project's README from github.com/mwaskom/seaborn. As one markdown file: README.md.



seaborn: statistical data visualization

PyPI Version License DOI Tests Code Coverage

Seaborn is a Python visualization library based on matplotlib. It provides a high-level interface for drawing attractive statistical graphics.

Documentation

Online documentation is available at seaborn.pydata.org.

The docs include a tutorial, example gallery, API reference, FAQ, and other useful information.

To build the documentation locally, please refer to doc/README.md.

Dependencies

Seaborn supports Python 3.10+.

Installation requires numpy, pandas, and matplotlib. Some advanced statistical functionality requires scipy and/or statsmodels.

Installation

The latest stable release (and required dependencies) can be installed from PyPI:

uv pip install seaborn

It is also possible to include optional statistical dependencies:

uv pip install seaborn[stats]

Seaborn can also be installed with conda:

conda install seaborn

Note that the main anaconda repository lags PyPI in adding new releases, but conda-forge (-c conda-forge) typically updates quickly.

Citing

A paper describing seaborn has been published in the Journal of Open Source Software. The paper provides an introduction to the key features of the library, and it can be used as a citation if seaborn proves integral to a scientific publication.

Testing

Testing seaborn requires installing additional dependencies; they will be installed when running uv sync with a source checkout.

To test the code, run make test in the source directory. This will exercise the unit tests (using pytest) and generate a coverage report.

Code style is enforced with ruff using the settings in the pyproject.toml file. Run make lint to check. Alternately, you can use pre-commit to automatically run lint checks on any files you are committing: just run pre-commit install to set it up, and then commit as usual going forward.

Development

Seaborn development takes place on Github: https://github.com/mwaskom/seaborn

Please submit bugs that you encounter to the issue tracker with a reproducible example demonstrating the problem. Questions about usage are more at home on StackOverflow, where there is a seaborn tag.

seaborn (mwaskom/seaborn)

Searching Database…

14.1K ·GitHub
Что это такое?Seaborn — это библиотека визуализации для Python на основе matplotlib, которая предлагает высокоуровневый интерфейс для создания красивых статистических графиков.
А чем это отличается от обычного matplotlib?Это библиотека, которую вы импортируете в свой Python-код, и она работает поверх matplotlib: вместо того чтобы вручную настраивать детали графиков, вы получаете более удобный API, заточенный под статистическую графику.
Что ещё нужно установить, кроме самой библиотеки?Python 3.10 или новее, а также numpy, pandas и matplotlib. Для продвинутой статистики дополнительно нужны scipy и/или statsmodels — всё это ставится командой uv pip install seaborn[stats].
Есть ли подводные камни, о которых стоит знать перед установкой?Если ставить через conda, учтите: основной репозиторий anaconda выкладывает новые версии позже, чем PyPI, а канал conda-forge обычно обновляется быстро.
С чего начать после установки?В онлайн-документации на seaborn.pydata.org есть учебник, галерея примеров, справочник по API и FAQ — галерея примеров — это самый быстрый способ увидеть, какие графики умеет строить библиотека.
А будет ли работать с моими DataFrame в pandas?Да — pandas входит в обязательные зависимости, поэтому seaborn изначально построен вокруг структур данных pandas, и конвертировать ваши данные отдельно не придётся.
Если я использую её в научной работе, что можно сослать?Да — статья про seaborn была опубликована в Journal of Open Source Software, и README предлагает её как цитирование, если seaborn играет важную роль в научной публикации.
Можно ли использовать её в коммерческих проектах?Да — согласно метаданным на GitHub, seaborn распространяется под разрешающей лицензией BSD-3-Clause, так что и коммерческое, и научное использование вполне допустимы.
Creator
mwaskom
Size
53.3 MB
Stars
14.1K
Age
14y
Commits · 90 Days