The Kitware Plot Module
=======================
|GitlabCIPipeline| |GitlabCICoverage| |Appveyor| |Pypi| |Downloads| |ReadTheDocs|
+------------------+------------------------------------------------------+
| ReadTheDocs | https://kwplot.readthedocs.io/en/latest/ |
+------------------+------------------------------------------------------+
| Gitlab (main) | https://gitlab.kitware.com/computer-vision/kwplot |
+------------------+------------------------------------------------------+
| Github (mirror) | https://github.com/Kitware/kwplot |
+------------------+------------------------------------------------------+
| Pypi | https://pypi.org/project/kwplot |
+------------------+------------------------------------------------------+
The ``kwplot`` module is a wrapper around ``matplotlib`` and can be used for
visualizing algorithm results.
The top-level API is:
.. code:: python
from .auto_backends import (autompl, autoplt, set_mpl_backend,)
from .draw_conv import (make_conv_images, plot_convolutional_features,)
from .mpl_3d import (plot_surface3d,)
from .mpl_color import (Color,)
from .mpl_core import (distinct_colors, distinct_markers, ensure_fnum, figure,
imshow, legend, next_fnum, set_figtitle,
show_if_requested,)
from .mpl_draw import (draw_boxes, draw_boxes_on_image, draw_clf_on_image,
draw_line_segments, draw_text_on_image, plot_matrix, draw_points,)
from .mpl_make import (make_heatmask, make_orimask, make_vector_field,)
from .mpl_multiplot import (multi_plot,)
from .mpl_plotnums import (PlotNums,)
One of the key features is the `kwplot.autompl <https://kwplot.readthedocs.io/en/main/kwplot.html#kwplot.autompl>`_
function, which is able to somewhat intelligently set the notorious matplotlib
backend.
By default it will attempt to use ``PyQt5`` if it is installed and a
``DISPLAY`` is available. Otherwise it will ensure the backend is set to
``Agg``. For convinience, the functions:
`kwplot.autoplt <https://kwplot.readthedocs.io/en/main/kwplot.html#kwplot.autoplt>`_ and
`kwplot.autosns <https://kwplot.readthedocs.io/en/main/kwplot.html#kwplot.autosns>`_
also execute this auto-backend behavior, but return the pyplot and seaborn
module, respectively. It is recommended to call one of these functions before
any use of pyplot due to pyplot's import-time side effects (note: pre-importing
most other matplotlib modules is ok).
The ``kwplot.imshow`` and ``kwplot.figure`` functions are extensions of the
``matplotlib`` versions with slightly extended interfaces (again to help reduce
the density of visualization code in research scripts). The ``kwplot.PlotNums``
helps manage subplots locations, especially when you are developing /
reordering them.
.. |Pypi| image:: https://img.shields.io/pypi/v/kwplot.svg
:target: https://pypi.python.org/pypi/kwplot
.. |Downloads| image:: https://img.shields.io/pypi/dm/kwplot.svg
:target: https://pypistats.org/packages/kwplot
.. |ReadTheDocs| image:: https://readthedocs.org/projects/kwplot/badge/?version=main
:target: http://kwplot.readthedocs.io/en/main/
.. # See: https://ci.appveyor.com/project/jon.crall/kwplot/settings/badges
.. |Appveyor| image:: https://ci.appveyor.com/api/projects/status/py3s2d6tyfjc8lm3/branch/main?svg=true
:target: https://ci.appveyor.com/project/jon.crall/kwplot/branch/main
.. |GitlabCIPipeline| image:: https://gitlab.kitware.com/computer-vision/kwplot/badges/main/pipeline.svg
:target: https://gitlab.kitware.com/computer-vision/kwplot/-/jobs
.. |GitlabCICoverage| image:: https://gitlab.kitware.com/computer-vision/kwplot/badges/main/coverage.svg
:target: https://gitlab.kitware.com/computer-vision/kwplot/commits/main
Raw data
{
"_id": null,
"home_page": "https://gitlab.kitware.com/computer-vision/kwplot",
"name": "kwplot",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Jon Crall",
"author_email": "jon.crall@kitware.com",
"download_url": "https://files.pythonhosted.org/packages/e4/c2/e3c32b6dd7c9caabb19120161f6261d9d168071e879a646cfb747d4fd2b0/kwplot-0.5.2.tar.gz",
"platform": null,
"description": "The Kitware Plot Module\n=======================\n\n|GitlabCIPipeline| |GitlabCICoverage| |Appveyor| |Pypi| |Downloads| |ReadTheDocs|\n\n+------------------+------------------------------------------------------+\n| ReadTheDocs | https://kwplot.readthedocs.io/en/latest/ |\n+------------------+------------------------------------------------------+\n| Gitlab (main) | https://gitlab.kitware.com/computer-vision/kwplot |\n+------------------+------------------------------------------------------+\n| Github (mirror) | https://github.com/Kitware/kwplot |\n+------------------+------------------------------------------------------+\n| Pypi | https://pypi.org/project/kwplot |\n+------------------+------------------------------------------------------+\n\nThe ``kwplot`` module is a wrapper around ``matplotlib`` and can be used for\nvisualizing algorithm results.\n\nThe top-level API is:\n\n.. code:: python\n\n from .auto_backends import (autompl, autoplt, set_mpl_backend,)\n from .draw_conv import (make_conv_images, plot_convolutional_features,)\n from .mpl_3d import (plot_surface3d,)\n from .mpl_color import (Color,)\n from .mpl_core import (distinct_colors, distinct_markers, ensure_fnum, figure,\n imshow, legend, next_fnum, set_figtitle,\n show_if_requested,)\n from .mpl_draw import (draw_boxes, draw_boxes_on_image, draw_clf_on_image,\n draw_line_segments, draw_text_on_image, plot_matrix, draw_points,)\n from .mpl_make import (make_heatmask, make_orimask, make_vector_field,)\n from .mpl_multiplot import (multi_plot,)\n from .mpl_plotnums import (PlotNums,)\n\nOne of the key features is the `kwplot.autompl <https://kwplot.readthedocs.io/en/main/kwplot.html#kwplot.autompl>`_\nfunction, which is able to somewhat intelligently set the notorious matplotlib\nbackend.\nBy default it will attempt to use ``PyQt5`` if it is installed and a\n``DISPLAY`` is available. Otherwise it will ensure the backend is set to\n``Agg``. For convinience, the functions:\n`kwplot.autoplt <https://kwplot.readthedocs.io/en/main/kwplot.html#kwplot.autoplt>`_ and\n`kwplot.autosns <https://kwplot.readthedocs.io/en/main/kwplot.html#kwplot.autosns>`_\nalso execute this auto-backend behavior, but return the pyplot and seaborn\nmodule, respectively. It is recommended to call one of these functions before\nany use of pyplot due to pyplot's import-time side effects (note: pre-importing\nmost other matplotlib modules is ok).\n\nThe ``kwplot.imshow`` and ``kwplot.figure`` functions are extensions of the\n``matplotlib`` versions with slightly extended interfaces (again to help reduce\nthe density of visualization code in research scripts). The ``kwplot.PlotNums``\nhelps manage subplots locations, especially when you are developing /\nreordering them.\n\n\n.. |Pypi| image:: https://img.shields.io/pypi/v/kwplot.svg\n :target: https://pypi.python.org/pypi/kwplot\n\n.. |Downloads| image:: https://img.shields.io/pypi/dm/kwplot.svg\n :target: https://pypistats.org/packages/kwplot\n\n.. |ReadTheDocs| image:: https://readthedocs.org/projects/kwplot/badge/?version=main\n :target: http://kwplot.readthedocs.io/en/main/\n\n.. # See: https://ci.appveyor.com/project/jon.crall/kwplot/settings/badges\n.. |Appveyor| image:: https://ci.appveyor.com/api/projects/status/py3s2d6tyfjc8lm3/branch/main?svg=true\n :target: https://ci.appveyor.com/project/jon.crall/kwplot/branch/main\n\n.. |GitlabCIPipeline| image:: https://gitlab.kitware.com/computer-vision/kwplot/badges/main/pipeline.svg\n :target: https://gitlab.kitware.com/computer-vision/kwplot/-/jobs\n\n.. |GitlabCICoverage| image:: https://gitlab.kitware.com/computer-vision/kwplot/badges/main/coverage.svg\n :target: https://gitlab.kitware.com/computer-vision/kwplot/commits/main\n",
"bugtrack_url": null,
"license": "Apache 2",
"summary": "The kwplot module",
"version": "0.5.2",
"project_urls": {
"Homepage": "https://gitlab.kitware.com/computer-vision/kwplot"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9de7dd38ac7ce83543e27acd5893eb249d066bc67f21adb7b237d85fe6fa779d",
"md5": "01337b7c59eeb52e23c79fa95f937643",
"sha256": "f21b5ad12901dd4ebcbda64e2d81803c7311c5e8dbe87b506a9c4129044b03f5"
},
"downloads": -1,
"filename": "kwplot-0.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "01337b7c59eeb52e23c79fa95f937643",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 89667,
"upload_time": "2024-09-09T21:13:04",
"upload_time_iso_8601": "2024-09-09T21:13:04.796196Z",
"url": "https://files.pythonhosted.org/packages/9d/e7/dd38ac7ce83543e27acd5893eb249d066bc67f21adb7b237d85fe6fa779d/kwplot-0.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e4c2e3c32b6dd7c9caabb19120161f6261d9d168071e879a646cfb747d4fd2b0",
"md5": "91cab0b2cdbbf6aa4d49ad5054c5c85c",
"sha256": "7114cdae9c8a6830ddd668ce668b7cda3fd8220937d346131f7853ff05593cf0"
},
"downloads": -1,
"filename": "kwplot-0.5.2.tar.gz",
"has_sig": false,
"md5_digest": "91cab0b2cdbbf6aa4d49ad5054c5c85c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 87702,
"upload_time": "2024-09-09T21:13:07",
"upload_time_iso_8601": "2024-09-09T21:13:07.794310Z",
"url": "https://files.pythonhosted.org/packages/e4/c2/e3c32b6dd7c9caabb19120161f6261d9d168071e879a646cfb747d4fd2b0/kwplot-0.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-09 21:13:07",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "kwplot"
}
JSON