1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
//! SubstanceNucleicAcid
//!
//! URL: http://hl7.org/fhir/StructureDefinition/SubstanceNucleicAcid
//!
//! Version: 5.0.0
//!
//! SubstanceNucleicAcid Resource: Nucleic acids are defined by three distinct elements: the base, sugar and linkage.
//!
//! FHIR: <https://build.fhir.org/>
//!
//! UML: <https://build.fhir.org/uml.html>
// Allow unused crate::r5::types as types;
#![allow(unused_imports)]
use crate::r5::types;
use ::serde::{Deserialize, Serialize};
use fhir_derive_macros::Validate;
/// SubstanceNucleicAcid describes the chemical structure of a nucleic acid
/// substance. Nucleic acids are defined by three distinct elements: the base,
/// sugar and linkage, and individual substance/moiety IDs are created for each
/// of these elements. The nucleotide sequence is always entered in the 5'-3'
/// direction. This resource is primarily used in medicinal product regulatory
/// submissions to characterize substances such as oligonucleotides.
///
/// Structurally, a nucleic acid substance is composed of one or more subunits
/// (linear chains of nucleotides), each of which may in turn describe its
/// constituent sugars and the linkages connecting them. This layered model
/// mirrors the way regulators and manufacturers document complex synthetic
/// oligonucleotide therapeutics (for example antisense oligonucleotides or
/// siRNA drug substances), where the exact sequence, stereochemistry, and
/// chemical linkages must be precisely characterized for identity and quality
/// control purposes. As with other substance-family resources, instances of
/// `SubstanceNucleicAcid` are typically referenced from a general `Substance`
/// or from medicinal product definition resources rather than being used
/// directly in clinical patient records.
///
/// See also: [`CodeableConcept`](crate::r5::types::CodeableConcept) for
/// coded elements such as `sequence_type`, and the related `Substance`,
/// `SubstanceProtein`, and `SubstancePolymer` resources that together model
/// the composition of complex substances.
///
/// # Examples
///
/// ```
/// use fhir::r5::resources::substance_nucleic_acid::SubstanceNucleicAcid;
///
/// let value = SubstanceNucleicAcid::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: SubstanceNucleicAcid = ::serde_json::from_value(json).unwrap();
/// assert_eq!(value, back);
/// ```
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct SubstanceNucleicAcid {
/// Logical id of this artifact
pub id: Option<types::String>,
/// Metadata about the resource
pub meta: Option<types::Meta>,
/// A set of rules under which this content was created
pub implicit_rules: Option<types::Uri>,
/// Language of the resource content
pub language: Option<types::Code>,
/// Text summary of the resource, for human interpretation
pub text: Option<types::Narrative>,
/// Contained, inline Resources
pub contained: Option<Vec<::serde_json::Value>>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored
pub modifier_extension: Option<Vec<types::Extension>>,
/// The type of the sequence, e.g. DNA or RNA, specified using a controlled vocabulary
pub sequence_type: Option<types::CodeableConcept>,
/// The number of linear nucleotide sequences (subunits) linked through phosphodiester bonds
pub number_of_subunits: Option<types::Integer>,
/// The area of hybridisation shall be described if applicable for double stranded RNA or DNA
pub area_of_hybridisation: Option<types::String>,
/// (TBC)
pub oligo_nucleotide_type: Option<types::CodeableConcept>,
/// The individual nucleotide subunits that make up this substance, listed in order of decreasing length
pub subunit: Option<Vec<SubstanceNucleicAcidSubunit>>,
}
/// Subunits are listed in order of decreasing length; sequences of the same
/// length will be ordered by molecular weight; subunits that have identical
/// sequences will be repeated multiple times.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct SubstanceNucleicAcidSubunit {
/// Unique id for inter-element referencing
pub id: Option<types::String>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored even if unrecognized
pub modifier_extension: Option<Vec<types::Extension>>,
/// Index of linear sequences of nucleic acids in order of decreasing length
pub subunit: Option<types::Integer>,
/// Actual nucleotide sequence notation from 5' to 3' end using standard single letter codes
pub sequence: Option<types::String>,
/// The length of the sequence shall be captured
pub length: Option<types::Integer>,
/// (TBC)
pub sequence_attachment: Option<types::Attachment>,
/// The nucleotide present at the 5' terminal shall be specified based on a controlled vocabulary
pub five_prime: Option<types::CodeableConcept>,
/// The nucleotide present at the 3' terminal shall be specified based on a controlled vocabulary
pub three_prime: Option<types::CodeableConcept>,
/// The linkages between sugar residues will also be captured
pub linkage: Option<Vec<SubstanceNucleicAcidSubunitLinkage>>,
/// 5.3.6.8.1 Sugar ID (Mandatory)
pub sugar: Option<Vec<SubstanceNucleicAcidSubunitSugar>>,
}
/// The linkages between sugar residues will also be captured.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct SubstanceNucleicAcidSubunitLinkage {
/// Unique id for inter-element referencing
pub id: Option<types::String>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored even if unrecognized
pub modifier_extension: Option<Vec<types::Extension>>,
/// The entity that links the sugar residues together
pub connectivity: Option<types::String>,
/// Each linkage will be registered as a fragment and have an ID
pub identifier: Option<types::Identifier>,
/// Each linkage will be registered as a fragment and have at least one name
pub name: Option<types::String>,
/// Residues shall be captured as described in 5.3.6.8.3
pub residue_site: Option<types::String>,
}
/// 5.3.6.8.1 Sugar ID (Mandatory).
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct SubstanceNucleicAcidSubunitSugar {
/// Unique id for inter-element referencing
pub id: Option<types::String>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored even if unrecognized
pub modifier_extension: Option<Vec<types::Extension>>,
/// The Substance ID of the sugar or sugar-like component that make up the nucleotide
pub identifier: Option<types::Identifier>,
/// The name of the sugar or sugar-like component that make up the nucleotide
pub name: Option<types::String>,
/// The residues that contain a given sugar will be captured
pub residue_site: Option<types::String>,
}
#[cfg(test)]
mod tests {
use super::*;
type T = SubstanceNucleicAcid;
#[test]
fn test_default() {
let _ = T::default();
}
#[test]
fn test_serde_round_trip() {
let value = T::default();
let json = ::serde_json::to_value(&value).expect("to_value");
let back: T = ::serde_json::from_value(json).expect("from_value");
assert_eq!(value, back);
}
}