Opened 5 years ago

Closed 5 years ago

#2132 closed task (fixed)

Include a collection of Jupyter notebooks

Reported by: kalxas Owned by: osgeolive@…
Priority: major Milestone: OSGeoLive13.0
Component: OSGeoLive Keywords: notebooks
Cc: osgeolive@…

Description

Having used Jupyter Notebooks and OSGeoLive recently in class, I believe we need to put some effort to bring back the notebooks git repository.

I think we additionally need some demos to cover geopandas and OWSLib.

We should also create a quickstart and overview document to cover Jupyter.

Attachments (1)

live12_notebooks_min.png (89.2 KB ) - added by darkblueb 5 years ago.

Download all attachments as: .zip

Change history (14)

in reply to:  description comment:1 by lucadelu, 5 years ago

Replying to kalxas:

Having used Jupyter Notebooks and OSGeoLive recently in class, I believe we need to put some effort to bring back the notebooks git repository.

I can help on this, we should also reorder a little bit the existing notebooks. It could be really useful to connect external notebooks, for example GRASS has several notebooks

I think we additionally need some demos to cover geopandas and OWSLib.

I could work on geopandas, there are some examples here

For OWSLib there is something here, we need to review it

We should also create a quickstart and overview document to cover Jupyter.

comment:2 by camerons, 5 years ago

I'm building a list of documentation ideas to improve OSGeo and OSGeoLive documentation, which I'll be pointing potential writers at for inspiration. (In particular, I'm hoping to attract writers from the Google Season of Docs initiative.)

I have a title for Jupyter, but I feel my description of what a writing task could/should be better. @lucadelu, are you in a position to improve this description? https://docs.google.com/document/d/1yriJoybYjsCKhprNLNGGanw8HRA5Z8GhrNrA5RjavUU/edit#heading=h.uxp9m781oud6

And would you be prepared to mentor a writer if they volunteered? If so, please add your name to the list of "People keen to take part". (I'm expecting that a buzzing community will attract more community). https://docs.google.com/document/d/1yriJoybYjsCKhprNLNGGanw8HRA5Z8GhrNrA5RjavUU/edit#heading=h.s584ca6y83ac

in reply to:  2 comment:3 by lucadelu, 5 years ago

Replying to camerons:

I have a title for Jupyter, but I feel my description of what a writing task could/should be better. @lucadelu, are you in a position to improve this description?

I read it, but I could not be able to improve it since it seems quiet well explained ( i just added a comment)

And would you be prepared to mentor a writer if they volunteered? If so, please add your name to the list of "People keen to take part". (I'm expecting that a buzzing community will attract more community).

I cannot be part of this activity (since I have no time to use for it), but I could spend time to improve the state of our notebooks git repository if we agree on what and how the notebooks should be reorganized

comment:4 by camerons, 5 years ago

Hi Luca, in that case, would you be prepared to add a statement to the "People Keen to Help" similar to: Luca Delu: <A bit about you>. Willing to help improve (existing?) Jupyter Notebook documents in line with a developed template and writing instructions, if one is developed and committed to.

A statement such as that shows that we have the start of a community willing to sustainably build upon a tech writer's initiative, and will increase the chance of us attracting a tech writer to our project.

comment:5 by darkblueb, 5 years ago

hi all -- now Apr19, it is an opportunity, and a necessity, to make a new structure for Notebooks; python, R and perhaps other. The repository OSGeoLive-Notebooks is actually specific to the last version of OSGeoLive 12, and therefore stale. The current, minimum install of Notebook looks like this (see attachment) .

by darkblueb, 5 years ago

Attachment: live12_notebooks_min.png added

in reply to:  5 comment:6 by lucadelu, 5 years ago

Replying to darkblueb:

hi all -- now Apr19, it is an opportunity, and a necessity, to make a new structure for Notebooks; python, R and perhaps other. The repository OSGeoLive-Notebooks is actually specific to the last version of OSGeoLive 12, and therefore stale. The current, minimum install of Notebook looks like this (see attachment) .

I agree in a structure with python, R, bash, others. Another way could split by project GRASS, Scitools, R, GeoPandas..

Why notebooks in the install is so small?

comment:7 by darkblueb, 5 years ago

july Sprint Weekend results

https://git.osgeo.org/gitea/osgeolive/o13-Jupyter

$ cd jupyter
$ git clone https://git.osgeo.org/gitea/osgeolive/o13-Jupyter.git; cd o13-Jupyter
$ BRS="Rasterio_py3 Geopandas_py3 Folium_py3 Fiona_py2 Rasdaman_py2 Cartopy_py2 Mapserver_py ipy55 Shapely_py2 Iris_py2"
$ for br in ${BRS}; do git checkout $br; cp -R notebooks/* ../notebook_gallery/;done

## Pandas_py3  - ready
## pySAL_py3 - not ready

hack - does not include the docs_dir

Last edited 5 years ago by darkblueb (previous) (diff)

comment:8 by misev, 5 years ago

We have a Jupyter notebook demo that makes some use of OWSLib and showcases WCS/WCPS queries on a rasdaman installation at CODE-DE: https://processing.code-de.org/rasdaman/index.html?page=demo-apps&group=client&app=jupyter-notebook-extensive

It could be adapted and added to the OSGeoLive if you think it's a good idea? Although it will be tricky to adapt the examples to work with local data.

comment:9 by darkblueb, 5 years ago

beta3 git branch Geopandas_py3 needs

python3-pandas python3-seaborn python3-geopandas python3-descartes

in reply to:  8 comment:10 by darkblueb, 5 years ago

Replying to misev:

We have a Jupyter notebook demo ...

hi misev - the notebook is now in the repo (above)

It could be adapted and added to the OSGeoLive if you think it's a good idea? Although it will be tricky to adapt the examples to work with local data.

sure - many possibilities

comment:11 by kalxas, 5 years ago

Hi, it looks like everything is held in several branches in https://git.osgeo.org/gitea/osgeolive/o13-Jupyter so we need to clean up and merge to get the notebooks ready for 13.0.

I will move current master of https://github.com/OSGeo/OSGeoLive-Notebooks to branch v12.0 and then we can start merging Brian's work on master directly.

comment:12 by kalxas, 5 years ago

Previous code is now included in 11.0 release tag:

https://git.osgeo.org/gitea/osgeolive/OSGeoLive-Notebooks/releases

I have also created a 11.x branch in case someone wants to fix something in the old code:

https://git.osgeo.org/gitea/osgeolive/OSGeoLive-Notebooks/src/branch/11.x

Master is open to start from scratch:

https://git.osgeo.org/gitea/osgeolive/OSGeoLive-Notebooks/src/branch/master

I have only kept the intro notebooks, just in case we want to keep around.

Brian, can you please send pull requests against this git repository so we can merge your work? Thanks!

Note: See TracTickets for help on using tickets.