GraphStructure: Difference between revisions

(created page (as a test))
 
(→‎Basic Structure: added docu for several items)
Line 4: Line 4:


= Graph Structure =
= Graph Structure =
== Basic Structure ==
== Basic Item ==
A basic item describes a ''learning content''. It uses [[Property:P2|subclass of]] to link to a defined [[Item:Q169|Cateogory]], that is used to group topics. Items are linked between each other with [[Property:P1|depends on]] to define an item that defines some previous knowledge, or [[Property:P21|related to]] to link to a similar item. Additionally they link to resources with [[Property:P21|resource]].


'''A short overview:'''
{| class="wikitable" style="margin:auto; text-align:center;"
|-
| Item || — [[Property:P2|subclass of]] → || [[Item:Q169|Category]]
|-
| Item || — [[Property:P1|depends on]] → || Prerequisite
|-
| Item || — [[Property:P4|related to]] → || Equivalent
|-
| Item || — [[Property:P21|resource]] →  || [[Item:Q446|Resource]]
|}
Additionally an item can be closer defined by linking an importance-item using [[Property:P13|importance]]. This can be done as simple link or as an added value to a property.
* [[Item:Q324|Mandatory]]
* [[Item:Q325|Essential]]
* [[Item:Q326|Recommended]]
* [[Item:Q327|Optional]]
== Resources ==
A Resource is an item that is defined by the Properties [[Property:P20|url]] to '''link''' to an external site and [[Property:P3|instance of]] a '''structure-item''', as seen below.
{{#widget:SPARQLquery|code=
#defaultView:Graph
PREFIX wdt: <https://graphit.ur.de/prop/direct/>
PREFIX wd: <https://graphit.ur.de/entity/>
select distinct ?item ?itemLabel ?category ?categoryLabel ?edgeLabel
where {
  bind (wd:Q446 as?item).
  ?item wdt:P3 ?category.
  service wikibase:label { bd:serviceParam wikibase:language "en".}
}
}}
'''A short overview:'''
{| class="wikitable" style="margin:auto; text-align:center;"
|-
| Resource || — [[Property:P20|url]] &rarr; || URL
|-
| Resource ||  — [[Property:P3|instance of]] &rarr; || Structure-Item
|-
|}
See: [[Item:Q280]] as an example and [[Item:Q446|Resource]] to reference a dummy element
== Category ==
A general category, such as "Mathematical Foundations"; used to group topics.
{{#widget:SPARQLquery|code=
#defaultView:Graph
PREFIX wdt: <https://graphit.ur.de/prop/direct/>
PREFIX wd: <https://graphit.ur.de/entity/>
select distinct ?item ?itemLabel ?category ?categoryLabel ?edgeLabel
where {
  bind (wd:Q169 as ?category).
  ?item wdt:P3 ?category.
  service wikibase:label { bd:serviceParam wikibase:language "en".}
}
}}
'''A short overview:'''
{| class="wikitable" style="margin:auto; text-align:center;"
{| class="wikitable" style="margin:auto; text-align:center;"
|-
|-
| [Item] || — [[Property:P1|depends on]] &rarr; || [Item]  
| Category-Item || — [[Property:P3|instance of]] &rarr; || [[Item:Q169|Category]]
|-
|}
 
A Course can include
 
== Course ==
A course encompasses a collection of learning contents. To declare an item as a [[Item:Q170|Course]] use [[Property:P3|instance of]].
 
'''A short overview:'''
{| class="wikitable" style="margin:auto; text-align:center;"
|-
| Course-Item || — [[Property:P3|instance of]] &rarr; || [[Item:Q170|Course]]
|-
| Course-Item || — [[Property:P24|taught by] &rarr; || [[Item:Q168|Educator]]
|-
|-
| [Item] || — [[Property:P4|related to]] &rarr; || [Item]
| Course-Item || — [[Property:P14|includes]] &rarr; || [[Item:Q427|Session]]
|}
See: [[Item:Q170]] as an example.
A course can include a [[Item:Q427|Session]], as seen below:
 
=== Session ===
A [[Item:Q427|Session]] acts as a possibility to group several items that will be discussed during an actual course session.
{{#widget:SPARQLquery|code=
#defaultView:Graph
# via: https://phabricator.wikimedia.org/T168715
PREFIX wdt: <https://graphit.ur.de/prop/direct/>
PREFIX wd: <https://graphit.ur.de/entity/>
select distinct ?item ?itemLabel ?session ?sessionLabel ?course ?courseLabel ?edgeLabel
where {
 
  ?session wdt:P14 ?item.
  MINUS {?item wdt:P20 ?url.}
  MINUS {?session wdt:P3 wd:Q162.}
  ?property a wikibase:Property;
              wikibase:directClaim wdt:P14.
 
  service wikibase:label { bd:serviceParam wikibase:language "en".
                          ?item rdfs:label ?itemLabel.
                          ?session rdfs:label ?sessionLabel.
                          ?property rdfs:label ?edgeLabel.}
}
}}
See: [[Item:Q248]] as an example.
 
'''A short overview:'''
{| class="wikitable" style="margin:auto; text-align:center;"
|-
|-
| [Item] || — [[Property:P3|instance]] &rarr;   || [Class]
| Session-Item || — [[Property:P3|instance of]] &rarr; || [[Item:Q427|Session]]
|-
|-
| [Item] || — [[Property:P21|resource]] &rarr; || [Resource]
| Session-Item || — [[Property:P14|includes] &rarr; || Item
|-
| Course-Item || — [[Property:P19|on date]] &rarr; || Date
|}
|}
== People ==
=== Student ===
=== Educator ===




Line 27: Line 138:
! style="background:#ffecb3" | An item  
! style="background:#ffecb3" | An item  
! style="background:#ffcc99" | uses Property  
! style="background:#ffcc99" | uses Property  
! style="background:#ff8080" | with Structure-Item
! style="background:#ff8080"| with Item
! style="background:#ff9999" | that declares
! style="background:#ff9999" | that declares
|-  
|-  
| [[Item:Q1|Markers]] || [[Property:P3]] - instance of || [[Item:Q169]] - Category || a general category or group
| [[Item:Q1|Markers]] || [[Property:P3]] - instance of || [[Item:Q169]] - Category || a general category or group
|-
| [[Item:Q100]] || [[Property:P21]] - resource || [[Item:Q399]] || a resource
|-
|-
|}
|}
= Useful Pages =
* [[DebugQueries]]
* [https://query.graphit.ur.de/| Query Service]

Revision as of 09:39, 26 August 2023

A Documentation of the structure behind the Graph.

Graph Structure

Basic Item

A basic item describes a learning content. It uses subclass of to link to a defined Cateogory, that is used to group topics. Items are linked between each other with depends on to define an item that defines some previous knowledge, or related to to link to a similar item. Additionally they link to resources with resource.

A short overview:

Item — subclass of → Category
Item — depends on → Prerequisite
Item — related to → Equivalent
Item — resource → Resource

Additionally an item can be closer defined by linking an importance-item using importance. This can be done as simple link or as an added value to a property.


Resources

A Resource is an item that is defined by the Properties url to link to an external site and instance of a structure-item, as seen below.

A short overview:

Resource — url → URL
Resource — instance of → Structure-Item

See: Item:Q280 as an example and Resource to reference a dummy element

Category

A general category, such as "Mathematical Foundations"; used to group topics.

A short overview:

Category-Item — instance of → Category

A Course can include

Course

A course encompasses a collection of learning contents. To declare an item as a Course use instance of.

A short overview:

Course-Item — instance of → Course
Course-Item — [[Property:P24|taught by] → Educator
Course-Item — includes → Session

See: Item:Q170 as an example. A course can include a Session, as seen below:

Session

A Session acts as a possibility to group several items that will be discussed during an actual course session.

See: Item:Q248 as an example.

A short overview:

Session-Item — instance of → Session
Session-Item — [[Property:P14|includes] → Item
Course-Item — on date → Date

People

Student

Educator

Elements

Properties

List of Properties

Items

An item uses Property with Item that declares
Markers Property:P3 - instance of Item:Q169 - Category a general category or group
Item:Q100 Property:P21 - resource Item:Q399 a resource

Useful Pages

Retrieved from "https://graphit.ur.de/w/index.php?title=GraphStructure&oldid=2238"