From a135528fe62a39c75f5bc773d5122402caf485e6 Mon Sep 17 00:00:00 2001 From: Lennart <163899770+catwolfman@users.noreply.github.com> Date: Tue, 14 Jan 2025 15:37:17 +0100 Subject: [PATCH 1/3] Update preset description --- presets/Bibliometrics-OpenAlex_1_Get_a_single_work.fp4.json | 2 +- presets/Bibliometrics-OpenAlex_2_Get_author.fp4.json | 2 +- presets/Bibliometrics-OpenAlex_3_Get_list_of_authors.fp4.json | 2 +- .../Bibliometrics-OpenAlex_4_Get_list_of_references_.fp4.json | 2 +- ...metrics-OpenAlex_5_Get_list_of_works_by_search_term.fp4.json | 2 +- ...Alex_6_Get_list_of_collaborations_between_countries.fp4.json | 2 +- ...e-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json | 2 +- ...-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json | 2 +- presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json | 2 +- ...aph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json | 2 +- presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json | 2 +- 11 files changed, 11 insertions(+), 11 deletions(-) diff --git a/presets/Bibliometrics-OpenAlex_1_Get_a_single_work.fp4.json b/presets/Bibliometrics-OpenAlex_1_Get_a_single_work.fp4.json index bdc508f9..0452c551 100644 --- a/presets/Bibliometrics-OpenAlex_1_Get_a_single_work.fp4.json +++ b/presets/Bibliometrics-OpenAlex_1_Get_a_single_work.fp4.json @@ -1,7 +1,7 @@ { "name": "OpenAlex 1: Get a single work", "category": "Bibliometrics", - "description": "This preset accompanies our [Getting Started with OpenAlex](https://github.com/strohne/Facepager/wiki/Getting-Started-with-OpenAlex) guide. \n\nIt retrives a number of information about a single scholarly work based on a DOI (e.g., https://doi.org/10.1007/978-3-658-37747-2) as seed node. However, DOIs are not the only option, see [OpenAlex' documentation](https://docs.openalex.org/api-entities/works/work-object#ids) for all possible IDs.\n\nSpecify the *select* parameter to narrow down your query. The preset at hand asks for id, doi, title, publication_year, authorships, and referenced_works of the stated work. \n\nIf you want to fetch other information about a single work such as, for example, the work's citation count, have a look at [OpenAlex's documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", + "description": "This preset retrives a number of information about a single scholarly work from OpenAlex. To start add a DOI URL (e.g., https://doi.org/10.1007/978-3-658-37747-2) as a seed node. DOIs are not the only option, see [OpenAlex' documentation](https://docs.openalex.org/api-entities/works/work-object#ids) for all possible IDs. Once seed nodes are in place fetch data. \n\nSpecify the *select* parameter to narrow down your query. The preset at hand asks for id, doi, title, publication_year, authorships, and referenced_works of the stated work. \n\nIf you want to fetch other information about a single work such as, for example, the work's citation count, have a look at [OpenAlex's documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. \n\nSee our [Getting Started with OpenAlex](https://github.com/strohne/Facepager/wiki/Getting-Started-with-OpenAlex) for a full walk through this preset. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/Bibliometrics-OpenAlex_2_Get_author.fp4.json b/presets/Bibliometrics-OpenAlex_2_Get_author.fp4.json index ed11b913..121bb197 100644 --- a/presets/Bibliometrics-OpenAlex_2_Get_author.fp4.json +++ b/presets/Bibliometrics-OpenAlex_2_Get_author.fp4.json @@ -1,7 +1,7 @@ { "name": "OpenAlex 2: Get author", "category": "Bibliometrics", - "description": "[OpenAlex](https://openalex.org/about) is a free and open online repository of the world's research system maintained by the nonprofit [OurResearch](https://ourresearch.org/). It includes scholarly works, authors, sources, concepts, institutions, publishers, funders, their interconnections, and all kinds of metadata about each. The project aims to create an universal collection and index of scholarship. Notably, due to its open-source nature, OpenAlex requires no user nor institutional authentication.\n\nApply this preset, if you are interested in getting detailed information about an author. For detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, the *select* parameter determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, orcid, display_name, works_count, cited_by_count, and last_known_institution of the stated author. Check out [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) to get an overview over the broad range of options.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box either add an OpenAlex ID (e.g. A5088931518) or external IDs such as ORCID (e.g. https://orcid.org/0000-0003-1860-6695 or in URN format orcid:0000-0003-1860-6695), ScopusID, Twitter, or Wikipedia. Check [OpenAlex' documentation](https://docs.openalex.org/api-entities/authors/author-object#ids) for an up-to-date list of all possibilities. Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to fetch other information about an author such as, for example, the author's citation metrics or institution, have a look at [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) and adjust the *select* parameter in the Query Setup accordingly.\n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for OpenAlex Premium. ", + "description": "This preset fetches detailed information about an author from OpenAlex. To start add an OpenAlex author ID (e.g. A5088931518) or external IDs such as ORCID (e.g. https://orcid.org/0000-0003-1860-6695) as a seed note. Then fetch data. \n\nFor detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, the *select* parameter determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, orcid, display_name, works_count, cited_by_count, and last_known_institution of the stated author. Check out [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) to get an overview over the broad range of options.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box either add an OpenAlex ID (e.g. A5088931518) or external IDs such as ORCID (e.g. https://orcid.org/0000-0003-1860-6695 or in URN format orcid:0000-0003-1860-6695), ScopusID, Twitter, or Wikipedia. Check [OpenAlex' documentation](https://docs.openalex.org/api-entities/authors/author-object#ids) for an up-to-date list of all possibilities. Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to fetch other information about an author such as, for example, the author's citation metrics or institution, have a look at [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) and adjust the *select* parameter in the Query Setup accordingly.\n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for OpenAlex Premium. ", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/Bibliometrics-OpenAlex_3_Get_list_of_authors.fp4.json b/presets/Bibliometrics-OpenAlex_3_Get_list_of_authors.fp4.json index f1a25ab3..400cc458 100644 --- a/presets/Bibliometrics-OpenAlex_3_Get_list_of_authors.fp4.json +++ b/presets/Bibliometrics-OpenAlex_3_Get_list_of_authors.fp4.json @@ -1,7 +1,7 @@ { "name": "OpenAlex 3: Get list of authors", "category": "Bibliometrics", - "description": "[OpenAlex](https://openalex.org/about) is a free and open online repository of the world's research system maintained by the nonprofit [OurResearch](https://ourresearch.org/). It includes scholarly works, authors, sources, concepts, institutions, publishers, funders, their interconnections, and all kinds of metadata about each. The project aims to create an universal collection and index of scholarship. Notably, due to its open-source nature, OpenAlex requires no user nor institutional authentication.\n\nApply this preset, to fetch a list of authors filtered by the name of their last known institution. For detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, you will find a couple of pre-configured parameters: \n\t- The *filter* parameter filters the results returned from your query according to your seed node. \n\t- *Per-page* sets how many results are returned for each page. To understand paging and how Facepager builds on-top, revisit [Facepager's basic concepts](https://github.com/strohne/Facepager/wiki/Basic-Concepts). Up the number to fetch more results.\n\t- *Select* determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, orcid, display_name, works_count, and cited_by_count of all authors associated with the stated institution. Check out [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) to get an overview over all options.\n\t- Lastly, the *sort* parameter dictates the order in which the results will appear. In the case at hand we decided to sort them descending by their citation count. Of course that is only one way to arrange the results. Refer to [OpenAlex' documentation](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists) to learn about your options.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. While the query is based on an OpenAlexID referencing an institution and you can insert one as usual, you do have the chance to repurpose the preset \"OpenAlex 2: Get author\" by leveraging Facepagers *Response* feature as well (scroll down further to learn about a user-friendlier workflow available on Windows only at the moment). To do so, first apply the \u201cOpenAlex: Get author\u201d preset. In the Query Setup set last_known_institution as *Key to extract* and id *Key for Object ID*. Hit *Fetch Data* once more. Note that your query returns a new node containing an OpenAlexID referencing the last known institution of your stated author. Now, apply the \"OpenAlex: Get list of authors\" preset again, select the newly created seed node and retrieve all authors affiliated with the institution. \n**(For Windows users only)** Alternatively use the user-friendly *Transfer nodes*. First apply the \u201cOpenAlex: Get author\u201d preset and fetch data. Next, select *Transfer nodes* and set last_known_institution.id as *Extraction key*. By applying this feature Facepager will automatically generate a new seed node containing an OpenAlexID referencing the last known institution of your stated author. Apply the \"OpenAlex: Get list of authors\" preset again, select the newly created seed node and fetch all authors affiliated with the institution.\nShould you want to add nodes conventionally, simply select *Add Nodes* in the Menu Bar. In the open dialogue box add any OpenAlexID referencing an institution (e.g., I22465464). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to include other information in your list of authors related through their last know institution, have a look at [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) and adjust the *select* parameter in the Query Setup accordingly.\n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for OpenAlex Premium. ", + "description": "This preset fetches a list of authors filtered by the name of their last known institution from OpenAlex. To start add an OpenAlex institution ID (e.g. I22465464) as a seed note. Then fetch data. \n\nFor detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, you will find a couple of pre-configured parameters: \n\t- The *filter* parameter filters the results returned from your query according to your seed node. \n\t- *Per-page* sets how many results are returned for each page. To understand paging and how Facepager builds on-top, revisit [Facepager's basic concepts](https://github.com/strohne/Facepager/wiki/Basic-Concepts). Up the number to fetch more results.\n\t- *Select* determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, orcid, display_name, works_count, and cited_by_count of all authors associated with the stated institution. Check out [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) to get an overview over all options.\n\t- Lastly, the *sort* parameter dictates the order in which the results will appear. In the case at hand we decided to sort them descending by their citation count. Of course that is only one way to arrange the results. Refer to [OpenAlex' documentation](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists) to learn about your options.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. While the query is based on an OpenAlexID referencing an institution and you can insert one as usual, you do have the chance to repurpose the preset \"OpenAlex 2: Get author\" by leveraging Facepagers *Response* feature as well (scroll down further to learn about a user-friendlier workflow available on Windows only at the moment). To do so, first apply the \u201cOpenAlex: Get author\u201d preset. In the Query Setup set last_known_institution as *Key to extract* and id *Key for Object ID*. Hit *Fetch Data* once more. Note that your query returns a new node containing an OpenAlexID referencing the last known institution of your stated author. Now, apply the \"OpenAlex: Get list of authors\" preset again, select the newly created seed node and retrieve all authors affiliated with the institution. \n**(For Windows users only)** Alternatively use the user-friendly *Transfer nodes*. First apply the \u201cOpenAlex: Get author\u201d preset and fetch data. Next, select *Transfer nodes* and set last_known_institution.id as *Extraction key*. By applying this feature Facepager will automatically generate a new seed node containing an OpenAlexID referencing the last known institution of your stated author. Apply the \"OpenAlex: Get list of authors\" preset again, select the newly created seed node and fetch all authors affiliated with the institution.\nShould you want to add nodes conventionally, simply select *Add Nodes* in the Menu Bar. In the open dialogue box add any OpenAlexID referencing an institution (e.g., I22465464). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to include other information in your list of authors related through their last know institution, have a look at [OpenAlex' documentation on author-objects](https://docs.openalex.org/api-entities/authors/author-object) and adjust the *select* parameter in the Query Setup accordingly.\n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for OpenAlex Premium. ", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/Bibliometrics-OpenAlex_4_Get_list_of_references_.fp4.json b/presets/Bibliometrics-OpenAlex_4_Get_list_of_references_.fp4.json index 56a4fdbf..ab31cd19 100644 --- a/presets/Bibliometrics-OpenAlex_4_Get_list_of_references_.fp4.json +++ b/presets/Bibliometrics-OpenAlex_4_Get_list_of_references_.fp4.json @@ -1,7 +1,7 @@ { "name": "OpenAlex 4: Get list of references ", "category": "Bibliometrics", - "description": "[OpenAlex](https://openalex.org/about) is a free and open online repository of the world's research system maintained by the nonprofit [OurResearch](https://ourresearch.org/). It includes scholarly works, authors, sources, concepts, institutions, publishers, funders, their interconnections, and all kinds of metadata about each. The project aims to create an universal collection and index of scholarship. Notably, due to its open-source nature, OpenAlex requires no user nor institutional authentication.\n\nApply this preset, to fetch a list of references of one or more scholarly works. For detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, the *select* parameter determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, doi, title, display_name, publication_year, and, of course, the referenced_works of the stated work. Check out [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) to get learn about further accessible data.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box add an OpenAlexID referencing a work (e.g., W2957825729). OpenAlexIDs are not your only option. Alternatively, insert a DOI, MAG (Microsoft Academic Graph), Pubmed Identifier, or Pubmed Central Identifier. Find an always up-to-date list of all possible identifiers at [OpenAlex' documentation](https://docs.openalex.org/api-entities/works/work-object#ids). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to fetch other information, have a look at [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. To snowball, select all child nodes of your seed node and rerun the query. Repeat this as many times as like, just keep the daily API limit in mind. To obtain the metadata of any reference, apply the \"OpenAlex: Get a single work\" preset from the [first tutorial](https://github.com/strohne/Facepager/wiki/Getting-Started-with-OpenAlex#tutorial-1-get-a-single-work), select the node(s) of interest, and hit *Fetch data* once more. \n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", + "description": "This preset fetches a list of references of one or more scholarly works from OpenAlex. To start add an OpenAlex work ID (e.g. W2957825729)) as a seed note. Then fetch data. \n\nFor detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, the *select* parameter determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, doi, title, display_name, publication_year, and, of course, the referenced_works of the stated work. Check out [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) to get learn about further accessible data.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box add an OpenAlexID referencing a work (e.g., W2957825729). OpenAlexIDs are not your only option. Alternatively, insert a DOI, MAG (Microsoft Academic Graph), Pubmed Identifier, or Pubmed Central Identifier. Find an always up-to-date list of all possible identifiers at [OpenAlex' documentation](https://docs.openalex.org/api-entities/works/work-object#ids). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to fetch other information, have a look at [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. To snowball, select all child nodes of your seed node and rerun the query. Repeat this as many times as like, just keep the daily API limit in mind. To obtain the metadata of any reference, apply the \"OpenAlex: Get a single work\" preset from the [first tutorial](https://github.com/strohne/Facepager/wiki/Getting-Started-with-OpenAlex#tutorial-1-get-a-single-work), select the node(s) of interest, and hit *Fetch data* once more. \n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/Bibliometrics-OpenAlex_5_Get_list_of_works_by_search_term.fp4.json b/presets/Bibliometrics-OpenAlex_5_Get_list_of_works_by_search_term.fp4.json index 737c5143..3c515079 100644 --- a/presets/Bibliometrics-OpenAlex_5_Get_list_of_works_by_search_term.fp4.json +++ b/presets/Bibliometrics-OpenAlex_5_Get_list_of_works_by_search_term.fp4.json @@ -1,7 +1,7 @@ { "name": "OpenAlex 5: Get list of works by search term", "category": "Bibliometrics", - "description": "[OpenAlex](https://openalex.org/about) is a free and open online repository of the world's research system maintained by the nonprofit [OurResearch](https://ourresearch.org/). It includes scholarly works, authors, sources, concepts, institutions, publishers, funders, their interconnections, and all kinds of metadata about each. The project aims to create an universal collection and index of scholarship. Notably, due to its open-source nature, OpenAlex requires no user nor institutional authentication.\n\nApply this preset, to retrieve a list of scholarly works by setting one or more arbitrary search terms as seed nodes. For detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, you will find a couple of pre-configured parameters: \n\t- *Per-page* sets how many results are returned for each page. To understand paging and how Facepager builds on-top, revisit [Facepager's basic concepts](https://github.com/strohne/Facepager/wiki/Basic-Concepts). Up the number to fetch more results. Mind, however, that calling for works based on one or more search terms, depending on the term, the number of returns can potentially skyrocket. \n\t- *Search* serves as the placeholder for your Object ID or search term respectively. The query thus prompts OpenAlex' API to return any work that contains your Object ID in its title, abstract, or even full-text. \n\t- *Select* determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, doi, title, authorships, referenced_works, and publication_year of all returned works associated with the search term. Check out [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) to get an overview over all options.\n\t- Lastly, the *sort* parameter dictates the order in which the results will appear. In the case at hand their order will be decided by their publication year. Of course that is only one way to arrange the results. Refer to [OpenAlex' documentation](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists) to learn about your options.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box add one or more arbitrary search terms (e.g., computational methods). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to include other information in your list of authors related through their last know institution, have a look at [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. For now, the query will return a list of works each designated by its unique OpenAlexID. To obtain the metadata of any of the works, apply the \"OpenAlex: Get a single work\" preset, select the node(s) of interest, and hit *Fetch data* once more. \n5. **Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", + "description": "This preset retrieves a list of scholarly works from OpenAlex. To start set one or more arbitrary search terms (e.g. Computational Methods) as seed nodes. Then fetch data. \n\nFor detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, you will find a couple of pre-configured parameters: \n\t- *Per-page* sets how many results are returned for each page. To understand paging and how Facepager builds on-top, revisit [Facepager's basic concepts](https://github.com/strohne/Facepager/wiki/Basic-Concepts). Up the number to fetch more results. Mind, however, that calling for works based on one or more search terms, depending on the term, the number of returns can potentially skyrocket. \n\t- *Search* serves as the placeholder for your Object ID or search term respectively. The query thus prompts OpenAlex' API to return any work that contains your Object ID in its title, abstract, or even full-text. \n\t- *Select* determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, doi, title, authorships, referenced_works, and publication_year of all returned works associated with the search term. Check out [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) to get an overview over all options.\n\t- Lastly, the *sort* parameter dictates the order in which the results will appear. In the case at hand their order will be decided by their publication year. Of course that is only one way to arrange the results. Refer to [OpenAlex' documentation](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists) to learn about your options.\n**3. Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box add one or more arbitrary search terms (e.g., computational methods). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to include other information in your list of authors related through their last know institution, have a look at [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. For now, the query will return a list of works each designated by its unique OpenAlexID. To obtain the metadata of any of the works, apply the \"OpenAlex: Get a single work\" preset, select the node(s) of interest, and hit *Fetch data* once more. \n5. **Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/Bibliometrics-OpenAlex_6_Get_list_of_collaborations_between_countries.fp4.json b/presets/Bibliometrics-OpenAlex_6_Get_list_of_collaborations_between_countries.fp4.json index 013dca5b..9efa6991 100644 --- a/presets/Bibliometrics-OpenAlex_6_Get_list_of_collaborations_between_countries.fp4.json +++ b/presets/Bibliometrics-OpenAlex_6_Get_list_of_collaborations_between_countries.fp4.json @@ -1,7 +1,7 @@ { "name": "OpenAlex 6: Get list of collaborations between countries", "category": "Bibliometrics", - "description": "[OpenAlex](https://openalex.org/about) is a free and open online repository of the world's research system maintained by the nonprofit [OurResearch](https://ourresearch.org/). It includes scholarly works, authors, sources, concepts, institutions, publishers, funders, their interconnections, and all kinds of metadata about each. The project aims to create an universal collection and index of scholarship. Notably, due to its open-source nature, OpenAlex requires no user nor institutional authentication.\n\nApply this preset, to retrieve a list of scholarly works based on one or more arbitrary search terms refined by the use of geographical filters. For detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, you will find a couple of pre-configured parameters: \n\t- *Filter* allows to specify the geographical filter. For more geographical filter options than the one presented here, see [OpenAlex' Geo documentation](https://docs.openalex.org/api-entities/geo). Or head to [OpenAlex' documentation about Filter entity lists](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/filter-entity-lists) to find all possible filter options.\n\t- *Per-page* sets how many results are returned for each page. To understand paging and how Facepager builds on-top, revisit [Facepager's basic concepts](https://github.com/strohne/Facepager/wiki/Basic-Concepts). Up the number to fetch more results. Mind, however, that calling for works based on one or more search terms, depending on the term, the number of returns can potentially skyrocket. Though, our query returns less than a 100 results.\n\t- *Search* serves as the placeholder for your Object ID or search term respectively. The query thus prompts OpenAlex' API to return any work that contains your Object ID in its title, abstract, or even full-text. \n\t- *Select* determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, doi, title, authorships, referenced_works, and publication_year of all returned works associated with the search term. Check out [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) to get an overview over all options.\n\t- The *sort* parameter, finally, dictates the order in which the results will appear. In the case at hand their order will be decided by their publication date. Of course that is only one way to arrange the results. Refer to [OpenAlex' documentation](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists) to learn about your options.\n3. **Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box add one or more arbitrary search terms (e.g., colonialism). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to fetch other information than what we display here, have a look at [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. For now, the query will return scholarly works that at least one author from a Brazilian institution as well as at least one author from a Portuguese institution has contributed to. To obtain the metadata of any of the works, apply the \"OpenAlex: Get a single work\" preset, select the node(s) of interest, and hit *Fetch data* once more. \n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", + "description": "This preset retrieves a list of scholarly works based on one or more arbitrary search terms refined by the use of geographical filters from OpenAlex. This preset displays an advanced use case. For detailed instructions, see the step-by-step guide below.\n\n**1. Create a database:** Click *New Database* in the [Menu Bar](https://github.com/strohne/Facepager/wiki/Layout#menu-bar) of Facepager to create a blank database. Save it in a directory of your choice.\n**2. Setup the Generic module:** Apply the preset at hand. The [Generic module](https://github.com/strohne/Facepager/wiki/Query-Setup.-Generic) in the [Query Setup](https://github.com/strohne/Facepager/wiki/Layout#query-setup) will refresh automatically. Notice that the base path is now set to call OpenAlex' API and a node placeholder has been installed. Additionally, you will find a couple of pre-configured parameters: \n\t- *Filter* allows to specify the geographical filter. For more geographical filter options than the one presented here, see [OpenAlex' Geo documentation](https://docs.openalex.org/api-entities/geo). Or head to [OpenAlex' documentation about Filter entity lists](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/filter-entity-lists) to find all possible filter options.\n\t- *Per-page* sets how many results are returned for each page. To understand paging and how Facepager builds on-top, revisit [Facepager's basic concepts](https://github.com/strohne/Facepager/wiki/Basic-Concepts). Up the number to fetch more results. Mind, however, that calling for works based on one or more search terms, depending on the term, the number of returns can potentially skyrocket. Though, our query returns less than a 100 results.\n\t- *Search* serves as the placeholder for your Object ID or search term respectively. The query thus prompts OpenAlex' API to return any work that contains your Object ID in its title, abstract, or even full-text. \n\t- *Select* determines what information Facepager will fetch from OpenAlex. Specify the input to narrow down your query. The preset at hand asks for id, doi, title, authorships, referenced_works, and publication_year of all returned works associated with the search term. Check out [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) to get an overview over all options.\n\t- The *sort* parameter, finally, dictates the order in which the results will appear. In the case at hand their order will be decided by their publication date. Of course that is only one way to arrange the results. Refer to [OpenAlex' documentation](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/sort-entity-lists) to learn about your options.\n3. **Add nodes:** Before fetching data, you will need to provide one or more seed nodes which will fill in said placeholder later on. For this, select *Add Nodes* in the Menu Bar. In the open dialogue box add one or more arbitrary search terms (e.g., colonialism). Include as many nodes as you like here.\n**4. Fetch data:** Select one or more seed nodes and hit *Fetch Data* at the bottom of the Query Setup afterwards. Facepager will now fetch data on the basis of your setup. Once finished, you can inspect the data by expanding your seed node or clicking *Expand nodes* in the Menu Bar. For more detail, select a child node and review the raw data displayed in the [Data View](https://github.com/strohne/Facepager/wiki/Layout#data-view) to the right. If you want to fetch other information than what we display here, have a look at [OpenAlex' documentation on work-objects](https://docs.openalex.org/api-entities/works/work-object) and adjust the *select* parameter in the Query Setup accordingly. For now, the query will return scholarly works that at least one author from a Brazilian institution as well as at least one author from a Portuguese institution has contributed to. To obtain the metadata of any of the works, apply the \"OpenAlex: Get a single work\" preset, select the node(s) of interest, and hit *Fetch data* once more. \n**5. Export data:** Expand all nodes and select the ones you want to export. Hit [*Export Data*](https://github.com/strohne/Facepager/wiki/Export-Data) to get a CSV-file. Notice the options provided by the export dialogue. You can open CSV files with Excel or any statistics software you like. \n\nPlease note that each user is allowed a maximum of 100,000 API calls per day and 10 API calls per second. If you need a higher limit, you can register for [OpenAlex Premium](https://openalex.org/pricing).", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json b/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json index 6e683ffd..ac97d15f 100644 --- a/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json +++ b/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json @@ -1,7 +1,7 @@ { "name": "NFDI4Culture: 1 Get GND IDs of Ferdinand Gregorovius' addressees", "category": "Knowledge Graph", - "description": "This preset accompanies our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) guide. \n\nIt retrives GND IDs of Ferdinand Gregorovius' addressees based on years as seed nodes. At the heart of the preset lies a SPARQL query. Making an effort to learn the basics of SPARQL's syntax will allow you to literally understand any such query and, more crucially, let's you write your own queries, thus empowering you to answer (research) questions of your interest. A great resources to start with is, for example, [Wikidata's introduction to SPARQL](https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial). For now, it will suffice to understand that the query returns the url, label, and date of any letter Gregorovius wrote during the specfied year as well as the GND IDs of all persons addressed or mention in each letter.\n\n**DISCLAIMER:** The Culture Knowledge Graph is work in progress. Currently, only a handful of datasets are accessible through its SPARQL endpoint using the NFDI4Culture Ontology. The User-Policy and guidelines of the Culture Knowledge Graph are being worked on as well. For the time being we advise you to be mindful of potential query limits.", + "description": "This preset retrieves GND IDs of Ferdinand Gregorovius' addressees from the Culture Knowledge Graph. To start add a year (e.g. 1851) as a seed node. Then fetch data. \n\nAt the heart of the preset lies a SPARQL query. Making an effort to learn the basics of SPARQL's syntax will allow you to literally understand any such query and, more crucially, let's you write your own queries, thus empowering you to answer (research) questions of your interest. A great resources to start with is, for example, [Wikidata's introduction to SPARQL](https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial). For now, it will suffice to understand that the query returns the url, label, and date of any letter Gregorovius wrote during the specified year as well as the GND IDs of all persons addressed or mention in each letter. \n\nSee our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) for a full and beginner friendly walk through this preset. \n\n**DISCLAIMER:** The Culture Knowledge Graph is work in progress. Currently, only a handful of datasets are accessible through its SPARQL endpoint using the NFDI4Culture Ontology. The User-Policy and guidelines of the Culture Knowledge Graph are being worked on as well. For the time being we advise you to be mindful of potential query limits.", "module": "Generic", "options": { "basepath": "https://nfdi4culture.de", diff --git a/presets/KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json b/presets/KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json index 21df116e..a64dfa75 100644 --- a/presets/KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json +++ b/presets/KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json @@ -1,7 +1,7 @@ { "name": "NFDI4Culture: 2 Translate GND ID to a person's name (Entity Facts API; German National Library)", "category": "Knowledge Graph", - "description": "This preset accompanies our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) guide. \n\nIt translates the GND IDs of Ferdinand Gregorovius' addressees from the first preset into the persons' preferred names (from a historic perspective) for further use. Generally, you can use this preset to obtain any data accessible through the [Entity Facts API](https://www.dnb.de/EN/Professionell/Metadatendienste/Datenbezug/Entity-Facts/entityFacts_node.html#doc250704bodyText8) of the German National Library. To get an overview of the possibilities, please, refer to the [library's online sheet](https://wiki.dnb.de/pages/viewpage.action?pageId=134055670).\n\nPlease, mind the German National Library's [Terms of Use](https://www.dnb.de/EN/Professionell/Metadatendienste/Datenbezug/geschaeftsmodell.html).", + "description": "This preset builds upon the first NFDI4Culture preset. It translates the resulting GND IDs of Ferdinand Gregorovius' addressees into the persons' preferred names (from a historic perspective) for further use. Generally, you can use this preset to obtain any data accessible through the [Entity Facts API](https://www.dnb.de/EN/Professionell/Metadatendienste/Datenbezug/Entity-Facts/entityFacts_node.html#doc250704bodyText8) of the German National Library. To get an overview of the possibilities, please, refer to the [library's online sheet](https://wiki.dnb.de/pages/viewpage.action?pageId=134055670). \n\nSee our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) for a full walk through this preset. \n\nPlease, mind the German National Library's [Terms of Use](https://www.dnb.de/EN/Professionell/Metadatendienste/Datenbezug/geschaeftsmodell.html).", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json b/presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json index bc770fda..b1a56e5d 100644 --- a/presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json +++ b/presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json @@ -1,7 +1,7 @@ { "name": "SemOpenAlex: Get a single work", "category": "Knowledge Graph", - "description": "This SemOpenAlex preset poses an alternative to fetching data from OpenAlex's API using SPARQL instead. In terms of what information will be fetched, it mirrors the \"OpenAlex 1: Get a single work\" preset (not all information is readily available yet, see the SPARQL query for details).\n\n[SemOpenAlex](https://semopenalex.org/resource/semopenalex:UniversalSearch) is built upon [OpenAlex](https://openalex.org/about) and contains the same comprehensive information on scholarly works and related entities, such as authors, sources, etc.. It can practically be understood as a semantic extension of OpenAlex and aims at making the shared data base more accessible for use in semantic web technologies and linked open data applications. For this purpose, it offers an URI Resolution as well as a [SPARQL endpoint](https://semopenalex.org/sparql) available through the [SemOpenAlex Ontology](https://semopenalex.org/resource/?uri=https://semopenalex.org/ontology/).\n\nApply this preset if you are interested in using SemOpenAlex's SPARQL endpoint to retrieve a range of information about scholarly works based on its title (e.g., \"Computational Methods f\u00fcr die Sozial- und Geisteswissenschaften\"). Although featured in SemOpenAlex's Ontology, finding scholarly works by their DOI does not work yet. Should no result return, always check if any of the data you are intereseted in is not available on SemOpenAlex. For other (more complex) queries, please, see [SemOpenAlex's SPARQL examples](https://semopenalex.org/resource/semopenalex:About).\n\nTo learn more about the basic usage of SPARQL and its semantic structure, please, see our [Getting Started with Wikidata](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata) where we dedicated a whole chapter to a SPARQL introduction. Or have a look into [SemOpenAlex's own documentation](https://semopenalex.org/resource/Help:WorkingWithData#querying-retrieving-data).", + "description": "This preset retrieves a range of information about scholarly works from SemOpenAlex' SPARQL endpoint. To start create seed nodes containing a work's title (e.g., \"Computational Methods für die Sozial- und Geisteswissenschaften\"). Then fetch data. \n\nThis SemOpenAlex preset poses an alternative to fetching data from OpenAlex's API using SPARQL instead. In terms of what information will be fetched, it mirrors the \"OpenAlex 1: Get a single work\" preset (not all information is readily available yet, see the SPARQL query for details).\n\n[SemOpenAlex](https://semopenalex.org/resource/semopenalex:UniversalSearch) is built upon [OpenAlex](https://openalex.org/about) and contains the same comprehensive information on scholarly works and related entities, such as authors, sources, etc. It can practically be understood as a semantic extension of OpenAlex and aims at making the shared data base more accessible for use in semantic web technologies and linked open data applications. For this purpose, it offers an URI Resolution as well as a [SPARQL endpoint](https://semopenalex.org/sparql) available through the [SemOpenAlex Ontology](https://semopenalex.org/resource/?uri=https://semopenalex.org/ontology/). \n\nAlthough featured in SemOpenAlex's Ontology, finding scholarly works by their DOI does not work yet. Should no result return, always check the availability of the data you are interested in on SemOpenAlex. For other (more complex) queries, please, see [SemOpenAlex's SPARQL examples](https://semopenalex.org/resource/semopenalex:About).\n\nTo learn more about the basic usage of SPARQL and its semantic structure, please, see our [Getting Started with SPARQL](https://github.com/strohne/Facepager/wiki/Getting-Started-with-SPARQL). Alternatively have a look into [SemOpenAlex's own documentation](https://semopenalex.org/resource/Help:WorkingWithData#querying-retrieving-data).", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json b/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json index cc3cc63e..08de7766 100644 --- a/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json +++ b/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json @@ -1,7 +1,7 @@ { "name": "Wikidata: Get gender of solo artist/band members", "category": "Knowledge Graph", - "description": "This preset fetches a list of muscial artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". The query automatically extracts names of band members and their respective on the basis of the group's name, e.g. \"Coldplay\". \n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", + "description": "This preset fetches a list of muscial artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". Then fetch data. \n\nThe query automatically extracts names of band members on the basis of the group's name, e.g. \"Coldplay\". \n\nSee our [Getting Started with Wikidata (artists gender)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(artists-gender)) for a full walk through this preset.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", "module": "Generic", "options": { "auth": "disable", diff --git a/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json b/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json index e74b6314..a6c3292e 100644 --- a/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json +++ b/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json @@ -1,7 +1,7 @@ { "name": "Wikidata: Writers Network", "category": "Knowledge Graph", - "description": "This preset accompanies the [Getting Started with Wikidata](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata) tutorial. It fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitary literary movement as seed node, e.g. \"Q37068\" for romanticism.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.\n", + "description": "This preset fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitrary literary movement as seed node, e.g. \"Q37068\" for romanticism. Then fetch data. \n\nSee our [Getting Started with Wikidata (writers network)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(writers-network)) for a full walk through this preset.\n\nCheck https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.\n", "module": "Generic", "options": { "auth": "disable", From e05ce8c441d2c957ca53a98e593f3119ca6c7be9 Mon Sep 17 00:00:00 2001 From: Lennart <163899770+catwolfman@users.noreply.github.com> Date: Tue, 14 Jan 2025 17:33:39 +0100 Subject: [PATCH 2/3] Update preset descriptions and delete outdated presets --- ...cientists_who_have_birthday_today.3_9.json | 25 ---------- ..._Ferdinand_Gregorovius_addressees.fp4.json | 47 ------------------ ...ender_of_solo_artist_band_members.fp4.json | 43 ----------------- ...a-Get_list_of_biblical_characters.fp4.json | 48 ------------------- ...ns_did_not_die_on_natural_causes_.fp4.json | 45 ----------------- ...dgeGraph-Wikidata-Writers_Network.fp4.json | 48 ------------------- ...cientists_who_have_birhtday_today.fp4.json | 44 +++++++++++++++++ ...ave_birhtday_today_SPARQL_Module_.fp4.json | 44 ----------------- ...erdinand_Gregorovius_s_addressees.fp4.json | 43 +++++++++++++++++ ...ovius_s_addressees_SPARQL_module_.fp4.json | 43 ----------------- ...nslate_GND_ID_to_a_person_s_name.fp4.json} | 0 ...ph-SemOpenAlex_Get_a_single_work.fp4.json} | 0 ...nder_of_solo_artist_band_members.fp4.json} | 6 +-- ..._Get_list_of_biblical_characters.fp4.json} | 14 +++--- ...ns_did_not_die_on_natural_causes.fp4.json} | 6 +-- ...e_Graph-Wikidata_Writers_Network.fp4.json} | 6 +-- 16 files changed, 103 insertions(+), 359 deletions(-) delete mode 100644 presets/KnowledgeGraph-DBPedia-Scientists_who_have_birthday_today.3_9.json delete mode 100644 presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json delete mode 100644 presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json delete mode 100644 presets/KnowledgeGraph-Wikidata-Get_list_of_biblical_characters.fp4.json delete mode 100644 presets/KnowledgeGraph-Wikidata-Which_politicians_did_not_die_on_natural_causes_.fp4.json delete mode 100644 presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json create mode 100644 presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today.fp4.json delete mode 100644 presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today_SPARQL_Module_.fp4.json create mode 100644 presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees.fp4.json delete mode 100644 presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees_SPARQL_module_.fp4.json rename presets/{KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json => Knowledge_Graph-NFDI4Culture_2_Translate_GND_ID_to_a_person_s_name.fp4.json} (100%) rename presets/{KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json => Knowledge_Graph-SemOpenAlex_Get_a_single_work.fp4.json} (100%) rename presets/{Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members_SPARQL_module_.fp4.json => Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json} (52%) rename presets/{Knowledge_Graph-Wikidata_Get_list_of_biblical_characters_SPARQL_module_.fp4.json => Knowledge_Graph-Wikidata_Get_list_of_biblical_characters.fp4.json} (54%) rename presets/{Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes_SPARQL_module_.fp4.json => Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes.fp4.json} (64%) rename presets/{Knowledge_Graph-Wikidata_Writers_Network_SPARQL_module_.fp4.json => Knowledge_Graph-Wikidata_Writers_Network.fp4.json} (50%) diff --git a/presets/KnowledgeGraph-DBPedia-Scientists_who_have_birthday_today.3_9.json b/presets/KnowledgeGraph-DBPedia-Scientists_who_have_birthday_today.3_9.json deleted file mode 100644 index 60f5e4f2..00000000 --- a/presets/KnowledgeGraph-DBPedia-Scientists_who_have_birthday_today.3_9.json +++ /dev/null @@ -1,25 +0,0 @@ -{ - "description": "Get the names, descriptions, birthdays and if available thumbnail images of scientists who have birthday today. The results are limited to English and to the 10 oldest scientists. This preset is compatible with Facepager v3.9.2 or newer. \n\nAdd an arbitrary node and fetch data. The node name doesn't matter as it is not used in the query. Suggestion: add dates as node names and adjust the query to get scientists who have birthday at a specific date.\n\nDBPedia is like Wikidata a semantic web version of Wikipedia. On the semantic web data is organizied according to the Resource Decription Framework (RDF). The preset retrieves data from the SPARQL endpoint of DBPedia. DBPedia mainly consists of content scrapted from the info boxes of Wikipedia. With limiting to english names and descriptions the results should reflect the English Wikipedia.\n\nSee https://wiki.dbpedia.org/ for details about DBPedia. If you are not familiar with semantic web technology consider reading Wikipedia articles about the Resource Description Framework and about SPARQL.\n\nThe example query was taken from an OpenHPI course: https://open.hpi.de/courses/semanticweb2017/\n\nPay attention on how the SPARQL query is formulated. Since angle brackets signify placeholders in Facepager they have to be masked with a backslash. If you need a backslash in your query, mask it by another backslash. To use the name of a node or data of previously fetched nodes in your query user placeholders (see the Facepager help).\n", - "module": "Generic", - "category": "Knowledge Graph", - "speed": 200, - "options": { - "resource": "/sparql", - "objectid": "scientist.value", - "basepath": "http://dbpedia.org", - "headers": {}, - "params": { - "default-graph-uri": "http://dbpedia.org", - "query": "PREFIX rdf: \\\nPREFIX dbo: \\\nPREFIX rdfs: \\\nPREFIX dc: \\\n\nSelect distinct ?birthdate ?thumbnail ?scientist ?name ?description WHERE {\n?scientist rdf:type dbo:Scientist ;\n dbo:birthDate ?birthdate ;\n rdfs:label ?name ;\n rdfs:comment ?description \n FILTER ((lang(?name)=\"en\")&&(lang(?description)=\"en\")&&(STRLEN(STR(?birthdate))>6)&&(SUBSTR(STR(?birthdate),6)=SUBSTR(STR(bif:curdate('')),6))) .\n OPTIONAL { ?scientist dbo:thumbnail ?thumbnail . }\n} ORDER BY ?birthdate LIMIT 10", - "format": "application/sparql-results+json" - }, - "nodedata": "results.bindings" - }, - "columns": [ - "name.value", - "description.value", - "birthdate.value", - "thumbnail.value" - ], - "name": "Scientists who have birthday today" -} diff --git a/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json b/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json deleted file mode 100644 index b9a0172b..00000000 --- a/presets/KnowledgeGraph-NFDI4Culture-1_Get_GND_IDs_of_Ferdinand_Gregorovius_addressees.fp4.json +++ /dev/null @@ -1,47 +0,0 @@ -{ - "name": "NFDI4Culture: 1 Get GND IDs of Ferdinand Gregorovius' addressees", - "category": "Knowledge Graph", - "description": "This preset retrieves GND IDs of Ferdinand Gregorovius' addressees from the Culture Knowledge Graph. To start add a year (e.g. 1851) as a seed node. Then fetch data. \n\nAt the heart of the preset lies a SPARQL query. Making an effort to learn the basics of SPARQL's syntax will allow you to literally understand any such query and, more crucially, let's you write your own queries, thus empowering you to answer (research) questions of your interest. A great resources to start with is, for example, [Wikidata's introduction to SPARQL](https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial). For now, it will suffice to understand that the query returns the url, label, and date of any letter Gregorovius wrote during the specified year as well as the GND IDs of all persons addressed or mention in each letter. \n\nSee our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) for a full and beginner friendly walk through this preset. \n\n**DISCLAIMER:** The Culture Knowledge Graph is work in progress. Currently, only a handful of datasets are accessible through its SPARQL endpoint using the NFDI4Culture Ontology. The User-Policy and guidelines of the Culture Knowledge Graph are being worked on as well. For the time being we advise you to be mindful of potential query limits.", - "module": "Generic", - "options": { - "basepath": "https://nfdi4culture.de", - "resource": "/sparql", - "params": {}, - "extension": "", - "headers": { - "Accept": "application/sparql-results+json", - "Content-Type": "application/sparql-query" - }, - "verb": "POST", - "format": "json", - "encoding": "", - "payload": "PREFIX cto: \\\nPREFIX schema: \\\nPREFIX rdf: \\\nPREFIX rdfs: \\\nPREFIX n4c: \\\n\nSELECT ?letter ?letterLabel ?date ?gnd_id\nWHERE {\n n4c:E5378 schema:dataFeedElement/schema:item ?letter .\n ?letter rdfs:label ?letterLabel ;\n cto:creationDate ?date ;\n cto:relatedPerson ?gnd_url .\n FILTER(YEAR(?date) = ).\n BIND(REPLACE(STR(?gnd_url), \".*://.*/(.*?)\", \"$1\") AS ?gnd_id)\n}", - "filename": "", - "fileext": "", - "pages": 1, - "paging_type": "count", - "param_paging": null, - "offset_start": 0, - "offset_step": 0, - "nodedata": "results.bindings", - "objectid": "gnd_id.value", - "scope": "", - "proxy": "", - "auth_type": "Disable", - "auth_uri": "", - "redirect_uri": "", - "token_uri": "", - "auth": "disable", - "auth_tokenname": "", - "auth_prefix": "" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "date.value", - "gnd_id.value", - "letterLabel.value" - ] -} \ No newline at end of file diff --git a/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json b/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json deleted file mode 100644 index 08de7766..00000000 --- a/presets/KnowledgeGraph-Wikidata-Get_gender_of_solo_artist_band_members.fp4.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "name": "Wikidata: Get gender of solo artist/band members", - "category": "Knowledge Graph", - "description": "This preset fetches a list of muscial artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". Then fetch data. \n\nThe query automatically extracts names of band members on the basis of the group's name, e.g. \"Coldplay\". \n\nSee our [Getting Started with Wikidata (artists gender)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(artists-gender)) for a full walk through this preset.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", - "module": "Generic", - "options": { - "auth": "disable", - "auth_prefix": "", - "auth_tokenname": "", - "auth_type": "Disable", - "auth_uri": "", - "basepath": "https://query.wikidata.org", - "extension": "", - "fileext": "", - "filename": "", - "format": "json", - "headers": {}, - "nodedata": "results.bindings", - "objectid": "entityLabel.value", - "offset_start": 0, - "offset_step": 10, - "pages": 1, - "paging_type": "count", - "param_paging": "", - "params": { - "format": "json", - "query": "SELECT distinct ?entityLabel ?genderLabel WHERE {\n \n # Search for solo artist or band\n ?entity rdfs:label \"\"@en.\n \n # Check if ?entity is solo artist or band (musical group)\n {\n # If solo artist, get sex or gender\n ?entity wdt:P31 wd:Q5. \n ?entity wdt:P21 ?gender. \n }\n UNION\n {\n # If band (musical group), first get all members then their sex or gender \n ?entity wdt:P31 wd:Q215380. \n ?entity wdt:P527 ?member. \n ?member wdt:P21 ?gender. \n ?member rdfs:label ?entityLabel.\n FILTER(LANG(?entityLabel) = \"en\")\n }\n SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\". }\n}" - }, - "proxy": "", - "redirect_uri": "", - "resource": "/sparql", - "scope": "", - "token_uri": "", - "verb": "GET" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "genderLabel.value" - ] -} \ No newline at end of file diff --git a/presets/KnowledgeGraph-Wikidata-Get_list_of_biblical_characters.fp4.json b/presets/KnowledgeGraph-Wikidata-Get_list_of_biblical_characters.fp4.json deleted file mode 100644 index c3d00065..00000000 --- a/presets/KnowledgeGraph-Wikidata-Get_list_of_biblical_characters.fp4.json +++ /dev/null @@ -1,48 +0,0 @@ -{ - "name": "Wikidata: Get list of biblical characters", - "category": "Knowledge Graph", - "description": "This preset gets a list of biblical characters, along with the sections in which they occur, from WikiData. Add an arbitrary seed node and fetch data.\n\nSee https://www.wikidata.org/wiki/Wikidata:Lists/List_of_biblical_characters\n\nYou can try out different query on https://query.wikidata.org/ (paste the value of the query parameter to get started).\n\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, if your query contains angle brackets, escape them with a backslash. Pagination is handled by the placeholder.", - "module": "Generic", - "options": { - "auth": "disable", - "auth_prefix": "", - "auth_tokenname": "", - "auth_type": "Disable", - "auth_uri": "", - "basepath": "https://query.wikidata.org", - "extension": "", - "fileext": "", - "filename": "", - "format": "json", - "headers": {}, - "nodedata": "results.bindings", - "objectid": "figure.value", - "offset_start": 0, - "offset_step": 10, - "pages": 2, - "paging_type": "count", - "param_paging": "", - "params": { - "format": "json", - "query": "SELECT DISTINCT ?figure ?figureLabel ?figureDescription ?section ?sectionLabel ?sectionDescription WHERE {\n\n ?figure wdt:P31 wd:Q12405827 .\n ?figure wdt:P1441 ?section .\n wd:Q1845 (wdt:P527)* ?chapter . \n wd:Q1845 (wdt:P527)* ?chapter .\n \n SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\".} \n}\nLIMIT 10 OFFSET " - }, - "proxy": "", - "redirect_uri": "", - "resource": "/sparql", - "scope": "", - "token_uri": "", - "verb": "GET" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "figureLabel.value", - "figureDescription.value", - "sectionLabel.value", - "sectionDescription.value", - "figure.value", - "section.value" - ] -} \ No newline at end of file diff --git a/presets/KnowledgeGraph-Wikidata-Which_politicians_did_not_die_on_natural_causes_.fp4.json b/presets/KnowledgeGraph-Wikidata-Which_politicians_did_not_die_on_natural_causes_.fp4.json deleted file mode 100644 index c469e73b..00000000 --- a/presets/KnowledgeGraph-Wikidata-Which_politicians_did_not_die_on_natural_causes_.fp4.json +++ /dev/null @@ -1,45 +0,0 @@ -{ - "name": "Wikidata: Which politicians did not die on natural causes?", - "category": "Knowledge Graph", - "description": "This preset fetches a list of politicians from WikiData that did not die on natural causes. Add an arbitrary node as seed node, e.g. \"politicians\".\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", - "module": "Generic", - "options": { - "basepath": "https://query.wikidata.org", - "resource": "/sparql", - "params": { - "format": "json", - "query": "PREFIX wd: \\ \nPREFIX wdt: \\\n\nSELECT DISTINCT ?politician ?cause ?politicianLabel ?causeLabel WHERE {\n ?politician wdt:P106 wd:Q82955 . # find items that have \"occupation (P106): politician (Q82955)\"\n ?politician wdt:P509|wdt:P1196 ?cause . # with a P509 (cause of death) or P1196 (manner of death) claim\n ?cause wdt:P279* wd:Q149086 . # ... where the cause is a subclass of (P279*) homicide (Q149086)\n # ?politician wdt:P39 wd:Q11696 . # Uncomment this line to include only U.S. Presidents \n SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\" }\n} LIMIT 10 OFFSET " - }, - "extension": "", - "headers": {}, - "verb": "GET", - "format": "json", - "filename": "", - "fileext": "", - "pages": 3, - "paging_type": "count", - "param_paging": "", - "offset_start": 0, - "offset_step": 10, - "nodedata": "results.bindings", - "objectid": "politician.value", - "scope": "", - "proxy": "", - "auth_type": "API key", - "auth_uri": "", - "redirect_uri": "", - "token_uri": "", - "auth": "param", - "auth_tokenname": "token" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "politicianLabel.value", - "causeLabel.value", - "politician.value", - "cause.value" - ] -} \ No newline at end of file diff --git a/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json b/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json deleted file mode 100644 index a6c3292e..00000000 --- a/presets/KnowledgeGraph-Wikidata-Writers_Network.fp4.json +++ /dev/null @@ -1,48 +0,0 @@ -{ - "name": "Wikidata: Writers Network", - "category": "Knowledge Graph", - "description": "This preset fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitrary literary movement as seed node, e.g. \"Q37068\" for romanticism. Then fetch data. \n\nSee our [Getting Started with Wikidata (writers network)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(writers-network)) for a full walk through this preset.\n\nCheck https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.\n", - "module": "Generic", - "options": { - "auth": "disable", - "auth_prefix": "", - "auth_tokenname": "", - "auth_type": "Disable", - "auth_uri": "", - "basepath": "https://query.wikidata.org", - "extension": "", - "fileext": "", - "filename": "", - "format": "json", - "headers": { - "Accept-Encoding": "gzip,deflate", - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" - }, - "nodedata": "results.bindings", - "objectid": null, - "offset_start": 0, - "offset_step": 10, - "pages": 2, - "paging_type": "count", - "param_paging": "", - "params": { - "format": "json", - "query": "SELECT DISTINCT ?writer ?writerLabel ?place ?placeLabel ?movement\nWHERE\n{\n # get all German writers of a literary movement\n ?writer wdt:P135 wd:;\n wdt:P106 wd:Q36180;\n wdt:P6886 wd:Q188.\n \n wd: rdfs:label ?movement.\n filter(lang(?movement) = \"en\")\n \n # relevant places\n ?writer wdt:P19|wdt:P20|(wdt:P69/wdt:P131)|(wdt:P108/wdt:P131) ?place.\n\n SERVICE wikibase:label { bd:serviceParam wikibase:language \"[AUTO_LANGUAGE],en\". }\n \n}" - }, - "proxy": "", - "redirect_uri": "", - "resource": "/sparql", - "scope": "", - "token_uri": "", - "verb": "GET" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "writerLabel.value", - "placeLabel.value", - "movement.value" - ] -} \ No newline at end of file diff --git a/presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today.fp4.json b/presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today.fp4.json new file mode 100644 index 00000000..bf7b1561 --- /dev/null +++ b/presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today.fp4.json @@ -0,0 +1,44 @@ +{ + "name": "DBPedia: Scientists who have birhtday today", + "category": "Knowledge Graph", + "description": "*This preset requires at least Facepager v4.6.* \n\nGet the names, descriptions, birthdays and if available thumbnail images of scientists who have birthday today. The results are limited to English and to the 10 oldest scientists. \n\nAdd an arbitrary node and fetch data. The node name doesn't matter as it is not used in the query. Suggestion: add dates as node names and adjust the query to get scientists who have birthday at a specific date.\n\nDBPedia is like Wikidata a semantic web version of Wikipedia. On the semantic web data is organizied according to the Resource Decription Framework (RDF). The preset retrieves data from the SPARQL endpoint of DBPedia. DBPedia mainly consists of content scrapted from the info boxes of Wikipedia. With limiting to english names and descriptions the results should reflect the English Wikipedia.\n\nSee https://wiki.dbpedia.org/ for details about DBPedia. If you are not familiar with semantic web technology consider reading Wikipedia articles about the Resource Description Framework and about SPARQL.\n\nThe example query was taken from an OpenHPI course: https://open.hpi.de/courses/semanticweb2017/\n\nPay attention on how the SPARQL query is formulated. Since angle brackets signify placeholders in Facepager they have to be masked with a backslash. If you need a backslash in your query, mask it by another backslash. To use the name of a node or data of previously fetched nodes in your query user placeholders (see the Facepager help).\n", + "module": "SPARQL", + "options": { + "auth": "disable", + "auth_prefix": "", + "auth_tokenname": "", + "auth_type": "Disable", + "auth_uri": "", + "basepath": "http://dbpedia.org/sparql", + "extension": "", + "format": "json", + "headers": { + "User-Agent": "FACEPAGERBOT/4.6 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.6" + }, + "key_paging": null, + "nodedata": "results.bindings", + "objectid": null, + "offset_start": 1, + "offset_step": 1, + "paging_stop": null, + "paging_type": null, + "param_paging": null, + "params": { + "format": "json", + "query": "PREFIX rdf: \\\nPREFIX dbo: \\\nPREFIX rdfs: \\\nPREFIX dc: \\\n\nSelect distinct ?birthdate ?thumbnail ?scientist ?name ?description WHERE {\n?scientist rdf:type dbo:Scientist ;\n dbo:birthDate ?birthdate ;\n rdfs:label ?name ;\n rdfs:comment ?description \n FILTER ((lang(?name)=\"en\")&&(lang(?description)=\"en\")&&(STRLEN(STR(?birthdate))>6)&&(SUBSTR(STR(?birthdate),6)=SUBSTR(STR(bif:curdate('')),6))) .\n OPTIONAL { ?scientist dbo:thumbnail ?thumbnail . }\n} ORDER BY ?birthdate LIMIT 10" + }, + "redirect_uri": "", + "resource": "", + "token_uri": "" + }, + "speed": 200, + "saveheaders": false, + "timeout": 15, + "maxsize": 5, + "columns": [ + "name.value", + "description.value", + "birthdate.value", + "thumbnail.value" + ] +} \ No newline at end of file diff --git a/presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today_SPARQL_Module_.fp4.json b/presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today_SPARQL_Module_.fp4.json deleted file mode 100644 index b09659b2..00000000 --- a/presets/Knowledge_Graph-DBPedia_Scientists_who_have_birhtday_today_SPARQL_Module_.fp4.json +++ /dev/null @@ -1,44 +0,0 @@ -{ - "name": " (SPARQL Module) DBPedia: Scientists who have birhtday today", - "category": "Knowledge Graph", - "description": "SPARQL module is work in progress \n\nGet the names, descriptions, birthdays and if available thumbnail images of scientists who have birthday today. The results are limited to English and to the 10 oldest scientists. This preset is compatible with Facepager v3.9.2 or newer. \n\nAdd an arbitrary node and fetch data. The node name doesn't matter as it is not used in the query. Suggestion: add dates as node names and adjust the query to get scientists who have birthday at a specific date.\n\nDBPedia is like Wikidata a semantic web version of Wikipedia. On the semantic web data is organizied according to the Resource Decription Framework (RDF). The preset retrieves data from the SPARQL endpoint of DBPedia. DBPedia mainly consists of content scrapted from the info boxes of Wikipedia. With limiting to english names and descriptions the results should reflect the English Wikipedia.\n\nSee https://wiki.dbpedia.org/ for details about DBPedia. If you are not familiar with semantic web technology consider reading Wikipedia articles about the Resource Description Framework and about SPARQL.\n\nThe example query was taken from an OpenHPI course: https://open.hpi.de/courses/semanticweb2017/\n\nPay attention on how the SPARQL query is formulated. Since angle brackets signify placeholders in Facepager they have to be masked with a backslash. If you need a backslash in your query, mask it by another backslash. To use the name of a node or data of previously fetched nodes in your query user placeholders (see the Facepager help).\n", - "module": "SPARQL", - "options": { - "auth": "disable", - "auth_prefix": "", - "auth_tokenname": "", - "auth_type": "Disable", - "auth_uri": "", - "basepath": "http://dbpedia.org/sparql", - "extension": "", - "format": "json", - "headers": { - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" - }, - "key_paging": null, - "nodedata": "results.bindings", - "objectid": null, - "offset_start": 1, - "offset_step": 1, - "paging_stop": null, - "paging_type": null, - "param_paging": null, - "params": { - "format": "json", - "query": "PREFIX rdf: \\\nPREFIX dbo: \\\nPREFIX rdfs: \\\nPREFIX dc: \\\n\nSelect distinct ?birthdate ?thumbnail ?scientist ?name ?description WHERE {\n?scientist rdf:type dbo:Scientist ;\n dbo:birthDate ?birthdate ;\n rdfs:label ?name ;\n rdfs:comment ?description \n FILTER ((lang(?name)=\"en\")&&(lang(?description)=\"en\")&&(STRLEN(STR(?birthdate))>6)&&(SUBSTR(STR(?birthdate),6)=SUBSTR(STR(bif:curdate('')),6))) .\n OPTIONAL { ?scientist dbo:thumbnail ?thumbnail . }\n} ORDER BY ?birthdate LIMIT 10" - }, - "redirect_uri": "", - "resource": "", - "token_uri": "" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "name.value", - "description.value", - "birthdate.value", - "thumbnail.value" - ] -} \ No newline at end of file diff --git a/presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees.fp4.json b/presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees.fp4.json new file mode 100644 index 00000000..92756200 --- /dev/null +++ b/presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees.fp4.json @@ -0,0 +1,43 @@ +{ + "name": "NFDI4Culture: 1 Get GND IDs of Ferdinand Gregorovius's addressees", + "category": "Knowledge Graph", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset retrieves GND IDs of Ferdinand Gregorovius' addressees from the Culture Knowledge Graph. To start add a year (e.g. 1851) as a seed node. Then fetch data. \n\nAt the heart of the preset lies a SPARQL query. Making an effort to learn the basics of SPARQL's syntax will allow you to literally understand any such query and, more crucially, let's you write your own queries, thus empowering you to answer (research) questions of your interest. A great resources to start with is, for example, [Wikidata's introduction to SPARQL](https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial). For now, it will suffice to understand that the query returns the url, label, and date of any letter Gregorovius wrote during the specified year as well as the GND IDs of all persons addressed or mention in each letter. \n\nSee our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) for a full and beginner friendly walk through this preset. \n\n**DISCLAIMER:** The Culture Knowledge Graph is work in progress. Currently, only a handful of datasets are accessible through its SPARQL endpoint using the NFDI4Culture Ontology. The User-Policy and guidelines of the Culture Knowledge Graph are being worked on as well. For the time being we advise you to be mindful of potential query limits.", + "module": "SPARQL", + "options": { + "auth": "disable", + "auth_prefix": "", + "auth_tokenname": "", + "auth_type": "Disable", + "auth_uri": "", + "basepath": "https://nfdi4culture.de/sparql", + "extension": "", + "format": "json", + "headers": { + "User-Agent": "FACEPAGERBOT/4.6 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.6" + }, + "key_paging": null, + "nodedata": "results.bindings", + "objectid": null, + "offset_start": 1, + "offset_step": 1, + "paging_stop": null, + "paging_type": null, + "param_paging": null, + "params": { + "format": "json", + "query": "PREFIX cto: \\\nPREFIX schema: \\\nPREFIX rdf: \\\nPREFIX rdfs: \\\nPREFIX n4c: \\\n\nSELECT ?letter ?letterLabel ?date ?gnd_id\nWHERE {\n n4c:E5378 schema:dataFeedElement/schema:item ?letter .\n ?letter rdfs:label ?letterLabel ;\n cto:creationDate ?date ;\n cto:relatedPerson ?gnd_url .\n FILTER(YEAR(?date) = ).\n BIND(REPLACE(STR(?gnd_url), \".*://.*/(.*?)\", \"$1\") AS ?gnd_id)\n} LIMIT 100" + }, + "redirect_uri": "", + "resource": "", + "token_uri": "" + }, + "speed": 200, + "saveheaders": false, + "timeout": 15, + "maxsize": 5, + "columns": [ + "date.value", + "gnd_id.value", + "letterLabel.value" + ] +} \ No newline at end of file diff --git a/presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees_SPARQL_module_.fp4.json b/presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees_SPARQL_module_.fp4.json deleted file mode 100644 index 5262a074..00000000 --- a/presets/Knowledge_Graph-NFDI4Culture_1_Get_GND_IDs_of_Ferdinand_Gregorovius_s_addressees_SPARQL_module_.fp4.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "name": "(SPARQL module) NFDI4Culture: 1 Get GND IDs of Ferdinand Gregorovius's addressees", - "category": "Knowledge Graph", - "description": "SPARQL module is work in progress \n\nThis preset accompanies our [Getting Started with Culture Knowledge Graph](https://github.com/strohne/Facepager/wiki/Getting-Started-with-CultureKnowledgeGraph) guide. \n\nIt retrives GND IDs of Ferdinand Gregorovius' addressees based on years as seed nodes. At the heart of the preset lies a SPARQL query. Making an effort to learn the basics of SPARQL's syntax will allow you to literally understand any such query and, more crucially, let's you write your own queries, thus empowering you to answer (research) questions of your interest. A great resources to start with is, for example, [Wikidata's introduction to SPARQL](https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial). For now, it will suffice to understand that the query returns the url, label, and date of any letter Gregorovius wrote during the specfied year as well as the GND IDs of all persons addressed or mention in each letter.\n\n**DISCLAIMER:** The Culture Knowledge Graph is work in progress. Currently, only a handful of datasets are accessible through its SPARQL endpoint using the NFDI4Culture Ontology. The User-Policy and guidelines of the Culture Knowledge Graph are being worked on as well. For the time being we advise you to be mindful of potential query limits.", - "module": "SPARQL", - "options": { - "auth": "disable", - "auth_prefix": "", - "auth_tokenname": "", - "auth_type": "Disable", - "auth_uri": "", - "basepath": "https://nfdi4culture.de/sparql", - "extension": "", - "format": "json", - "headers": { - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" - }, - "key_paging": null, - "nodedata": "results.bindings", - "objectid": null, - "offset_start": 1, - "offset_step": 1, - "paging_stop": null, - "paging_type": null, - "param_paging": null, - "params": { - "format": "json", - "query": "PREFIX cto: \\\nPREFIX schema: \\\nPREFIX rdf: \\\nPREFIX rdfs: \\\nPREFIX n4c: \\\n\nSELECT ?letter ?letterLabel ?date ?gnd_id\nWHERE {\n n4c:E5378 schema:dataFeedElement/schema:item ?letter .\n ?letter rdfs:label ?letterLabel ;\n cto:creationDate ?date ;\n cto:relatedPerson ?gnd_url .\n FILTER(YEAR(?date) = ).\n BIND(REPLACE(STR(?gnd_url), \".*://.*/(.*?)\", \"$1\") AS ?gnd_id)\n} LIMIT 100" - }, - "redirect_uri": "", - "resource": "", - "token_uri": "" - }, - "speed": 200, - "saveheaders": false, - "timeout": 15, - "maxsize": 5, - "columns": [ - "date.value", - "gnd_id.value", - "letterLabel.value" - ] -} \ No newline at end of file diff --git a/presets/KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json b/presets/Knowledge_Graph-NFDI4Culture_2_Translate_GND_ID_to_a_person_s_name.fp4.json similarity index 100% rename from presets/KnowledgeGraph-NFDI4Culture-2_Translate_GND_ID_to_a_person_s_name.fp4.json rename to presets/Knowledge_Graph-NFDI4Culture_2_Translate_GND_ID_to_a_person_s_name.fp4.json diff --git a/presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json b/presets/Knowledge_Graph-SemOpenAlex_Get_a_single_work.fp4.json similarity index 100% rename from presets/KnowledgeGraph-SemOpenAlex_Get_a_single_work.fp4.json rename to presets/Knowledge_Graph-SemOpenAlex_Get_a_single_work.fp4.json diff --git a/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members_SPARQL_module_.fp4.json b/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json similarity index 52% rename from presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members_SPARQL_module_.fp4.json rename to presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json index 1aba4276..67b064b9 100644 --- a/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members_SPARQL_module_.fp4.json +++ b/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json @@ -1,7 +1,7 @@ { - "name": "(SPARQL module) Wikidata: Get gender of solo artist/band members", + "name": "Wikidata: Get gender of solo artist/band members", "category": "Knowledge Graph", - "description": "SPARQL module is work in progress \n\nThis preset fetches a list of muscial artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". The query automatically extracts names of band members and their respective on the basis of the group's name, e.g. \"Coldplay\". \n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of muscial artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". Then fetch data. \n\nThe query automatically extracts names of band members on the basis of the group's name, e.g. \"Coldplay\". \n\nSee our [Getting Started with Wikidata (artists gender)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(artists-gender)) for a full walk through this preset.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", "module": "SPARQL", "options": { "basepath": "https://query.wikidata.org/sparql", @@ -24,7 +24,7 @@ "resource": "", "format": "json", "headers": { - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" + "User-Agent": "FACEPAGERBOT/4.6 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.6" }, "params": { "query": "SELECT distinct ?entityLabel ?genderLabel WHERE {\n \n # Search for solo artist or band\n ?entity rdfs:label \"\"@en.\n \n # Check if ?entity is solo artist or band (musical group)\n {\n # If solo artist, get sex or gender\n ?entity wdt:P31 wd:Q5. \n ?entity wdt:P21 ?gender. \n }\n UNION\n {\n # If band (musical group), first get all members then their sex or gender \n ?entity wdt:P31 wd:Q215380. \n ?entity wdt:P527 ?member. \n ?member wdt:P21 ?gender. \n ?member rdfs:label ?entityLabel.\n FILTER(LANG(?entityLabel) = \"en\")\n }\n SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\". }\n}", diff --git a/presets/Knowledge_Graph-Wikidata_Get_list_of_biblical_characters_SPARQL_module_.fp4.json b/presets/Knowledge_Graph-Wikidata_Get_list_of_biblical_characters.fp4.json similarity index 54% rename from presets/Knowledge_Graph-Wikidata_Get_list_of_biblical_characters_SPARQL_module_.fp4.json rename to presets/Knowledge_Graph-Wikidata_Get_list_of_biblical_characters.fp4.json index 6faa1d66..c360d12d 100644 --- a/presets/Knowledge_Graph-Wikidata_Get_list_of_biblical_characters_SPARQL_module_.fp4.json +++ b/presets/Knowledge_Graph-Wikidata_Get_list_of_biblical_characters.fp4.json @@ -1,17 +1,17 @@ { - "name": "(SPARQL module) Wikidata: Get list of biblical characters", + "name": "Wikidata: Get list of biblical characters", "category": "Knowledge Graph", - "description": "SPARQL module is work in progress. If reliant on paging stay with Generic module. \n\nThis preset gets a list of biblical characters, along with the sections in which they occur, from WikiData. Add an arbitrary seed node and fetch data.\n\nSee https://www.wikidata.org/wiki/Wikidata:Lists/List_of_biblical_characters\n\nYou can try out different query on https://query.wikidata.org/ (paste the value of the query parameter to get started).\n\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, if your query contains angle brackets, escape them with a backslash. Pagination is handled by the placeholder.", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset gets a list of biblical characters, along with the sections in which they occur, from WikiData. Add an arbitrary seed node and fetch data.\n\nSee https://www.wikidata.org/wiki/Wikidata:Lists/List_of_biblical_characters\n\nYou can try out different query on https://query.wikidata.org/ (paste the value of the query parameter to get started).\n\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, if your query contains angle brackets, escape them with a backslash. Pagination is handled by the placeholder.", "module": "SPARQL", "options": { "basepath": "https://query.wikidata.org/sparql", "extension": "", - "paging_type": null, + "paging_type": "count", "key_paging": null, "paging_stop": null, - "param_paging": null, - "offset_start": 1, - "offset_step": 1, + "param_paging": "", + "offset_start": 0, + "offset_step": 10, "nodedata": "results.bindings", "objectid": "figure.value", "auth_type": "Disable", @@ -24,7 +24,7 @@ "resource": "", "format": "json", "headers": { - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" + "User-Agent": "FACEPAGERBOT/4.6 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.6" }, "params": { "query": "SELECT DISTINCT ?figure ?figureLabel ?figureDescription ?section ?sectionLabel ?sectionDescription WHERE {\n\n ?figure wdt:P31 wd:Q12405827 .\n ?figure wdt:P1441 ?section .\n wd:Q1845 (wdt:P527)* ?chapter . \n wd:Q1845 (wdt:P527)* ?chapter .\n \n SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\".} \n}\nLIMIT 10", diff --git a/presets/Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes_SPARQL_module_.fp4.json b/presets/Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes.fp4.json similarity index 64% rename from presets/Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes_SPARQL_module_.fp4.json rename to presets/Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes.fp4.json index b87674e1..2ea7df0e 100644 --- a/presets/Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes_SPARQL_module_.fp4.json +++ b/presets/Knowledge_Graph-Wikidata_Which_politicans_did_not_die_on_natural_causes.fp4.json @@ -1,7 +1,7 @@ { - "name": "(SPARQL module) Wikidata: Which politicans did not die on natural causes?", + "name": "Wikidata: Which politicans did not die on natural causes?", "category": "Knowledge Graph", - "description": "SPARQL module is work in progress. If reliant on paging stay with Generic module. \n\nThis preset fetches a list of politicians from WikiData that did not die on natural causes. Add an arbitrary node as seed node, e.g. \"politicians\".\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of politicians from WikiData that did not die on natural causes. Add an arbitrary node as seed node, e.g. \"politicians\".\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", "module": "SPARQL", "options": { "auth": "disable", @@ -13,7 +13,7 @@ "extension": "", "format": "json", "headers": { - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" + "User-Agent": "FACEPAGERBOT/4.6 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.6" }, "key_paging": null, "nodedata": "results.bindings", diff --git a/presets/Knowledge_Graph-Wikidata_Writers_Network_SPARQL_module_.fp4.json b/presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json similarity index 50% rename from presets/Knowledge_Graph-Wikidata_Writers_Network_SPARQL_module_.fp4.json rename to presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json index 130bcf97..5802efe4 100644 --- a/presets/Knowledge_Graph-Wikidata_Writers_Network_SPARQL_module_.fp4.json +++ b/presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json @@ -1,7 +1,7 @@ { - "name": "(SPARQL module) Wikidata: Writers Network", + "name": "Wikidata: Writers Network", "category": "Knowledge Graph", - "description": "SPARQL module is work in progress \n\nThis preset accompanies the [Getting Started with Wikidata](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata) tutorial. It fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitary literary movement as seed node, e.g. \"Q37068\" for romanticism.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitrary literary movement as seed node, e.g. \"Q37068\" for romanticism. Then fetch data. \n\nSee our [Getting Started with Wikidata (writers network)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(writers-network)) for a full walk through this preset.\n\nCheck https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", "module": "SPARQL", "options": { "basepath": "https://query.wikidata.org/sparql", @@ -24,7 +24,7 @@ "resource": "", "format": "json", "headers": { - "User-Agent": "FACEPAGERBOT/4.5 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.5" + "User-Agent": "FACEPAGERBOT/4.6 ([https://github.com/strohne/Facepager](https://github.com/strohne/Facepager)) fp/4.6" }, "params": { "query": "SELECT DISTINCT ?writer ?writerLabel ?place ?placeLabel ?movement\nWHERE\n{\n # get all German writers of a literary movement\n ?writer wdt:P135 wd:;\n wdt:P106 wd:Q36180;\n wdt:P6886 wd:Q188.\n \n wd: rdfs:label ?movement.\n filter(lang(?movement) = \"en\")\n \n # relevant places\n ?writer wdt:P19|wdt:P20|(wdt:P69/wdt:P131)|(wdt:P108/wdt:P131) ?place.\n\n SERVICE wikibase:label { bd:serviceParam wikibase:language \"[AUTO_LANGUAGE],en\". }\n \n}", From bbe759db0bf57c67937d3499eadee43991e91c2b Mon Sep 17 00:00:00 2001 From: Lennart <163899770+catwolfman@users.noreply.github.com> Date: Wed, 15 Jan 2025 16:34:25 +0100 Subject: [PATCH 3/3] Update preset descriptions --- ...aph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json | 2 +- presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json b/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json index 67b064b9..e006ef48 100644 --- a/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json +++ b/presets/Knowledge_Graph-Wikidata_Get_gender_of_solo_artist_band_members.fp4.json @@ -1,7 +1,7 @@ { "name": "Wikidata: Get gender of solo artist/band members", "category": "Knowledge Graph", - "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of muscial artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". Then fetch data. \n\nThe query automatically extracts names of band members on the basis of the group's name, e.g. \"Coldplay\". \n\nSee our [Getting Started with Wikidata (artists gender)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(artists-gender)) for a full walk through this preset.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of musical artists and their sex or gender as provided by Wikidata. To start add the English name (label) of an arbitrary musical solo artist or band as seed node, e.g. \"Peter Maffay\" or \"Coldplay\". Then fetch data. \n\nThe query automatically extracts names of band members on the basis of the group's name, e.g. \"Coldplay\". \n\nSee our [Getting Started with Wikidata (artists gender)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(artists-gender)) for a full walk through this preset.\n\nSee https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure that you comply with Wikidata's User-Agent policy and be mindful of potential query limits.\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", "module": "SPARQL", "options": { "basepath": "https://query.wikidata.org/sparql", diff --git a/presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json b/presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json index 5802efe4..3e5958d5 100644 --- a/presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json +++ b/presets/Knowledge_Graph-Wikidata_Writers_Network.fp4.json @@ -1,7 +1,7 @@ { "name": "Wikidata: Writers Network", "category": "Knowledge Graph", - "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitrary literary movement as seed node, e.g. \"Q37068\" for romanticism. Then fetch data. \n\nSee our [Getting Started with Wikidata (writers network)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(writers-network)) for a full walk through this preset.\n\nCheck https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure to comply to [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", + "description": "*This preset requires at least Facepager v4.6.* \n\nThis preset fetches a list of German writers as well as cities relevant to them based on literary movements. To start add a Q-identifier of an arbitrary literary movement as seed node, e.g. \"Q37068\" for romanticism. Then fetch data. \n\nSee our [Getting Started with Wikidata (writers network)](https://github.com/strohne/Facepager/wiki/Getting-Started-with-Wikidata-(writers-network)) for a full walk through this preset.\n\nCheck https://www.wikidata.org/ for further information. You can try out different queries on https://query.wikidata.org/ (paste the value of the query parameter).\n\nAlways ensure that you comply with [Wikidata's User-Agent policy](https://foundation.wikimedia.org/wiki/Policy:User-Agent_policy) and be mindful of potential [query limits](https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits).\n\nPlease be aware that expressions in angle brackets are handled as placeholder by Facepager. Thus, the brackets of the prefixes have to be escaped with a backslash.\n\nPagination is handled by the placeholder.", "module": "SPARQL", "options": { "basepath": "https://query.wikidata.org/sparql",