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 | == 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]] → || URL | |||
|- | |||
| Resource || — [[Property:P3|instance of]] → || 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: | | Category-Item || — [[Property:P3|instance of]] → || [[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]] → || [[Item:Q170|Course]] | |||
|- | |||
| Course-Item || — [[Property:P24|taught by] → || [[Item:Q168|Educator]] | |||
|- | |- | ||
| | | Course-Item || — [[Property:P14|includes]] → || [[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;" | |||
|- | |- | ||
| | | Session-Item || — [[Property:P3|instance of]] → || [[Item:Q427|Session]] | ||
|- | |- | ||
| [Item | | Session-Item || — [[Property:P14|includes] → || Item | ||
|- | |||
| Course-Item || — [[Property:P19|on date]] → || 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 | ! 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
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 |