<div dir="ltr"><div>+1, Vaclav<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, 19 Apr 2022 at 17:17, Veronica Andreo <<a href="mailto:veroandreo@gmail.com">veroandreo@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="auto"><div dir="auto">Dear PSC,<div dir="auto"><br></div><div dir="auto">Caitlin has just completed her project for the student grant and submitted the final report (I FWD it here in case you missed it).</div><div dir="auto"><br></div><div dir="auto">I hereby propose to approve her final report and issue the second half of the payment. Big thanks to Caitlin and her mentors for your work and commitment! Thanks as well to those testing and providing feedback along the process! Great work Caitlin!! Congratulations!</div><div dir="auto"><br></div><div dir="auto">I start with my +1 !!</div><div dir="auto"><br></div><div dir="auto">Vero</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">---------- Forwarded message ---------<br>De: <strong class="gmail_sendername" dir="auto">Caitlin Haedrich</strong> <span dir="auto"><<a href="mailto:caitlin.haedrich@gmail.com" rel="noreferrer" target="_blank">caitlin.haedrich@gmail.com</a>></span><br>Date: lun., 18 abr. 2022 19:25<br>Subject: [GRASS-dev] grass.jupyter Mini Project Final Report<br>To:  <<a href="mailto:grass-dev@lists.osgeo.org" rel="noreferrer" target="_blank">grass-dev@lists.osgeo.org</a>>,  <<a href="mailto:grass-user@lists.osgeo.org" rel="noreferrer" target="_blank">grass-user@lists.osgeo.org</a>><br></div><br><br><div dir="ltr">Hi all,<br><br>Last week, we wrapped a final push on grass.jupyter and are excited for its official release with GRASS 8.2. Here's my final report along with a summary of grass.jupyter changes introduced as part of the project. Thank you all for your support, feedback and testing over the past few months!<br><br><b>The state of the art BEFORE the start of the Mini Project:</b><br>During GSoC 2021, we created “grass.jupyter”, a package that improves the integration of GRASS GIS and Jupyter with a set of functions for displaying GRASS data in Jupyter Notebooks. In its previous state, “grass.jupyter” allows users to create static visuals and simple interactive maps. However, several additional features are needed to allow Jupyter users to fully and easily access the power GRASS, including space-time dataset visualization and more options for interactive mapping.<br><br><b>Project Goals</b>: <br>In preparation for the stable release of grass.jupyter with GRASS 8.2, this project had three main goals: (1) create space time dataset visualizations for use in Jupyter Notebooks, (2) improve the integration of GRASS with folium (leaflet library for Python) and (3) write a function for displaying vector attributes in nicely-formatted tables (using Pandas or Geopandas). Along the way, we also wanted to finalize the naming of grass.jupyter classes and create documentation (thank you Vaclav Petras).<br><br><b>The state of the art AFTER the Mini Project:</b><br>1. New TimeSeriesMap class that creates ipywidget time sliders of space time datasets (see attached timeseriesmap.png) and a notebook documenting it's usage [1]<br>2. Improved GRASS-folium integration allowing rasters and vectors to be added to existing folium maps (see attached grass-folium.png) and updated notebook demonstrating its usage [2]<br>3. Updated class names:<ul><li>GrassRenderer -> Map</li><li>Grass3dRenderer -> Map3D</li><li>InteractiveMap</li><li>TimeSeries -> TimeSeriesMap</li></ul>4. Thanks to Vaclav Petras, we also have a manual page for grass.jupyter [3]<br>5. I didn't end up working to integrate GRASS and Pandas. It seems that it is quite straightforward to display vector attributes in nicely-formatted Pandas tables. For example:<div><blockquote style="margin:0px 0px 0px 40px;border:medium none;padding:0px"><blockquote style="margin:0px 0px 0px 40px;border:medium none;padding:0px"></blockquote></blockquote><blockquote style="margin:0px 0px 0px 40px;border:medium none;padding:0px">>>> import pandas as pd<br><blockquote style="margin:0px 0px 0px 40px;border:medium none;padding:0px"></blockquote>>>> import sqlite3<br>>>> sql_path = gs.read_command("db.databases", driver="sqlite").replace('\n', '')<br>>>> con = sqlite3.connect(sql_path)<br>>>> sql_stat="SELECT * FROM field"<br>>>> df = pd.read_sql_query(sql_stat, con)<blockquote style="margin:0px 0px 0px 40px;border:medium none;padding:0px"></blockquote>>>> con.close()<br>>>> df</blockquote>There are other outputs that would be nice to display in nice Pandas tables, like text output from r.univar, r.stats, or t.vect.list. However, this is difficult since there is no standard output that is easily parse-able to pandas. I think the best way would be to create a standard json or csv output for all modules that return text. Then, it would be simple to take any module output and convert to a nice-looking Pandas table.<br><br><b>Next Steps:</b><br>1. Bug: InteractiveMap does not honor use_region=True for vectors.<br>2. Bug: InteractiveMap for Jupyter does not handle not existing data properly (<a href="https://github.com/OSGeo/grass/issues/2302" rel="noreferrer noreferrer" target="_blank">https://github.com/OSGeo/grass/issues/2302</a>)<br>3. InteractiveMap: add legend options for rasters, support simpleCRS for faster rendering, ToolTip integration for vector attributes<br>4. Continue Pandas integration by adding standard json or csv output to modules that return text<br>5. ... And many others! I think there's still lots of ways we can improve and expand the integration of GRASS and Jupyter. Ideas welcome.<br><br>You can find an archive of all my weekly reports at [4] and follow next steps for grass.jupyter on our project page on GitHub [5]. Thank you again to Vaclav Petras and Anna Petrasova for their guidance and contributions to grass.jupyter. And, another thank you to Vero Andreo, Stefan Blumentrath and Markus Neteler for their feedback and testing!<br><br>Best,<br>Caitlin<br><br>[1] <a href="https://mybinder.org/v2/gh/OSGeo/grass/main?urlpath=lab%2Ftree%2Fdoc%2Fnotebooks%2Ftemporal.ipynb" rel="noreferrer noreferrer" target="_blank">https://mybinder.org/v2/gh/OSGeo/grass/main?urlpath=lab%2Ftree%2Fdoc%2Fnotebooks%2Ftemporal.ipynb</a><br>[2] <a href="https://mybinder.org/v2/gh/OSGeo/grass/main?urlpath=lab%2Ftree%2Fdoc%2Fnotebooks%2Fgrass_jupyter.ipynb" rel="noreferrer noreferrer" target="_blank">https://mybinder.org/v2/gh/OSGeo/grass/main?urlpath=lab%2Ftree%2Fdoc%2Fnotebooks%2Fgrass_jupyter.ipynb</a><br>[3] <a href="https://grass.osgeo.org/grass81/manuals/libpython/grass.jupyter.html" rel="noreferrer noreferrer" target="_blank">https://grass.osgeo.org/grass81/manuals/libpython/grass.jupyter.html</a><br>[4] <a href="https://trac.osgeo.org/grass/wiki/GSoC/2021/JupyterAndGRASS/MiniGrant2022" rel="noreferrer noreferrer" target="_blank">https://trac.osgeo.org/grass/wiki/GSoC/2021/JupyterAndGRASS/MiniGrant2022</a><br>[5] <a href="https://github.com/OSGeo/grass/projects/7" rel="noreferrer noreferrer" target="_blank">https://github.com/OSGeo/grass/projects/7</a></div></div>
_______________________________________________<br>
grass-dev mailing list<br>
<a href="mailto:grass-dev@lists.osgeo.org" rel="noreferrer noreferrer" target="_blank">grass-dev@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/grass-dev" rel="noreferrer noreferrer noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/grass-dev</a><br>
</div></div>
_______________________________________________<br>
grass-psc mailing list<br>
<a href="mailto:grass-psc@lists.osgeo.org" target="_blank">grass-psc@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/grass-psc" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/grass-psc</a><br>
</blockquote></div>