DOC: Added plt.show() at the end of each necessary block

[ehallam]

Added plt.show() at the end of each necessary block.
Moved and reworded title section.

• closes DOC: Addition of plt.show() in the "How to create plots in pandas?" section of the Getting started tutorials #45772
• Tests added and passed if fixing a bug or adding a new feature
• All code checks passed.
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature.

[jreback]

why are you changing to use plt.show() and not just adding ; which render the plots?

[jreback]

umm you can just add a ; no?

[ehallam]

Hi @jreback. Thanks for your comment. I understand that adding the semicolon at the end of air_quality.plot() line will suppress the Out[N]: AxesSubplot:xlabel='datetime' line from the output, but that's not how I understood the purpose of issue #45772.

I believe that the fix for the issue needs to explicitly show the plt.show(), not because it is necessary in that particular example, but so that the user understands plt.show() is the function that can be called to render the plot, rather than it just automagically appearing below the cell. Without this, a new user may believe that the call to plot() is actually rendering the figure. In the scenario below, for example, we need to explicitly call plt.show() to render the charts at the right point in the code. I think the hope is that including plt.show() in the example will provide them with the knowledge to be able to do this.

for station in air_quality.columns:
    print(station)

    fig = air_quality[station].plot(figsize=(12, 4))
    fig.set_ylabel("NO$_2$ concentration")
    plt.show()

    fig = air_quality[station].plot.area(figsize=(12, 4))
    fig.set_ylabel("NO$_2$ concentration")
    plt.show()

[ehallam]

[jreback]

why are you not letting these run with python mode. this is not what we do elsewhere.

[ehallam]

Hi @jreback, if I run them in Python mode it displays as below with the extra Out[4] line, which is why I didn't run them in Python mode. I just thought it looked cleaner that way as the Out line doesn't add value.

If we wanted to get rid of this out line while still running in Python mode I can add semi colons to the end of each .plot() line as demonstrated below. Which of these would you prefer me to do?

[jreback]

just assign it instead. this is a bit non-standard what you are doing and that's not great.

[ehallam]

@jreback how does this look? Many thanks for your help

[mroeschke]

Sure, this change looks okay. LGTM

[jreback]

thanks @ehallam