The Freshwater Waterhackweek Connector is a tool to visualize and summarize connections between researchers in the hydrologic sciences. This project is currently in the planning and early development phase.

Link to the demonstration Waterhackweek 2019 visualization on the University of Washington Freshwater website

To run the python code or explore the visualization with NetworkX, click on the badge to launch the Binder software environment.

The ultimate goal is to produce an interactive network visualization of freshwater scientists. Ideally, it would be similar to the ERC-citations tool hosted on nanoHUB. It might even make sense to use the ERC tool directly or with some small modifications.

The ERC-citations tool uses a bibtex file input to construct the network. There are positives and negatives to using this approach.

• standardized format for Collaborations as a digital object
• can be easily obtained from ORCID
• if web resources like GitHub and Hydroshare have a DOI, then it is easy to include in bibtex

• any resources that don't have an easy bibtex form will have to be translated programmatically to bibtex, which could be difficult to standardize
• it is complicated to include entities like "Waterhackweek" as centralized nodes

Users' information will be captured through some channel (online form, Waterhackweek application, etc.). This information will include:

• Name
• GitHub username
• ORCID
• HydroShare username

This information will be procured using the respective APIs for Github and Hydroshare, and by parsing through the bibtex file containing journal and paper publications of the WHW participants.

Any feedback on the Connector is welcome! Please post your review on the connector as a Github Issue in the following Q/A format:

• Question 1

Is the visualization intuitive ? Can you interact with all the individual elements ?

• Question 2

Is there anything that is not working as expected?

• Question 3

Any suggestions that can enhance the visualization ?

GitHub has a fully-featured API that should allow for the following information to be retrieved for any given user:

• public repos that they own
• public repos that they have contributed to
• public GitHub organizations they belong to
• other contributors to public repos they own
• other contributors to public repos they have contributed to
• other members of the GitHub organizations they belong to
• ...more

There are a number of Python wrappers for the GitHub API (https://developer.github.com/v3/libraries/). It is probably best to use one of these as it should be easier to maintain than using the raw JSON returned by a lower-level library like requests.

Like GitHub, ORCID already has a public API that can be queried with Python. There is even a Python wrapper for the ORCID API that should make things easier.

However, ORCID requires user permission, even for read-only

HydroShare also has an API and a Python client that will allow for easier extraction of a user's HydroShare Resources and collaborators.

Most of the paper and journal publications are present in the form of bibtex files, which can be easily parsed using the Bibtexparser.

1. Fork, clone, branch

git clone https://github.com/waterhackweek/Connector.git

2. You will need a token authorizing your access to the Github repository where you are accessing user data.

Go to Github Profile. Click through Settings/Developer Settings/Personal Access Token.

Select Scope by checking repo: Full control of private repositories

Generate token

Copy token to file to a safe place NOT in Github directory

3. You will need the HydroShare UserID and Password and Ownership Access to the Group

Currently, the data generated for the visualization in Tableau consists of the following tables :

WHW_XY (Person, X-coordinate, Y-coordinate)
WHW_edge_collabs (Person1, Person2, Link, Collaboration)

Thanks goes to these wonderful people (emoji key):

Christina Bandaragoda 💻 📖 🤔 🔍 📆 👀

Madhavi Srinivasan 💻 📖 🤔

Tony Castronova 🤔

Jacob Deppen 🤔 📖 💻

National Science Foundation 💵

This project follows the all-contributors specification. Contributions of any kind welcome!