Visitar URL original
Improve the tutorial for Cartesian Histograms · Issue #4905 · GenericMappingTools/pygmt · GitHub
Skip to content

Improve the tutorial for Cartesian Histograms #4905

Open

Description

@seisman

We already have a good tutorial for Cartesian Histograms at https://www.pygmt.org/0.19.0/tutorials/advanced/cartesian_histograms.html, which was initially developed more than 3 years ago (#2445).

Here are some ideas to improve the tutorial:

  • The series parameter is one of the most important parameters that controls the histogram, but it's not explained well. The first subsection should focus on this parameter
  • Inspired by matplotlib's hist method's histype parameter, I feel we should have a subsection showing different histogram styles, by different combinations of fill/pen/stairs (xref: Figure.histogram: Migrate parameter 'stairs' to the new alias system #4884 (comment)). With this subsection, we could remove the existing "Stair-steps" subsection from the tutorial
  • Horizontal histograms are less commonly used, so it makes little sense to have "Vertical and horizontal bars" at the start of the tutorial
  • Maybe also add a subsection for adding the distribution curves

Activity

  1. added this to the 0.20.0 milestone on Sep 21, 2026
  2. added
    documentationImprovements or additions to documentation
    help wantedHelping hands are appreciated
    on Sep 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationhelp wantedHelping hands are appreciated

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions