Latest revision as of 15:49, 6 August 2021

DAAP search tools

Browsing (in the DAAP frontend)

Use the browsing features of this website to look through the entire DAAP collection, and also to search for specific publications, artists, or publishers. To find a specific title you’re looking for, browse the collection alphabetically from A–Z here. To find a specific artist or DAAP contributor, browse the alphabetical list here. To find a specific publisher, browse the alphabetical list here. All the browse pages can be navigated with the numbered buttons and arrows at the bottom of each page.

Keyword search (in the wiki database)

Keyword search in the DAAP is accessible through the input box in the top right corner of the wiki database interface or the Search page (no log-in required). You can follow the tutorial that explains the basic and advanced functions of keyword search.

Query service (in the wiki database)

The DAAP query service is an advanced search tool, which uses the linked data structure of Wikibase to query for more complex data relations, not keywords. This service uses a language called SPARQL (pronounced SPARQL), however you can use it without knowing how to write SPARQL from scratch. Follow the tutorial to get started using the query helper interface, or look at some of the examples below which also serve as learning prompts and are easy to modify.

Example queries

There are many different types of queries you can run and discover new data in the database. Here are some examples that can give you an idea of what types of materials you can query for.

Feel free to experiment by amending the “Filter” or “Show” values in these and see what alternative results you can get:

@@ Line 1: / Line 1: @@
 =DAAP search tools=
