Class: RDF::Vocab::DISCO

Inherits:
StrictVocabulary
  • Object
show all
Defined in:
lib/rdf/vocab/disco.rb

Overview

Vocabulary for <rdf-vocabulary.ddialliance.org/discovery#>

DDI-RDF Discovery Vocabulary

This specification defines the DDI Discovery Vocabulary, an RDF Schema vocabulary that enables discovery of research and survey data on the Web. It is based on DDI (Data Documentation Initiative) XML formats.

This specification defines the DDI Discovery Vocabulary, an RDF Schema vocabulary that enables discovery of research and survey data on the Web. It is based on DDI (Data Documentation Initiative) XML formats.

Version:

  • Version 0.6 - 2013-09-30

Instance Attribute Summary collapse

Instance Attribute Details

#aggregation ⇒ RDF::Vocabulary::Term (readonly)

This property points to the aggregated data set of a microdata data set. The aggregated data set is a qb:DataSet of the RDF Data Cube Vocabulary.

Returns:

  • (RDF::Vocabulary::Term) 


76
77
78
 
# File 'lib/rdf/vocab/disco.rb', line 76

def aggregation
  @aggregation
end

#analysisUnit ⇒ RDF::Vocabulary::Term (readonly)

This property links to the analysis unit of a Study, a StudyGroup, or a Variable.

Returns:

  • (RDF::Vocabulary::Term) 


80
81
82
 
# File 'lib/rdf/vocab/disco.rb', line 80

def analysisUnit
  @analysisUnit
end

#AnalysisUnit ⇒ RDF::Vocabulary::Term (readonly)

The process collecting data is focusing on the analysis of a particular type of subject. If, for example, the adult population of Finland is being studied, the AnalysisUnit would be individuals or persons.

Returns:

  • (RDF::Vocabulary::Term) 


12
13
14
 
# File 'lib/rdf/vocab/disco.rb', line 12

def AnalysisUnit
  @AnalysisUnit
end

#basedOn ⇒ RDF::Vocabulary::Term (readonly)

This property points to the RepresentedVariable the Variable is based on.

Returns:

  • (RDF::Vocabulary::Term) 


84
85
86
 
# File 'lib/rdf/vocab/disco.rb', line 84

def basedOn
  @basedOn
end

#caseQuantity ⇒ RDF::Vocabulary::Term (readonly)

This property is used for representing the case quantity of a DataFile.

Returns:

  • (RDF::Vocabulary::Term) 


88
89
90
 
# File 'lib/rdf/vocab/disco.rb', line 88

def caseQuantity
  @caseQuantity
end

#CategoryStatistics ⇒ RDF::Vocabulary::Term (readonly)

For CategoryStatistics, frequencies, percentages, and weighted percentages can be defined.

Returns:

  • (RDF::Vocabulary::Term) 


16
17
18
 
# File 'lib/rdf/vocab/disco.rb', line 16

def CategoryStatistics
  @CategoryStatistics
end

#collectionMode ⇒ RDF::Vocabulary::Term (readonly)

This property points to the mode of collection of a Questionnaire which is a skos:Concept.

Returns:

  • (RDF::Vocabulary::Term) 


92
93
94
 
# File 'lib/rdf/vocab/disco.rb', line 92

def collectionMode
  @collectionMode
end

#computationBase ⇒ RDF::Vocabulary::Term (readonly)

computationBase expresses if the cases - which are the basis of the computation of a statistics value - are valid, invalid or the total of both. The usage of computationBase for frequency differs from the usage for the percentage statistics and the summary statistics. A distinction regarding computationBase doesn’t apply to frequency as category statistic. Please find more details in Section 6.3 of the specification.

Returns:

  • (RDF::Vocabulary::Term) 


96
97
98
 
# File 'lib/rdf/vocab/disco.rb', line 96

def computationBase
  @computationBase
end

#concept ⇒ RDF::Vocabulary::Term (readonly)

This property points to the DDI concept of a RepresentedVariable, a Variable, or a Question

Returns:

  • (RDF::Vocabulary::Term) 


100
101
102
 
# File 'lib/rdf/vocab/disco.rb', line 100

def concept
  @concept
end

#context ⇒ RDF::Vocabulary::Term (readonly)

context specifies conditions which have to be fulfilled for particular mappings. Context information can be either a SPARQL query or an informal description as plain literal.

Returns:

  • (RDF::Vocabulary::Term) 


104
105
106
 
# File 'lib/rdf/vocab/disco.rb', line 104

def context
  @context
end

#cumulativePercentage ⇒ RDF::Vocabulary::Term (readonly)

This property is used to describe the cumulative percentages within category statistics. See Sections 6 and 7 more more details and examples.

Returns:

  • (RDF::Vocabulary::Term) 


108
109
110
 
# File 'lib/rdf/vocab/disco.rb', line 108

def cumulativePercentage
  @cumulativePercentage
end

#DataFile ⇒ RDF::Vocabulary::Term (readonly)

The class DataFile, which is also a dcmitype:Dataset, represents all the data files containing the microdata datasets.

Returns:

  • (RDF::Vocabulary::Term) 


20
21
22
 
# File 'lib/rdf/vocab/disco.rb', line 20

def DataFile
  @DataFile
end

#dataFile ⇒ RDF::Vocabulary::Term (readonly)

This property points to the DataFile of a Study or a LogicalDataSet.

Returns:

  • (RDF::Vocabulary::Term) 


112
113
114
 
# File 'lib/rdf/vocab/disco.rb', line 112

def dataFile
  @dataFile
end

#ddifile ⇒ RDF::Vocabulary::Term (readonly)

This property points from a Study or a StudyGroup to the original DDI file which is a foaf:Document.

Returns:

  • (RDF::Vocabulary::Term) 


116
117
118
 
# File 'lib/rdf/vocab/disco.rb', line 116

def ddifile
  @ddifile
end

#DescriptiveStatistics ⇒ RDF::Vocabulary::Term (readonly)

SummaryStatistics pointing to variables and CategoryStatistics pointing to categories and codes are both DescriptiveStatistics.

Returns:

  • (RDF::Vocabulary::Term) 


24
25
26
 
# File 'lib/rdf/vocab/disco.rb', line 24

def DescriptiveStatistics
  @DescriptiveStatistics
end

#endDate ⇒ RDF::Vocabulary::Term (readonly)

Defines the end date of a period of time. Please note that this property is a feature at risk, since the domain is not a class of Disco. Maintainers of the domain ontology may define their own property.

Returns:

  • (RDF::Vocabulary::Term) 


120
121
122
 
# File 'lib/rdf/vocab/disco.rb', line 120

def endDate
  @endDate
end

#externalDocumentation ⇒ RDF::Vocabulary::Term (readonly)

This property points from an Instrument to a foaf:Document which is the external documentation of the Instrument.

Returns:

  • (RDF::Vocabulary::Term) 


124
125
126
 
# File 'lib/rdf/vocab/disco.rb', line 124

def externalDocumentation
  @externalDocumentation
end

#frequency ⇒ RDF::Vocabulary::Term (readonly)

This property is used to describe the frequencies within category statistics. See Sections 6 and 7 more more details and examples.

Returns:

  • (RDF::Vocabulary::Term) 


128
129
130
 
# File 'lib/rdf/vocab/disco.rb', line 128

def frequency
  @frequency
end

#fundedBy ⇒ RDF::Vocabulary::Term (readonly)

This property points from a Study or a StudyGroup to the funding foaf:Agent which is either a foaf:Person or a org:Organization.

Returns:

  • (RDF::Vocabulary::Term) 


132
133
134
 
# File 'lib/rdf/vocab/disco.rb', line 132

def fundedBy
  @fundedBy
end

#hadRole ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the role of an Agent, e.g. analyst, data modeler, programmer, co-investigator or others.

Returns:

  • (RDF::Vocabulary::Term) 


136
137
138
 
# File 'lib/rdf/vocab/disco.rb', line 136

def hadRole
  @hadRole
end

#inGroup ⇒ RDF::Vocabulary::Term (readonly)

This property points from a Study to the StudyGroup which contains the Study.

Returns:

  • (RDF::Vocabulary::Term) 


