/
the-eml-module-and-resources.html
548 lines (507 loc) · 52.6 KB
/
the-eml-module-and-resources.html
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
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<title>5 The EML Module and Resources | Ecological Metadata Language (EML)</title>
<meta name="description" content="5 The EML Module and Resources | Ecological Metadata Language (EML)" />
<meta name="generator" content="bookdown 0.12 and GitBook 2.6.7" />
<meta property="og:title" content="5 The EML Module and Resources | Ecological Metadata Language (EML)" />
<meta property="og:type" content="book" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:title" content="5 The EML Module and Resources | Ecological Metadata Language (EML)" />
<meta name="date" content="2019-08-15" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="black" />
<link rel="prev" href="whats-new-in-eml-2-2-0.html">
<link rel="next" href="data-structure-modules.html">
<script src="libs/jquery-2.2.3/jquery.min.js"></script>
<link href="libs/gitbook-2.6.7/css/style.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-table.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-bookdown.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-highlight.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-search.css" rel="stylesheet" />
<link href="libs/gitbook-2.6.7/css/plugin-fontsettings.css" rel="stylesheet" />
<style type="text/css">
a.sourceLine { display: inline-block; line-height: 1.25; }
a.sourceLine { pointer-events: none; color: inherit; text-decoration: inherit; }
a.sourceLine:empty { height: 1.2em; }
.sourceCode { overflow: visible; }
code.sourceCode { white-space: pre; position: relative; }
pre.sourceCode { margin: 0; }
@media screen {
div.sourceCode { overflow: auto; }
}
@media print {
code.sourceCode { white-space: pre-wrap; }
a.sourceLine { text-indent: -1em; padding-left: 1em; }
}
pre.numberSource a.sourceLine
{ position: relative; left: -4em; }
pre.numberSource a.sourceLine::before
{ content: attr(data-line-number);
position: relative; left: -1em; text-align: right; vertical-align: baseline;
border: none; pointer-events: all; display: inline-block;
-webkit-touch-callout: none; -webkit-user-select: none;
-khtml-user-select: none; -moz-user-select: none;
-ms-user-select: none; user-select: none;
padding: 0 4px; width: 4em;
color: #aaaaaa;
}
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
div.sourceCode
{ }
@media screen {
a.sourceLine::before { text-decoration: underline; }
}
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code span.at { color: #7d9029; } /* Attribute */
code span.bn { color: #40a070; } /* BaseN */
code span.bu { } /* BuiltIn */
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code span.ch { color: #4070a0; } /* Char */
code span.cn { color: #880000; } /* Constant */
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
code span.dt { color: #902000; } /* DataType */
code span.dv { color: #40a070; } /* DecVal */
code span.er { color: #ff0000; font-weight: bold; } /* Error */
code span.ex { } /* Extension */
code span.fl { color: #40a070; } /* Float */
code span.fu { color: #06287e; } /* Function */
code span.im { } /* Import */
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
code span.op { color: #666666; } /* Operator */
code span.ot { color: #007020; } /* Other */
code span.pp { color: #bc7a00; } /* Preprocessor */
code span.sc { color: #4070a0; } /* SpecialChar */
code span.ss { color: #bb6688; } /* SpecialString */
code span.st { color: #4070a0; } /* String */
code span.va { color: #19177c; } /* Variable */
code span.vs { color: #4070a0; } /* VerbatimString */
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
</style>
<link rel="stylesheet" href="style.css" type="text/css" />
</head>
<body>
<div class="book without-animation with-summary font-size-2 font-family-1" data-basepath=".">
<div class="book-summary">
<nav role="navigation">
<ul class="summary">
<li><a href="./">EML Specification</a></li>
<li class="divider"></li>
<li class="chapter" data-level="1" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html"><i class="fa fa-check"></i><b>1</b> EML: Ecological Metadata Language</a><ul>
<li class="chapter" data-level="1.1" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#getting-started"><i class="fa fa-check"></i><b>1.1</b> Getting Started</a></li>
<li class="chapter" data-level="1.2" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#about-the-eml-project"><i class="fa fa-check"></i><b>1.2</b> About the EML Project</a></li>
<li class="chapter" data-level="1.3" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#contributing"><i class="fa fa-check"></i><b>1.3</b> Contributing</a></li>
<li class="chapter" data-level="1.4" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#history"><i class="fa fa-check"></i><b>1.4</b> History</a></li>
<li class="chapter" data-level="1.5" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#older-versions-deprecated"><i class="fa fa-check"></i><b>1.5</b> Older versions (deprecated)</a></li>
<li class="chapter" data-level="1.6" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#copyright-and-license"><i class="fa fa-check"></i><b>1.6</b> Copyright and License</a></li>
<li class="chapter" data-level="1.7" data-path="eml-ecological-metadata-language.html"><a href="eml-ecological-metadata-language.html#funding-and-acknowledgements"><i class="fa fa-check"></i><b>1.7</b> Funding and Acknowledgements</a></li>
</ul></li>
<li class="chapter" data-level="2" data-path="features.html"><a href="features.html"><i class="fa fa-check"></i><b>2</b> Features</a></li>
<li class="chapter" data-level="3" data-path="contributors.html"><a href="contributors.html"><i class="fa fa-check"></i><b>3</b> Contributors</a><ul>
<li class="chapter" data-level="3.1" data-path="contributors.html"><a href="contributors.html#current-contributors"><i class="fa fa-check"></i><b>3.1</b> Current contributors</a></li>
<li class="chapter" data-level="3.2" data-path="contributors.html"><a href="contributors.html#past-contributors"><i class="fa fa-check"></i><b>3.2</b> Past contributors</a></li>
</ul></li>
<li class="chapter" data-level="4" data-path="whats-new-in-eml-2-2-0.html"><a href="whats-new-in-eml-2-2-0.html"><i class="fa fa-check"></i><b>4</b> What’s New in EML 2.2.0</a></li>
<li class="chapter" data-level="5" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html"><i class="fa fa-check"></i><b>5</b> The EML Module and Resources</a><ul>
<li class="chapter" data-level="5.1" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#the-eml-module---a-metadata-container"><i class="fa fa-check"></i><b>5.1</b> The eml module - A metadata container</a></li>
<li class="chapter" data-level="5.2" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#the-eml-resource-module---base-information-for-all-resources"><i class="fa fa-check"></i><b>5.2</b> The eml-resource module - Base information for all resources</a></li>
<li class="chapter" data-level="5.3" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#the-eml-dataset-module---dataset-specific-information"><i class="fa fa-check"></i><b>5.3</b> The eml-dataset module - Dataset specific information</a></li>
<li class="chapter" data-level="5.4" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#the-eml-literature-module---citation-specific-information"><i class="fa fa-check"></i><b>5.4</b> The eml-literature module - Citation-specific information</a><ul>
<li class="chapter" data-level="5.4.1" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#eml-literature-module---literature-cited"><i class="fa fa-check"></i><b>5.4.1</b> eml-literature module - literature cited</a></li>
<li class="chapter" data-level="5.4.2" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#eml-literature-module---usage-citation"><i class="fa fa-check"></i><b>5.4.2</b> eml-literature module - usage citation</a></li>
<li class="chapter" data-level="5.4.3" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#eml-literature-module---reference-publication"><i class="fa fa-check"></i><b>5.4.3</b> eml-literature module - reference publication</a></li>
</ul></li>
<li class="chapter" data-level="5.5" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#the-eml-software-module---software-specific-information"><i class="fa fa-check"></i><b>5.5</b> The eml-software module - Software specific information</a></li>
<li class="chapter" data-level="5.6" data-path="the-eml-module-and-resources.html"><a href="the-eml-module-and-resources.html#the-eml-protocol-module---research-protocol-specific-information"><i class="fa fa-check"></i><b>5.6</b> The eml-protocol module - Research protocol specific information</a></li>
</ul></li>
<li class="chapter" data-level="6" data-path="data-structure-modules.html"><a href="data-structure-modules.html"><i class="fa fa-check"></i><b>6</b> Data Structure Modules</a><ul>
<li class="chapter" data-level="6.1" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-entity-module---entity-level-information-within-datasets"><i class="fa fa-check"></i><b>6.1</b> The eml-entity module - Entity level information within datasets</a></li>
<li class="chapter" data-level="6.2" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-attribute-module---attribute-level-information-within-dataset-entities"><i class="fa fa-check"></i><b>6.2</b> The eml-attribute module - Attribute level information within dataset entities</a><ul>
<li class="chapter" data-level="6.2.1" data-path="data-structure-modules.html"><a href="data-structure-modules.html#philosophy-of-attribute-units"><i class="fa fa-check"></i><b>6.2.1</b> Philosophy of Attribute Units</a></li>
</ul></li>
<li class="chapter" data-level="6.3" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-constraint-module---relationships-among-and-within-dataset-entities"><i class="fa fa-check"></i><b>6.3</b> The eml-constraint module - Relationships among and within dataset entities</a></li>
<li class="chapter" data-level="6.4" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-datatable-module---logical-information-about-data-table-entities"><i class="fa fa-check"></i><b>6.4</b> The eml-dataTable module - Logical information about data table entities</a></li>
<li class="chapter" data-level="6.5" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-spatialraster-module---logical-information-about-regularly-gridded-geospatial-image-data"><i class="fa fa-check"></i><b>6.5</b> The eml-spatialRaster module - Logical information about regularly gridded geospatial image data</a></li>
<li class="chapter" data-level="6.6" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-spatialvector-module---logical-information-about-non-gridded-geospatial-image-data"><i class="fa fa-check"></i><b>6.6</b> The eml-spatialVector module - Logical information about non-gridded geospatial image data</a></li>
<li class="chapter" data-level="6.7" data-path="data-structure-modules.html"><a href="data-structure-modules.html#schema-for-validating-spatial-referencing-descriptions"><i class="fa fa-check"></i><b>6.7</b> Schema for validating spatial referencing descriptions</a></li>
<li class="chapter" data-level="6.8" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-storedprocedure-module---data-tables-resulting-from-procedures-stored-in-a-database"><i class="fa fa-check"></i><b>6.8</b> The eml-storedProcedure module - Data tables resulting from procedures stored in a database</a></li>
<li class="chapter" data-level="6.9" data-path="data-structure-modules.html"><a href="data-structure-modules.html#the-eml-view-module---data-tables-resulting-from-a-database-query"><i class="fa fa-check"></i><b>6.9</b> The eml-view module - Data tables resulting from a database query</a></li>
</ul></li>
<li class="chapter" data-level="7" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html"><i class="fa fa-check"></i><b>7</b> Discovery and Interpretation Modules</a><ul>
<li class="chapter" data-level="7.1" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html#the-eml-access-module---access-control-rules-for-resources"><i class="fa fa-check"></i><b>7.1</b> The eml-access module - Access control rules for resources</a></li>
<li class="chapter" data-level="7.2" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html#the-eml-physical-module---physical-file-format"><i class="fa fa-check"></i><b>7.2</b> The eml-physical module - Physical file format</a></li>
<li class="chapter" data-level="7.3" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html#the-eml-party-module---people-and-organization-information"><i class="fa fa-check"></i><b>7.3</b> The eml-party module - People and organization information</a></li>
<li class="chapter" data-level="7.4" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html#the-eml-coverage-module---geographic-temporal-and-taxonomic-extents-of-resources"><i class="fa fa-check"></i><b>7.4</b> The eml-coverage module - Geographic, temporal, and taxonomic extents of resources</a></li>
<li class="chapter" data-level="7.5" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html#the-eml-project-module---research-context-information-for-resources"><i class="fa fa-check"></i><b>7.5</b> The eml-project module - Research context information for resources</a></li>
<li class="chapter" data-level="7.6" data-path="discovery-and-interpretation-modules.html"><a href="discovery-and-interpretation-modules.html#the-eml-methods-module---methodological-information-for-resources"><i class="fa fa-check"></i><b>7.6</b> The eml-methods module - Methodological information for resources</a></li>
</ul></li>
<li class="chapter" data-level="8" data-path="utility-modules.html"><a href="utility-modules.html"><i class="fa fa-check"></i><b>8</b> Utility Modules</a><ul>
<li class="chapter" data-level="8.1" data-path="utility-modules.html"><a href="utility-modules.html#the-eml-text-module---text-field-formatting"><i class="fa fa-check"></i><b>8.1</b> The eml-text module - Text field formatting</a></li>
<li class="chapter" data-level="8.2" data-path="utility-modules.html"><a href="utility-modules.html#the-eml-semantics-module---semantic-annotations-for-formalized-statements-about-eml-components"><i class="fa fa-check"></i><b>8.2</b> The eml-semantics module - Semantic annotations for formalized statements about EML components</a></li>
</ul></li>
<li class="chapter" data-level="9" data-path="eml-schema.html"><a href="eml-schema.html"><i class="fa fa-check"></i><b>9</b> EML Schema</a></li>
<li class="chapter" data-level="10" data-path="validation-and-content-references.html"><a href="validation-and-content-references.html"><i class="fa fa-check"></i><b>10</b> Validation and Content references</a><ul>
<li class="chapter" data-level="10.1" data-path="validation-and-content-references.html"><a href="validation-and-content-references.html#validation-rules"><i class="fa fa-check"></i><b>10.1</b> Validation rules</a></li>
<li class="chapter" data-level="10.2" data-path="validation-and-content-references.html"><a href="validation-and-content-references.html#validation-algorithm"><i class="fa fa-check"></i><b>10.2</b> Validation algorithm</a></li>
<li class="chapter" data-level="10.3" data-path="validation-and-content-references.html"><a href="validation-and-content-references.html#content-references"><i class="fa fa-check"></i><b>10.3</b> Content references</a></li>
<li class="chapter" data-level="10.4" data-path="validation-and-content-references.html"><a href="validation-and-content-references.html#eml-validity-parser"><i class="fa fa-check"></i><b>10.4</b> EML Validity Parser</a></li>
<li class="chapter" data-level="10.5" data-path="validation-and-content-references.html"><a href="validation-and-content-references.html#id-and-scope-examples"><i class="fa fa-check"></i><b>10.5</b> id and Scope Examples</a></li>
</ul></li>
<li class="chapter" data-level="11" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html"><i class="fa fa-check"></i><b>11</b> Semantic Annotation Primer</a><ul>
<li class="chapter" data-level="11.1" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#introduction"><i class="fa fa-check"></i><b>11.1</b> Introduction</a><ul>
<li class="chapter" data-level="11.1.1" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#take-home-messages"><i class="fa fa-check"></i><b>11.1.1</b> Take-home messages</a></li>
<li class="chapter" data-level="11.1.2" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#organization-of-this-document"><i class="fa fa-check"></i><b>11.1.2</b> Organization of this document</a></li>
<li class="chapter" data-level="11.1.3" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#other-conventions-and-terminology"><i class="fa fa-check"></i><b>11.1.3</b> Other Conventions and Terminology</a></li>
</ul></li>
<li class="chapter" data-level="11.2" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#semantic-annotations-in-eml-2.2.0"><i class="fa fa-check"></i><b>11.2</b> Semantic Annotations in EML 2.2.0</a><ul>
<li class="chapter" data-level="11.2.1" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#annotation-element-structure"><i class="fa fa-check"></i><b>11.2.1</b> Annotation element structure</a></li>
<li class="chapter" data-level="11.2.2" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#top-level-resource-entity-level-and-attribute-annotations"><i class="fa fa-check"></i><b>11.2.2</b> Top-level resource, entity-level, and attribute annotations</a></li>
<li class="chapter" data-level="11.2.3" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#annotations-grouped-under-the-eml-annotations-element"><i class="fa fa-check"></i><b>11.2.3</b> Annotations grouped under the EML <code><annotations></code> element</a></li>
<li class="chapter" data-level="11.2.4" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#annotations-grouped-under-additionalmetadata"><i class="fa fa-check"></i><b>11.2.4</b> Annotations grouped under <code><additionalMetadata></code></a></li>
</ul></li>
<li class="chapter" data-level="11.3" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#appendix"><i class="fa fa-check"></i><b>11.3</b> Appendix</a><ul>
<li class="chapter" data-level="11.3.1" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#semantic-triples"><i class="fa fa-check"></i><b>11.3.1</b> Semantic triples</a></li>
<li class="chapter" data-level="11.3.2" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#uris"><i class="fa fa-check"></i><b>11.3.2</b> URIs</a></li>
<li class="chapter" data-level="11.3.3" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#rdf-graphs"><i class="fa fa-check"></i><b>11.3.3</b> RDF Graphs</a></li>
<li class="chapter" data-level="11.3.4" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#check-for-logical-consistency"><i class="fa fa-check"></i><b>11.3.4</b> Check for Logical Consistency</a></li>
<li class="chapter" data-level="11.3.5" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#glossary"><i class="fa fa-check"></i><b>11.3.5</b> Glossary</a></li>
<li class="chapter" data-level="11.3.6" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#vocabularies-and-repositories-used-in-examples"><i class="fa fa-check"></i><b>11.3.6</b> Vocabularies and repositories used in examples</a></li>
<li class="chapter" data-level="11.3.7" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#additional-background-information"><i class="fa fa-check"></i><b>11.3.7</b> Additional background information</a></li>
</ul></li>
<li class="chapter" data-level="11.4" data-path="semantic-annotation-primer.html"><a href="semantic-annotation-primer.html#frequently-asked-questions"><i class="fa fa-check"></i><b>11.4</b> Frequently asked questions</a></li>
</ul></li>
<li class="chapter" data-level="12" data-path="internationalization-metadata-in-multiple-languages.html"><a href="internationalization-metadata-in-multiple-languages.html"><i class="fa fa-check"></i><b>12</b> Internationalization - Metadata in multiple languages</a></li>
<li class="chapter" data-level="13" data-path="release-notes.html"><a href="release-notes.html"><i class="fa fa-check"></i><b>13</b> Release Notes</a><ul>
<li class="chapter" data-level="13.0.1" data-path="release-notes.html"><a href="release-notes.html#section"><i class="fa fa-check"></i><b>13.0.1</b> 2.2.0</a></li>
<li class="chapter" data-level="13.0.2" data-path="release-notes.html"><a href="release-notes.html#section-1"><i class="fa fa-check"></i><b>13.0.2</b> 2.1.1</a></li>
<li class="chapter" data-level="13.0.3" data-path="release-notes.html"><a href="release-notes.html#numbers-refer-to-the-corresponding-bugzilla-bug-id-not-the-github"><i class="fa fa-check"></i><b>13.0.3</b> 2.1.0 (numbers refer to the corresponding Bugzilla bug id, not the GitHub #)</a></li>
<li class="chapter" data-level="13.0.4" data-path="release-notes.html"><a href="release-notes.html#numbers-refer-to-the-corresponding-bugzilla-bug-id-not-the-github-1"><i class="fa fa-check"></i><b>13.0.4</b> 2.0.1 (numbers refer to the corresponding Bugzilla bug id, not the GitHub #)</a></li>
<li class="chapter" data-level="13.0.5" data-path="release-notes.html"><a href="release-notes.html#numbers-refer-to-the-corresponding-bugzilla-bug-id-not-the-github-2"><i class="fa fa-check"></i><b>13.0.5</b> 2.0.0 - (numbers refer to the corresponding Bugzilla bug id, not the GitHub #)</a></li>
<li class="chapter" data-level="13.0.6" data-path="release-notes.html"><a href="release-notes.html#rc3-numbers-refer-to-the-corresponding-bugzilla-bug-id-not-the-github"><i class="fa fa-check"></i><b>13.0.6</b> 2.0.0rc3 (numbers refer to the corresponding Bugzilla bug id, not the GitHub #)</a></li>
<li class="chapter" data-level="13.0.7" data-path="release-notes.html"><a href="release-notes.html#rc2-numbers-refer-to-the-corresponding-bugzilla-bug-id-not-the-github"><i class="fa fa-check"></i><b>13.0.7</b> RC2 (numbers refer to the corresponding Bugzilla bug id, not the GitHub #)</a></li>
<li class="chapter" data-level="13.0.8" data-path="release-notes.html"><a href="release-notes.html#rc1-numbers-refer-to-the-corresponding-bugzilla-bug-id-not-the-github"><i class="fa fa-check"></i><b>13.0.8</b> RC1 (numbers refer to the corresponding Bugzilla bug id, not the GitHub #)</a></li>
<li class="chapter" data-level="13.0.9" data-path="release-notes.html"><a href="release-notes.html#beta9-fixes-"><i class="fa fa-check"></i><b>13.0.9</b> Beta9 Fixes-</a></li>
<li class="chapter" data-level="13.0.10" data-path="release-notes.html"><a href="release-notes.html#beta-8-fixes-"><i class="fa fa-check"></i><b>13.0.10</b> Beta 8 Fixes-</a></li>
<li class="chapter" data-level="13.0.11" data-path="release-notes.html"><a href="release-notes.html#beta-7-fixes-"><i class="fa fa-check"></i><b>13.0.11</b> Beta 7 Fixes-</a></li>
</ul></li>
<li class="chapter" data-level="14" data-path="about-this-site.html"><a href="about-this-site.html"><i class="fa fa-check"></i><b>14</b> About this site</a><ul>
<li class="chapter" data-level="14.1" data-path="about-this-site.html"><a href="about-this-site.html#building-the-site"><i class="fa fa-check"></i><b>14.1</b> Building the site</a></li>
<li class="chapter" data-level="14.2" data-path="about-this-site.html"><a href="about-this-site.html#deploying-the-site"><i class="fa fa-check"></i><b>14.2</b> Deploying the site</a></li>
</ul></li>
<li class="chapter" data-level="15" data-path="references.html"><a href="references.html"><i class="fa fa-check"></i><b>15</b> References</a></li>
<li class="divider"></li>
<li><a href="../">← Back to main website</a></li>
</ul>
</nav>
</div>
<div class="book-body">
<div class="body-inner">
<div class="book-header" role="navigation">
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i><a href="./">Ecological Metadata Language (EML)</a>
</h1>
</div>
<div class="page-wrapper" tabindex="-1" role="main">
<div class="page-inner">
<section class="normal" id="section-">
<div id="the-eml-module-and-resources" class="section level1">
<h1><span class="header-section-number">5</span> The EML Module and Resources</h1>
<div id="the-eml-module---a-metadata-container" class="section level2">
<h2><span class="header-section-number">5.1</span> The eml module - A metadata container</h2>
<p>The eml module is a wrapper container that allows the inclusion of any
metadata content in a single EML document. The eml module is used as a
container to hold structured descriptions of ecological resources. In
EML, the definition of a resource comes from the <a href="http://dublincore.org/documents/usageguide/"><em>The Dublin Core
Metadata Initiative</em></a>,
which describes a general element set used to describe "networked
digital resources". The top-level structure of EML has been designed to
be compatible with the Dublin Core syntax. In general, dataset
resources, literature resources, software resources, and protocol
resources comprise the list of information that may be described in EML.
EML is largely designed to describe digital resources, however, it may
also be used to describe non-digital resources such as paper maps and
other non-digital media. <span class="emphasis"><em>In EML, the definition of a "Data Package"
is the combination of both the data and metadata for a resource.</em></span> So, data packages are built by using the <eml> wrapper,
which will include all of the metadata, and optionally the data (or
references to them). All EML packages must begin with the <eml> tag
and end with the </eml> tag.</p>
<p>The eml module may be extended to describe other resources by means of
its optional sub-field, <additionalMetadata>. This field is largely
reserved for the inclusion of metadata that may be highly discipline
specific and not covered in this version of EML, or it may be used to
internally extend fields within the EML standard.</p>
</div>
<div id="the-eml-resource-module---base-information-for-all-resources" class="section level2">
<h2><span class="header-section-number">5.2</span> The eml-resource module - Base information for all resources</h2>
<p>The eml-resource module contains general information that describes
dataset resources, literature resources, protocol resources, and
software resources. Each of the above four types of resources share a
common set of information, but also have information that is unique to
that particular resource type. Each resource type uses the eml-resource
module to document the information common to all resources, but then
extend eml-resource with modules that are specific to that particular
resource type. For instance, all resources have creators, titles, and
perhaps keywords, but only the dataset resource would have a "data
table" within it. Likewise, a literature resource may have an "ISBN"
number associated with it, whereas the other resource types would not.</p>
<p>The eml-resource module is exclusively used by other modules, and is
therefore not a stand-alone module. The following four modules are used
to describe separate resources:
datasets, literature, software, and protocols. However, note that the
dataset module makes use of the other top-level modules by importing
them at different levels. For instance, a dataset may have been produced
using a particular protocol, and that protocol may come from a protocol
document in a library of protocols. Likewise, citations are used
throughout the top-level resource modules by importing the literature
module.</p>
</div>
<div id="the-eml-dataset-module---dataset-specific-information" class="section level2">
<h2><span class="header-section-number">5.3</span> The eml-dataset module - Dataset specific information</h2>
<p>The eml-dataset module contains general information that describes
dataset resources. It is intended to provide overview information about
the dataset: broad information such as the title, abstract, keywords,
contacts, maintenance history, purpose, and distribution of the data
themselves. The eml-dataset module also imports many other modules that
are used to describe the dataset in fine detail. Specifically, it uses
the eml-methods module to describe methodology used in collecting or
processing the dataset, the eml-project module to describe the
overarching research context and experimental design, the eml-access
module to define access control rules for the data and metadata, and the
eml-entity module to provide detailed information about the logical
structure of the dataset. A dataset can be (and often is) composed of a
series of data entities (tables) that are linked together by particular
integrity constraints.</p>
<p>The eml-dataset module, like other modules, may be "referenced" via
the <references> tag. This allows a dataset to be described once, and
then used as a reference in other locations within the EML document via
its ID.</p>
</div>
<div id="the-eml-literature-module---citation-specific-information" class="section level2">
<h2><span class="header-section-number">5.4</span> The eml-literature module - Citation-specific information</h2>
<p>The eml-literature module contains information that describes literature resources. It is intended to provide overview information about the literature citation, including title, abstract, keywords, and contacts. Citation types follow the conventions laid out by <a href="http://www.endnote.com">EndNote</a>, and there is an attempt to represent a compatible subset of the EndNote citation types. These citation types include: article, book, chapter, edited book, manuscript, report, thesis, conference proceedings, personal communication, map, generic, audio visual, and presentation. The generic citation type would be used when one of the other types will not work.</p>
<p>There are three unique CitationType elements that may be employed within a eml-dataset module, including the <literatureCited>, <usageCitation>, and <referencePublication> elements. The purpose and examples of each CitationType element type are detailed below.</p>
<p>Similar to other eml modules, each of the CitationType elements may be referenced via the <references> tag. The <references> tag allows a citation to be described once then used as a reference in other locations within the EML document via its reference ID.</p>
<p>As of EML 2.2.0, each CitationType element can use the <bibtex> element as an alternative to encoding citations in the EML XML structures. BibTeX entries generally play well inside of XML structures, but XML escaping is still needed for special characters so consider embedding BibTeX entries in CDATA blocks if XML escaping is cumbersome.</p>
<div id="eml-literature-module---literature-cited" class="section level3">
<h3><span class="header-section-number">5.4.1</span> eml-literature module - literature cited</h3>
<p>Citations to articles or other resources that are referenced in the data set or its associated metadata should be included in a <literatureCited> element. <literatureCited> is a CitationListType cataloging one or more citations that represent a bibliography of works related to the data set for reference, comparison, or other purposes. These citations can be a series of <citation> elements, a <bibtex> element featuring one or more BibTeX-style citations, or a mix of the two types.</p>
<p><em>Example of the <literatureCited> element:</em></p>
<div class="sourceCode" id="cb13"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb13-1" data-line-number="1"><span class="kw"><dataset></span></a>
<a class="sourceLine" id="cb13-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb13-3" data-line-number="3"> <span class="kw"><literatureCited></span></a>
<a class="sourceLine" id="cb13-4" data-line-number="4"> <span class="kw"><citation></span></a>
<a class="sourceLine" id="cb13-5" data-line-number="5"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb13-6" data-line-number="6"> @article{fegraus_2005,</a>
<a class="sourceLine" id="cb13-7" data-line-number="7"> title = {Maximizing the {Value} of {Ecological} {Data} with {Structured} {Metadata}: {An} {Introduction} to {Ecological} {Metadata} {Language} ({EML}) and {Principles} for {Metadata} {Creation}},</a>
<a class="sourceLine" id="cb13-8" data-line-number="8"> journal = {Bulletin of the Ecological Society of America},</a>
<a class="sourceLine" id="cb13-9" data-line-number="9"> author = {Fegraus, Eric H. and Andelman, Sandy and Jones, Matthew B. and Schildhauer, Mark},</a>
<a class="sourceLine" id="cb13-10" data-line-number="10"> year = {2005},</a>
<a class="sourceLine" id="cb13-11" data-line-number="11"> pages = {158--168}</a>
<a class="sourceLine" id="cb13-12" data-line-number="12"> }</a>
<a class="sourceLine" id="cb13-13" data-line-number="13"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb13-14" data-line-number="14"> <span class="kw"></citation></span></a>
<a class="sourceLine" id="cb13-15" data-line-number="15"> <span class="kw"><citation></span></a>
<a class="sourceLine" id="cb13-16" data-line-number="16"> <span class="kw"><title></span>Title of a paper that this dataset, or its metadata, references.<span class="kw"></title></span></a>
<a class="sourceLine" id="cb13-17" data-line-number="17"> <span class="kw"><creator></span></a>
<a class="sourceLine" id="cb13-18" data-line-number="18"> <span class="kw"><individualName></span></a>
<a class="sourceLine" id="cb13-19" data-line-number="19"> <span class="kw"><givenName></span>Mark<span class="kw"></givenName></span></a>
<a class="sourceLine" id="cb13-20" data-line-number="20"> <span class="kw"><surName></span>Jarkady<span class="kw"></surName></span></a>
<a class="sourceLine" id="cb13-21" data-line-number="21"> <span class="kw"></individualName></span></a>
<a class="sourceLine" id="cb13-22" data-line-number="22"> <span class="kw"></creator></span></a>
<a class="sourceLine" id="cb13-23" data-line-number="23"> <span class="kw"><pubDate></span>2017<span class="kw"></pubDate></span></a>
<a class="sourceLine" id="cb13-24" data-line-number="24"> <span class="kw"><article></span></a>
<a class="sourceLine" id="cb13-25" data-line-number="25"> <span class="kw"><journal></span>EcoSphere<span class="kw"></journal></span></a>
<a class="sourceLine" id="cb13-26" data-line-number="26"> <span class="kw"><publicationPlace></span>https://doi.org/10.1002/ecs2.2166<span class="kw"></publicationPlace></span></a>
<a class="sourceLine" id="cb13-27" data-line-number="27"> <span class="kw"></article></span></a>
<a class="sourceLine" id="cb13-28" data-line-number="28"> <span class="kw"></citation></span></a>
<a class="sourceLine" id="cb13-29" data-line-number="29"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb13-30" data-line-number="30"> @article{hampton\_2017,</a>
<a class="sourceLine" id="cb13-31" data-line-number="31"> title = {Skills and {Knowledge} for {Data}-{Intensive} {Environmental} {Research}},</a>
<a class="sourceLine" id="cb13-32" data-line-number="32"> volume = {67},</a>
<a class="sourceLine" id="cb13-33" data-line-number="33"> copyright = {All rights reserved},</a>
<a class="sourceLine" id="cb13-34" data-line-number="34"> issn = {0006-3568, 1525-3244},</a>
<a class="sourceLine" id="cb13-35" data-line-number="35"> url = {https://academic.oup.com/bioscience/article-lookup/doi/10.1093/biosci/bix025},</a>
<a class="sourceLine" id="cb13-36" data-line-number="36"> doi = {10.1093/biosci/bix025},</a>
<a class="sourceLine" id="cb13-37" data-line-number="37"> language = {en},</a>
<a class="sourceLine" id="cb13-38" data-line-number="38"> number = {6},</a>
<a class="sourceLine" id="cb13-39" data-line-number="39"> urldate = {2018-02-15},</a>
<a class="sourceLine" id="cb13-40" data-line-number="40"> journal = {BioScience},</a>
<a class="sourceLine" id="cb13-41" data-line-number="41"> author = {Hampton, Stephanie E. and Jones, Matthew B. and Wasser, Leah A. and Schildhauer, Mark P. and Supp, Sarah R. and Brun, Julien and Hernandez, Rebecca R. and Boettiger, Carl and Collins, Scott L. and Gross, Louis J. and Fernández, Denny S. and Budden, Amber and White, Ethan P. and Teal, Tracy K. and Labou, Stephanie G. and Aukema, Juliann E.},</a>
<a class="sourceLine" id="cb13-42" data-line-number="42"> month = jun,</a>
<a class="sourceLine" id="cb13-43" data-line-number="43"> year = {2017},</a>
<a class="sourceLine" id="cb13-44" data-line-number="44"> pages = {546--557}</a>
<a class="sourceLine" id="cb13-45" data-line-number="45"> }</a>
<a class="sourceLine" id="cb13-46" data-line-number="46"></a>
<a class="sourceLine" id="cb13-47" data-line-number="47"> @article{collins\_2018,</a>
<a class="sourceLine" id="cb13-48" data-line-number="48"> title = {Temporal heterogeneity increases with spatial heterogeneity in ecological communities},</a>
<a class="sourceLine" id="cb13-49" data-line-number="49"> volume = {99},</a>
<a class="sourceLine" id="cb13-50" data-line-number="50"> copyright = {All rights reserved},</a>
<a class="sourceLine" id="cb13-51" data-line-number="51"> issn = {00129658},</a>
<a class="sourceLine" id="cb13-52" data-line-number="52"> url = {http://doi.wiley.com/10.1002/ecy.2154},</a>
<a class="sourceLine" id="cb13-53" data-line-number="53"> doi = {10.1002/ecy.2154},</a>
<a class="sourceLine" id="cb13-54" data-line-number="54"> language = {en},</a>
<a class="sourceLine" id="cb13-55" data-line-number="55"> number = {4},</a>
<a class="sourceLine" id="cb13-56" data-line-number="56"> urldate = {2018-04-16},</a>
<a class="sourceLine" id="cb13-57" data-line-number="57"> journal = {Ecology},</a>
<a class="sourceLine" id="cb13-58" data-line-number="58"> author = {Collins, Scott L. and Avolio, Meghan L. and Gries, Corinna and Hallett, Lauren M. and Koerner, Sally E. and La Pierre, Kimberly J. and Rypel, Andrew L. and Sokol, Eric R. and Fey, Samuel B. and Flynn, Dan F. B. and Jones, Sydney K. and Ladwig, Laura M. and Ripplinger, Julie and Jones, Matt B.},</a>
<a class="sourceLine" id="cb13-59" data-line-number="59"> month = apr,</a>
<a class="sourceLine" id="cb13-60" data-line-number="60"> year = {2018},</a>
<a class="sourceLine" id="cb13-61" data-line-number="61"> pages = {858--865}</a>
<a class="sourceLine" id="cb13-62" data-line-number="62"> }</a>
<a class="sourceLine" id="cb13-63" data-line-number="63"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb13-64" data-line-number="64"> <span class="kw"></literatureCited></span></a>
<a class="sourceLine" id="cb13-65" data-line-number="65"> ...</a>
<a class="sourceLine" id="cb13-66" data-line-number="66"><span class="kw"></dataset></span></a></code></pre></div>
</div>
<div id="eml-literature-module---usage-citation" class="section level3">
<h3><span class="header-section-number">5.4.2</span> eml-literature module - usage citation</h3>
<p>A citation to an article or other resource in which the data set is used or referenced should be included in a <usageCitation> element, a CitationType detailing a literature resource that has used or references this data set. It is not expected that one or more usage citations will necessarily be an exhaustive list of resources that employ the data set, but rather will serve as a example(s) and pointer(s) to scholarly works in which this data set has been used. The <usageCitation> element can be a <citation> or <bibtex> element.</p>
<p><em>Example of the <usageCitation> element:</em></p>
<div class="sourceCode" id="cb14"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb14-1" data-line-number="1"><span class="kw"><dataset></span></a>
<a class="sourceLine" id="cb14-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb14-3" data-line-number="3"> <span class="kw"><usageCitation></span></a>
<a class="sourceLine" id="cb14-4" data-line-number="4"> <span class="kw"><citation></span></a>
<a class="sourceLine" id="cb14-5" data-line-number="5"> <span class="kw"><title></span>Title of a paper that uses this dataset or its metadata<span class="kw"></title></span></a>
<a class="sourceLine" id="cb14-6" data-line-number="6"> <span class="kw"><creator></span></a>
<a class="sourceLine" id="cb14-7" data-line-number="7"> <span class="kw"><individualName></span></a>
<a class="sourceLine" id="cb14-8" data-line-number="8"> <span class="kw"><givenName></span>Mark<span class="kw"></givenName></span></a>
<a class="sourceLine" id="cb14-9" data-line-number="9"> <span class="kw"><surName></span>Jarkady<span class="kw"></surName></span></a>
<a class="sourceLine" id="cb14-10" data-line-number="10"> <span class="kw"></individualName></span></a>
<a class="sourceLine" id="cb14-11" data-line-number="11"> <span class="kw"></creator></span></a>
<a class="sourceLine" id="cb14-12" data-line-number="12"> <span class="kw"><pubDate></span>2017<span class="kw"></pubDate></span></a>
<a class="sourceLine" id="cb14-13" data-line-number="13"> <span class="kw"><article></span></a>
<a class="sourceLine" id="cb14-14" data-line-number="14"> <span class="kw"><journal></span>EcoSphere<span class="kw"></journal></span></a>
<a class="sourceLine" id="cb14-15" data-line-number="15"> <span class="kw"><publicationPlace></span>https://doi.org/10.1002/ecs2.2166<span class="kw"></publicationPlace></span></a>
<a class="sourceLine" id="cb14-16" data-line-number="16"> <span class="kw"></article></span></a>
<a class="sourceLine" id="cb14-17" data-line-number="17"> <span class="kw"></citation></span></a>
<a class="sourceLine" id="cb14-18" data-line-number="18"> <span class="kw"></usageCitation></span></a>
<a class="sourceLine" id="cb14-19" data-line-number="19"> <span class="kw"><usageCitation></span></a>
<a class="sourceLine" id="cb14-20" data-line-number="20"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb14-21" data-line-number="21"> <span class="bn"><![CDATA[</span></a>
<a class="sourceLine" id="cb14-22" data-line-number="22"> @article{doi:10.1890/10-0423.1,</a>
<a class="sourceLine" id="cb14-23" data-line-number="23"> author = {Lerman, Susannah B. and Warren, Paige S.},</a>
<a class="sourceLine" id="cb14-24" data-line-number="24"> title = {The conservation value of residential yards: linking birds and people},</a>
<a class="sourceLine" id="cb14-25" data-line-number="25"> journal = {Ecological Applications},</a>
<a class="sourceLine" id="cb14-26" data-line-number="26"> volume = {21},</a>
<a class="sourceLine" id="cb14-27" data-line-number="27"> number = {4},</a>
<a class="sourceLine" id="cb14-28" data-line-number="28"> pages = {1327-1339},</a>
<a class="sourceLine" id="cb14-29" data-line-number="29"> keywords = {Arizona, USA, CAP LTER, human–wildlife interactions, long-term ecological research, native landscaping, residential yards, socio-ecology, urban birds},</a>
<a class="sourceLine" id="cb14-30" data-line-number="30"> doi = {10.1890/10-0423.1},</a>
<a class="sourceLine" id="cb14-31" data-line-number="31"> url = {https://esajournals.onlinelibrary.wiley.com/doi/abs/10.1890/10-0423.1},</a>
<a class="sourceLine" id="cb14-32" data-line-number="32"> eprint = {https://esajournals.onlinelibrary.wiley.com/doi/pdf/10.1890/10-0423.1}</a>
<a class="sourceLine" id="cb14-33" data-line-number="33"> }</a>
<a class="sourceLine" id="cb14-34" data-line-number="34"> <span class="bn">]]></span></a>
<a class="sourceLine" id="cb14-35" data-line-number="35"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb14-36" data-line-number="36"> <span class="kw"></usageCitation></span></a>
<a class="sourceLine" id="cb14-37" data-line-number="37"> ...</a>
<a class="sourceLine" id="cb14-38" data-line-number="38"><span class="kw"></dataset></span></a></code></pre></div>
</div>
<div id="eml-literature-module---reference-publication" class="section level3">
<h3><span class="header-section-number">5.4.3</span> eml-literature module - reference publication</h3>
<p>A citation to an article or other resource that serves as an important reference for a data set should be documented in a <referencePublication> element. Anyone using the data set should generally cite the data set itself (using the creator, pubDate, title, publisher, and packageId fields), and consider providing an additional citation to the reference publication. The <referencePublication> element will typically be used when the data set and a companion or associated paper are published near concurrently. Common cases where a reference publication may be useful include when a data paper is published that describes the dataset, or when a paper is intended to be the canonical or exemplar reference to the dataset – these are features that distinguish the <referencePublication> CitationType from the <usageCitation> CitationType.</p>
<p><em>Example of the <referencePublication> element:</em></p>
<div class="sourceCode" id="cb15"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb15-1" data-line-number="1"><span class="kw"><dataset></span></a>
<a class="sourceLine" id="cb15-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb15-3" data-line-number="3"> <span class="kw"><referencePublication></span></a>
<a class="sourceLine" id="cb15-4" data-line-number="4"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb15-5" data-line-number="5"> @article{doi:10.1890/14-2252.1,</a>
<a class="sourceLine" id="cb15-6" data-line-number="6"> author = {Edwards, Kyle F. and Klausmeier, Christopher A. and Litchman, Elena},</a>
<a class="sourceLine" id="cb15-7" data-line-number="7"> title = {Nutrient utilization traits of phytoplankton},</a>
<a class="sourceLine" id="cb15-8" data-line-number="8"> journal = {Ecology},</a>
<a class="sourceLine" id="cb15-9" data-line-number="9"> volume = {96},</a>
<a class="sourceLine" id="cb15-10" data-line-number="10"> number = {8},</a>
<a class="sourceLine" id="cb15-11" data-line-number="11"> pages = {2311-2311},</a>
<a class="sourceLine" id="cb15-12" data-line-number="12"> keywords = {algae, allometry, competition, Droop, Monod, nitrogen, phosphorus, physiology, stoichiometry, uptake kinetics},</a>
<a class="sourceLine" id="cb15-13" data-line-number="13"> doi = {10.1890/14-2252.1},</a>
<a class="sourceLine" id="cb15-14" data-line-number="14"> url = {https://esajournals.onlinelibrary.wiley.com/doi/abs/10.1890/14-2252.1},</a>
<a class="sourceLine" id="cb15-15" data-line-number="15"> eprint = {https://esajournals.onlinelibrary.wiley.com/doi/pdf/10.1890/14-2252.1}</a>
<a class="sourceLine" id="cb15-16" data-line-number="16"> }</a>
<a class="sourceLine" id="cb15-17" data-line-number="17"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb15-18" data-line-number="18"> <span class="kw"></referencePublication></span></a>
<a class="sourceLine" id="cb15-19" data-line-number="19"> ...</a>
<a class="sourceLine" id="cb15-20" data-line-number="20"><span class="kw"></dataset></span></a></code></pre></div>
</div>
</div>
<div id="the-eml-software-module---software-specific-information" class="section level2">
<h2><span class="header-section-number">5.5</span> The eml-software module - Software specific information</h2>
<p>The eml-software module contains general information that describes
software resources. This module is intended to fully document software
that is needed in order to view a resource (such as a dataset) or to
process a dataset. The software module is also imported into the
eml-methods module in order to document what software was used to
process or perform quality control procedures on a dataset.</p>
<p>The eml-software module, like other modules, may be "referenced" via
the <references> tag. This allows a software resource to be described
once, and then used as a reference in other locations within the EML
document via its ID.</p>
</div>
<div id="the-eml-protocol-module---research-protocol-specific-information" class="section level2">
<h2><span class="header-section-number">5.6</span> The eml-protocol module - Research protocol specific information</h2>
<p>The EML Protocol Module is used to define abstract, prescriptive
procedures for generating or processing data. Conceptually, a protocol
is a standardized method.</p>
<p>Eml-protocol resembles eml-methods; however, eml-methods is descriptive
(often written in the declarative mood: "I took five subsamples...")
whereas eml-protocol is prescriptive (often written in the imperative
mood: "Take five subsamples..."). A protocol may have versions,
whereas methods (as used in eml-methods) should not.</p>
</div>
</div>
</section>
</div>
</div>
</div>
<a href="whats-new-in-eml-2-2-0.html" class="navigation navigation-prev " aria-label="Previous page"><i class="fa fa-angle-left"></i></a>
<a href="data-structure-modules.html" class="navigation navigation-next " aria-label="Next page"><i class="fa fa-angle-right"></i></a>
</div>
</div>
<script src="libs/gitbook-2.6.7/js/app.min.js"></script>
<script src="libs/gitbook-2.6.7/js/lunr.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-search.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-sharing.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-fontsettings.js"></script>
<script src="libs/gitbook-2.6.7/js/plugin-bookdown.js"></script>
<script src="libs/gitbook-2.6.7/js/jquery.highlight.js"></script>
<script>
gitbook.require(["gitbook"], function(gitbook) {
gitbook.start({
"sharing": {
"github": false,
"facebook": true,
"twitter": true,
"google": false,
"linkedin": false,
"weibo": false,
"instapaper": false,
"vk": false,
"all": ["facebook", "google", "twitter", "linkedin", "weibo", "instapaper"]
},
"fontsettings": {
"theme": "white",
"family": "sans",
"size": 2
},
"edit": {
"link": null,
"text": null
},
"history": {
"link": null,
"text": null
},
"download": null,
"toc": {
"collapse": "section"
}
});
});
</script>
</body>
</html>