b07-pyplot

%23%20%2F%2F%2F%20script%0A%23%20dependencies%20%3D%20%5B%0A%23%20%20%20%20%20%22cmocean%22%2C%0A%23%20%20%20%20%20%22marimo%22%2C%0A%23%20%20%20%20%20%22matplotlib%22%2C%0A%23%20%20%20%20%20%22numpy%22%2C%0A%23%20%20%20%20%20%22openpyxl%22%2C%0A%23%20%20%20%20%20%22pandas%22%2C%0A%23%20%20%20%20%20%22plotly%22%2C%0A%23%20%5D%0A%23%20%2F%2F%2F%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.25.0%22%0Aapp%20%3D%20marimo.App()%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%0A%20%20%20%20return%20(mo%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Aasync%20def%20_()%3A%0A%20%20%20%20%23%20WebAssembly%20(browser)%20version%20only%3A%20download%20the%20course%20data%20files%0A%20%20%20%20import%20sys%20as%20_sys%0A%0A%20%20%20%20if%20_sys.platform%20%3D%3D%20%22emscripten%22%3A%0A%20%20%20%20%20%20%20%20import%20os%20as%20_os%0A%20%20%20%20%20%20%20%20from%20pyodide.http%20import%20pyfetch%20as%20_pyfetch%0A%0A%20%20%20%20%20%20%20%20for%20_file%20in%20(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22data%2Fexample_flow_gauge.xlsx%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22data%2FFlowDepth009.csv%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22data%2Ftemperature_change.csv%22%2C%0A%20%20%20%20%20%20%20%20)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20_os.makedirs(_os.path.dirname(_file)%2C%20exist_ok%3DTrue)%0A%20%20%20%20%20%20%20%20%20%20%20%20_response%20%3D%20await%20_pyfetch(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22https%3A%2F%2Fraw.githubusercontent.com%2Fsschwindt%2Fmarimo-python-course%2Fmain%2F%22%20%2B%20_file%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20with%20open(_file%2C%20%22wb%22)%20as%20_local_file%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20_local_file.write(await%20_response.bytes())%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%20Plotting%0A%0A%20%20%20%20Use%20matplotlib%2C%20pandas%2C%20and%20plotly%20to%20leverage%20Python's%20power%20of%20data%20visualization.%0A%0A%20%20%20%20%23%23%20Tools%20(Packages)%20for%20Plotting%20with%20Python%0A%0A%20%20%20%20Several%20packages%20enable%20plotting%20in%20Python.%20The%20last%20page%20already%20introduced%20%5BNumPy%5D(https%3A%2F%2Fhydro-informatics.com%2Fpython-basics%2Fpynum.html%23numpy)%20and%20%5Bpandas%5D(https%3A%2F%2Fhydro-informatics.com%2Fpython-basics%2Fpynum.html%23pandas)%20for%20plotting%20histograms.%20*pandas*%20plotting%20capacities%20go%20way%20beyond%20just%20plotting%20histograms%20and%20it%20relies%20on%20the%20powerful%20%5Bmatplotlib%5D(https%3A%2F%2Fmatplotlib.org%2F)%20library.%20*SciPy*'s%20*matplotlib*%20is%20the%20most%20popular%20plotting%20library%20in%20*Python*%20(since%20its%20introduction%20in%202003)%20and%20not%20only%20*pandas*%2C%20but%20also%20other%20libraries%20(for%20example%20the%20abstraction%20layer%20%5BSeaborn%5D(https%3A%2F%2Fseaborn.pydata.org%2F))%20use%20*matplotlib*%20with%20facilitated%20commands.%20This%20page%20introduces%20the%20following%20packages%20for%20data%20visualization%3A%0A%0A%20%20%20%20*%20%5Bmatplotlib%5D(https%3A%2F%2Fhydro-informatics.com%2Fpython-basics%2Fpynum.html%23matplotlib)%20-%20the%20baseline%20for%20data%20visualization%20in%20Python%0A%20%20%20%20*%20%5Bpandas%5D(https%3A%2F%2Fhydro-informatics.com%2Fpython-basics%2Fpynum.html%23pandas)%20-%20as%20wrapper%20API%20of%20*matplotlib*%2C%20with%20many%20simplified%20options%20for%20meaningful%20plots%0A%20%20%20%20*%20%5Bplotly%5D(https%3A%2F%2Fhydro-informatics.com%2Fjupyter%2Fpyplot.html%23interactive-plots-with-plotly)%20-%20for%20interactive%20plots%2C%20in%20which%20users%20can%20change%20and%20move%20plot%20scales%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Matplotlib%0A%0A%20%20%20%20Because%20of%20its%20complexity%20and%20the%20fact%20that%20all%20important%20functions%20can%20be%20used%20with%20*pandas*%20in%20a%20much%20more%20manageable%20way%2C%20we%20will%20discuss%20*matplotlib*%20only%20briefly%20here.%20Yet%20it%20is%20important%20to%20know%20how%20*matplotlib*%20works%20to%20better%20understand%20the%20baseline%20of%20plotting%20with%20*Python*%20and%20to%20use%20more%20complex%20graphics%20or%20more%20plotting%20options%20when%20needed.%0A%0A%20%20%20%20In%202003%2C%20the%20development%20of%20*matplotlib*%20was%20initiated%20in%20the%20field%20of%20neurobiology%20by%20%5B*John%20D.%20Hunter%20(%26dagger%3B)*%5D(https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FJohn_D._Hunter)%20to%20emulate%20*The%20MathWorks*'%20*MATLAB%26reg%3B*%20software.%20This%20early%20development%20constituted%20the%20%60pylab%60%20package%2C%20which%20is%20deprecated%20today%20for%20its%20bad%20practice%20of%20overwriting%20Python%20(in%20particular%20NumPy)%20%60plot()%60%20and%20%60array()%60%20methods%2Fobjects.%20Today%2C%20it%20is%20recommended%20to%20use%3A%3Cbr%3E%0A%20%20%20%20%60import%20matplotlib.pyplot%20as%20plt%60.%0A%0A%20%20%20%20%23%23%23%20Some%20Terms%20and%20Definitions%0A%20%20%20%20A%20%60plt.figure%60%20can%20be%20thought%20of%20as%20a%20box%20containing%20one%20or%20more%20axes%2C%20which%20represent%20the%20actual%20plots.%20Within%20the%20axes%2C%20there%20are%20smaller%20objects%20in%20the%20hierarchy%20such%20as%20markers%2C%20lines%2C%20legends%2C%20and%20text%20fields.%20Almost%20every%20element%20of%20a%20plot%20is%20a%20manipulable%20attribute%20and%20the%20most%20important%20attributes%20are%20shown%20in%20the%20following%20figure.%20More%20attributes%20can%20be%20found%20in%20the%20showcases%20of%20%5Bmatplotlib.org%5D(https%3A%2F%2Fmatplotlib.org%2Fexamples%2Fshowcase%2Fanatomy.html).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Step-by-step%20Recipe%20for%201d%2F2d%20(line)%20Plots%0A%0A%20%20%20%201.%20Import%20Matplotlib's%20plotting%20interface%20with%20%60import%20matplotlib.pyplot%20as%20plt%60.%0A%20%20%20%201.%20Create%20a%20figure%20with%20%60fig%20%3D%20plt.figure(figsize%3D(width%2C%20height)%2C%20dpi%3Ddpi)%60.%0A%20%20%20%201.%20Add%20an%20Axes%20with%20%60ax%20%3D%20fig.add_subplot(nrows%2C%20ncols%2C%20index%2C%20label%3Dlabel)%60%3B%20for%20example%2C%20%60ax%20%3D%20fig.add_subplot(1%2C%201%2C%201)%60.%0A%20%20%20%201.%20Obtain%20a%20colormap%20with%20%60cmap%20%3D%20matplotlib.colormaps%5B%22plasma%22%5D%60%20and%20sample%20it%20with%20a%20normalized%20value%20such%20as%20%60cmap(0.5)%60.%0A%20%20%20%201.%20Draw%20lines%20with%20%60ax.plot(x%2C%20y%2C%20linestyle%3D%22-%22%2C%20marker%3D%22o%22%2C%20color%3Dcmap(0.5))%60%20or%20points%20with%20%60ax.scatter(x%2C%20y%2C%20marker%3D%22x%22%2C%20color%3Dcolors)%60.%0A%20%20%20%201.%20Manipulate%20axis%20ticks%0A%20%20%20%20%20%20%20%20*%20%60plt.xticks(list)%60%20define%20x-axis%20ticks%0A%20%20%20%20%20%20%20%20*%20%60plt.yticks(list)%60%20define%20y-axis%20ticks%0A%20%20%20%20%20%20%20%20*%20%60axes.set_xlim(tuple(min%2C%20max))%60%20sets%20the%20x-axis%20minimum%20and%20maximum%0A%20%20%20%20%20%20%20%20*%20%60axes.set_ylim(tuple(min%2C%20max))%60%20sets%20the%20y-axis%20minimum%20and%20maximum%0A%20%20%20%20%20%20%20%20*%20%60axes.set_xlabel(str)%60%20sets%20the%20x-axis%20label%0A%20%20%20%20%20%20%20%20*%20%60axes.set_ylabel(str)%60%20sets%20the%20y-axis%20label%0A%20%20%20%201.%20Add%20a%20legend%20(optionally)%20with%20%60axes.legend(loc%3Dstr%2C%20facecolor%3Dstr%2C%20edgecolor%3Dstr%2C%20framealpha%3Dfloat_between_0_and_1)%60%20and%20many%20more%20%60**kwargs%60%20can%20be%20defined%20(%5Bconfer%20to%20the%20*matplotlib*%20docs%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fapi%2Flegend_api.html%23matplotlib.legend.Legend)).%0A%20%20%20%201.%20Optional%3A%20Save%20the%20figure%20with%20%60plt.savefig(fname%3Dstr%2C%20dpi%3Dint)%60%20with%20many%20more%20%60**kwargs%60%20available%20(%5Bconfer%20to%20the%20*matplotlib*%20docs%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fapi%2F_as_gen%2Fmatplotlib.pyplot.savefig.html)).%0A%0A%20%20%20%20%3E%20**Tip%3A**%20Most%20of%20the%20below%20illustrated%20%60matplotlib%60%20features%20are%20embedded%20in%20a%20plotter%20script%2C%20which%20is%20available%20at%20a%20%5Bsupplemental%20repository%20of%20the%20hydro-informatics.com%20eBook%5D(https%3A%2F%2Fraw.githubusercontent.com%2Fhydro-informatics%2Fmaterial-py-codes%2Fmain%2Fplotting%2Fplotter.py).%0A%0A%20%20%20%20The%20following%20code%20block%20illustrates%20a%20plot%20recipe%20using%20%5Brandomly%20drawn%20samples%20from%20a%20*Weibull*%20distribution%5D(https%3A%2F%2Fnumpy.org%2Fdoc%2Fstable%2Freference%2Frandom%2Fgenerated%2Fnumpy.random.RandomState.weibull.html%23numpy.random.RandomState.weibull)%20with%20the%20distribution%20shape%20factor%20*a*%20(for%20%60a%3D1%60%2C%20the%20*Weibull*%20distribution%20reduces%20to%20an%20exponential%20distribution).%20The%20%60seed%60%20argument%20describes%20the%20source%20of%20randomness%20and%20%60seed%3DNone%60%20makes%20Python%20use%20randomness%20from%20operating%20system%20variables.%0A%0A%20%20%20%20The%20code%20block%20defines%20a%20function%20called%20%60plot_xy%60%20that%20requires%20%60x%60%20and%20%60y%60%20arguments%20and%20accepts%20the%20following%20optional%20keyword%20arguments%3A%0A%20%20%20%20*%20%60plot_type%3Dstr%60%20defines%20if%20a%20line%20or%20scatter%20plot%20should%20be%20produced%2C%0A%20%20%20%20*%20%60label%3Dstr%60%20sets%20the%20legend%2C%0A%20%20%20%20*%20%60save%3Dstr%60%20defines%20a%20path%20where%20the%20figure%20should%20be%20saved%20(the%20figure%20is%20not%20saved%20if%20nothing%20is%20provided).%20To%20activate%20saving%20a%20figure%2C%20use%20the%20optional%20keyword%20argument%20%60save%60%2C%20for%20example%2C%20%60save%3D'C%3A%2Ftemp%2Fweibull.png'%60%20saves%20the%20figure%20to%20a%20local%20%60temp%60%20folder%20on%20a%20Windows%20%60C%3A%60%20drive.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20matplotlib.pyplot%20as%20plt%0A%20%20%20%20import%20matplotlib.cm%20as%20cm%0A%20%20%20%20import%20numpy%20as%20np%0A%20%20%20%20_x%20%3D%20np.arange(1%2C%20100)%0A%20%20%20%20_y%20%3D%20np.random.RandomState(seed%3DNone).weibull(3.0%2C%20len(_x))%0A%0A%20%20%20%20def%20plot_xy(x%2C%20y%2C%20plot_type%3D'line'%2C%20label%3D'Random%20Weibull'%2C%20save%3DNone)%3A%0A%20%20%20%20%20%20%20%20fig%2C%20ax%20%3D%20plt.subplots(figsize%3D(6.18%2C%203.82)%2C%20dpi%3D100)%0A%20%20%20%20%20%20%20%20colors%20%3D%20cm.plasma(np.linspace(0%2C%201%2C%20len(y)))%0A%20%20%20%20%20%20%20%20if%20plot_type%20%3D%3D%20'line'%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20artist%20%3D%20ax.plot(x%2C%20y%2C%20linestyle%3D'-'%2C%20marker%3D'o'%2C%20color%3Dcolors%5B0%5D%2C%20label%3Dlabel)%0A%20%20%20%20%20%20%20%20elif%20plot_type%20%3D%3D%20'scatter'%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20artist%20%3D%20ax.scatter(x%2C%20y%2C%20marker%3D'x'%2C%20color%3Dcolors%2C%20label%3Dlabel)%0A%20%20%20%20%20%20%20%20else%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20raise%20ValueError(%22plot_type%20must%20be%20'line'%20or%20'scatter'%22)%0A%20%20%20%20%20%20%20%20ax.set_xlim(0%2C%20100)%0A%20%20%20%20%20%20%20%20ax.set_ylim(0%2C%202)%0A%20%20%20%20%20%20%20%20ax.set_xlabel('Linear%20x%20data')%0A%20%20%20%20%20%20%20%20ax.set_ylabel(f'Scale%20of%20%7Blabel%7D')%0A%20%20%20%20%20%20%20%20ax.legend(loc%3D'upper%20right')%0A%20%20%20%20%20%20%20%20if%20save%20is%20not%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20fig.savefig(save)%0A%20%20%20%20%20%20%20%20plt.show()%0A%20%20%20%20%20%20%20%20return%20(fig%2C%20ax%2C%20artist)%0A%20%20%20%20print('Plot%20lines')%0A%20%20%20%20plot_xy(_x%2C%20_y)%0A%20%20%20%20print('Scatter%20plot')%0A%20%20%20%20plot_xy(_x%2C%20_y%2C%20plot_type%3D'scatter'%2C%20label%3D'Rand.%20Weibull%20scattered')%0A%20%20%20%20return%20np%2C%20plt%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20**Challenge%3A**%20The%20%60plot_xy%60%20function%20has%20some%20weaknesses.%20For%20instance%2C%20if%20more%20arguments%20are%20provided%2C%20or%20%60y%60%20data%20is%20a%20multidimensional%20array%20(not%20*nx1*%20or%20*1xm*)%20that%20should%20produce%20multiple%20plot%20lines%2C%20the%20function%20will%20not%20work.%20So%2C%20how%20can%20you%20optimize%20the%20%60plot_xy%60%20function%2C%20to%20make%20it%20more%20robust%20and%20enable%20multi-line%20plotting%3F%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Surface%20and%20Contour%20Plots%0A%0A%20%20%20%20*matplotlib*%20provides%20multiple%20options%20to%20plot%20X-Y-Z%20(2d%2F3d)%20data%20such%20as%3A%0A%0A%20%20%20%20*%20Surface%20plots%20with%20color%20shades%3A%20%5B%60axes.plot_surface(X%2C%20Y%2C%20Z)%60%5D(https%3A%2F%2Fmatplotlib.org%2Fmpl_toolkits%2Fmplot3d%2Ftutorial.html%23surface-plots)%0A%20%20%20%20*%20Contour%20plots%3A%20%5B%60axes.contour(X%2C%20Y%2C%20Z)%60%5D(https%3A%2F%2Fmatplotlib.org%2Fmpl_toolkits%2Fmplot3d%2Ftutorial.html%23contour-plots)%0A%20%20%20%20*%20Contour%20plots%20with%20filled%20surfaces%3A%20%5B%60axes.contourf(X%2C%20Y%2C%20Z)%60%5D(https%3A%2F%2Fmatplotlib.org%2Fmpl_toolkits%2Fmplot3d%2Ftutorial.html%23filled-contour-plots)%0A%20%20%20%20*%20Surface%20plots%20with%20triangulated%20mesh%3A%20%5B%60axes.plot_trisurf(X%2C%20Y%2C%20Z)%60%5D(https%3A%2F%2Fmatplotlib.org%2Fmpl_toolkits%2Fmplot3d%2Ftutorial.html%23tri-surface-plots)%0A%20%20%20%20*%20Three-dimensional%20scatter%20plots%3A%20%5B%60axes.scatter3D(X%2C%20Y%2C%20Z)%60%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fgallery%2Fmplot3d%2Fscatter3d.html)%0A%20%20%20%20*%20Streamplots%20(e.g.%2C%20of%20velocity%20vectors)%3A%20%5B%60axes.streamplot(X%2C%20Y%2C%20U%2C%20V)%60%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fapi%2F_as_gen%2Fmatplotlib.pyplot.streamplot.html)%0A%20%20%20%20*%20Color-coded%20representation%20of%20gridded%20values%20with%20(annotated)%20heatmaps%20(e.g.%2C%20for%20habitat%20suitability%20index%20maps)%3A%20%5B%60axes.imshow(data%2C%20**kwargs)%60%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fgallery%2Fimages_contours_and_fields%2Fimage_annotated_heatmap.html)%0A%0A%20%20%20%20This%20section%20features%20the%20usage%20of%20streamplots%2C%20which%20are%20a%20useful%20tool%20for%20the%20visualization%20of%20velocity%20vectors%20(flow%20fields)%20in%20rivers%20(e.g.%2C%20produced%20with%20a%20numerical%20model).%20To%20generate%20a%20streamplot%3A%0A%0A%20%20%20%201.%20Create%20an%20%60X%60%20-%20%60Y%60%20grid%2C%20for%20example%20with%20the%20%5BNumPy's%20%60mgrid%60%20method%5D(https%3A%2F%2Fnumpy.org%2Fdoc%2Fstable%2Freference%2Fgenerated%2Fnumpy.mgrid.html)%3A%20%60Y%2C%20X%20%3D%20np.mgrid%5Brange%2C%20range%5D%60%0A%20%20%20%201.%20Assign%20stream%20field%20data%20(can%20be%20artificially%20generated%2C%20for%20example%2C%20in%20the%20form%20of%20%60U%60%20and%20%60V%60%20variables%20in%20the%20below%20code%20block)%20to%20the%20grid%20nodes.%20Note%20that%20every%20grid%20node%20can%20only%20get%20assigned%20one%20scalar%20value%2C%20which%20is%20%60velocity%60%20(as%20a%20function%20of%20the%202-directional%20field%20data)%20in%20the%20below%20code%20block.%0A%20%20%20%201.%20Generate%20figures%2C%20as%20before%20in%20the%20%60plot_xy%60%20function%20example%20(see%20the%20above%201d%2F2d%20plot%20instructions).%0A%0A%20%20%20%20The%20below%20code%20block%20illustrates%20the%20generation%20of%20a%20streamplot%20(adapted%20from%20the%20%5Bmatplotlib%20docs%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fgallery%2Fimages_contours_and_fields%2Fplot_streamplot.html%23sphx-glr-gallery-images-contours-and-fields-plot-streamplot-py))%20and%20uses%20%60import%20matplotlib.gridspec%60%20to%20place%20the%20subplots%20in%20the%20figure.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(np%2C%20plt)%3A%0A%20%20%20%20import%20matplotlib.gridspec%20as%20gridspec%0A%20%20%20%20w%20%3D%20100%0A%20%20%20%20_Y%2C%20_X%20%3D%20np.mgrid%5B-w%3Aw%3A10j%2C%20-w%3Aw%3A10j%5D%0A%20%20%20%20U%20%3D%20-2%20-%20_X%20**%202%20%2B%20_Y%0A%20%20%20%20V%20%3D%200%20%2B%20_X%20-%20_Y%20**%202%0A%20%20%20%20_fig%20%3D%20plt.figure(figsize%3D(6.0%2C%202.5)%2C%20dpi%3D200)%0A%20%20%20%20fig_grid%20%3D%20gridspec.GridSpec(nrows%3D1%2C%20ncols%3D2)%0A%20%20%20%20velocity%20%3D%20np.sqrt(U%20**%202%20%2B%20V%20**%202)%0A%20%20%20%20axes1%20%3D%20_fig.add_subplot(fig_grid%5B0%2C%200%5D)%0A%20%20%20%20axes1.streamplot(_X%2C%20_Y%2C%20U%2C%20V%2C%20density%3D0.6%2C%20color%3D'b'%2C%20linewidth%3D3%20*%20velocity%20%2F%20velocity.max())%0A%20%20%20%20axes1.set_title('Line%20width%20variation'%2C%20fontfamily%3D'Tahoma'%2C%20fontsize%3D8%2C%20fontweight%3D'bold')%0A%20%20%20%20axes2%20%3D%20_fig.add_subplot(fig_grid%5B0%2C%201%5D)%0A%20%20%20%20uv_stream%20%3D%20axes2.streamplot(_X%2C%20_Y%2C%20U%2C%20V%2C%20color%3Dvelocity%2C%20linewidth%3D2%2C%20cmap%3D'Blues')%0A%20%20%20%20_fig.colorbar(uv_stream.lines)%0A%20%20%20%20axes2.set_title('Color%20maps'%2C%20fontfamily%3D'Tahoma'%2C%20fontsize%3D8%2C%20fontweight%3D'bold')%0A%20%20%20%20plt.tight_layout()%0A%20%20%20%20plt.show()%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Fonts%20and%20Styles%0A%0A%20%20%20%20The%20previous%20example%20featured%20a%20font%20type%20adjustment%20for%20the%20plot%20titles%20(%60axes.set_title('title'%2C%20font%20...)%60).%20The%20font%20and%20its%20characteristics%20(e.g.%2C%20size%2C%20weight%2C%20style%2C%20or%20family)%20can%20be%20defined%20more%20coherently%20with%20%60matplotlib.rc%60%20(%5Bsee%20matplotlib%20docs%5D(https%3A%2F%2Fmatplotlib.org%2Fstable%2Fapi%2Ffont_manager_api.html))%2C%20where%20plot%20font%20settings%20can%20be%20globally%20modified%20within%20a%20script.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(np%2C%20plt)%3A%0A%20%20%20%20from%20matplotlib%20import%20rc%0A%20%20%20%20rc('font'%2C%20family%3D'Times%20New%20Roman'%2C%20style%3D'italic'%2C%20weight%3D'semibold'%2C%20size%3D10)%0A%20%20%20%20x_lin%20%3D%20np.linspace(0.0%2C%2010.0%2C%201000)%0A%20%20%20%20y_osc%20%3D%20np.cos(5%20*%20np.pi%20*%20x_lin)%20*%20np.exp(-x_lin)%0A%20%20%20%20_fig%2C%20_axes%20%3D%20plt.subplots(figsize%3D(6.18%2C%201.8)%2C%20dpi%3D150)%0A%20%20%20%20_axes.plot(x_lin%2C%20y_osc%2C%20label%3D'Oscillations')%0A%20%20%20%20_axes.legend()%0A%20%20%20%20_axes.set_xlabel('Time%20(s)')%0A%20%20%20%20_axes.set_ylabel('Oscillation%20(V)')%0A%20%20%20%20plt.tight_layout()%0A%20%20%20%20plt.show()%0A%20%20%20%20return%20x_lin%2C%20y_osc%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Instead%20of%20using%20%60rc%60%2C%20font%20characteristics%20can%20also%20be%20updated%20with%20matplotlib's%20%60rcParams%60%20*dictionary*.%20In%20general%2C%20all%20font%20parameters%20can%20be%20accessed%20with%20%60rcParams%60%20along%20with%20many%20more%20parameters%20of%20plot%20layout%20options.%20The%20parametric%20options%20are%20stored%20in%20the%20%5B%60matplotlibrc%60%5D(https%3A%2F%2Fmatplotlib.org%2Ftutorials%2Fintroductory%2Fcustomizing.html%23customizing-with-matplotlibrc-files)%20file%20and%20can%20be%20accessed%20with%20%60rcParams%5B%22matplotlibrc-parameter%22%5D%60.%20Read%20more%20about%20modification%20options%20(%60%22matplotlibrc-parameter%22%60)%20in%20the%20%5B*matplotlib*%20docs%5D(https%3A%2F%2Fmatplotlib.org%2Ftutorials%2Fintroductory%2Fcustomizing.html%23customizing-with-matplotlibrc-files).%20In%20order%20to%20modify%20a%20(font)%20style%20parameter%20use%20%60rcParams.update(%7Bparameter-name%3A%20parameter-value%7D)%60%20(which%20does%20not%20always%20work%2C%20for%20example%2C%20in%20%5Bjupyter%5D(https%3A%2F%2Fgithub.com%2Fjupyter%2Fnotebook%2Fissues%2F3385)).%0A%0A%20%20%20%20In%20addition%2C%20many%20default%20plot%20styles%20are%20available%20through%20%5B%60matplotlib.style%60%5D(https%3A%2F%2Fmatplotlib.org%2Fapi%2Fstyle_api.html%23matplotlib-style)%20with%20many%20%5Bstyle%20templates%5D(https%3A%2F%2Fmatplotlib.org%2Fgallery%2Fstyle_sheets%2Fstyle_sheets_reference.html).%20The%20following%20example%20illustrates%20the%20application%20of%20%60rcParams%60%20and%20%60style%60%20variables%20to%20the%20previously%20generated%20x-y%20oscillation%20dataset.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(plt%2C%20x_lin%2C%20y_osc)%3A%0A%20%20%20%20from%20matplotlib%20import%20rcParams%0A%20%20%20%20from%20matplotlib%20import%20rcParamsDefault%0A%20%20%20%20from%20matplotlib%20import%20style%0A%20%20%20%20rcParams.update(rcParamsDefault)%20%20%23%20reset%20parameters%20in%20case%20you%20run%20this%20block%20multiple%20times%0A%20%20%20%20print('Some%20available%20serif%20fonts%3A%20'%20%2B%20'%2C%20'.join(rcParams%5B'font.serif'%5D%5B0%3A5%5D))%0A%20%20%20%20print('Some%20available%20sans-serif%20fonts%3A%20'%20%2B%20'%2C%20'.join(rcParams%5B'font.sans-serif'%5D%5B0%3A5%5D))%0A%20%20%20%20print('Some%20available%20monospace%20fonts%3A%20'%20%2B%20'%2C%20'.join(rcParams%5B'font.monospace'%5D%5B0%3A5%5D))%0A%20%20%20%20print('Some%20available%20fantasy%20fonts%3A%20'%20%2B%20'%2C%20'.join(rcParams%5B'font.fantasy'%5D%5B0%3A5%5D))%0A%20%20%20%20rcParams.update(%7B'font.fantasy'%3A%20'Impact'%7D)%0A%20%20%20%20%23%20change%20rcParams%0A%20%20%20%20print('Some%20available%20styles%3A%20'%20%2B%20'%2C%20'.join(style.available%5B0%3A5%5D))%20%20%23%20has%20no%20effect%20here!%0A%20%20%20%20style.use('seaborn-v0_8-darkgrid')%0A%20%20%20%20_fig%2C%20_axes%20%3D%20plt.subplots(figsize%3D(6.18%2C%201.8)%2C%20dpi%3D150)%0A%20%20%20%20_axes.plot(x_lin%2C%20y_osc%2C%20label%3D'Oscillations')%0A%20%20%20%20_axes.legend()%0A%20%20%20%20%23%20plot%0A%20%20%20%20_axes.set_xlabel('Time%20(s)')%0A%20%20%20%20_axes.set_ylabel('Oscillation%20(V)')%0A%20%20%20%20plt.tight_layout()%0A%20%20%20%20plt.show()%0A%20%20%20%20return%20rcParams%2C%20rcParamsDefault%2C%20style%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Colors%0A%0A%20%20%20%20The%20use%20of%20color%20maps%20is%20a%20sensitive%20topic%3A%20often%20default-set%20rainbow%20palettes%20map%20distinct%20hues%20that%20many%20viewers%20with%20color-vision%20deficiencies%20(approx.%201%20in%2012%20men)%20cannot%20reliably%20differentiate.%20Consider%20the%20following%20aspects%20to%20accommodate%20perceptually%20uniform%2C%20colorblind-friendly%20colormaps%3A%0A%0A%20%20%20%20*%20**Sequential%20(low%20%3E%20high)%3A**%20use%20Matplotlib's%20%60viridis%60%2C%20%60magma%60%2C%20%60plasma%60%2C%20%60inferno%60%3B%20or%20domain-aware%20sequences%20from%20cmocean%20(see%20also%20below)%20to%20use%2C%20for%20instance%2C%20%60cmo.thermal%60%20for%20temperature%2C%20%60cmo.haline%60%20for%20salinity).%0A%20%20%20%20*%20**Diverging%20(midpoint%20emphasis)%3A**%20use%20when%20values%20deviate%20around%20a%20meaningful%20center%20(0%2C%20climatology%2C%20etc.).%20Examples%3A%20Matplotlib's%20%60seismic%60-style%20but%20*perceptually%20tuned*%20options%20like%20%60coolwarm%60%20(still%20imperfect)%20or%20cmocean's%20%60balance%60%2C%20%60delta%60%2C%20%60curl%60%2C%20which%20are%20engineered%20for%20symmetry%20and%20lightness%20control.%0A%20%20%20%20*%20**Cyclic%20(wrap-around%20variables)%3A**%20for%20phase%2Faspect%20(0%C2%B0%E2%89%A1360%C2%B0).%20Use%20cyclic%20maps%20such%20as%20cmocean's%20%60phase%60.%0A%20%20%20%20*%20**Categorical%20(discrete%20classes)%3A**%20use%20distinct%2C%20desaturated%20palettes%20with%20good%20lightness%20separation%3B%20avoid%20%22rainbow%22%20categories%20for%20quantitative%20data.%0A%20%20%20%20*%20**Dynamic%20range%3A**%20ensure%20the%20lightness%20ramp%20spans%20the%20range%20where%20your%20audience%20needs%20discrimination%20(you%20can%20trim%2Fclip%20the%20colormap%20range%20if%20needed).%0A%20%20%20%20*%20**Background%3A**%20pick%20a%20map%20whose%20lightness%20contrasts%20with%20the%20figure%20background%20(dark%20maps%20on%20dark%20backgrounds%20obscure%20low%20values).%0A%0A%20%20%20%20To%20ease%20working%20with%20such%20colormaps%2C%20consider%20installing%20%60cmocean%60%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20%23%20run%20in%20a%20terminal%20(not%20in%20the%20notebook)%3A%20pip%20install%20cmocean%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Below%20is%20an%20example%20of%20code%20for%20using%20perceptually%20uniform%2C%20colorblind-friendly%20colormaps.%20You%20can%20find%20this%20example%20also%20on%20%5Bhttps%3A%2F%2Fhydro-informatics.com%2Fscilife%2Fcolor-hacks.html%5D(https%3A%2F%2Fhydro-informatics.com%2Fscilife%2Fcolor-hacks.html).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(np%2C%20plt)%3A%0A%20%20%20%20import%20cmocean%0A%20%20%20%20plt.rcParams%5B'image.cmap'%5D%20%3D%20'viridis'%0A%20%20%20%20_x%20%3D%20np.linspace(-3%2C%203%2C%20400)%0A%20%20%20%20_y%20%3D%20np.linspace(-3%2C%203%2C%20400)%0A%20%20%20%20_X%2C%20_Y%20%3D%20np.meshgrid(_x%2C%20_y)%0A%20%20%20%20Z%20%3D%20np.hypot(_X%2C%20_Y)%0A%20%20%20%20plt.imshow(Z%2C%20origin%3D'lower'%2C%20cmap%3Dcmocean.cm.thermal)%0A%20%20%20%20plt.colorbar(label%3D'Temperature-like%20quantity')%0A%20%20%20%20plt.title('Sequential%2C%20perceptually-uniform')%0A%20%20%20%20plt.show()%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Annotations%0A%0A%20%20%20%20Pointing%20out%20particularities%20in%20graphs%20is%20sometimes%20helpful%20to%20explain%20or%20name%20observations%20on%20graphs.%20The%20following%20code%20block%20shows%20some%20options%20with%20self-explaining%20*strings*.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(plt%2C%20rcParams%2C%20rcParamsDefault%2C%20style)%3A%0A%20%20%20%20rcParams.update(rcParamsDefault)%0A%20%20%20%20_fig%2C%20_axes%20%3D%20plt.subplots(figsize%3D(10%2C%202.5)%2C%20dpi%3D150)%0A%20%20%20%20style.use('fivethirtyeight')%0A%20%20%20%20_fig.suptitle('This%20is%20the%20figure%20(super)%20title'%2C%20fontsize%3D8%2C%20fontweight%3D'bold')%0A%20%20%20%20_axes.set_title('This%20is%20the%20axes%20(sub)%20title'%2C%20fontsize%3D8)%0A%20%20%20%20_axes.text(1%2C%200.8%2C%20'B-boxed%20italic%20text%20with%20axis%20coords%201%2C%200.8'%2C%20style%3D'italic'%2C%20fontsize%3D8%2C%20bbox%3D%7B'facecolor'%3A%20'green'%2C%20'alpha'%3A%200.5%2C%20'pad'%3A%205%7D)%0A%20%20%20%20_axes.text(5%2C%200.6%2C%20'Annotation%20text%20with%20equation%3A%20%24u%3DU%5E2%20%2B%20V%5E2%24'%2C%20fontsize%3D8)%0A%20%20%20%20_axes.text(7%2C%200.2%2C%20'Color%20text%20with%20axis%20coords%20(7%2C%200.2)'%2C%20verticalalignment%3D'bottom'%2C%20horizontalalignment%3D'left'%2C%20color%3D'red'%2C%20fontsize%3D8)%0A%20%20%20%20_axes.plot(%5B0.5%5D%2C%20%5B0.2%5D%2C%20'x'%2C%20markersize%3D7%2C%20color%3D'blue')%0A%20%20%20%20_axes.annotate('Annotated%20point'%2C%20xy%3D(0.5%2C%200.2)%2C%20xytext%3D(2%2C%200.4)%2C%20fontsize%3D8%2C%20arrowprops%3Ddict(facecolor%3D'blue'%2C%20shrink%3D0.05))%0A%20%20%20%20_axes.axis(%5B0%2C%2010%2C%200%2C%201%5D)%0A%20%20%20%20plt.show()%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20**Challenge%3A**%20The%20above%20code%20blocks%20involve%20many%20repetitive%20statements%20such%20as%20%60import%20...%60%20-%20%60rcParams.update(rcParamsDefault)%60%2C%20and%20%60plot.show()%60%20at%20the%20end.%20Can%20you%20write%20a%20%5Bwrapper%20function%5D(https%3A%2F%2Fhydro-informatics.com%2Fjupyter%2Fpyfun.html%23wrappers)%20to%20decorate%20a%20*matplotlib*%20plot%20function%3F%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20**Exercise%3A**%20Familiarize%20with%20built-in%20plot%20functions%20using%20*matplotlib*%20with%20the%20template%20scripts%20provided%20with%20the%20%5Breservoir%20design%5D(https%3A%2F%2Fhydro-informatics.com%2Fexercises%2Fex-sp)%20and%20%5Bflood%20return%20period%20calculation%5D(https%3A%2F%2Fhydro-informatics.com%2Fexercises%2Fex-floods)%20exercises.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Plotting%20with%20*pandas*%0A%0A%20%20%20%20Plotting%20with%20*matplotlib*%20can%20be%20daunting%2C%20not%20because%20the%20library%20is%20poorly%20documented%20(the%20complete%20opposite%20is%20the%20case)%2C%20but%20because%20*matplotlib*%20is%20very%20extensive.%20*pandas*%20brings%20remedy%20with%20simplified%20commands%20for%20high-quality%20plots.%20The%20simplest%20way%20to%20plot%20a%20*pandas*%20data%20frame%20is%20%5B%60pd.DataFrame.plot(x%3D%22col1%22%2C%20y%3D%22col2%22)%60%5D(https%3A%2F%2Fpandas.pydata.org%2Fpandas-docs%2Fstable%2Freference%2Fapi%2Fpandas.DataFrame.plot.html).%20The%20following%20example%20illustrates%20this%20fundamentally%20simple%20usage%20with%20a%20river%20discharge%20series%20stored%20in%20a%20workbook%20(%5Bdownload%20example_flow_gauge.xlsx%5D(https%3A%2F%2Fraw.githubusercontent.com%2Fhydro-informatics%2Fjupyter-python-course%2Fmain%2Fdata%2Fexample_flow_gauge.xlsx)).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20pandas%20as%20pd%0A%20%20%20%20flow_df%20%3D%20pd.read_excel('data%2Fexample_flow_gauge.xlsx'%2C%20sheet_name%3D'Mean%20Monthly%20CMS')%0A%20%20%20%20print(flow_df.head(3))%0A%20%20%20%20flow_df.plot(x%3D%22Date%20(mmm-jj)%22%2C%20y%3D%22Flow%20(CMS)%22%2C%20kind%3D'line')%0A%20%20%20%20return%20(pd%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20*pandas*%20and%20*matplotlib*%0A%0A%20%20%20%20Because%20*pandas*%20plot%20functionality%20roots%20in%20the%20*matplotlib*%20library%2C%20those%20can%20be%20easily%20combined%2C%20for%20example%2C%20to%20create%20subplots%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(pd%2C%20plt)%3A%0A%20%20%20%20flow_ex_df%20%3D%20pd.read_excel('data%2Fexample_flow_gauge.xlsx'%2C%20sheet_name%3D'FlowDuration')%0A%20%20%20%20_fig%2C%20_axes%20%3D%20plt.subplots(nrows%3D1%2C%20ncols%3D2%2C%20figsize%3D(10%2C%202.5)%2C%20dpi%3D150)%0A%20%20%20%20flow_ex_df.plot(x%3D'Relative%20exceedance'%2C%20y%3D'Flow%20(CMS)'%2C%20kind%3D'area'%2C%20color%3D'DarkBlue'%2C%20grid%3DTrue%2C%20title%3D'Blue%20area%20plot'%2C%20ax%3D_axes%5B0%5D)%0A%20%20%20%20flow_ex_df.plot(x%3D'Relative%20exceedance'%2C%20y%3D'Flow%20(CMS)'%2C%20kind%3D'scatter'%2C%20color%3D'DarkGreen'%2C%20title%3D'Green%20scatter'%2C%20marker%3D'x'%2C%20ax%3D_axes%5B1%5D)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Boxplots%20and%20Error%20Bars%0A%0A%20%20%20%20A%20%5Bbox-plot%5D(https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FBox_plot)%20graphically%20represents%20the%20distribution%20of%20(statistical)%20scatter%20and%20parameters%20of%20a%20data%20series.%0A%0A%20%20%20%20Why%20use%20a%20box-plot%20with%20a%20*pandas*%20data%20frame%3F%20The%20reason%20is%20that%20with%20*pandas*%20data%20frames%2C%20we%20typically%20load%20data%20series%20with%20per-column%20statistical%20properties.%20For%20instance%2C%20if%20we%20run%20a%20steady-flow%20experiment%20in%20a%20hydraulic%20lab%20flume%20with%20ultrasonic%20probes%20for%20deriving%20water%20depths%2C%20we%20will%20observe%20signal%20fluctuation%2C%20even%20though%20the%20flow%20was%20steady.%20By%20loading%20the%20signal%20data%20into%20a%20*pandas*%20data%20frame%2C%20we%20can%20use%20a%20box%20plot%20to%20observe%20the%20average%20water%20depth%20and%20the%20noise%20in%20the%20measurement%20among%20different%20probes.%20Thus%2C%20probes%20with%20unexpected%20noise%20can%20be%20identified%20and%20repaired.%20This%20small%20example%20can%20be%20applied%20on%20a%20broader%20scale%20to%20many%20other%20sensors%20and%20for%20many%20other%20purposes%20(noise%20does%20not%20always%20mean%20that%20a%20sensor%20is%20broken).%20A%20box-plot%20has%20the%20following%20attributes%3A%0A%0A%20%20%20%20*%20*boxes*%20represent%20the%20interquartile%20range%20(IQR)%2C%20extending%20from%20the%20first%20quartile%20(Q1)%20to%20the%20third%20quartile%20(Q3).%20If%20notches%20are%20enabled%2C%20they%20indicate%20a%20confidence%20interval%20around%20the%20median.%0A%20%20%20%20*%20*medians*%20are%20horizontal%20lines%20marking%20the%20median%20within%20each%20box.%0A%20%20%20%20*%20*whiskers*%20are%20vertical%20lines%20extending%20from%20the%20box%20to%20data%20points%20determined%20by%20the%20specified%20%60whis%60%20rule.%0A%20%20%20%20*%20*caps*%20are%20small%20horizontal%20lines%20marking%20the%20ends%20of%20the%20whiskers.%0A%20%20%20%20*%20*fliers*%20are%20data%20points%20that%20fall%20beyond%20the%20whiskers%20and%20are%20therefore%20plotted%20individually.%0A%20%20%20%20*%20*means*%20are%20optional%20markers%20or%20lines%20indicating%20the%20dataset%20means.%0A%0A%20%20%20%20*pandas*%20data%20frames%20make%20use%20of%20%5B%60matplotlib.pyplot.boxplot%60%5D(https%3A%2F%2Fmatplotlib.org%2Fapi%2F_as_gen%2Fmatplotlib.pyplot.boxplot.html%23matplotlib.pyplot.boxplot)%20to%20generate%20box-plots%20with%20%5B%60df.boxplot()%60%5D(https%3A%2F%2Fpandas.pydata.org%2Fpandas-docs%2Fstable%2Freference%2Fapi%2Fpandas.DataFrame.boxplot.html)%20or%20%60df.plot.box()%60.%20The%20following%20example%20features%20box-plots%20of%20water%20depth%20measurements%20with%20ultrasonic%20probes%20(sensors%201%2C%202%2C%203%2C%20and%205)%20stored%20in%20%60FlowDepth009.csv%60%20(%5Bdownload%5D(https%3A%2F%2Fraw.githubusercontent.com%2Fhydro-informatics%2Fjupyter-python-course%2Fmain%2Fdata%2FFlowDepth009.csv)).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(pd%2C%20plt)%3A%0A%20%20%20%20us_sensor_df%20%3D%20pd.read_csv('data%2FFlowDepth009.csv'%2C%20index_col%3D0%2C%20usecols%3D%5B0%2C%201%2C%202%2C%203%2C%205%5D)%0A%20%20%20%20print(us_sensor_df.head(2))%0A%20%20%20%20_fig%2C%20_axes%20%3D%20plt.subplots(nrows%3D1%2C%20ncols%3D2%2C%20figsize%3D(10%2C%202.5)%2C%20dpi%3D150)%0A%20%20%20%20fontsize%20%3D%208.0%0A%20%20%20%20labels%20%3D%20%5B'S1'%2C%20'S2'%2C%20'S3'%2C%20'S5'%5D%0A%20%20%20%20diamond_fliers%20%3D%20dict(markerfacecolor%3D'thistle'%2C%20marker%3D'D'%2C%20markersize%3D2%2C%20linestyle%3DNone)%0A%20%20%20%20%23%20make%20plot%20props%20dicts%0A%20%20%20%20square_fliers%20%3D%20dict(markerfacecolor%3D'aquamarine'%2C%20marker%3D'%2B'%2C%20markersize%3D3)%0A%20%20%20%20capprops%20%3D%20dict(color%3D'deepskyblue'%2C%20linestyle%3D'-')%0A%20%20%20%20medianprops%20%3D%20%7B'color'%3A%20'purple'%2C%20'linewidth'%3A%202%7D%0A%20%20%20%20boxprops%20%3D%20%7B'color'%3A%20'palevioletred'%2C%20'linestyle'%3A%20'-'%7D%0A%20%20%20%20whiskerprops%20%3D%20%7B'color'%3A%20'darkcyan'%2C%20'linestyle'%3A%20'%3A'%7D%0A%20%20%20%20us_sensor_df%20%3D%20us_sensor_df.rename(columns%3Ddict(zip(list(us_sensor_df.columns)%2C%20labels)))%0A%20%20%20%20us_sensor_df.boxplot(fontsize%3Dfontsize%2C%20ax%3D_axes%5B0%5D%2C%20tick_labels%3Dlabels%2C%20widths%3D0.25%2C%20flierprops%3Ddiamond_fliers%2C%20capprops%3Dcapprops%2C%20medianprops%3Dmedianprops%2C%20boxprops%3Dboxprops%2C%20whiskerprops%3Dwhiskerprops)%0A%20%20%20%20us_sensor_df.plot.box(color%3D'tomato'%2C%20vert%3DFalse%2C%20title%3D'Hz.%20box-plot'%2C%20flierprops%3Dsquare_fliers%2C%20whis%3D0.75%2C%20fontsize%3Dfontsize%2C%20meanline%3DTrue%2C%20showmeans%3DTrue%2C%20ax%3D_axes%5B1%5D%2C%20tick_labels%3Dlabels)%20%20%23%20rename%20for%20plot%20conciseness%0A%20%20%20%20return%20fontsize%2C%20us_sensor_df%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Box-plots%20represent%20the%20statistical%20assets%20of%20datasets%2C%20but%20box-plots%20can%20quickly%20become%20confusing%20(messy)%20when%20they%20are%20presented%20in%20technical%20reports%20for%20multiple%20measurement%20series.%20Yet%2C%20it%20is%20state-of-the-art%20and%20good%20practice%20to%20present%20uncertainties%20in%20datasets%20in%20scientific%20and%20non-scientific%20publications%2C%20but%20somewhat%20more%20easily%20than%2C%20for%20example%2C%20with%20box-plots.%20To%20this%20end%2C%20so-called%20%5Berror%20bars%5D(https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FError_bar)%20can%20be%20added%20to%20data%20bars.%20%20Error%20bars%20display%20a%20chosen%20uncertainty%20or%20variability%20measure%20around%20plotted%20values%20and%20may%20include%20lines%2C%20caps%2C%20and%20central%20markers.%20Depending%20on%20the%20measurement%20process%2C%20uncertainty%20may%20occur%20in%20x%2C%20y%2C%20both%20directions%2C%20or%20neither.%20State%20explicitly%20whether%20an%20error%20bar%20represents%20standard%20deviation%2C%20standard%20error%2C%20a%20confidence%20interval%2C%20instrument%20precision%2C%20or%20another%20quantity.%20The%20following%20example%20shows%20the%20application%20of%20error%20bars%20to%20bar%20plots%20of%20the%20above%20ultrasonic%20sensor%20data.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(fontsize%2C%20plt%2C%20us_sensor_df)%3A%0A%20%20%20%20_fig%2C%20_axes%20%3D%20plt.subplots(nrows%3D1%2C%20ncols%3D2%2C%20figsize%3D(10%2C%202.5)%2C%20dpi%3D150)%0A%20%20%20%20%23%20calculate%20stats%0A%20%20%20%20means%20%3D%20us_sensor_df.mean()%0A%20%20%20%20errors%20%3D%20us_sensor_df.std()%0A%20%20%20%20%23%20make%20error%20bar%20bar%20plots%0A%20%20%20%20means.plot.bar(yerr%3Derrors%2C%20capsize%3D4%2C%20color%3D'palegreen'%2C%20title%3D'Error%20bars'%2C%20width%3D0.3%2C%20fontsize%3Dfontsize%2C%20ax%3D_axes%5B0%5D)%0A%20%20%20%20means.plot.barh(xerr%3Derrors%2C%20capsize%3D5%2C%20color%3D'lightsteelblue'%2C%20title%3D'Horizontal%20error%20bars'%2C%20fontsize%3Dfontsize%2C%20ax%3D_axes%5B1%5D)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20In%20scatter%20plots%2C%20errors%20are%20present%20in%20both%20*x*%20and%20*y*%20directions.%20For%20instance%2C%20the%20*x*-uncertainty%20may%20result%20from%20the%20measurement%20device%20precision%2C%20and%20*y*-uncertainty%20can%20be%20a%20result%20of%20signal%20processing.%20The%20above%20error%20measure%20in%20terms%20of%20the%20standard%20deviation%20is%20just%20an%20example%20of%20error%20amplitude.%20To%20measure%20and%20represent%20uncertainty%20correctly%2C%20always%20refer%20to%20device%20descriptions%20and%20assess%20precision%20effects%20of%20multiple%20devices%20or%20signal%20processing%20by%20calculating%20the%20%5Bpropagation%20of%20errors%5D(https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FPropagation_of_uncertainty).%0A%0A%20%20%20%20More%20options%20for%20visualizing%20a%20*pandas*%20data%20frame%20is%20provided%20in%20the%20%5Bdeveloper's%20visualization%20docs%5D(https%3A%2F%2Fpandas.pydata.org%2Fpandas-docs%2Fstable%2Fuser_guide%2Fvisualization.html).%20Keep%20in%20mind%20that%20*matplotlib*%20can%20always%20be%20applied%20on%20top%20of%20a%20*pandas*%20plot.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Interactive%20Plots%20with%20*plotly*%0A%0A%20%20%20%20The%20above%20shown%20*matplotlib*%20and%20*pandas*%20packages%20are%20great%20for%20creating%20static%20graphs%20in%20a%20desktop%2C%20report%2C%20or%20paper%20environment.%20Although%20interactive%20plots%20for%20web%20presentations%20can%20be%20created%20with%20*matplotlib*%20(%5Bread%20more%20in%20the%20*matplotlib*%20docs%5D(https%3A%2F%2Fmatplotlib.org%2F3.1.1%2Fusers%2Finteractive.html))%2C%20the%20*plotly*%20library%20leverages%20many%20more%20interactive%20web%20plotting%20options%20within%20an%20easy-to-use%20API.%20*plotly*%20can%20also%20handle%20JSON-like%20data%20(hosted%20somewhere%20on%20the%20internet)%20to%20create%20web%20applications%20with%20*Dash*.%20Just%20one%20issue%3A%20the%20company%20behind%20(*Plotly*)%20is%20business-oriented...%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Installation%0A%20%20%20%20Plotly%20is%20not%20a%20default%20package%20neither%20in%20the%20%60flusstools%60%20environment%20file%20(*environment.yml*)%2C%20nor%20in%20the%20*conda%20base*%20environment.%20Therefore%2C%20it%20must%20be%20installed%20manually%20with%20*conda%20prompt*%20(or%20*Conda%20Navigator*%20if%20you%20prefer%20the%20Desktop%20version).%20Plotly's%20Python%20graphing%20library%20is%20open-source%20and%20supports%20interactive%2C%20browser-based%20figures%20as%20well%20as%20static%20export.%20Install%20it%20in%20the%20active%20notebook%20environment%20with%3A%0A%0A%20%20%20%20%60%25pip%20install%20plotly%60%0A%0A%20%20%20%20Install%20%60anywidget%60%20as%20well%20when%20using%20Plotly%20%60FigureWidget%60%20features.%20Restart%20the%20kernel%20if%20the%20environment%20requires%20it.%20Plotly%20also%20offers%20separate%20commercial%20products%2C%20but%20they%20are%20not%20required%20to%20use%20the%20open-source%20graphing%20library.%0A%0A%20%20%20%20Read%20more%20about%20installing%20packages%20in%20a%20%5Bconda%20environment%5D(https%3A%2F%2Fhydro-informatics.com%2Fpyinstall%23install-pckg)%20or%20%5Bpip%20environment%5D(https%3A%2F%2Fhydro-informatics.com%2Fpyinstall%23pip-install-pckg).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Usage%20(Simple%20Plots)%0A%0A%20%20%20%20Plotly%20comes%20with%20datasets%20that%20can%20be%20queried%20online%20for%20showcases.%20The%20following%20example%20uses%20one%20of%20these%20datasets%20(find%20more%20at%20%5Bplotly.com%5D(https%3A%2F%2Fplotly.com%2Fpython-api-reference%2Fgenerated%2Fplotly.express.data.html)).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20plotly.express%20as%20px%0A%20%20%20%20import%20plotly.graph_objects%20as%20go%0A%20%20%20%20import%20plotly.offline%20as%20pyo%0A%20%20%20%20_df%20%3D%20px.data.gapminder().query(%22continent%3D%3D'Europe'%22)%0A%20%20%20%20_fig%20%3D%20px.line(_df%2C%20x%3D'year'%2C%20y%3D'pop'%2C%20color%3D'country')%0A%20%20%20%20_fig%20%20%23%20marimo%20displays%20the%20last%20expression%0A%20%20%20%20return%20go%2C%20px%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20In%20hydraulics%2C%20we%20often%20prefer%20to%20visualize%20data%20in%20locally%20stored%20text%20files%2C%20for%20example%2C%20after%20processing%20output%20from%202d-numerical%20modeling%20with%20NumPy%20or%20pandas.%20*plotly*%20works%20hand-in-hand%20with%20*pandas*%20and%20the%20following%20example%20features%20plotting%20*pandas*%20data%20frames%2C%20build%20from%20a%20*csv*%20file%2C%20with%20*ploty*%20(better%20solutions%20for%20*pandas*%20data%20frame%20sorting%20are%20shown%20in%20the%20%5Bpandas%20reshaping%20section%5D(https%3A%2F%2Fhydro-informatics.com%2Fjupyter%2Fpynum.html%23pd-reshape)).%20In%20marimo%2C%20a%20plotly%20figure%20is%20displayed%20when%20it%20is%20the%20last%20expression%20of%20a%20cell%20(the%20Jupyter%20version%20of%20this%20notebook%20uses%20%60pyo.init_notebook_mode()%60%20and%20%60pyo.iplot()%60%20instead%2C%20which%20only%20work%20in%20IPython).%20The%20*csv*%20file%20comes%20from%20the%20*Food%20and%20Agriculture%20Organization%20of%20the%20United%20Nations*%20(FAO)%20data%20center%20%5BFAOSTAT%5D(http%3A%2F%2Fwww.fao.org%2Ffaostat%2Fen%2F%23data%2FET)%20(%5Bdownload%20temperature_change.csv%5D(https%3A%2F%2Fraw.githubusercontent.com%2Fhydro-informatics%2Fjupyter-python-course%2Fmain%2Fdata%2Ftemperature_change.csv)).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(go%2C%20pd)%3A%0A%20%20%20%20_df%20%3D%20pd.read_csv('data%2Ftemperature_change.csv')%0A%20%20%20%20country_filter%20%3D%20'France'%0A%20%20%20%20month_filter1%20%3D%20'January'%0A%20%20%20%20month_filter2%20%3D%20'July'%0A%20%20%20%20df_country%20%3D%20_df%5B_df%5B'Area'%5D%20%3D%3D%20country_filter%5D%0A%20%20%20%20df_country_month1%20%3D%20df_country%5Bdf_country%5B'Months'%5D%20%3D%3D%20month_filter1%5D%0A%20%20%20%20df_country_month2%20%3D%20df_country%5Bdf_country%5B'Months'%5D%20%3D%3D%20month_filter2%5D%0A%20%20%20%20bar_plots%20%3D%20%5Bgo.Bar(x%3Ddf_country_month1%5B'Year'%5D%2C%20y%3Ddf_country_month1%5B'Value'%5D%2C%20name%3Dmonth_filter1)%2C%20go.Bar(x%3Ddf_country_month2%5B'Year'%5D%2C%20y%3Ddf_country_month2%5B'Value'%5D%2C%20name%3Dmonth_filter2)%5D%0A%20%20%20%20_fig%20%3D%20go.Figure(data%3Dbar_plots)%0A%20%20%20%20_fig.update_layout(title%3Df'Monthly%20average%20surface%20temperature%20deviation%20(ref.%201951%E2%80%931980)%20in%20%7Bcountry_filter%7D'%2C%20yaxis_title%3D'Temperature%20(%C2%B0C)')%0A%20%20%20%20_fig%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%23%20Interactive%20map%20applications%0A%20%20%20%20*plotly*%20uses%20the%20%5BGeoJSON%5D(https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FGeoJSON)%20data%20format%20(an%20open%20standard%20for%20simple%20geospatial%20objects)%20in%20interactive%20maps.%20The%20developers%20provide%20many%20examples%20in%20their%20documentation%20and%20the%20below%20code%20block%20replicates%20a%20map%20representing%20unemployment%20rates%20in%20the%20United%20States.%20More%20examples%20are%20available%20at%20the%20%5Bdeveloper's%20website%5D(https%3A%2F%2Fplotly.com%2Fpython%2Fmaps%2F).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(pd%2C%20px)%3A%0A%20%20%20%20from%20urllib.request%20import%20urlopen%0A%20%20%20%20import%20json%0A%20%20%20%20with%20urlopen('https%3A%2F%2Fraw.githubusercontent.com%2Fplotly%2Fdatasets%2Fmaster%2Fgeojson-counties-fips.json')%20as%20response%3A%0A%20%20%20%20%20%20%20%20counties%20%3D%20json.load(response)%0A%20%20%20%20_df%20%3D%20pd.read_csv('https%3A%2F%2Fraw.githubusercontent.com%2Fplotly%2Fdatasets%2Fmaster%2Ffips-unemp-16.csv'%2C%20dtype%3D%7B'fips'%3A%20str%7D)%0A%20%20%20%20_fig%20%3D%20px.choropleth_map(_df%2C%20geojson%3Dcounties%2C%20locations%3D'fips'%2C%20color%3D'unemp'%2C%20color_continuous_scale%3D'Viridis'%2C%20range_color%3D(0%2C%2012)%2C%20map_style%3D'carto-positron'%2C%20zoom%3D2%2C%20center%3D%7B'lat'%3A%2035.0%2C%20'lon'%3A%20-90.0%7D%2C%20opacity%3D0.5%2C%20labels%3D%7B'unemp'%3A%20'Unemployment%20rate%20(%25)'%7D)%0A%20%20%20%20_fig.update_layout(margin%3D%7B'r'%3A%200%2C%20't'%3A%200%2C%20'l'%3A%200%2C%20'b'%3A%200%7D)%0A%20%20%20%20_fig%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Many%20more%20maps%20are%20available%20-%20some%20of%20them%20require%20a%20*Mapbox*%20account%20and%20the%20creation%20of%20a%20public%20token%20(read%20more%20at%20%5Bplotly.com%5D(https%3A%2F%2Fplotly.com%2Fpython%2Fmapbox-layers%2F)).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A