140
141
142
 
# File 'lib/rdf/vocab/disco.rb', line 140

def inGroup
  @inGroup
end

#inputVariable ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the original Variable of an aggregated qb:DataSet. Please note that this property is a feature at risk, since the domain is not a class of Disco. Maintainers of the domain ontology may define their own property.

Returns:

  • (RDF::Vocabulary::Term) 


144
145
146
 
# File 'lib/rdf/vocab/disco.rb', line 144

def inputVariable
  @inputVariable
end

#instrument ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the Instrument of a Study or a LogicalDataSet.

Returns:

  • (RDF::Vocabulary::Term) 


148
149
150
 
# File 'lib/rdf/vocab/disco.rb', line 148

def instrument
  @instrument
end

#Instrument ⇒ RDF::Vocabulary::Term (readonly)

The data for the study are collected by an Instrument. The purpose of an Instrument, i.e. an interview, a questionnaire or another entity used as a means of data collection, is in the case of a survey to record the flow of a questionnaire, its use of questions, and additional component parts. A questionnaire contains a flow of questions.

Returns:

  • (RDF::Vocabulary::Term) 


28
29
30
 
# File 'lib/rdf/vocab/disco.rb', line 28

def Instrument
  @Instrument
end

#isPublic ⇒ RDF::Vocabulary::Term (readonly)

This property is used as a flag indicating if the microdata dataset is publicly available. The value true indicates that the dataset can be accessed (usually downloaded) by anyone.

Returns:

  • (RDF::Vocabulary::Term) 


152
153
154
 
# File 'lib/rdf/vocab/disco.rb', line 152

def isPublic
  @isPublic
end

#isValid ⇒ RDF::Vocabulary::Term (readonly)

Indicates if the code (represented by skos:Concept) is valid or missing. Please note that this property is a feature at risk, since the domain is not a class of Disco. Maintainers of the domain ontology may define their own property.

Returns:

  • (RDF::Vocabulary::Term) 


156
157
158
 
# File 'lib/rdf/vocab/disco.rb', line 156

def isValid
  @isValid
end

#kindOfData ⇒ RDF::Vocabulary::Term (readonly)

The general kind of data (e.g. geospatial, register, survey) collected in this study, given either as a skos:Concept, or as a blank node with attached free-text rdfs:label.

Returns:

  • (RDF::Vocabulary::Term) 


160
161
162
 
# File 'lib/rdf/vocab/disco.rb', line 160

def kindOfData
  @kindOfData
end

#LogicalDataSet ⇒ RDF::Vocabulary::Term (readonly)

Each study has a set of logical metadata associated with the processing of data, at the time of collection or later during cleaning, and re-coding. LogicalDataSet represents the microdata dataset.

Returns:

  • (RDF::Vocabulary::Term) 


32
33
34
 
# File 'lib/rdf/vocab/disco.rb', line 32

def LogicalDataSet
  @LogicalDataSet
end

#Mapping ⇒ RDF::Vocabulary::Term (readonly)

This class is for representing mappings betwenn DDI-RDF and DDI-XML. See Section 10 in the specification for more details and examples.

Returns:

  • (RDF::Vocabulary::Term) 


36
37
38
 
# File 'lib/rdf/vocab/disco.rb', line 36

def Mapping
  @Mapping
end

#percentage ⇒ RDF::Vocabulary::Term (readonly)

This property is used to describe the percentages within category statistics. See Sections 6 and 7 more more details and examples.

Returns:

  • (RDF::Vocabulary::Term) 


164
165
166
 
# File 'lib/rdf/vocab/disco.rb', line 164

def percentage
  @percentage
end

#product ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the LogicalDataSets of a Study.

Returns:

  • (RDF::Vocabulary::Term) 


168
169
170
 
# File 'lib/rdf/vocab/disco.rb', line 168

def product
  @product
end

#purpose ⇒ RDF::Vocabulary::Term (readonly)

The purpose of a Study of a StudyGroup.

Returns:

  • (RDF::Vocabulary::Term) 


172
173
174
 
# File 'lib/rdf/vocab/disco.rb', line 172

def purpose
  @purpose
end

