.. -*- mode: rst -*-
.. image:: doc/datamapplot_text_horizontal.png
:width: 600
:alt: DataMapPlot logo
:align: center
===========
DataMapPlot
===========
Creating beautiful plots of data maps. DataMapPlot is a small library designed to help you make beautiful data map
plots for inclusion in presentations, posters and papers. The focus is on producing static plots,
or simple interactive plots, that are great looking with as little work for you as possible. All you need to do is
label clusters of points in the data map and DataMapPlot will take care of the rest. While this involves automating
most of the aesthetic choices, the library provides a wide variety of ways to customize the resulting
plot to your needs.
--------------------
Static Plot Examples
--------------------
Some examples of the kind of output that DataMapPlot can provide.
A basic plot, with some highlighted labels:
.. image:: examples/plot_cord19.png
:width: 1024
:alt: A data map plot of the CORD-19 dataset
:align: center
Using darkmode and some custom font choices:
.. image:: examples/plot_arxiv_ml.png
:width: 1024
:alt: A data map plot of papers from ArXiv ML
:align: center
Alternative custom styling:
.. image:: examples/plot_wikipedia.png
:width: 1024
:alt: A data map plot of Simple Wikipedia
:align: center
Custom arrow styles, fonts, and colour maps:
.. image:: examples/plot_simple_arxiv.png
:width: 1024
:alt: A styled data map plot of papers from ArXiv ML
:align: center
-------------------------
Interactive Plot Examples
-------------------------
Some example videos of interacting with the interactive html plots.
.. image:: examples/ArXiv_example.gif
:width: 640px
:alt: Animation of searching and zooming on ArXiv data
.. image:: examples/CORD19_example.gif
:width: 640px
:alt: Animation of zooming and panning on CORD19 data
.. image:: examples/Wikipedia_example.gif
:width: 640px
:alt: Animation of panning and zooming on Wikipedia data
.. image:: examples/CORD19_custom_example.gif
:width: 640px
:alt: Animation of searching and zooming on CORD19 data
-----------
Basic Usage
-----------
DataMapPlot is very easy to use. There are essentially only two functions: `create_plot` and
`create_interactive_plot`. They take coordinates of a data map, and an array or list of labels
for the data points. A variety of further options can be used to customise the output.
A basic example might look something like:
.. code:: python
import datamapplot
datamapplot.create_plot(data_map_coords, data_map_labels, **style_keywords)
Please see the documentation for full details on usage and options.
-------------
Documentation
-------------
Full documentation for DataMapPlot is available on
`ReadTheDocs <https://datamapplot.readthedocs.io/>`_.
------------
Installation
------------
DataMapPlot requires a few libraries, but all are widely available and easy to install:
* Numpy
* Matplotlib
* Scikit-learn
* Pandas
* Datashader
* Scikit-image
* Numba
* Requests
* Jinja2
To install DataMapPlot you can use pip:
.. code:: bash
pip install datamapplot
or use conda with conda-forge
.. code:: bash
conda install -c conda-forge datamapplot
-------
License
-------
DataMapPlot is MIT licensed. See the LICENSE file for details.
----------------
Help and Support
----------------
Documentation is at `Read the Docs <https://datamapplot.readthedocs.io/>`_.
The documentation `includes a FAQ <https://datamapplot.readthedocs.io/en/latest/faq.html>`_ that
may answer your questions. If you still have questions then please
`open an issue <https://github.com/TutteInstitute/datamapplot/issues/new>`_
and I will try to provide any help and guidance that I can. Please read
the `code of conduct <https://github.com/TutteInstitute/datamapplot/blob/main/CODE_OF_CONDUCT.md>`_
for acceptable behaviour in issue and PR discussions.
------------
Contributing
------------
Contributions are more than welcome! If you have ideas for features or projects please get in touch. Everything from
code to notebooks to examples and documentation are all *equally valuable* so please don't feel you can't contribute.
To contribute please `fork the project <https://github.com/TutteInstitute/datamapplot/issues#fork-destination-box>`_ make your
changes and submit a pull request. We will do our best to work through any issues with you and get your code merged in.
We would like to note that the DataMapPlot package makes heavy use of
NumFOCUS sponsored projects, and would not be possible without
their support of those projects, so please `consider contributing to NumFOCUS <https://www.numfocus.org/membership>`_.
Raw data
{
"_id": null,
"home_page": "https://github.com/TutteInstitute/datamapplot",
"name": "datamapplot",
"maintainer": "Leland McInnes",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "leland.mcinnes@gmail.com",
"keywords": "data map,visualization,topic modelling,cluster,clustering",
"author": "Leland McInnes",
"author_email": "leland.mcinnes@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/de/ab/0dfc789deb32c3d1a7796f237119237be7619ee28652309db9cf87127f5d/datamapplot-0.2.2.tar.gz",
"platform": null,
"description": ".. -*- mode: rst -*-\n\n.. image:: doc/datamapplot_text_horizontal.png\n :width: 600\n :alt: DataMapPlot logo\n :align: center\n\n===========\nDataMapPlot\n===========\n\nCreating beautiful plots of data maps. DataMapPlot is a small library designed to help you make beautiful data map\nplots for inclusion in presentations, posters and papers. The focus is on producing static plots,\nor simple interactive plots, that are great looking with as little work for you as possible. All you need to do is\nlabel clusters of points in the data map and DataMapPlot will take care of the rest. While this involves automating\nmost of the aesthetic choices, the library provides a wide variety of ways to customize the resulting\nplot to your needs.\n\n--------------------\nStatic Plot Examples\n--------------------\n\nSome examples of the kind of output that DataMapPlot can provide.\n\nA basic plot, with some highlighted labels:\n\n.. image:: examples/plot_cord19.png\n :width: 1024\n :alt: A data map plot of the CORD-19 dataset\n :align: center\n\nUsing darkmode and some custom font choices:\n\n.. image:: examples/plot_arxiv_ml.png\n :width: 1024\n :alt: A data map plot of papers from ArXiv ML\n :align: center\n\nAlternative custom styling:\n\n.. image:: examples/plot_wikipedia.png\n :width: 1024\n :alt: A data map plot of Simple Wikipedia\n :align: center\n\nCustom arrow styles, fonts, and colour maps:\n\n.. image:: examples/plot_simple_arxiv.png\n :width: 1024\n :alt: A styled data map plot of papers from ArXiv ML\n :align: center\n\n-------------------------\nInteractive Plot Examples\n-------------------------\n\nSome example videos of interacting with the interactive html plots.\n\n.. image:: examples/ArXiv_example.gif\n :width: 640px\n :alt: Animation of searching and zooming on ArXiv data\n\n.. image:: examples/CORD19_example.gif\n :width: 640px\n :alt: Animation of zooming and panning on CORD19 data\n\n.. image:: examples/Wikipedia_example.gif\n :width: 640px\n :alt: Animation of panning and zooming on Wikipedia data\n\n.. image:: examples/CORD19_custom_example.gif\n :width: 640px\n :alt: Animation of searching and zooming on CORD19 data\n\n-----------\nBasic Usage\n-----------\n\nDataMapPlot is very easy to use. There are essentially only two functions: `create_plot` and\n`create_interactive_plot`. They take coordinates of a data map, and an array or list of labels\nfor the data points. A variety of further options can be used to customise the output.\nA basic example might look something like:\n\n.. code:: python\n\n import datamapplot\n\n datamapplot.create_plot(data_map_coords, data_map_labels, **style_keywords)\n\nPlease see the documentation for full details on usage and options.\n\n-------------\nDocumentation\n-------------\n\nFull documentation for DataMapPlot is available on\n`ReadTheDocs <https://datamapplot.readthedocs.io/>`_.\n\n------------\nInstallation\n------------\n\nDataMapPlot requires a few libraries, but all are widely available and easy to install:\n\n * Numpy\n * Matplotlib\n * Scikit-learn\n * Pandas\n * Datashader\n * Scikit-image\n * Numba\n * Requests\n * Jinja2\n\nTo install DataMapPlot you can use pip:\n\n.. code:: bash\n\n pip install datamapplot\n\nor use conda with conda-forge\n\n.. code:: bash\n\n conda install -c conda-forge datamapplot\n\n\n-------\nLicense\n-------\n\nDataMapPlot is MIT licensed. See the LICENSE file for details.\n\n----------------\nHelp and Support\n----------------\n\nDocumentation is at `Read the Docs <https://datamapplot.readthedocs.io/>`_.\nThe documentation `includes a FAQ <https://datamapplot.readthedocs.io/en/latest/faq.html>`_ that\nmay answer your questions. If you still have questions then please\n`open an issue <https://github.com/TutteInstitute/datamapplot/issues/new>`_\nand I will try to provide any help and guidance that I can. Please read\nthe `code of conduct <https://github.com/TutteInstitute/datamapplot/blob/main/CODE_OF_CONDUCT.md>`_\nfor acceptable behaviour in issue and PR discussions.\n\n------------\nContributing\n------------\n\nContributions are more than welcome! If you have ideas for features or projects please get in touch. Everything from\ncode to notebooks to examples and documentation are all *equally valuable* so please don't feel you can't contribute.\nTo contribute please `fork the project <https://github.com/TutteInstitute/datamapplot/issues#fork-destination-box>`_ make your\nchanges and submit a pull request. We will do our best to work through any issues with you and get your code merged in.\n\nWe would like to note that the DataMapPlot package makes heavy use of\nNumFOCUS sponsored projects, and would not be possible without\ntheir support of those projects, so please `consider contributing to NumFOCUS <https://www.numfocus.org/membership>`_.\n\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A library for presentation and publication ready plots of data maps",
"version": "0.2.2",
"project_urls": {
"Homepage": "https://github.com/TutteInstitute/datamapplot"
},
"split_keywords": [
"data map",
"visualization",
"topic modelling",
"cluster",
"clustering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "90f81563284d0a24b776d2b24b3d2025161a9561540f185e11436205b98e0251",
"md5": "1738eeb37b978c246cede0968b6dcda5",
"sha256": "02fa23166dd8801895486e2956d27fdf8f367538434c9ee462149da9396795cd"
},
"downloads": -1,
"filename": "datamapplot-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1738eeb37b978c246cede0968b6dcda5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 34654,
"upload_time": "2024-03-02T01:34:46",
"upload_time_iso_8601": "2024-03-02T01:34:46.501418Z",
"url": "https://files.pythonhosted.org/packages/90/f8/1563284d0a24b776d2b24b3d2025161a9561540f185e11436205b98e0251/datamapplot-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "deab0dfc789deb32c3d1a7796f237119237be7619ee28652309db9cf87127f5d",
"md5": "b8911bdfd698b7656b2f62e6810139b0",
"sha256": "a6fe49ace7f3610dd6e3ea0ef31f4b45ec8019a29cfa5ed967e3d2abe1b689e7"
},
"downloads": -1,
"filename": "datamapplot-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "b8911bdfd698b7656b2f62e6810139b0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 33448,
"upload_time": "2024-03-02T01:34:48",
"upload_time_iso_8601": "2024-03-02T01:34:48.189132Z",
"url": "https://files.pythonhosted.org/packages/de/ab/0dfc789deb32c3d1a7796f237119237be7619ee28652309db9cf87127f5d/datamapplot-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-02 01:34:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TutteInstitute",
"github_project": "datamapplot",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "datamapplot"
}
JSON
