.. -- mode: rst --

.. image:: doc/datamapplot_text_horizontal.png :width: 600 :alt: DataMapPlot 标志 :align: center

=========== DataMapPlot

创建美观的数据地图图表。DataMapPlot 是一个小型库，旨在帮助您制作美观的数据地图图表，以便用于演示、海报和论文中。其重点是生成静态图表或简单的交互式图表，尽可能减少您的工作量，同时保证出色的外观。您只需要标记数据地图中的点簇，DataMapPlot 将处理其余部分。尽管这涉及自动化大部分美学选择，但该库提供了多种方法来根据您的需求自定义生成的图表。

静态图表示例

以下是 DataMapPlot 可以提供的一些输出示例。

基本图表，带有一些高亮标签：

.. image:: examples/plot_cord19.png :width: 1024 :alt: CORD-19 数据集的数据地图图表 :align: center

使用暗黑模式和一些自定义字体选择：

.. image:: examples/plot_arxiv_ml.png :width: 1024 :alt: ArXiv ML 论文的数据地图图表 :align: center

以词云风格在点上显示标签：

.. image:: examples/plot_arxiv_ml_word_cloud.png :width: 1024 :alt: ArXiv ML 论文的词云风格数据地图图表 :align: center

替代性自定义样式：

.. image:: examples/plot_wikipedia.png :width: 1024 :alt: 简体维基百科的数据地图图表 :align: center

自定义箭头样式、字体和颜色图：

.. image:: examples/plot_simple_arxiv.png :width: 1024 :alt: ArXiv ML 论文的样式化数据地图图表 :align: center

交互式图表示例

以下是与交互式 HTML 图表交互的一些示例视频。

.. image:: examples/ArXiv_example.gif :width: 640px :alt: ArXiv 数据搜索和缩放动画

.. image:: examples/CORD19_example.gif :width: 640px :alt: CORD19 数据缩放和平移动画

.. image:: examples/Wikipedia_example.gif :width: 640px :alt: 维基百科数据平移和缩放动画

.. image:: examples/CORD19_custom_example.gif :width: 640px :alt: CORD19 数据搜索和缩放动画

基本用法

DataMapPlot 使用非常简单。本质上只有两个函数：create_plot 和 create_interactive_plot。它们接受数据地图的坐标和数据点的标签数组或列表。可以使用各种其他选项来自定义输出。一个基本示例可能如下所示：

.. code:: python

import datamapplot

datamapplot.create_plot(data_map_coords, data_map_labels, **style_keywords)

有关使用和选项的完整详细信息，请参阅文档。

文档

DataMapPlot 的完整文档可在 ReadTheDocs <https://datamapplot.readthedocs.io/>_ 上获取。

安装

DataMapPlot 需要一些库，但它们都广泛可用且易于安装：

Numpy
Matplotlib
Scikit-learn
Pandas
Datashader
Scikit-image
Numba
Requests
Jinja2

要安装 DataMapPlot，您可以使用 pip：

.. code:: bash

pip install datamapplot

或使用 conda 和 conda-forge：

.. code:: bash

conda install -c conda-forge datamapplot

许可证

DataMapPlot 采用 MIT 许可。有关详细信息，请参阅 LICENSE 文件。

帮助和支持

文档位于 Read the Docs <https://datamapplot.readthedocs.io/>。文档 包含一个常见问题解答 <https://datamapplot.readthedocs.io/en/latest/faq.html>，可能回答您的问题。如果您仍有疑问，请 提出问题 <https://github.com/TutteInstitute/datamapplot/issues/new>，我将尽力提供帮助和指导。请阅读 行为准则 <https://github.com/TutteInstitute/datamapplot/blob/main/CODE_OF_CONDUCT.md>，了解问题和PR讨论中可接受的行为。

贡献

我们非常欢迎贡献！如果您对功能或项目有想法，请与我们联系。从代码到笔记本再到示例和文档，一切都同等重要，所以请不要觉得您不能做出贡献。要贡献，请 fork 项目 <https://github.com/TutteInstitute/datamapplot/issues#fork-destination-box>_，进行更改并提交拉取请求。我们将尽最大努力解决任何问题，并将您的代码合并进来。

我们想指出，DataMapPlot 包大量使用了 NumFOCUS 赞助的项目，如果没有他们对这些项目的支持，这将是不可能的，所以请 考虑为 NumFOCUS 做出贡献 <https://www.numfocus.org/membership>_。