#question ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the Questions associated to Variables or contained in Questionnaires.

Returns:

  • (RDF::Vocabulary::Term) 


176
177
178
 
# File 'lib/rdf/vocab/disco.rb', line 176

def question
  @question
end

#Question ⇒ RDF::Vocabulary::Term (readonly)

A Question is designed to get information upon a subject, or sequence of subjects, from a respondent.

Returns:

  • (RDF::Vocabulary::Term) 


40
41
42
 
# File 'lib/rdf/vocab/disco.rb', line 40

def Question
  @Question
end

#Questionnaire ⇒ RDF::Vocabulary::Term (readonly)

A questionnaire contains a flow of questions. Questionnaires must contain 1 to n questions using the object property question. Particular questions may be contained in 0 to n questionnaires.

Returns:

  • (RDF::Vocabulary::Term) 


44
45
46
 
# File 'lib/rdf/vocab/disco.rb', line 44

def Questionnaire
  @Questionnaire
end

#questionText ⇒ RDF::Vocabulary::Term (readonly)

This property contains the actual text of a question as string. See Section 8.2 for examples.

Returns:

  • (RDF::Vocabulary::Term) 


180
181
182
 
# File 'lib/rdf/vocab/disco.rb', line 180

def questionText
  @questionText
end

#representation ⇒ RDF::Vocabulary::Term (readonly)

RepresentedVariables and Variables can have a Representation whose individuals are either of the class rdfs:Datatype (to represent values) or skos:ConceptScheme (to represent code lists).

Returns:

  • (RDF::Vocabulary::Term) 


184
185
186
 
# File 'lib/rdf/vocab/disco.rb', line 184

def representation
  @representation
end

#Representation ⇒ RDF::Vocabulary::Term (readonly)

Representation of a variable or question definition.

Returns:

  • (RDF::Vocabulary::Term) 


48
49
50
 
# File 'lib/rdf/vocab/disco.rb', line 48

def Representation
  @Representation
end

#RepresentedVariable ⇒ RDF::Vocabulary::Term (readonly)

RepresentedVariables encompasse study-independent, re-usable parts of variables like occupation classification.

Returns:

  • (RDF::Vocabulary::Term) 


52
53
54
 
# File 'lib/rdf/vocab/disco.rb', line 52

def RepresentedVariable
  @RepresentedVariable
end

#responseDomain ⇒ RDF::Vocabulary::Term (readonly)

The response domain of questions. The response domain has to be an instance of the class Representation.

Returns:

  • (RDF::Vocabulary::Term) 


188
189
190
 
# File 'lib/rdf/vocab/disco.rb', line 188

def responseDomain
  @responseDomain
end

#startDate ⇒ RDF::Vocabulary::Term (readonly)

Defines the start date of a period of time. Please note that this property is a feature at risk, since the domain is not a class of Disco. Maintainers of the domain ontology may define their own property.

Returns:

  • (RDF::Vocabulary::Term) 


192
193
194
 
# File 'lib/rdf/vocab/disco.rb', line 192

def startDate
  @startDate
end

#statisticsCategory ⇒ RDF::Vocabulary::Term (readonly)

This property points to the skos:Concept (representing codes and categories) of a specific CategoryStatistics individual.

Returns:

  • (RDF::Vocabulary::Term) 


196
197
198
 
# File 'lib/rdf/vocab/disco.rb', line 196

def statisticsCategory
  @statisticsCategory
end

#statisticsDataFile ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the DataFile of a specific DesciptiveStatistics individual. DescriptiveStatistics may have statisticsDataFile relations to 0 to n data files (DataFile) and data files (DataFile) may be in 0 to n statisticsDataFile relations to DescriptiveStatistics individuals.

Returns:

  • (RDF::Vocabulary::Term) 


200
201
202
 
# File 'lib/rdf/vocab/disco.rb', line 200

def statisticsDataFile
  @statisticsDataFile
end

#statisticsVariable ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the Variable of a specific SummaryStatistics individual. SummaryStatistics point to 0 to n variables (Variable) using the object property statisticsVariable.

Returns:

  • (RDF::Vocabulary::Term) 


204
205
206
 