-<blockquote>There are two types of search interfaces in the DAAP. A keyword search interface, which you can interact with via the input box in the top right corner of the database interface. And a second advanced search interface, which uses the linked data structure of Wikibase to search for more complex data relations. This latter interface uses a query language called SPARQL (pronounced “sparkle”). The tutorial below outlines a sample workflow with this interface which does not require coding skills.</blockquote>
+==Browsing (in the DAAP frontend)==
+'''Use the browsing features of this website to look through the entire DAAP collection, and also to search for specific publications, artists, or publishers.''' To find a specific title you’re looking for, [https://daap.network/browsethearchive browse the collection alphabetically from A–Z here]. To find a specific artist or DAAP contributor, [https://daap.network/artistsindex browse the alphabetical list here]. To find a specific publisher, [https://daap.network/publishersindex browse the alphabetical list here]. All the browse pages can be navigated with the numbered buttons and arrows at the bottom of each page.
-https://daap.bannerrepeater.org/w/images/0/02/SPARQL_tut_img1.png
+==Keyword search (in the wiki database)==
-==SPARQL query interface tutorial workflow==
+Keyword search in the DAAP is accessible through the input box in the top right corner of the wiki database interface or the [https://daap.bannerrepeater.org/w/index.php?search=&search=&title=Special%3ASearch&go=Go Search page] (no log-in required). You can follow the [https://daap.network/tutorial_9 tutorial] that explains the basic and advanced functions of keyword search.
-===Step 1===
-Start by accessing the search query interface to the DAAP [https://query.daap.bannerrepeater.org/ here].
-This interface is based on the public query interface provided by Wikidata. Our instance is called DockerWikibaseQueryService, because it is an access point to the DAAP’s private Wikibase instead of the public Wikidata database. This tutorial will guide you through using the “Query Helper” interface (highlighted in the image below), which is a graphic user interface. ''If you don’t see the “Query Helper” interface immediately, click the “info” icon in the top left corner below the wiki logo image.''
+https://daap.bannerrepeater.org/w/images/1/1f/DAAP_keyword_search.jpg
-https://daap.bannerrepeater.org/w/images/0/0e/SPARQL_tut_img2.png
+==Query service (in the wiki database)==
+The [https://query.daap.bannerrepeater.org/ DAAP query service] is an advanced search tool, which uses the linked data structure of Wikibase to query for more complex data relations, not keywords. This service uses a language called SPARQL (pronounced SPARQL), however you can use it without knowing how to write SPARQL from scratch. Follow the [https://daap.network/tutorial_10 tutorial] to get started using the query helper interface, or look at some of the examples below which also serve as learning prompts and are easy to modify.
-There are further tutorials suggested in the end of this page, which you can follow for instructions on more advanced use including writing your own SPARQL queries from scratch.
+https://daap.bannerrepeater.org/w/images/a/a2/DAAP_queryservice.jpg
-===Step 2===
-Next step is to select what to query for. To be able to work with the query service efficiently, you need to be moderately well acquainted with the way data is structured in the DAAP. To do this you can always refer to the main data model spreadsheet here, or just look at some example items in the database. For this tutorial we will use the case study of artworks by artist Carolee Schneemann already added to the DAAP. You can read more about the case study here.
-Let’s examine an artwork record for one of these works, e.g. [https://daap.bannerrepeater.org/wiki/Item:Q435 Earth Ship].
+==Example queries==
-https://daap.bannerrepeater.org/w/images/7/7b/SPARQL_tut_img3.png
-We can see that the artwork is linked to the artist via the property “creators/ contributors”. So we’ll start our search in the query service by looking for all works which are linked to artist Carolee Schneeman via property “creators/ contributors”.
-===Step 3===
-The Query Helper interface works like a filter. If you click on the Filter button and start typing the artist name, in this case – Carolee Schneeman, it should pop up as an auto-suggestion while you’re typing.
-https://daap.bannerrepeater.org/w/images/a/a6/SPARQL_tut_img4.png
-The query helper will even suggest an appropriate property to use with this item. In this case, the property “creators/ contributors” is exactly the one we want to use, so we can leave it as is.
-Sometimes the autosuggestion may be wrong, in which case you need to start typing into the property field and choose the correct property.
-https://daap.bannerrepeater.org/w/images/5/56/SPARQL_tut_img5.png
-===Step 4===
-Once you have created at least one filter, you can “run” your query to see the results. Some results may appear even while you’re typing in the filter values, but you won’t get complete results until you’ve hit the big blue “play” button on the left side of the Helper interface.
-https://daap.bannerrepeater.org/w/images/1/1d/SPARQL_tut_img6.png
-Once you click the button, you will get the complete set of results in the space below the Helper interface. At this point in time, there appear to be 6 artworks associated with this artist in the DAAP.
-===Step 5===
-Next you may want to “show” some additional attributes for these artworks. You can do that by using the “show” button in the helper interface. For this particular query let’s use publication locations and other contributors. You will note that the way the “show” button operates is not to filter down, but rather to add optional attributes to the artworks. This means the total number of artworks in the query remains 6, but for some of these you start to see additional data where applicable.
-To see the additional attributes, you need to choose the correct properties from the “Show” option. You can consult an example artwork page or the general data model sheet once again to get the property titles if you need to. In this case, the properties are: “place of publication” and “creators/ contributors”.
-https://daap.bannerrepeater.org/w/images/d/d3/SPARQL_tut_img7.png
-https://daap.bannerrepeater.org/w/images/c/cf/SPARQL_tut_img8.png
-===Step 6===
-Once again you need to press the “run” button to see your updated query results.
-https://daap.bannerrepeater.org/w/images/7/7e/SPARQL_tut_img9.png
-You may also notice that the query returns 12 results now. This is because works which have more than one additional contributor (besides the artist Carolee Schneemann) appear as separate results in the table view.
-This is not a problem from a data management perspective, but if you don’t find the table view very useful, you can experiment with alternative ways of visualising the data results. For example in this case, you can also try the “graph view” accessible via a drop-down menu.
-https://daap.bannerrepeater.org/w/images/7/73/SPARQL_tut_img10.png
-Once you select the alternate view, the results are automatically reloaded in the correct view. Different views suit different cases and different types of “query questions”. The more you use the query tools and experiment, the more you’ll discover what types of data are best displayed via specific visualisations.
-https://daap.bannerrepeater.org/w/images/0/04/SPARQL_tut_img11.png
-===Step 7===
-Finally if you want to share this query with someone else, or save it for your own research, there are two options of getting links to the results. The link button in the Query helper interface creates a link to the editable query interface.
-https://daap.bannerrepeater.org/w/images/1/19/SPARQL_tut_img12.png
-Whereas the link in the results part of the screen, will give you a link that opens to a full-screen visualisation of the query results and can be embedded elsewhere on the web, too. This is how we produced the link to the visualisation accessible from the case study page for Schneeman’s works.
-https://daap.bannerrepeater.org/w/images/a/a1/SPARQL_tut_img13.png
-===Step 8===
-You can also download your results in a number of different formats to suit your needs. A CSV file is a convenient way to get data in a standard spreadsheet format.
-https://daap.bannerrepeater.org/w/images/a/ab/SPARQL_tut_img14.png
-===Next steps===
 There are many different types of queries you can run and discover new data in the database.
 Here are some examples that can give you an idea of what types of materials you can query for.
-Feel free to experiment by amending the filter or show values in these and see what alternative results you can get:
+Feel free to experiment by amending the “Filter” or “Show” values in these and see what alternative results you can get:
 * [https://tinyurl.com/y6f26mne A query for all self-published publications]
@@ Line 85: / Line 27: @@
 * [https://tinyurl.com/y6jc3ptq A query for all organisations listed in the DAAP]
 * [https://tinyurl.com/yxvyfpe2 A query for all collectives listed in the DAAP]
+* [https://tinyurl.com/ygqvusvw A query for all publications by a specific contributor]
-===Further reading===
-There are many more sophisticated ways of using the Query interface, particularly if you know how to edit the SPARQL code manually.
-See some of these more advanced tutorial materials prepared by Wikidata:
-*[https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service#Learning_SPARQL  Wikidata SPARQL Introduction]
-*[https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial  Wikidata SPARQL Tutorial]
-We will aim to add more complex SPARQL tutorials to the DAAP site as well, as the database develops further as a community resource.

Search Tools: Difference between revisions