rkd 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf6f9827a74bf7a6288f966175b91ae0e847098783dd69cb13782aa4322e760b
-  data.tar.gz: 4eabbe9159f88e1fb2aed36b718d06fbff82772cd4abeff55b92f8647398b3f5
+  metadata.gz: 90fda4ea793f4c4ae3fb171d56b8919728b3e9f8a71d6b9ca636ee22ab6d648f
+  data.tar.gz: 0633b70cf3ba381369e6b1ec4c56d9540b545c965c847edb764bfad40e00d507
 SHA512:
-  metadata.gz: b09cfc13a74066f8e21317481ae10bf948509e2caa370382886d4827179580870e48eff5374c9337a6a3d9b7986b10a13f767070f0e7e813e2639f89618c9d4c
-  data.tar.gz: 46e9b716fea7db61e0243a7dc786f4548581a2801ea50636e914d69883d8bb6c0bc85897105e74898864ffb772e693a2d5366d3db2cc39604efaf1eb3acd0b4f
+  metadata.gz: 405e9a82dd92ffb06e1ee1144634e3dd41d7ec0044d6f9a76ad6ba29f90fab57acb2da49e73415680e2b784b0e95756b2505c56bc85a1980d9621013dfa46a06
+  data.tar.gz: 467289a5a7b19934bdb5f0ca48c4a56075c8ffd9b32783e327015907b04ed92701f5184f8da94d96460cf80c3d0fb76dda765c4d59a822118b514e26d038b0e4

data/.gitignore

@@ -6,3 +6,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+rkd*.gem

data/.gitlab-ci.yml

@@ -0,0 +1,37 @@
+# This file is a template, and might need editing before it works on your project.
+# You can copy and paste this template into a new `.gitlab-ci.yml` file.
+# You should not add this template to an existing `.gitlab-ci.yml` file by using the `include:` keyword.
+#
+# To contribute improvements to CI/CD templates, please follow the Development guide at:
+# https://docs.gitlab.com/ee/development/cicd/templates.html
+# This specific template is located at:
+# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Ruby.gitlab-ci.yml
+
+# Official language image. Look for the different tagged releases at:
+# https://hub.docker.com/r/library/ruby/tags/
+image: ruby:latest
+
+
+# Cache gems in between builds
+cache:
+  paths:
+    - vendor/ruby
+
+# This is a basic example for a gem or script which doesn't use
+# services such as redis or postgres
+before_script:
+  - ruby -v  # Print out ruby version for debugging
+  # Uncomment next line if your rails app needs a JS runtime:
+  # - apt-get update -q && apt-get install nodejs -yqq
+  - bundle config set --local deployment true  # Install dependencies into ./vendor/ruby
+  - bundle install -j $(nproc)
+  - gem install simplecov
+
+standardrb:
+  script:
+    - bundle exec standardrb
+
+
+test:
+  script:
+    - rake

data/.ruby-version

@@ -0,0 +1 @@
+3.3.4

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# 0.3.0 (in progress)
+
+* RKD SPARQL API implemented
+* Artist.find
+* Artist#public_url (returning a human readable page on the RKD website)
+* few Rails conveniences (that shouldn't hurt non-Rails solution)
+  * Artist#to_partial_path
+* Institution
+* Handling network errors
+
+# 0.2.0
+
+* RKD Search API implemented
+
+# 0.1.0 Init

data/Gemfile

@@ -1,6 +1,4 @@
 source "https://rubygems.org"
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
-
 # Specify your gem's dependencies in rkd.gemspec
 gemspec

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    rkd (0.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    docile (1.4.1)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    minitest (5.25.1)
+    parallel (1.26.3)
+    parser (3.3.5.0)
+      ast (~> 2.4.1)
+      racc
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (10.5.0)
+    regexp_parser (2.9.2)
+    rexml (3.3.7)
+    rubocop (1.65.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.4, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.32.3)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.21.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.1)
+    simplecov_json_formatter (0.1.4)
+    standard (1.40.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.65.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.4)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.4.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.21.0)
+    unicode-display_width (2.6.0)
+
+PLATFORMS
+  arm64-darwin-23
+  ruby
+
+DEPENDENCIES
+  bundler (> 1)
+  minitest (~> 5.0)
+  rake (~> 10.0)
+  rkd!
+  simplecov (~> 0.22)
+  standard (~> 1)
+
+BUNDLED WITH
+   2.5.18

data/README.md

