pdnd-open-notebooks

INFO

This repo contains a set of notebooks devoloped using pdnd-nteract on top of a datascience docker image provided by jupyter project. The image contains a ready to use datascience environment with the most used datascience libraries for python3, R, and Julia. If you want to deepen about the set of libraries you can read this.

Pdnd-nteract is a customisation of nteract that allows users registered into the pdnd to search and load datasets into the notebook from about 7000 italians public datasets. If you want to know more about the project you can start from here. Some material to understand how it works can be:

• Medium post
• Video tutorial
• Tutorial in this repo
• Examples in this repo

Examples open on binder

• List of examples on

GETTING STARTED

Docker MUST be installed on your local machine

From dockerhub

git clone git@github.com:teamdigitale/pdnd-open-notebooks.git
cd pdnd-open-notebooks
docker pull teamdigitale/pdnd-datascience
docker run -p 8888:8888 -v "$PWD":/home/jovyan/work teamdigitale/pdnd-datascience

Save the token from the output of your console as: http://(b4fd9e3ef290 or 127.0.0.1):8888/?token=XXXXXXXXXXXXXX and open your browser at [http://localhost:8888]. If you are asked the token paste it.

You should see something like this:

Navigate to work/examples and you should see a list of simple examples and tutorial where you can start to understand how it works.

CONGRATULATIONS NOW YOU ARE READY TO CONTRIBUTE.

HOW TO CONTRIBUTE

Never made an open source contribution before?

1. Fork this repository to your local GitHub organization.

2. Clone the repository to your local machine using:

$ git clone https://github.com/github-username/repository-name.git

3. Set the upstream repository by

$ git remote add upstream git@github.com:teamdigitale/pdnd-open-notebooks.git

4. Install the image and launch as in the steps described above

5. Create a new branch for your new analyses using:

$ git checkout -b branch-name-here

6. Create a new analysis on some public data provided by the platform

7. Add and commit the changed files using git add and git commit.

8. Push the changes to the remote repository using:

$ git push origin branch-name-here

9. Submit a pull request to the upstream repository.

10. Title the pull request per the requirements outlined in the section below.

11. Set the description of the pull request with a brief description of what you did and any questions you might have about what you did.

12. Wait for the pull request to be reviewed by a maintainer.

13. Make changes to the pull request if the reviewing maintainer recommends them.

14. Celebrate your success after your pull request is merged! 🎉