Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
PharmCat committed Jan 18, 2023
1 parent cf725e1 commit aed2d61
Show file tree
Hide file tree
Showing 9 changed files with 200 additions and 89 deletions.
9 changes: 6 additions & 3 deletions docs/make.jl
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,12 @@ makedocs(
"Examples" => "examples.md",
"ODM" => [
"ODM" => ".//odm//odm.md",
"Form" => ".//odm//form.md",
"ItemGroup" => ".//odm//itemgroup.md",
"Item" => ".//odm//item.md",
"Study" => ".//odm//study.md",
"MetaDataVersion" => ".//odm//metadata.md",
"StudyEventDef" => ".//odm//event.md",
"FormDef" => ".//odm//form.md",
"ItemGroupDef" => ".//odm//itemgroup.md",
"ItemDef" => ".//odm//item.md",
"ClinicalData"=>".//odm//clinicaldata.md"],
"API" => "api.md"
],
Expand Down
28 changes: 17 additions & 11 deletions docs/src/odm/clinicaldata.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,23 @@
## Body

(SubjectData*, AuditRecords*, Signatures*, Annotations*)

## Attributes

ClinicalData node should get attributes:
* StudyOID oidref References the Study that uses the data nested within this element.
* MetaDataVersionOID oidref References the MetaDataVersion (within the above Study) that governs the data nested within this element.

* StudyOID
* MetaDataVersionOID
## Contained in

## Body

* SubjectData*
* AuditRecords*
* Signatures*
* Annotations*
* ODM

Clinical data for multiple subjects.

## In
The StudyOID and MetaDataVersionOID attributes select a particular metadata version. All metadata references (OIDs) occurring within this ClinicalData element refer to definitions within the selected metadata version.

ODM
Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
28 changes: 28 additions & 0 deletions docs/src/odm/event.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
## Body

(Description?, FormRef*, Alias*)

## Attributes

* OID oid
* Name name
* Repeating (Yes | No)
* Type (Scheduled | Unscheduled | Common)
* Category text (optional)

## Contained in

* MetaDataVersion

A StudyEventDef packages a set of forms. Scheduled Study Events correspond to sets of forms that are expected to be collected for each subject as part of the planned visit sequence for the study. Unscheduled Study Events are designed to collect data that may or may not occur for any particular subject such as a set of forms that are completed for an early termination due to a serious adverse event. A common Study Event is a collection of forms that are used at several different data collection events such as an Adverse Event or Concomitant Medications log.

The Repeating flag indicates that this type of study event can occur repeatedly within any given subject.

The Category attribute is typically used to indicate the study phase appropriate to this type of study event. Examples might include Screening, PreTreatment, Treatment, and FollowUp.

Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
25 changes: 21 additions & 4 deletions docs/src/odm/form.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,24 @@
## Body

(Description?, ItemGroupRef*, ArchiveLayout*, Alias*)

## Attributes

Form node should get attributes:
* OID oid
* Name name
* Repeating (Yes | No)

## Contained in

* MetaDataVersion

A FormDef describes a type of form that can occur in a study.

The Repeating flag indicates that this type of form can occur repeatedly within a containing study event.

* OID
* Name
* Repeating (`Yes` or `No`)
Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
57 changes: 21 additions & 36 deletions docs/src/odm/item.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,28 @@
## Attributes
## Body

Item node should get attributes:
(Description?, Question?, ExternalQuestion?, MeasurementUnitRef*, RangeCheck*, CodeListRef?, Role* Deprecated, Alias*)

* OID
* Name
* DataType
## Attributes

Optional attributes:
* OID oid
* Name name
* DataType (text | integer | float | date | time | datetime | string | boolean | double | hexBinary | base64Binary | hexFloat | base64Float | partialDate | partialTime | partialDatetime | durationDatetime | intervalDatetime | incompleteDatetime | incompleteDate | incompleteTime | URI )
* Length positiveInteger (optional)
* SignificantDigits nonNegativeInteger (optional)
* SASFieldName sasName (optional)
* SDSVarName sasName (optional)
* Origin text (optional)
* Comment text (optional)

* Length
* SignificantDigits
* SASFieldName
* SDSVarName
* Origin
* Comment
# Contained in

## DataType
* MetaDataVersion

DataType values:
An ItemDef describes a type of item that can occur within a study. Item properties include name, datatype, measurement units, range or codelist restrictions, and several other properties.

* text
* integer
* float
* date
* time
* datetime
* string
* boolean
* double
* hexBinary
* base64Binary
* hexFloat
* base64Float
* partialDate
* partialTime
* partialDatetime
* durationDatetime
* intervalDatetime
* incompleteDatetime
* incompleteDate
* incompleteTime
* URI
Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
44 changes: 32 additions & 12 deletions docs/src/odm/itemgroup.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,37 @@
## Body

(Description?, ItemRef*, Alias*)

## Attributes

ItemGroup node should get attributes:
* OID oid
* Name name
* Repeating (Yes | No)
* IsReferenceData (Yes | No) (optional)
* SASDatasetName sasName (optional)
* Domain text (optional)
* Origin text (optional)
* Role name (optional) Deprecated
* Purpose text (optional)
* Comment text (optional)

## Contained in

* MetaDataVersion

An ItemGroupDef describes a type of item group that can occur within a study.