@@ -1,8 +1,6 @@
-# Rkd
+# RKD (unofficial)
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rkd`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+This is the RKD gem. A gem that helps ruby-developers to interact with the vast collection of data from the RKD in a ruby-friendly manner.
 
 ## Installation
 
@@ -22,7 +20,35 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Searching for an artist:
+
+```
+artists = RKD::Artist.search("Rembrandt") # returns array of results
+artist = artists.first # best hit :)
+artist.enrich! # enrich the data from the sparql endpoints
+```
+
+### Just getting a single artist
+
+```
+RKD::Artist.find(123)
+```
+
+### Retrieving data
+
+Just browse the methods:
+
+```
+artist.birth_place.geoname_id
+artist.performances.work.first.place.lat, artist.performances.work.first.place.lon
+artist.performances.work.first.place.geoname_id
+artist.performances.work.first.date_span.begin # returns a RKD::ImpreciseDate or Date
+artist.performances.study.map{|s| s.label}
+artist.types # []
+artist.name_variants
+```
+
+It is all powered by a combination of a ElasticSearch and SPARQL API call, but now without the hassle of making these queries manually.
 
 ## Development
 
@@ -32,7 +58,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rkd. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://gitlab.com/murb/rkd/. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
@@ -40,4 +66,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Rkd project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/rkd/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Rkd project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://gitlab.com/murb/rkd/-/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -7,4 +7,4 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task :default => :test
+task default: :test

data/docs/first query.sparql

@@ -0,0 +1,38 @@
+PREFIX rkd: <https://data.rkd.nl/def#>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
+PREFIX crm: <http://www.cidoc-crm.org/cidoc-crm/>
+prefix la: <https://linked.art/ns/terms/>
+
+SELECT ?property ?propertyLabel ?value ?symbolicContent ?prefLabel ?tookPlaceAt ?placePoint ?placeLabel ?placeGeoname ?timeSpan ?start ?end
+WHERE {
+  <https://data.rkd.nl/artists/66219> ?property ?value.
+  FILTER (
+    !(?property in (crm:P67i_is_referred_to_by, crm:P1_is_identified_by, crm:P62i_is_depicted_by, la:member_of))
+    )
+  OPTIONAL {
+    ?property rdfs:label ?propertyLabel.
+    FILTER (lang(?propertyLabel) = "en")
+  }
+  OPTIONAL {
+    ?value crm:P190_has_symbolic_content ?symbolicContent
+  }
+  OPTIONAL {
+    ?value skos:prefLabel ?prefLabel
+    FILTER (lang(?prefLabel) = "en")
+  }
+  OPTIONAL {
+    ?value crm:P7_took_place_at ?tookPlaceAt.
+    ?value crm:P4_has_time-span ?timeSpan.
+    ?tookPlaceAt crm:P168_place_is_defined_by ?placePoint.
+    ?tookPlaceAt rdfs:label ?placeLabel.
+    ?tookPlaceAt skos:exactMatch ?placeGeoname.
+    ?timeSpan crm:P82a_begin_of_the_begin ?start.
+    ?timeSpan crm:P82b_end_of_the_end ?end.
+
+    FILTER
+    (?property in (crm:P100i_died_in, crm:P98i_was_born))
+  }
+
+
+}

data/docs/fourth_query.sparql

@@ -0,0 +1,63 @@
+PREFIX rkd: <https://data.rkd.nl/def#>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
+PREFIX crm: <http://www.cidoc-crm.org/cidoc-crm/>
+prefix la: <https://linked.art/ns/terms/>
+
+SELECT ?property ?propertyLabel ?value ?symbolicContent ?prefLabel ?tookPlaceAt ?tookPlaceAtTimeSpan ?tookPlaceAtTimeSpanBegin ?tookPlaceAtTimeSpanEnd ?placePoint ?placeLabel ?placeGeoname ?timeSpan ?start ?end ?domain ?range ?studyLabel
+WHERE {
+  <https://data.rkd.nl/artists/32439> ?property ?value.
+  FILTER (
+    !(?property in (crm:P67i_is_referred_to_by, crm:P1_is_identified_by, crm:P62i_is_depicted_by, la:member_of))
+    )
+  OPTIONAL {
+    ?property rdfs:label ?propertyLabel.
+    FILTER (lang(?propertyLabel) = "en")
+  }
+  OPTIONAL {
+    ?value crm:P190_has_symbolic_content ?symbolicContent
+  }
+  OPTIONAL {
+    ?value skos:prefLabel ?prefLabel
+    FILTER (lang(?prefLabel) = "en")
+  }
+  OPTIONAL {
+    ?value crm:P7_took_place_at ?tookPlaceAt.
+    ?value crm:P4_has_time-span ?timeSpan.
+    ?tookPlaceAt crm:P168_place_is_defined_by ?placePoint.
+    ?tookPlaceAt rdfs:label ?placeLabel.
+    ?tookPlaceAt skos:exactMatch ?placeGeoname.
+    ?timeSpan crm:P82a_begin_of_the_begin ?start.
+    ?timeSpan crm:P82b_end_of_the_end ?end.
+    # FILTER
+    # (
+    #   #?property in (crm:P100i_died_in, crm:P98i_was_born, crm:P14i_performed)
+    #   # &&
+    #   # STRSTARTS(STR(?placeGeoname), "https://sws.geonames.org/")
+    # )
+  }
+  OPTIONAL {
+        ?value crm:P7_took_place_at ?tookPlaceAt.
+        ?tookPlaceAt rdfs:label ?placeLabel.
+    ?tookPlaceAt skos:exactMatch ?placeGeoname.
+
+
+ FILTER
+    (
+      ?property in (crm:P100i_died_in, crm:P98i_was_born, crm:P14i_performed)
+      &&
+      STRSTARTS(STR(?placeGeoname), "https://sws.geonames.org/")
+    )
+  }
+  OPTIONAL {
+    ?value crm:P01i_is_domain_of ?domain.
+    ?domain crm:P02_has_range ?range.
+       ?range skos:prefLabel ?studyLabel.
+  }
+  OPTIONAL {
+    ?value crm:P4_has_time-span ?tookPlaceAtTimeSpan.
+    ?tookPlaceAtTimeSpan crm:P82a_begin_of_the_begin ?tookPlaceAtTimeSpanBegin.
+    ?tookPlaceAtTimeSpan crm:P82b_end_of_the_end ?tookPlaceAtTimeSpanEnd.
+
+  }
+}

data/docs/second_query.sparql

@@ -0,0 +1,22 @@
+PREFIX rkd: <https://data.rkd.nl/def#>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
+PREFIX crm: <http://www.cidoc-crm.org/cidoc-crm/>
+prefix la: <https://linked.art/ns/terms/>
+prefix schema: <https://schema.org/>
+prefix thesaurus: <https://data.rkd.nl/thesaurus/>
+
+SELECT DISTINCT ?property ?value ?workLocation ?placeGeoname ?somethingElse
+WHERE {
+  <https://data.rkd.nl/artists/66219> ?property ?value
+  OPTIONAL {
+    ?value schema:workLocation ?workLocation .
+    FILTER(STRSTARTS(STR(?workLocation), "https://data.rkd.nl/thesaurus"))
+  }
+  OPTIONAL {
+    SERVICE <https://api.rkd.triply.cc/datasets/rkd/RKD-Knowledge-Graph/sparql> {
+      ?workLocation a skos:Concept .
+      ?workLocation skos:exactMatch ?placeGeoname
+    }
+  }
+}

data/docs/third_query.sparql

@@ -0,0 +1,53 @@
+PREFIX rkd: <https://data.rkd.nl/def#>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
+PREFIX crm: <http://www.cidoc-crm.org/cidoc-crm/>
+prefix la: <https://linked.art/ns/terms/>
+
+SELECT ?property ?propertyLabel ?value ?symbolicContent ?prefLabel ?tookPlaceAt ?placePoint ?placeLabel ?placeGeoname ?timeSpan ?start ?end
+WHERE {
+  <https://data.rkd.nl/artists/473628> ?property ?value.
+  FILTER (
+    !(?property in (crm:P67i_is_referred_to_by, crm:P1_is_identified_by, crm:P62i_is_depicted_by, la:member_of))
+    )
+  OPTIONAL {
+    ?property rdfs:label ?propertyLabel.
+    FILTER (lang(?propertyLabel) = "en")
+  }
+  OPTIONAL {
+    ?value crm:P190_has_symbolic_content ?symbolicContent
+  }
+  OPTIONAL {
+    ?value skos:prefLabel ?prefLabel
+    FILTER (lang(?prefLabel) = "en")
+  }
+  OPTIONAL {
+    ?value crm:P7_took_place_at ?tookPlaceAt.
+    ?value crm:P4_has_time-span ?timeSpan.
+    ?tookPlaceAt crm:P168_place_is_defined_by ?placePoint.
+    ?tookPlaceAt rdfs:label ?placeLabel.
+    ?tookPlaceAt skos:exactMatch ?placeGeoname.
+    ?timeSpan crm:P82a_begin_of_the_begin ?start.
+    ?timeSpan crm:P82b_end_of_the_end ?end.
+
+    FILTER
+    (
+      ?property in (crm:P100i_died_in, crm:P98i_was_born, crm:P14i_performed)
+      # &&
+      # STRSTARTS(STR(?placeGeoname), "https://sws.geonames.org/")
+    )
+  }
+  OPTIONAL {
+        ?value crm:P7_took_place_at ?tookPlaceAt.
+        ?tookPlaceAt rdfs:label ?placeLabel.
+    ?tookPlaceAt skos:exactMatch ?placeGeoname.
+
+
+ FILTER
+    (
+      ?property in (crm:P100i_died_in, crm:P98i_was_born, crm:P14i_performed)
+      &&
+      STRSTARTS(STR(?placeGeoname), "https://sws.geonames.org/")
+    )
+  }
+}

data/lib/r_k_d/artist.rb

@@ -0,0 +1,252 @@
+module RKD
+  class Artist
+    class NotFoundError < StandardError
+    end
+
+    include ::RKD::Helpers::DateParsing
+
+    # @!attribute [r] id
+    #   @return [String] the full identifier of the artist; typically the uri
+    # @!attribute [r] name
+    #   @return [String] the name of the artist
+    # @!attribute [r] identifier
+    #   @return [Integer] RKDid (basically the last part of the URI; which used to be the RKD Artist ID)
+    # @!attribute [r] gender
+    #   @return [String] currently just returns binary forms; 'male' | 'female'
+    # @!attribute [r] birth_date
+    #   @return [Date,RKD::ImpreciseDate] will return date when known, otherwise imprecise date
+    # @!attribute [r] death_date
+    #   @return [Date,RKD::ImpreciseDate] will return date when known, otherwise imprecise date
+    # @!attribute [r] types
+    #   @return [Array<RKD::Type>] the types associated with the artist
+    # @!attribute [r] updated_at
+    #   @return [DateTime] the timestamp when the artist information was last updated
+    # @!attribute [r] birth_place
+    #   @return [RKD::Place] the place where the artist was born
+    # @!attribute [r] death_place
+    #   @return [RKD::Place] the place where the artist died
+    # @!attribute [r] name_variants
+    #   @return [Array<String>] the different name variants of the artist
+    attr_reader :id, :name, :identifier, :gender, :birth_date, :death_date, :types, :updated_at, :birth_place, :death_place, :name_variants
+
+    class << self
+      # Searches for artists by name.
+      # @param name [String] the name of the artist to search for.
+      # @return [Array<RKD::Artist>] an array of artist objects matching the search criteria.
+      def search(name)
+        name = name.to_s.strip
+
+        return [] if name.empty?
+
+        Query::ElasticSearch.search(name, dataset: "artists").map do |artist|
+          new_from_search_result(artist)
+        end
+      end
+
+      # Finds an artist by identifier.
+      # @param identifier [Integer, String] the identifier of the artist to find. It will accept both artist's RKD URI as well as RKD Artist's numeric identifiers.
+      # @raise [NotFoundError] if no artist is found with the given identifier.
+      # @return [RKD::Artist] the artist object corresponding to the given identifier.
+      def find(identifier)
+        identifier = identifier.sub("https://data.rkd.nl/artists/", "") if identifier.is_a? String
+        raise NotFoundError.new("No artist with id #{identifier}") if identifier.to_i == 0
+        identifier = identifier.to_i
+
+        found_data = Query::ElasticSearch.find(identifier, dataset: "artists")
+        raise NotFoundError.new("No artist found with id #{identifier}") if found_data.nil?
+        artist = new_from_search_result(found_data)
+        artist.enrich!
+        artist
+      end
+
+      private
+
+      # Creates a new artist object from the search result.
+      # @param result [Hash] the search result data.
+      # @return [RKD::Artist] a new artist object populated with the search result data.
+      def new_from_search_result(result)
+        RKD::Artist.new(
+          id: result["@id"],
+          identifier: result["https://data rkd nl/search#identifier"].first.to_i,
+          name: result["https://data rkd nl/search#kunstenaarsnaam"]&.first || result["https://data rkd nl/search#creatorName"]&.first,
+          gender: result["https://data rkd nl/search#geslacht"]&.join(", "),
+          birth_date: [result["https://data rkd nl/search#geboortedatum_begin"]&.first, result["https://data rkd nl/search#geboortedatum_eind"]&.first].compact.max_by(&:length),
+          birth_place_desc: result["https://data rkd nl/search#geboorteplaats"]&.first,
+          death_date: [result["https://data rkd nl/search#sterfdatum_begin"]&.first, result["https://data rkd nl/search#sterfdatum_eind"]&.first].compact.max_by(&:length),
+          death_place_desc: result["https://data rkd nl/search#sterfplaats"]&.first,
+          name_variants: result["https://data rkd nl/search#spellingsvariant"] || []
+        )
+      end
+    end
+
+    def initialize(id: nil, name: nil, identifier: nil, gender: nil, birth_date: nil, death_date: nil, birth_place_desc: nil, death_place_desc: nil, name_variants: [])
+      @id = id
+      @name = name
+      @identifier = identifier
+      @gender = gender
+      self.birth_date = birth_date
+      self.death_date = death_date
+      @birth_place_desc = birth_place_desc
+      @death_place_desc = death_place_desc
+      @name_variants = name_variants
+      @performances = []
+    end
+
+    # @!method death_place_desc
+    #   Returns the description of the place where the artist died.
+    #   @return [String] the description of the death place.
+    def death_place_desc
+      @death_place_desc || death_place&.label
+    end
+
+    # @!method birth_place_desc
+    #   Returns the description of the place where the artist was born.
+    #   @return [String] the description of the birth place.
+    def birth_place_desc
+      @birth_place_desc || birth_place&.label
+    end
+
+    # @!method update(**key_values)
+    #   Updates the artist's attributes with the given key-value pairs.
+    #   @param key_values [Hash] the attributes to update.
+    def update(**key_values)
+      key_values.each do |key, value|
+        send(:"#{key}=", value)
+      end
+    end
+
+    # @!method performances
+    #   Returns a collection of the artist's performances.
+    #   @return [Performance::Collection] the collection of performances.
+    def performances
+      Performance::Collection.new(@performances)
+    end
+
+    # @!method public_url
+    #   Returns the public URL of the artist's profile.
+    #   @return [String] the public URL.
+    def public_url
+      "https://research.rkd.nl/nl/detail/https%3A%2F%2Fdata.rkd.nl%2Fartists%2F#{identifier}"
+    end
+
+    # @!method death_date=(date)
+    #   Sets the death date of the artist.
+    #   @param date [Date, String] the death date to set.
+    def death_date= date
+      @death_date = parse_date(date)
+    end
+
+    # @!method birth_date=(date)
+    #   Sets the birth date of the artist.
+    #   @param date [Date, String] the birth date to set.
+    def birth_date= date
+      @birth_date = parse_date(date)
+    end
+
+    # @!method to_partial_path
+    #   Returns the partial path for rendering the artist in Rails views.
+    #   @return [String] the partial path.
+    def to_partial_path
+      "rkd/artists/artist"
+    end
+
+    # @!method to_param
+    #   Returns the identifier of the artist for use in URLs (mostly for rails)
+    #   @return [String] the identifier.
+    def to_param
+      identifier
+    end
+
+    # @!method enrich!
+    #   Enriches the artist's data by fetching additional information from the SPARQL endpoint
+    #   @raise [RKD::Artist::NotFoundError] if no data is found for the artist.
+    def enrich!
+      json = Query::Sparql.find(identifier)
+
+      death_data = json.select { |a| a["property"] == "http://www.cidoc-crm.org/cidoc-crm/P100i_died_in" }
+      birth_data = json.select { |a| a["property"] == "http://www.cidoc-crm.org/cidoc-crm/P98i_was_born" } # different placeRefs
+
+      death_places_data = extract_places_data(death_data).first
+      birth_places_data = extract_places_data(birth_data).first
+
+      @death_place = Place.new(**death_places_data) if death_places_data
+      self.death_date = [death_data.first["begin"], death_data.first["end"]].compact.max_by(&:length) if death_data.first
+
+      @birth_place = Place.new(**birth_places_data) if birth_places_data
+      self.birth_date = [birth_data.first["begin"], birth_data.first["end"]].compact.max_by(&:length) if birth_data.first
+
+      @name = json.select { |row| row["property"] == "http://www.w3.org/2000/01/rdf-schema#label" }.map { |row| row["value"] }.first
+
+      performances_data = json.select { |row| row["property"] == "http://www.cidoc-crm.org/cidoc-crm/P14i_performed" }.group_by { |row| row["value"] }
+      @performances = performances_data.map do |perf_id, values|
+        parse_performance_data(perf_id, values)
+      end.compact
+
+      type_data = json.select { |a| a["property"] == "http://www.cidoc-crm.org/cidoc-crm/P2_has_type" }.map { |row| {label: row["prefLabel"], ref: row["value"]} }.select { |a| a[:label] }
+      @types = type_data.map { |type_datum| RKD::Type.new(**type_datum) }
+
+      unlabeled_types = json.select { |a| a["property"] == "http://www.cidoc-crm.org/cidoc-crm/P2_has_type" }.map { |row| {label: row["prefLabel"], ref: row["value"]} }.select { |a| !a[:label] }.map { |row| row[:ref] }
+
+      if unlabeled_types.delete("http://vocab.getty.edu/aat/300189559")
+        @gender = "male"
+      elsif unlabeled_types.delete("http://vocab.getty.edu/aat/300189557")
+        @gender = "female"
+      end
+
+      type_data = json.select { |a| a["property"] == "http://www.w3.org/1999/02/22-rdf-syntax-ns#type" }.map { |row| {label: row["value"].sub(/http:\/\/www\.cidoc-crm\.org\/cidoc-crm\/[A-E]\d+_/, "").sub("_", " "), ref: row["value"]} }.select { |a| a[:label] }
+      @types += type_data.map { |type_datum| RKD::Type.new(**type_datum) }
+
+      p unlabeled_types if unlabeled_types.any?
+
+      @updated_at = begin
+        DateTime.parse json.find { |a| a["property"] == "http://www.w3.org/ns/prov#generatedAtTime" }["value"]
+      rescue Date::Error
+      rescue NoMethodError
+        if json == []
+          raise RKD::Artist::NotFoundError, "Nothing found for id #{identifier}"
+        end
+      end
+    end
+
+    private
+
+    # details are not expected to be updated
+    attr_writer :id, :name, :identifier, :gender, :birth_place_desc, :death_place_desc
+
+    def extract_places_data(responses)
+      grouped_responses = responses.group_by { |a| [a["placePoint"], a["placeLabel"]] }
+      grouped_responses
+        .map { |k, v| [k, v.map { |a| a["placeRef"] }] }
+        .map { |r| {point: r[0][0], label: r[0][1], refs: r[1]} }
+    end
+
+    def parse_performance_data(perf_id, values)
+      if perf_id.start_with?("https://data.rkd.nl/artists/#{identifier}/study") || perf_id.start_with?("https://data.rkd.nl/artists/#{identifier}/educate")
+        label = values.first["studyLabel"] || values.first["referenceContent"]
+        return if label.nil?
+        institution = Institution.initialize_from_label(label)
+        institution&.id = values.map { |a| a["range"] }.compact.first
+        place = institution&.place || Place.new(label: values.first["studyLabel"])
+        comments = values.map { |a| a["referenceContent"] }.uniq
+        date_span = DateSpan.parse(comments.first)
+        RKD::Performance::Study.new(place:, date_span:, institution:, comments: comments.join("\n\n"))
+      elsif perf_id.start_with?("https://data.rkd.nl/artists/#{identifier}/award")
+      # ignoring for now
+      elsif perf_id.start_with?("https://data.rkd.nl/artists/#{identifier}/work")
+        place_data = extract_places_data(values).first
+        place = Place.new(**place_data)
+        ts_begin = values.first["tookPlaceAtTimeSpanBegin"]
+        ts_end = values.first["tookPlaceAtTimeSpanEnd"]
+        date_span = RKD::DateSpan.new(ts_begin, ts_end)
+        RKD::Performance::Work.new(place:, date_span:)
+      else
+        place_data = extract_places_data(values).first
+        place = Place.new(**place_data)
+        ts_begin = values.first["tookPlaceAtTimeSpanBegin"]
+        ts_end = values.first["tookPlaceAtTimeSpanEnd"]
+        date_span = RKD::DateSpan.new(ts_begin, ts_end)
+        RKD::Performance.new(place:, date_span:) unless place.nilly? || date_span.nilly?
+      end
+    end
+  end
+end