<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:0 0 0 40px;border:none;padding:0px"><blockquote style="margin:0 0 0 40px;border:none;padding:0px"></blockquote></blockquote><blockquote style="margin:0 0 0 40px;border:none;padding:0px">>>> import pandas as pd<br><blockquote style="margin:0 0 0 40px;border: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:0 0 0 40px;border: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">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">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">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">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">https://trac.osgeo.org/grass/wiki/GSoC/2021/JupyterAndGRASS/MiniGrant2022</a><br>[5] <a href="https://github.com/OSGeo/grass/projects/7">https://github.com/OSGeo/grass/projects/7</a></div></div>