The Repeating flag indicates that this type of item group can occur repeatedly within the containing form (or reference data).

If IsReferenceData is Yes, this type of item group can occur only within a ReferenceData element. If IsReferenceData is No, this type of item group can occur only within a ClinicalData element. The default for this attribute is No.

* OID
* Name
* Repeating (`Yes` or `No`)
The Domain, Origin, Purpose, and Comment attributes carry submission information as described in the CDISC Submission Metadata Model located in the SDTM Metadata Submission Guidelines.

Optional attributes:
Note: The Role attribute can be considered a synonym for Purpose. New applications should use Purpose rather than Role.

* IsReferenceData (`Yes` or `No`)
* SASDatasetName
* Domain
* Origin
* Role (Deprecated)
* Purpose
* Comment
Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
24 changes: 24 additions & 0 deletions docs/src/odm/metadata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
## Body

(Include?, Protocol?, StudyEventDef*, FormDef*, ItemGroupDef*, ItemDef*, CodeList*, ImputationMethod*Deprecated, Presentation*, ConditionDef*, MethodDef*)

## Attributes

* OID oid
* Name name
* Description text (optional)

## Contained in:

* Study

A metadata version defines the types of study events, forms, item groups, and items that form the study data.

The Include element references a prior metadata version. This causes all the definitions in that prior metadata version to be automatically included in this one. Any of the included definitions can be replaced (overridden) by explicitly giving a new version of the definition (with the same OID) in the new metadata version. See Include for more information on how the Include element works. New definitions (with new OIDs) can be added in the same way.

Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
54 changes: 31 additions & 23 deletions docs/src/odm/odm.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,34 @@
## Attributes:

Optional attributes:

* Description
* FileType
* Granularity
* Archival
* FileOID
* CreationDateTime
* PriorFileOID
* AsOfDateTime
* ODMVersion
* Originator
* SourceSystem
* SourceSystemVersion
* ID
# ODM

Description of main structural parts provided bellow. Only few elements descibed and only for imformation purpose. **An official version of ODM specificatoion document is available on the ODM page of the CDISC website http://www.cdisc.org/odm.**


## Body

* Study*
* AdminData*
* ReferenceData*
* ClinicalData*
* Association*
* ds:Signature*
(Study*, AdminData*, ReferenceData*, ClinicalData*, Association*, ds:Signature*)

## Attributes

* Description text (optional) The sender should use the Description attribute to record any information that will help the receiver interpret the document correctly.
* FileType ( Snapshot | Transactional ) Snapshot means that the document contains only the current state of the data and metadata it describes, and no transactional history. A Snapshot document may include only one instruction per data point. For clinical data, TransactionType in a Snapshot file must either not be present or be Insert. Transactional means that the document may contain more than one instruction per data point. Use a Transactional document to send both what the current state of the data is, and how it came to be there.
* Granularity ( All | Metadata | AdminData | ReferenceData | AllClinicalData | SingleSite | SingleSubject ) (optional) Granularity is intended to give the sender a shorthand way to describe the breadth of the information in the document, for certain common types of documents. All means the entire study; Metadata means the MetaDataVersion element; AdminData and ReferenceData mean the corresponding elements; AllClinicalData, SingleSite, and SingleSubject are successively more tightly focused subset of the study's clinical data. If these shorthand categories are not sufficient, use the Description attribute to give details.
* Archival (Yes | No) (optional) Set this attribute to Yes to indicate that the file is intended to meet the requirements of an electronic record as defined in 21 CFR 11. See Single Files and Collections for an fuller discussion of the meaning of this attribute, as well as its interaction with other ODM attributes.
* FileOID oid A unique identifier for this file.
* CreationDateTime datetime Time of creation of the file containing the document.
* PriorFileOID oidref (optional) Reference to the previous file (if any) in a series.
* AsOfDateTime datetime (optional) The date/time at which the source database was queried in order to create this document.
* ODMVersion ( 1.2 | 1.2.1 | 1.3 | 1.3.1 | 1.3.2 ) (optional) The version of the ODM standard used.
* Originator text (optional) The organization that generated the ODM file.
* SourceSystem text (optional) The computer system or database management system that is the source of the information in this file.
* SourceSystemVersion text (optional) The version of the "SourceSystem" above.
* ID ID (optional) May be used by the ds:Signature element to refer back to this element.


An element group consists of one or more element names (or element groups) enclosed in parentheses, and separated with commas or vertical bars. Commas indicate that the elements (or element groups) must occur in the XML sequentially in the order listed in the group. Vertical bars indicate that exactly one of the elements (or element groups) must occur. An element or element group can be followed by a ? (meaning optional), a * (meaning zero or more occurrences), or a + (meaning one or more occurrences).

Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm
20 changes: 20 additions & 0 deletions docs/src/odm/study.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
## Body

(GlobalVariables, BasicDefinitions?, MetaDataVersion*)

## Attributes

* OID oid

## Contained in

* ODM

This element collects static structural information about an individual study.

Based on
Specification for the Operational Data Model (ODM)
Version 1.3.2 Production
Source File: ODM1-3-2.htm
Last Update: 2013-12-01 Copyright © CDISC 2013.
http://www.cdisc.org/odm

0 comments on commit aed2d61

Please sign in to comment.