Skip to content

URI hierarchy

Jump to bottom
rspeer edited this page Sep 27, 2011 · 26 revisions

Nodes in ConceptNet have URIs. A URI should tell you:

  • what kind of object you're looking at
  • important defining properties of it, such as its language or its text ("name")
  • (if you prepend a server name) what URL to go to to get information about it, when we put up our API

For example, one concept URI is /concept/en/coffee. The type is "concept". The type defines that the parts that come next are the language (en) and the concept name (concept).

The internal encoding is UTF-8 with spaces changed to underscores. We don't URI-encode things on this end (such as changing apostrophes to %27), though someone accessing our API will have to do that.

The hierarchy

/: the root object, possibly the starting point for spreading confidence and for garbage collection

/assertions: Assertions

  • Assertions are specified by several concepts (the first of which acts as a relation), separated by /_ before each concept URI.
  • Examples:
    • /assertion/_/relation/IsA/_/concept/en/dog/_/concept/en/animal
    • /assertion/_/relation/UsedFor/_/concept/zh_TW/枕頭/_/concept/zh_TW/睡覺
    • /assertion/_/concept/en/eat/_/concept/en/cow/_/concept/en/grass

/concept: Concepts

Specified by a language and a name.

  • /concept/en: English concepts
    • /concept/en/coffee (for example): the concept "coffee" in English
    • /concept/en/for: the preposition "for", probably being used as a relation
  • /concept/zh_TW: Traditional Chinese concepts as used in Taiwan

/conjunction: conjunctions between sources

See below for how sources are specified. The sources in a conjunction are separated by /_.

  • /conjunction/_/source/web/en.wiktionary.org/_/source/rule/wiktionary_scraper (for example): we read things from Wiktionary with a scraper

/frame: text patterns

Specified by a name only.

  • /frame/{1}_is_used_for_{2} (for example)

/relation: language-independent relations

Specified by a name only.

  • /relation/UsedFor (for example): the "used for" relation, across all languages

/source: knowledge sources

Specified by an arbitrary hierarchy, examples of which are shown here.

  • /source/contributor: crowd-sourced contributors.
    • /source/contributor/omcs/bedume: contributors from the OMCS database
    • /source/contributor/petgame/3362: contributors from the NTU pet game
  • /source/web: Web sites
    • /source/web/en.wiktionary.org: a Web site, considered as a whole
  • /source/activity: an interface used by contributors
    • /source/activity/analogyspace
  • /source/rule: a derivation rule, ideally packaged with the code
    • /source/rule/wiktionary_scraper

/text: plain text that fills a frame and can be turned into concepts

Specified by a name only.

  • /text/en/a_dog: the phrase "a dog"

Starting points

Reproducibility

Details

Clone this wiki locally