# File 'lib/rdf/vocab/disco.rb', line 204

def statisticsVariable
  @statisticsVariable
end

#Study ⇒ RDF::Vocabulary::Term (readonly)

A Study represents the process by which a data set was generated or collected.

Returns:

  • (RDF::Vocabulary::Term) 


56
57
58
 
# File 'lib/rdf/vocab/disco.rb', line 56

def Study
  @Study
end

#StudyGroup ⇒ RDF::Vocabulary::Term (readonly)

In some cases, where data collection is cyclic or on-going, data sets may be released as a StudyGroup, where each cycle or wave of the data collection activity produces one or more data sets. This is typical for longitudinal studies, panel studies, and other types of series (to use the DDI term). In this case, a number of Study objects would be collected into a single StudyGroup.

Returns:

  • (RDF::Vocabulary::Term) 


60
61
62
 
# File 'lib/rdf/vocab/disco.rb', line 60

def StudyGroup
  @StudyGroup
end

#subtitle ⇒ RDF::Vocabulary::Term (readonly)

The sub-title of a Study of a StudyGroup.

Returns:

  • (RDF::Vocabulary::Term) 


208
209
210
 
# File 'lib/rdf/vocab/disco.rb', line 208

def subtitle
  @subtitle
end

#SummaryStatistics ⇒ RDF::Vocabulary::Term (readonly)

For SummaryStatistics, maximum values, minimum values, and standard deviations can be defined.

Returns:

  • (RDF::Vocabulary::Term) 


64
65
66
 
# File 'lib/rdf/vocab/disco.rb', line 64

def SummaryStatistics
  @SummaryStatistics
end

#summaryStatisticsType ⇒ RDF::Vocabulary::Term (readonly)

This property points to the summary statistics type of a Questionnaire which is a skos:Concept.

Returns:

  • (RDF::Vocabulary::Term) 


212
213
214
 
# File 'lib/rdf/vocab/disco.rb', line 212

def summaryStatisticsType
  @summaryStatisticsType
end

#Universe ⇒ RDF::Vocabulary::Term (readonly)

A Universe is the total membership or population of a defined class of people, objects or events.

Returns:

  • (RDF::Vocabulary::Term) 


68
69
70
 
# File 'lib/rdf/vocab/disco.rb', line 68

def Universe
  @Universe
end

#universe ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the Universe(s) of Studies, StudyGrous, RepresentedVariables, Variables, Questions, and LogicalDataSets.

Returns:

  • (RDF::Vocabulary::Term) 


216
217
218
 
# File 'lib/rdf/vocab/disco.rb', line 216

def universe
  @universe
end

#Variable ⇒ RDF::Vocabulary::Term (readonly)

Variables provide a definition of the column in a rectangular data file. Variable is a characteristic of a unit being observed. A variable might be the answer of a question, have an administrative source, or be derived from other variables.

Returns:

  • (RDF::Vocabulary::Term) 


72
73
74
 
# File 'lib/rdf/vocab/disco.rb', line 72

def Variable
  @Variable
end

#variable ⇒ RDF::Vocabulary::Term (readonly)

This property indicates the Variable of a Study and points to Variable contained in the LogicalDataSet.

Returns:

  • (RDF::Vocabulary::Term) 


220
221
222
 
# File 'lib/rdf/vocab/disco.rb', line 220

def variable
  @variable
end

#variableQuantity ⇒ RDF::Vocabulary::Term (readonly)

This property can be used when (1) no variable level information is available and when (2) only a stub of the RDF is requested e.g when returning basic information on a study of file, no information on potentially hundreds or thousands of variables references or metadata has to be returned.

Returns:

  • (RDF::Vocabulary::Term) 


224
225
226
 
# File 'lib/rdf/vocab/disco.rb', line 224

def variableQuantity
  @variableQuantity
end

#weightedBy ⇒ RDF::Vocabulary::Term (readonly)

SummaryStatistics or CategoryStatistics resources may be weighted by a specific Variable.

Returns:

  • (RDF::Vocabulary::Term) 


228
229
230
 
# File 'lib/rdf/vocab/disco.rb', line 228

def weightedBy
  @weightedBy
end