Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add post on improved GND reconciliation, update full documentation #49

Merged
merged 1 commit into from
Aug 19, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions _layouts/post.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
---
<h1>{{ page.title }}</h1>
<p class="meta">
{{ page.date | date_to_string }}, {{ page.author }}
| <b>&#127991;</b><small>
<small>{{ page.date | date_to_string }}{% if page.updated != null %} &ndash; {{page.updated | date_to_string}}{% endif %}, {{ page.author }}
| <b>&#127991;</b>
{% for tag in page.tags %}
{% capture tag_name %}{{ tag }}{% endcapture %}
<a href="/tags/{{ tag_name }}"><code><nobr>{{ tag_name }}</nobr></code></a>&nbsp;
Expand Down
13 changes: 9 additions & 4 deletions _posts/2018-08-27-openrefine.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
layout: post
title: "GND reconciliation for OpenRefine"
date: 2018-08-27
updated: 2019-08-19
author: Fabian Steeg, Adrian Pohl
tags: lobid-gnd
---
Expand Down Expand Up @@ -46,27 +47,31 @@ Collapse the drawer on the left hand side by clicking the newly added service. A

![7-1](/images/2018-08-27-openrefine/07-type.png)

Optionally, we could reconcile against a type that is not suggested by selecting "Reconcile against type" and specifying the type, e.g. `BuildingOrMemorial`:
Optionally, we could reconcile against a non-default type by typing into the "Reconcile against type" field and selecting one of the suggested types, e.g. `Person`:

![7-2](/images/2018-08-27-openrefine/07-type-custom.png)

For real-world data it can make sense to pass additional data from other columns to improve the reconciliation results (the value in the text box is arbitrary here, but must not be empty):
It can make sense to pass additional data from other columns to improve the reconciliation results. Type in the text fields for each column, and select one of the suggested properties. E.g. use the data from the `beruf` column to search in the `professionOrOccupationAsLiteral` field in the GND:

![8](/images/2018-08-27-openrefine/08-other.png)

After reconciliation, we can inspect not automatically matched candidates by clicking their name:
After reconciliation, we can inspect candidates that have not been automatically matched by clicking or hovering over (depending on your OpenRefine version) their name:

![9](/images/2018-08-27-openrefine/09-candidate.png)

This brings up a preview, with the option to match them:

![10](/images/2018-08-27-openrefine/10-preview.png)

Alternatively, we can search for a match by clicking "Search for match". This brings up a dialog with a text field prefilled with the cell value. Select one of the suggestions to match the cell:

![10](/images/2018-08-27-openrefine/10-search.png)

After matching, we can enrich our data with the reconciled data. We want to add columns based on the reconciled values:

![11](/images/2018-08-27-openrefine/11-add-columns.png)

We can now select the properties we want to add and preview them. Here, we choose `Beruf oder Beschäftigung`, `Geburtsort`, `Sterbeort`, and `Ländercode`:
We can now select the properties we want to add (using the search field and picking one of the suggestions for what we typed, or from the the prefilled list below the search field) and preview them. Here, we choose `Beruf oder Beschäftigung`, `Geburtsort`, `Sterbeort`, and `Ländercode`:

![12](/images/2018-08-27-openrefine/12-add-preview.png)

Expand Down
27 changes: 27 additions & 0 deletions _posts/2019-08-19-openrefine.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
layout: post
title: "Improved GND reconciliation for OpenRefine"
date: 2019-08-19
author: Fabian Steeg
tags: lobid-gnd
---

Triggered by the newly formed [W3C Entity Reconciliation Community Group](https://www.w3.org/community/reconciliation/) and its [reconciliation service test bench](https://reconciliation-api.github.io/testbench/) we have improved our GND reconciliation for OpenRefine by implementing the [OpenRefine suggest API](https://github.com/OpenRefine/OpenRefine/wiki/Suggest-API) for searching types, properties, and entities.

When selecting a custom type in the reconciliation dialog, matching types are suggested:

![7-2](/images/2018-08-27-openrefine/07-type-custom.png)

Data from other columns can be used to improve reconciliation results by selecting a suggested property:

![8](/images/2018-08-27-openrefine/08-other.png)

Candidates can be matched by selecting suggested entities:

![10](/images/2018-08-27-openrefine/10-search.png)

Properties are also suggested when adding columns from reconciled values:

![8](/images/2018-08-27-openrefine/12-add-suggest.png)

For complete usage instructions check out our updated documentation on [GND reconciliation for OpenRefine](http://blog.lobid.org/2018/08/27/openrefine.html).
Binary file modified images/2018-08-27-openrefine/07-type-custom.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/2018-08-27-openrefine/07-type.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/2018-08-27-openrefine/08-other.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/2018-08-27-openrefine/09-candidate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/2018-08-27-openrefine/10-preview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/2018-08-27-openrefine/10-search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/2018-08-27-openrefine/12-add-suggest.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.