PyPI - ricgraph - Versions diffs - 3.3__tar.gz → 3.5__tar.gz - Mend

ricgraph 3.3tar.gz → 3.5tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

{ricgraph-3.3/ricgraph.egg-info → ricgraph-3.5}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ricgraph
-Version: 3.3
+Version: 3.5
 Summary: Ricgraph - Research in context graph
 Author: Rik D.T. Janssen
 License-Expression: MIT
@@ -20,8 +20,10 @@ License-File: LICENSE
 Requires-Dist: neo4j>=5.8
 Requires-Dist: numpy
 Requires-Dist: pandas
+Requires-Dist: pymemcache
 Requires-Dist: requests
 Requires-Dist: unidecode
+Requires-Dist: markupsafe
 Dynamic: license-file
 [![DOI Ricgraph software](https://img.shields.io/badge/software-10.5281/zenodo.7524314-blue?logo=doi&logoColor=fff)](https://doi.org/10.5281/zenodo.7524314)
@@ -50,107 +52,48 @@ Documentation about the Podman badges can be found here: https://github.com/eggp
 ## What is Ricgraph?
-Ricgraph, also known as Research in context graph, enables the exploration of researchers,
-teams, their results,
+Ricgraph, also known as Research in context graph, enables the exploration of researchers, teams, their results,
 collaborations, skills, projects, and the relations between these items.
-Ricgraph can store many types of items into a single graph.
+Ricgraph can store many types of items into a single graph.
 These items can be obtained from various systems and from
-multiple organizations. Ricgraph facilitates reasoning about these
+multiple organizations. Ricgraph facilitates reasoning about these
 items because it infers new relations between items,
-relations that are not present in any of the separate source systems.
+relations that are not present in any of the separate source systems.
 It is flexible and extensible, and can be
 adapted to new application areas.
-## Motivation
-Ricgraph is software that is about
-relations between items. These items can be collected from various source
-systems and from multiple organizations. We
-explain how Ricgraph works by applying it to the application area
-*research information*. We show the insights that can be
-obtained by combining information from various source systems,
-insight arising from new relations that are not present
-in each separate source system.
-*Research information* is about anything related to research: research
-results, the persons in a research team, their
-collaborations, their skills, projects in which they have
-participated, as well as the relations between these entities.
-Examples of *research results* are publications, data sets, and software.
-The following sections show three use cases
-that use different types of information (called *items*):
-researchers, skills, publications,
-etc. Most often, these types of information are not stored in
-one system, so the use cases may be difficult or
-time-consuming to answer. However, by using Ricgraph, these
-use cases (and many others) are easy to answer, as will be
-explained throughout this documentation.
-Although this documentation illustrates Ricgraph in the application area
-research information, the principle “relations
-between items from various source systems” is general,
-so Ricgraph can be used in other application areas.
-### Use case for a journalist
-As a journalist, I want to find researchers with a certain skill S and their publications,
-so that I can interview them for a newspaper article.
-Example skills can be: *climate change* or *stem cells*.
-The items surrounded by the red line are the solution to this use case.
-<!--
-The 'width=...' in the lines below to include a figure are necessary for
-the documentation generated with Quarto, a.o. for the documentation website.
-We will need a width instead of a height to prevent right margin overflows
-on small mobile screens.
--->
-<img src="https://raw.githubusercontent.com/UtrechtUniversity/ricgraph/main/docs/images/journalist-use-case.jpg" alt="Ricgraph use case for a journalist." width="70%">
-### Use case for a librarian
-As a librarian, I want to enrich my local research information system with research results
-from person A that are in other systems (in orange, *RIS2*) but not in
-ours (in green, *RIS1*), so that we have a more complete view of research at our university.
-The items surrounded by the red line are the solution to this use case.
-<img src="https://raw.githubusercontent.com/UtrechtUniversity/ricgraph/main/docs/images/librarian-use-case.jpg" alt="Ricgraph use case for a librarian." width="75%">
-### Use case for a researcher
-As a researcher A, I want to find researchers from other universities that have
-co-authored publications written by the co-authors of my own publications,
-so that I can read their publications to find out if we share common research interests.
-The items surrounded by the red line are the solution to this use case.
-<img src="https://raw.githubusercontent.com/UtrechtUniversity/ricgraph/main/docs/images/researcher-use-case.jpg" alt="Ricgraph use case for a researcher." width="35%">
-## Main contributions of Ricgraph
-* Ricgraph can store many types of items in a single graph.
-* Ricgraph harvests multiple source systems into a single graph.
-* Ricgraph Explorer is the exploration tool for Ricgraph.
-* Ricgraph facilitates reasoning about items because it infers new relations between items.
-* Ricgraph can be tailored for an application area.
-## Read more about Ricgraph
-For a gentle introduction in Ricgraph, read the reference publication:
-Rik D.T. Janssen (2024). *Ricgraph: A flexible and extensible graph to explore research in
-context from various systems*. SoftwareX, 26(101736).
-[https://doi.org/10.1016/j.softx.2024.101736](https://doi.org/10.1016/j.softx.2024.101736).
-You might also want to read the documentation on
-[https://docs.ricgraph.eu](https://docs.ricgraph.eu).
-You can also go to the [Ricgraph GitHub repository](https://github.com/UtrechtUniversity/ricgraph).
-To use Ricgraph, installing the [Ricgraph package from PyPI](https://pypi.org/project/ricgraph)
-is not sufficient. Please read the
-installation instructions in the Ricgraph GitHub repository.
+## Why Ricgraph is unique
+Ricgraph is unique because it allows you to:
+* Explore collaborations between (sub-)organizations;
+* Explore open science;
+* Enhance research information systems.
+One of the other strengths of Ricgraph is that anyone with
+Python knowledge can easily extend it, allowing you to test
+your own ideas or create your own applications.
+You can use Ricgraph either as a standalone tool,
+or as a component that provides a graph based data structure with
+a number of handy tools.
+Ricgraph has been developed for the application area
+research information,
+and it can be used for other application areas that require
+relations between items from various source systems.
+## More information about Ricgraph
+To learn more about Ricgraph, please go to the
+[Ricgraph website www.ricgraph.eu](https://www.ricgraph.eu).
+If you would like to know more details about Ricgraph, please go to the
+[Ricgraph documentation website docs.ricgraph.eu](https://docs.ricgraph.eu).
 ## Contact
 Ricgraph has been created and is being maintained by
 Rik D.T. Janssen from Utrecht University in the Netherlands.
 You can find contact details at
-[his Utrecht University employee page](https://www.uu.nl/staff/DTJanssen).
-He also has an ORCID profile on
-[ORCID 0000-0001-9510-0802](https://orcid.org/0000-0001-9510-0802).
+the [Ricgraph contact page](https://www.ricgraph.eu/contact.html).

{ricgraph-3.3 → ricgraph-3.5}/README-PyPI.md RENAMED Viewed

@@ -24,107 +24,48 @@ Documentation about the Podman badges can be found here: https://github.com/eggp
 ## What is Ricgraph?
-Ricgraph, also known as Research in context graph, enables the exploration of researchers,
-teams, their results,
+Ricgraph, also known as Research in context graph, enables the exploration of researchers, teams, their results,
 collaborations, skills, projects, and the relations between these items.
-Ricgraph can store many types of items into a single graph.
+Ricgraph can store many types of items into a single graph.
 These items can be obtained from various systems and from
-multiple organizations. Ricgraph facilitates reasoning about these
+multiple organizations. Ricgraph facilitates reasoning about these
 items because it infers new relations between items,
-relations that are not present in any of the separate source systems.
+relations that are not present in any of the separate source systems.
 It is flexible and extensible, and can be
 adapted to new application areas.
-## Motivation
-Ricgraph is software that is about
-relations between items. These items can be collected from various source
-systems and from multiple organizations. We
-explain how Ricgraph works by applying it to the application area
-*research information*. We show the insights that can be
-obtained by combining information from various source systems,
-insight arising from new relations that are not present
-in each separate source system.
-*Research information* is about anything related to research: research
-results, the persons in a research team, their
-collaborations, their skills, projects in which they have
-participated, as well as the relations between these entities.
-Examples of *research results* are publications, data sets, and software.
-The following sections show three use cases
-that use different types of information (called *items*):
-researchers, skills, publications,
-etc. Most often, these types of information are not stored in
-one system, so the use cases may be difficult or
-time-consuming to answer. However, by using Ricgraph, these
-use cases (and many others) are easy to answer, as will be
-explained throughout this documentation.
-Although this documentation illustrates Ricgraph in the application area
-research information, the principle “relations
-between items from various source systems” is general,
-so Ricgraph can be used in other application areas.
-### Use case for a journalist
-As a journalist, I want to find researchers with a certain skill S and their publications,
-so that I can interview them for a newspaper article.
-Example skills can be: *climate change* or *stem cells*.
-The items surrounded by the red line are the solution to this use case.
-<!--
-The 'width=...' in the lines below to include a figure are necessary for
-the documentation generated with Quarto, a.o. for the documentation website.
-We will need a width instead of a height to prevent right margin overflows
-on small mobile screens.
--->
-<img src="https://raw.githubusercontent.com/UtrechtUniversity/ricgraph/main/docs/images/journalist-use-case.jpg" alt="Ricgraph use case for a journalist." width="70%">
-### Use case for a librarian
-As a librarian, I want to enrich my local research information system with research results
-from person A that are in other systems (in orange, *RIS2*) but not in
-ours (in green, *RIS1*), so that we have a more complete view of research at our university.
-The items surrounded by the red line are the solution to this use case.
-<img src="https://raw.githubusercontent.com/UtrechtUniversity/ricgraph/main/docs/images/librarian-use-case.jpg" alt="Ricgraph use case for a librarian." width="75%">
-### Use case for a researcher
-As a researcher A, I want to find researchers from other universities that have
-co-authored publications written by the co-authors of my own publications,
-so that I can read their publications to find out if we share common research interests.
-The items surrounded by the red line are the solution to this use case.
-<img src="https://raw.githubusercontent.com/UtrechtUniversity/ricgraph/main/docs/images/researcher-use-case.jpg" alt="Ricgraph use case for a researcher." width="35%">
-## Main contributions of Ricgraph
-* Ricgraph can store many types of items in a single graph.
-* Ricgraph harvests multiple source systems into a single graph.
-* Ricgraph Explorer is the exploration tool for Ricgraph.
-* Ricgraph facilitates reasoning about items because it infers new relations between items.
-* Ricgraph can be tailored for an application area.
-## Read more about Ricgraph
-For a gentle introduction in Ricgraph, read the reference publication:
-Rik D.T. Janssen (2024). *Ricgraph: A flexible and extensible graph to explore research in
-context from various systems*. SoftwareX, 26(101736).
-[https://doi.org/10.1016/j.softx.2024.101736](https://doi.org/10.1016/j.softx.2024.101736).
-You might also want to read the documentation on
-[https://docs.ricgraph.eu](https://docs.ricgraph.eu).
-You can also go to the [Ricgraph GitHub repository](https://github.com/UtrechtUniversity/ricgraph).
-To use Ricgraph, installing the [Ricgraph package from PyPI](https://pypi.org/project/ricgraph)
-is not sufficient. Please read the
-installation instructions in the Ricgraph GitHub repository.
+## Why Ricgraph is unique
+Ricgraph is unique because it allows you to:
+* Explore collaborations between (sub-)organizations;
+* Explore open science;
+* Enhance research information systems.
+One of the other strengths of Ricgraph is that anyone with
+Python knowledge can easily extend it, allowing you to test
+your own ideas or create your own applications.
+You can use Ricgraph either as a standalone tool,
+or as a component that provides a graph based data structure with
+a number of handy tools.
+Ricgraph has been developed for the application area
+research information,
+and it can be used for other application areas that require
+relations between items from various source systems.
+## More information about Ricgraph
+To learn more about Ricgraph, please go to the
+[Ricgraph website www.ricgraph.eu](https://www.ricgraph.eu).
+If you would like to know more details about Ricgraph, please go to the
+[Ricgraph documentation website docs.ricgraph.eu](https://docs.ricgraph.eu).
 ## Contact
 Ricgraph has been created and is being maintained by
 Rik D.T. Janssen from Utrecht University in the Netherlands.
 You can find contact details at
-[his Utrecht University employee page](https://www.uu.nl/staff/DTJanssen).
-He also has an ORCID profile on
-[ORCID 0000-0001-9510-0802](https://orcid.org/0000-0001-9510-0802).
+the [Ricgraph contact page](https://www.ricgraph.eu/contact.html).

ricgraph-3.5/README.md ADDED Viewed

@@ -0,0 +1,179 @@
+[![DOI Ricgraph software](https://img.shields.io/badge/software-10.5281/zenodo.7524314-blue?logo=doi&logoColor=fff)](https://doi.org/10.5281/zenodo.7524314)
+[![DOI Ricgraph reference publication](https://img.shields.io/badge/reference%20publication-10.1016%2Fj.softx.2024.101736-blue?logo=doi&logoColor=fff)](https://doi.org/10.1016/j.softx.2024.101736)
+[![DOI Ricgraph collaborations preprint](https://img.shields.io/badge/collaborations%20preprint-10.2139%2Fssrn.5524439-blue?logo=doi&logoColor=fff)](https://doi.org/10.2139/ssrn.5524439)
+[![Ricgraph website](https://img.shields.io/badge/website-www.ricgraph.eu-blue?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI3MC43NTIiIGhlaWdodD0iNzAuNzYxIiB2aWV3Qm94PSIwIDAgMTguNzIgMTguNzIyIj48ZyBzdHlsZT0ic3Ryb2tlOiNmZmY7c3Ryb2tlLW9wYWNpdHk6MSIgdHJhbnNmb3JtPSJtYXRyaXgoMS4wNTIwNCAwIDAgMS4wNTIwNCAtNjguMzM1IC0xMy4wODMpIj48Y2lyY2xlIGN4PSI2OS44MDkiIGN5PSIxNC43MDciIHI9IjEuODcyIiBmaWxsPSJub25lIiBzdHlsZT0iZmlsbDojZmZmO2ZpbGwtb3BhY2l0eTowO3N0cm9rZTojZmZmO3N0cm9rZS13aWR0aDouODtzdHJva2UtZGFzaGFycmF5Om5vbmU7c3Ryb2tlLW9wYWNpdHk6MSIvPjxjaXJjbGUgY3g9IjczLjMwMiIgY3k9IjIxLjA0OSIgcj0iMS44NzIiIGZpbGw9Im5vbmUiIHN0eWxlPSJmaWxsOiNmZmY7ZmlsbC1vcGFjaXR5OjA7c3Ryb2tlOiNmZmY7c3Ryb2tlLXdpZHRoOi44O3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2Utb3BhY2l0eToxIi8+PGNpcmNsZSBjeD0iODAuNDc3IiBjeT0iMjIuNTk2IiByPSIxLjg3MiIgZmlsbD0ibm9uZSIgc3R5bGU9ImZpbGw6I2ZmZjtmaWxsLW9wYWNpdHk6MDtzdHJva2U6I2ZmZjtzdHJva2Utd2lkdGg6Ljg7c3Ryb2tlLWRhc2hhcnJheTpub25lO3N0cm9rZS1vcGFjaXR5OjEiLz48Y2lyY2xlIGN4PSI3OC41MyIgY3k9IjE2LjM2OSIgcj0iMS44NzIiIGZpbGw9Im5vbmUiIHN0eWxlPSJmaWxsOiNmZmY7ZmlsbC1vcGFjaXR5OjA7c3Ryb2tlOiNmZmY7c3Ryb2tlLXdpZHRoOi44O3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2Utb3BhY2l0eToxIi8+PGNpcmNsZSBjeD0iNjcuMjI3IiBjeT0iMjMuNDQ2IiByPSIxLjg3MiIgZmlsbD0ibm9uZSIgc3R5bGU9ImZpbGw6I2ZmZjtmaWxsLW9wYWNpdHk6MDtzdHJva2U6I2ZmZjtzdHJva2Utd2lkdGg6Ljg7c3Ryb2tlLWRhc2hhcnJheTpub25lO3N0cm9rZS1vcGFjaXR5OjEiLz48Y2lyY2xlIGN4PSI3Ni4zNjgiIGN5PSIyNy45NiIgcj0iMS44NzIiIGZpbGw9Im5vbmUiIHN0eWxlPSJmaWxsOiNmZmY7ZmlsbC1vcGFjaXR5OjA7c3Ryb2tlOiNmZmY7c3Ryb2tlLXdpZHRoOi44O3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2Utb3BhY2l0eToxIi8+PHBhdGggZD0ibTc3LjUwNiAyNi40NzQgMS44MzMtMi4zOTJNNzAuNzEyIDE2LjM0N2wxLjY4NyAzLjA2M002OC45NjggMjIuNzZsMi41OTMtMS4wMjRNNzcuMTM1IDE3LjYxOCA3NC42OTcgMTkuOE03NS4xMzIgMjEuNDQ0bDMuNTE1Ljc1N003OS4wODkgMTguMTU1bC44MyAyLjY1NCIgc3R5bGU9ImZpbGw6bm9uZTtmaWxsLXJ1bGU6ZXZlbm9kZDtzdHJva2U6I2ZmZjtzdHJva2Utd2lkdGg6Ljg7c3Ryb2tlLWxpbmVjYXA6YnV0dDtzdHJva2UtbGluZWpvaW46bWl0ZXI7c3Ryb2tlLWRhc2hhcnJheTpub25lO3N0cm9rZS1vcGFjaXR5OjEiLz48L2c+PC9zdmc+)](https://www.ricgraph.eu)
+[![Ricgraph documentation website](https://img.shields.io/badge/doc%20website-docs.ricgraph.eu-blue?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI3MC43NTIiIGhlaWdodD0iNzAuNzYxIiB2aWV3Qm94PSIwIDAgMTguNzIgMTguNzIyIj48ZyBzdHlsZT0ic3Ryb2tlOiNmZmY7c3Ryb2tlLW9wYWNpdHk6MSIgdHJhbnNmb3JtPSJtYXRyaXgoMS4wNTIwNCAwIDAgMS4wNTIwNCAtNjguMzM1IC0xMy4wODMpIj48Y2lyY2xlIGN4PSI2OS44MDkiIGN5PSIxNC43MDciIHI9IjEuODcyIiBmaWxsPSJub25lIiBzdHlsZT0iZmlsbDojZmZmO2ZpbGwtb3BhY2l0eTowO3N0cm9rZTojZmZmO3N0cm9rZS13aWR0aDouODtzdHJva2UtZGFzaGFycmF5Om5vbmU7c3Ryb2tlLW9wYWNpdHk6MSIvPjxjaXJjbGUgY3g9IjczLjMwMiIgY3k9IjIxLjA0OSIgcj0iMS44NzIiIGZpbGw9Im5vbmUiIHN0eWxlPSJmaWxsOiNmZmY7ZmlsbC1vcGFjaXR5OjA7c3Ryb2tlOiNmZmY7c3Ryb2tlLXdpZHRoOi44O3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2Utb3BhY2l0eToxIi8+PGNpcmNsZSBjeD0iODAuNDc3IiBjeT0iMjIuNTk2IiByPSIxLjg3MiIgZmlsbD0ibm9uZSIgc3R5bGU9ImZpbGw6I2ZmZjtmaWxsLW9wYWNpdHk6MDtzdHJva2U6I2ZmZjtzdHJva2Utd2lkdGg6Ljg7c3Ryb2tlLWRhc2hhcnJheTpub25lO3N0cm9rZS1vcGFjaXR5OjEiLz48Y2lyY2xlIGN4PSI3OC41MyIgY3k9IjE2LjM2OSIgcj0iMS44NzIiIGZpbGw9Im5vbmUiIHN0eWxlPSJmaWxsOiNmZmY7ZmlsbC1vcGFjaXR5OjA7c3Ryb2tlOiNmZmY7c3Ryb2tlLXdpZHRoOi44O3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2Utb3BhY2l0eToxIi8+PGNpcmNsZSBjeD0iNjcuMjI3IiBjeT0iMjMuNDQ2IiByPSIxLjg3MiIgZmlsbD0ibm9uZSIgc3R5bGU9ImZpbGw6I2ZmZjtmaWxsLW9wYWNpdHk6MDtzdHJva2U6I2ZmZjtzdHJva2Utd2lkdGg6Ljg7c3Ryb2tlLWRhc2hhcnJheTpub25lO3N0cm9rZS1vcGFjaXR5OjEiLz48Y2lyY2xlIGN4PSI3Ni4zNjgiIGN5PSIyNy45NiIgcj0iMS44NzIiIGZpbGw9Im5vbmUiIHN0eWxlPSJmaWxsOiNmZmY7ZmlsbC1vcGFjaXR5OjA7c3Ryb2tlOiNmZmY7c3Ryb2tlLXdpZHRoOi44O3N0cm9rZS1kYXNoYXJyYXk6bm9uZTtzdHJva2Utb3BhY2l0eToxIi8+PHBhdGggZD0ibTc3LjUwNiAyNi40NzQgMS44MzMtMi4zOTJNNzAuNzEyIDE2LjM0N2wxLjY4NyAzLjA2M002OC45NjggMjIuNzZsMi41OTMtMS4wMjRNNzcuMTM1IDE3LjYxOCA3NC42OTcgMTkuOE03NS4xMzIgMjEuNDQ0bDMuNTE1Ljc1N003OS4wODkgMTguMTU1bC44MyAyLjY1NCIgc3R5bGU9ImZpbGw6bm9uZTtmaWxsLXJ1bGU6ZXZlbm9kZDtzdHJva2U6I2ZmZjtzdHJva2Utd2lkdGg6Ljg7c3Ryb2tlLWxpbmVjYXA6YnV0dDtzdHJva2UtbGluZWpvaW46bWl0ZXI7c3Ryb2tlLWRhc2hhcnJheTpub25lO3N0cm9rZS1vcGFjaXR5OjEiLz48L2c+PC9zdmc+)](https://docs.ricgraph.eu)
+[![GitHub Ricgraph](https://img.shields.io/badge/GitHub-UtrechtUniversity/ricgraph-blue?logo=github)](https://github.com/UtrechtUniversity/ricgraph)
+![GitHub release date](https://img.shields.io/github/release-date/UtrechtUniversity/ricgraph?color=%234c1&logo=github)
+[![GitHub latest release](https://img.shields.io/github/release/UtrechtUniversity/ricgraph?color=%234c1&logo=github)](https://github.com/UtrechtUniversity/ricgraph/releases)
+![GitHub commits since latest release](https://img.shields.io/github/commits-since/UtrechtUniversity/ricgraph/latest?color=%234c1&logo=github)
+![GitHub last commit](https://img.shields.io/github/last-commit/UtrechtUniversity/ricgraph?color=%234c1&logo=github)
+[![PyPI version](https://img.shields.io/pypi/v/ricgraph?label=PyPI%20version&color=%234c1&logo=pypi&logoColor=ffffff)](https://pypi.org/project/ricgraph)
+[![PyPI downloads](https://img.shields.io/pypi/dm/ricgraph?label=PyPI%20downloads&color=%234c1&logo=pypi&logoColor=ffffff)](https://pypistats.org/packages/ricgraph)
+[![Ricgraph container doc](https://img.shields.io/badge/Ricgraph_container_doc-click_here-%234c1)](https://github.com/UtrechtUniversity/ricgraph/blob/main/docs/ricgraph_containerized.md)
+[![Podman container version](https://ghcr-badge.egpl.dev/utrechtuniversity/ricgraph/latest_tag?color=%234c1&label=container+version)](https://github.com/utrechtuniversity/ricgraph/pkgs/container/ricgraph)
+[![GitHub license](https://img.shields.io/github/license/UtrechtUniversity/ricgraph?color=%234c1)](LICENSE)
+[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
+[![Technology Readiness Level 7/9 - Release Candidate - Technology ready enough and in initial use by end-users in intended scholarly environments](https://w3id.org/research-technology-readiness-levels/Level7ReleaseCandidate.svg)](https://github.com/CLARIAH/clariah-plus/blob/main/requirements/software-metadata-requirements.md#15--you-should-express-a-technology-readiness-level)
+[![FAIR checklist badge](https://fairsoftwarechecklist.net/badge.svg)](https://fairsoftwarechecklist.net/v0.2?f=31&a=32113&i=32110&r=123)
+<!---
+Note, some lines above end in two spaces, to force a line break but not a paragraph break.
+We use color=#4c1 (green), that color is used by the 'repo status' badge.
+Documentation about the Podman badges can be found here: https://github.com/eggplants/ghcr-badge.
+--->
+> Quick links:
+> [Use Ricgraph](https://www.ricgraph.eu/pilot-project-open-ricgraph-demo-server.html)
+> & [Read news about Ricgraph](https://www.ricgraph.eu/ricgraph-news.html)
+> & Go to the [Documentation website](https://docs.ricgraph.eu)
+> & Consult the [Table of contents](docs/ricgraph_toc_documentation.md#table-of-contents-ricgraph-documentation),
+> or the [Index](docs/ricgraph_index_documentation.md#index-ricgraph-documentation).
+<img alt="Ricgraph logo" src="docs/images/ricgraph_logo.png" width="30%">
+<!---
+The Mark below is used in file
+https://github.com/UtrechtUniversity/ricgraph-documentation/blob/main/Makefile
+to remove everything up and including these lines. Do not modify the text in it.
+--->
+<!--- Mark to remove everything up to here --->
+# Ricgraph - Research in context graph
+## What is Ricgraph?
+Ricgraph, also known as Research in context graph, enables the exploration of researchers, teams, their results,
+collaborations, skills, projects, and the relations between these items.
+Ricgraph can store many types of items into a single graph.
+These items can be obtained from various systems and from
+multiple organizations. Ricgraph facilitates reasoning about these
+items because it infers new relations between items,
+relations that are not present in any of the separate source systems.
+It is flexible and extensible, and can be
+adapted to new application areas.
+## Why Ricgraph is unique
+Ricgraph is unique because it allows you to:
+* [Explore collaborations between (sub-)organizations](https://www.ricgraph.eu/collaborations-with-ricgraph.html).
+* [Explore open science](https://www.ricgraph.eu/open-science-with-ricgraph.html).
+* [Enhance research information systems](https://www.ricgraph.eu/enhancing-with-ricgraph.html).
+One of the other strengths of Ricgraph is that anyone with
+Python knowledge can easily extend it, allowing you to test
+your own ideas or create your own applications.
+You can use Ricgraph either as a standalone tool,
+or as a component that provides a graph based data structure with
+a number of handy tools.
+Ricgraph has been developed for the application area
+research information,
+and it can be used for other application areas that require
+relations between items from various source systems.
+## Ricgraph introduction videos
+You may want to watch the following videos about Ricgraph. The left one is a
+short video, only including the Ricgraph use cases. The right one is a more
+extensive one (also including the use cases).
+<table>
+  <tr>
+    <td style="width:50%;"><b>Ricgraph use cases video (1m30s)</b></td>
+    <td style="width:50%;"><b>Ricgraph introduction video including use cases (2m28s)</b></td>
+  </tr>
+  <tr>
+    <td><video src="docs/videos/ricgraph_usecases.mp4" controls width="90%">Ricgraph use cases video (1m30s)</video></td>
+    <td><video src="docs/videos/ricgraph_intro_usecases.mp4" controls width="90%">Ricgraph introduction video including use cases (2m28s)</video></td>
+  </tr>
+  <tr>
+   <td>
+     <a href="https://docs.ricgraph.eu/docs/videos/ricgraph_usecases.mp4" target="_blank">
+     Click to play or download the Ricgraph use cases video</a>.
+   </td>
+   <td>
+     <a href="https://docs.ricgraph.eu/docs/videos/ricgraph_intro_usecases.mp4" target="_blank">
+     Click to play or download the Ricgraph introduction video</a>.
+   </td>
+  </tr>
+</table>
+## More information about Ricgraph
+To learn more about Ricgraph, please go to the
+[Ricgraph website www.ricgraph.eu](https://www.ricgraph.eu).
+If you would like to know more details about Ricgraph, please go to the
+[Ricgraph documentation website docs.ricgraph.eu](https://docs.ricgraph.eu).
+[Use Ricgraph or participate](https://www.ricgraph.eu/pilot-project-open-ricgraph-demo-server.html).
+## Ricgraph in bullet points
+* Read more about [Why Ricgraph is
+  unique](https://www.ricgraph.eu/what-is-ricgraph.html#why-ricgraph-is-unique).
+* The philosophy of Ricgraph is that it stores metadata, not the objects the metadata
+  refer to. To access an object, a node has a link to that object in
+  the system it was obtained from.
+* We have chosen a
+  graph as a data structure, since it is a logical and efficient
+  method to access objects
+  which are close to objects they have a relation to. For example,
+  starting with a person, its research outputs are only one
+  step away by following one edge, and other contributors to that research output are
+  again one step (edge) away.
+* Ricgraph can be used to store, manipulate and read metadata of any object that
+  has a relation to another object,
+  as long as every object can be "represented" by at least a *name* and a *value*.
+  In Ricgraph, one node represents one object, and an edge represents the
+  relation between two objects.
+* Ricgraph and Ricgraph Explorer are written in Python. You can use two different
+  [graph database backends](https://en.wikipedia.org/wiki/Graph_database):
+  [Neo4j](docs/ricgraph_backend_neo4j.md#ricgraph-with-neo4j-graph-database-backend) and
+  [Memgraph](docs/ricgraph_backend_memgraph.md#ricgraph-with-memgraph-graph-database-backend).
+* The objective of Ricgraph is to get metadata from
+  objects from a source system in a process called "harvesting".
+  That means that e.g. persons and publications
+  can be harvested from one system, data sets from another system, and software from a third system.
+  Everything found will be combined into one graph.
+* Ricgraph can harvest from many sources, and you can write your own
+  harvesting scripts. Example scripts are included to
+  harvest from the [OpenAlex](https://openalex.org),
+  the [Research Information System Pure](https://www.elsevier.com/solutions/pure),
+  the data repository [Yoda](https://www.uu.nl/en/research/yoda),
+  the [Research Software Directory](https://research-software-directory.org), and
+  for the [Utrecht University staff pages](https://www.uu.nl/staff/search).
+* Ricgraph is an ID resolver. It can, given an identifier of a person,
+  easily find other identifiers of that person. When new identifiers are found when
+  harvesting from new systems,
+  they will be added automatically.
+## Contact
+Ricgraph has been created and is being maintained by
+Rik D.T. Janssen from Utrecht University in the Netherlands.
+You can find contact details at
+[his Utrecht University employee page](https://www.uu.nl/staff/DTJanssen).
+He also has an ORCID profile on
+[ORCID 0000-0001-9510-0802](https://orcid.org/0000-0001-9510-0802).
+You can contact him for presentations, demos and workshops.
+For more details, including subscribing to the Ricgraph newsletter and
+opportunities for collaboration, read
+the [Ricgraph contact page](https://www.ricgraph.eu/contact.html).
+If you like Ricgraph, please give it a GitHub Star by clicking on the top right
+*Star* button on the Ricgraph GitHub page
+[https://github.com/UtrechtUniversity/ricgraph](https://github.com/UtrechtUniversity/ricgraph).
+If you have any suggestions or improvements,
+please let me know by creating a GitHub *Issue* at the top left of that page.
+<!-- Do not change the lines below. The version number will be
+     modified by script maintenance/update_version.bash -->
+This README.md file is part of the
+documentation for version 3.5 of Ricgraph - Research in context graph.

{ricgraph-3.3 → ricgraph-3.5}/pyproject.toml RENAMED Viewed

@@ -1,3 +1,5 @@
+# pyproject.toml file to build module ricgraph for PyPI.
 [build-system]
 requires = ["setuptools>=61.0"]
 build-backend = "setuptools.build_meta"
@@ -7,7 +9,7 @@ packages = ["ricgraph"]
 [project]
 name = "ricgraph"
-version = "3.3"
+version = "3.5"
 authors = [
   { name="Rik D.T. Janssen" },
 ]
@@ -29,8 +31,10 @@ dependencies = [
     "neo4j>=5.8",
     "numpy",
     "pandas",
+    "pymemcache",
     "requests",
     "unidecode",
+    "markupsafe",
 ]
 [project.urls]

{ricgraph-3.3 → ricgraph-3.5}/ricgraph/ricgraph.py RENAMED Viewed

@@ -120,7 +120,7 @@ __package__ = 'Ricgraph'
 # __version__ should be placed here instead of in __init__.py.
 # If not here, it cannot be found when executing something like
 # PYTHONPATH=../ricgraph ../bin/python ricgraph_explorer.py
-__version__ = '3.3'
+__version__ = '3.5'
 # ##############################################################################
@@ -147,9 +147,9 @@ def update_nodes_df(nodes: DataFrame) -> None:
     """
     nodes_clean = nodes.copy(deep=True)
     # Ensure that all '' values are NaN, so that those rows can be easily removed with dropna()
-    nodes_clean.replace('', nan, inplace=True)
-    nodes_clean.dropna(axis=0, how='any', inplace=True)
-    nodes_clean.drop_duplicates(keep='first', inplace=True, ignore_index=True)
+    nodes_clean = nodes_clean.replace('', nan)
+    nodes_clean = nodes_clean.dropna(axis=0, how='any')
+    nodes_clean = nodes_clean.drop_duplicates(keep='first', ignore_index=True)
     print('There are ' + str(len(nodes_clean)) + ' nodes ('
           + timestamp() + '), updating node:')
@@ -248,7 +248,7 @@ def create_nodepairs_and_edges_params(name1: dict | str, category1: dict | str,
                                                     index=[0])
     else:
         left_and_right_nodepairs = DataFrame(data=value1).copy(deep=True)
-        left_and_right_nodepairs.rename(columns={value1.name: 'value1'}, inplace=True)
+        left_and_right_nodepairs = left_and_right_nodepairs.rename(columns={value1.name: 'value1'})
     # This makes programming more efficient
     allowed_properties = get_ricgraph_properties_additional() + get_ricgraph_properties_standard()
@@ -268,14 +268,14 @@ def create_nodepairs_and_edges_params(name1: dict | str, category1: dict | str,
                     left_and_right_nodepairs[prop_name + '1'] = other_value
                 else:
                     left_and_right_nodepairs = concat([left_and_right_nodepairs, other_value], axis='columns')
-                    left_and_right_nodepairs.rename(columns={other_value.name: prop_name + '1'}, inplace=True)
+                    left_and_right_nodepairs = left_and_right_nodepairs.rename(columns={other_value.name: prop_name + '1'})
             if prop_name + '2' == other_name:
                 if isinstance(other_value, str):
                     left_and_right_nodepairs[prop_name + '2'] = other_value
                 else:
                     left_and_right_nodepairs = concat([left_and_right_nodepairs, other_value], axis='columns')
-                    left_and_right_nodepairs.rename(columns={other_value.name: prop_name + '2'}, inplace=True)
+                    left_and_right_nodepairs = left_and_right_nodepairs.rename(columns={other_value.name: prop_name + '2'})
     # Reorder a bit, starting with the last, only the name-category-value property, since they will surely exist
     left_and_right_nodepairs.insert(0, 'value2', left_and_right_nodepairs.pop('value2'))
@@ -314,10 +314,10 @@ def unify_personal_identifiers(personal_identifiers: DataFrame,
             identifiers = personal_identifiers[[column1, column2]].copy(deep=True)
             # Ensure that all '' values are NaN, so that those rows can be easily removed with dropna()
-            identifiers.replace('', nan, inplace=True)
+            identifiers = identifiers.replace('', nan)
             # dropna(how='any'): drop row if one or more row values contain NaN
-            identifiers.dropna(axis=0, how='any', inplace=True)
-            identifiers.drop_duplicates(keep='first', inplace=True, ignore_index=True)
+            identifiers = identifiers.dropna(axis=0, how='any')
+            identifiers = identifiers.drop_duplicates(keep='first', ignore_index=True)
             if get_ricgraph_nodeadd_mode() == 'strict':
                 # Remove rows which have a cell value that occurs more than once.
@@ -342,11 +342,11 @@ def unify_personal_identifiers(personal_identifiers: DataFrame,
                 # For more explanation, see file docs/ricgraph_install_configure.md,
                 # section RICGRAPH_NODEADD_MODE.
                 if column1 != 'FULL_NAME' and column2 != 'FULL_NAME':
-                    identifiers.drop_duplicates(subset=column1, keep=False, inplace=True, ignore_index=True)
-                    identifiers.drop_duplicates(subset=column2, keep=False, inplace=True, ignore_index=True)
+                    identifiers = identifiers.drop_duplicates(subset=column1, keep=False, ignore_index=True)
+                    identifiers = identifiers.drop_duplicates(subset=column2, keep=False, ignore_index=True)
-            identifiers.rename(columns={column1: 'value1',
-                                        column2: 'value2'}, inplace=True)
+            identifiers = identifiers.rename(columns={column1: 'value1',
+                                                      column2: 'value2'})
             new_identifiers_columns = {'name1': column1,
                                        'category1': PERSON_CATEGORY_PERSON,
                                        'name2': column2,

ricgraph 3.3__tar.gz → 3.5__tar.gz

ricgraph 3.3tar.gz → 3.5tar.gz