/
whats-new-in-eml-2-2-0.html
614 lines (573 loc) · 59.3 KB
/
whats-new-in-eml-2-2-0.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
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
<!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>4 What’s New in EML 2.2.0 | Ecological Metadata Language (EML)</title>
<meta name="description" content="4 What’s New in EML 2.2.0 | Ecological Metadata Language (EML)" />
<meta name="generator" content="bookdown 0.12 and GitBook 2.6.7" />
<meta property="og:title" content="4 What’s New in EML 2.2.0 | Ecological Metadata Language (EML)" />
<meta property="og:type" content="book" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:title" content="4 What’s New in EML 2.2.0 | 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="contributors.html">
<link rel="next" href="the-eml-module-and-resources.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="whats-new-in-eml-2.2.0" class="section level1">
<h1><span class="header-section-number">4</span> What’s New in EML 2.2.0</h1>
<p>This document highlights changes and new features in EML 2.2. EML authors
should also refer to the affected sections in the normative schema documents
for complete usage information and examples.</p>
<p>EML 2.2 is backward compatible, i.e., EML 2.0 and 2.1 documents could be
relabled as EML 2.2 without violating the schema. However, some predefined values, particularly units, are deprecated in favor of new values to fix mispellings or inconsistencies. EML authors are encouraged to migrate away from deprecated values.</p>
<p><strong>EML MAINTAINERS: Is this in the works??????</strong><br />
> Existing EML 2.1-series documents can be converted to EML 2.2.0 using the XSL
> stylesheet that accompanies this release, as described in section 2 below.</p>
<p>See the ‘Readme’ that accompanies the distribution for a complete list of the
bugs addressed, and for information of interest to developers.</p>
<p><strong>Q:</strong> Unit Additions and Changes</p>
<p><strong>A:</strong> Many units were added for EML 2.2.0, including units supporting
oceanography, climatology, forestry and limnology. The following unit types from
the unit dictionary have been renamed to better reflect their dimensionality:</p>
<ul>
<li>massFlux is now massRate</li>
<li>arealMassDensityRate is now massFlux</li>
<li>amountOfSubstanceWeightFlux is now amountOfSubstanceWeightRate</li>
</ul>
<p>Dozens of units are now deprecated in favor other units to address issues such
as naming consistency. Use the “deprecatedInFavorOf” attribute in
eml-unitDictionary.xml to identify deprecated units.</p>
<p><strong>Q:</strong> BibTeX Support</p>
<p><strong>A:</strong> CitationType elements can use the new <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 becomes cumbersome.</p>
<div class="sourceCode" id="cb2"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb2-1" data-line-number="1"><span class="kw"><citation></span></a>
<a class="sourceLine" id="cb2-2" data-line-number="2"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb2-3" data-line-number="3"> @article{fegraus_2005,</a>
<a class="sourceLine" id="cb2-4" data-line-number="4"> 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="cb2-5" data-line-number="5"> journal = {Bulletin of the Ecological Society of America},</a>
<a class="sourceLine" id="cb2-6" data-line-number="6"> author = {Fegraus, Eric H. and Andelman, Sandy and Jones, Matthew B. and Schildhauer, Mark},</a>
<a class="sourceLine" id="cb2-7" data-line-number="7"> year = {2005},</a>
<a class="sourceLine" id="cb2-8" data-line-number="8"> pages = {158--168}</a>
<a class="sourceLine" id="cb2-9" data-line-number="9"> }</a>
<a class="sourceLine" id="cb2-10" data-line-number="10"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb2-11" data-line-number="11"><span class="kw"></citation></span></a></code></pre></div>
<p><strong>Q:</strong> Citation Lists</p>
<p><strong>A:</strong> EML 2.2.0 includes a new <literatureCited> element as a
CitationListType that represents one or more citations. These citations can be a
series of <citation> elements or a <bibtex> element with a list of
citations.</p>
<p>Example of <literatureCited> element in EML 2.2.0:</p>
<div class="sourceCode" id="cb3"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb3-1" data-line-number="1"><span class="kw"><literatureCited></span></a>
<a class="sourceLine" id="cb3-2" data-line-number="2"> <span class="kw"><citation></span></a>
<a class="sourceLine" id="cb3-3" data-line-number="3"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb3-4" data-line-number="4"> @article{fegraus_2005,</a>
<a class="sourceLine" id="cb3-5" data-line-number="5"> 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="cb3-6" data-line-number="6"> journal = {Bulletin of the Ecological Society of America},</a>
<a class="sourceLine" id="cb3-7" data-line-number="7"> author = {Fegraus, Eric H. and Andelman, Sandy and Jones, Matthew B. and Schildhauer, Mark},</a>
<a class="sourceLine" id="cb3-8" data-line-number="8"> year = {2005},</a>
<a class="sourceLine" id="cb3-9" data-line-number="9"> pages = {158--168}</a>
<a class="sourceLine" id="cb3-10" data-line-number="10"> }</a>
<a class="sourceLine" id="cb3-11" data-line-number="11"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb3-12" data-line-number="12"> <span class="kw"></citation></span></a>
<a class="sourceLine" id="cb3-13" data-line-number="13"> <span class="kw"><citation></span></a>
<a class="sourceLine" id="cb3-14" data-line-number="14"> <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="cb3-15" data-line-number="15"> <span class="kw"><creator></span></a>
<a class="sourceLine" id="cb3-16" data-line-number="16"> <span class="kw"><individualName></span></a>
<a class="sourceLine" id="cb3-17" data-line-number="17"> <span class="kw"><givenName></span>Mark<span class="kw"></givenName></span></a>
<a class="sourceLine" id="cb3-18" data-line-number="18"> <span class="kw"><surName></span>Jarkady<span class="kw"></surName></span></a>
<a class="sourceLine" id="cb3-19" data-line-number="19"> <span class="kw"></individualName></span></a>
<a class="sourceLine" id="cb3-20" data-line-number="20"> <span class="kw"></creator></span></a>
<a class="sourceLine" id="cb3-21" data-line-number="21"> <span class="kw"><pubDate></span>2017<span class="kw"></pubDate></span></a>
<a class="sourceLine" id="cb3-22" data-line-number="22"> <span class="kw"><article></span></a>
<a class="sourceLine" id="cb3-23" data-line-number="23"> <span class="kw"><journal></span>EcoSphere<span class="kw"></journal></span></a>
<a class="sourceLine" id="cb3-24" data-line-number="24"> <span class="kw"><publicationPlace></span>https://doi.org/10.1002/ecs2.2166<span class="kw"></publicationPlace></span></a>
<a class="sourceLine" id="cb3-25" data-line-number="25"> <span class="kw"></article></span></a>
<a class="sourceLine" id="cb3-26" data-line-number="26"> <span class="kw"></citation></span></a>
<a class="sourceLine" id="cb3-27" data-line-number="27"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb3-28" data-line-number="28"> @article{hampton_2017,</a>
<a class="sourceLine" id="cb3-29" data-line-number="29"> title = {Skills and {Knowledge} for {Data}-{Intensive} {Environmental} {Research}},</a>
<a class="sourceLine" id="cb3-30" data-line-number="30"> volume = {67},</a>
<a class="sourceLine" id="cb3-31" data-line-number="31"> copyright = {All rights reserved},</a>
<a class="sourceLine" id="cb3-32" data-line-number="32"> issn = {0006-3568, 1525-3244},</a>
<a class="sourceLine" id="cb3-33" data-line-number="33"> url = {https://academic.oup.com/bioscience/article-lookup/doi/10.1093/biosci/bix025},</a>
<a class="sourceLine" id="cb3-34" data-line-number="34"> doi = {10.1093/biosci/bix025},</a>
<a class="sourceLine" id="cb3-35" data-line-number="35"> language = {en},</a>
<a class="sourceLine" id="cb3-36" data-line-number="36"> number = {6},</a>
<a class="sourceLine" id="cb3-37" data-line-number="37"> urldate = {2018-02-15},</a>
<a class="sourceLine" id="cb3-38" data-line-number="38"> journal = {BioScience},</a>
<a class="sourceLine" id="cb3-39" data-line-number="39"> 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="cb3-40" data-line-number="40"> month = jun,</a>
<a class="sourceLine" id="cb3-41" data-line-number="41"> year = {2017},</a>
<a class="sourceLine" id="cb3-42" data-line-number="42"> pages = {546--557}</a>
<a class="sourceLine" id="cb3-43" data-line-number="43"> }</a>
<a class="sourceLine" id="cb3-44" data-line-number="44"></a>
<a class="sourceLine" id="cb3-45" data-line-number="45"> @article{collins_2018,</a>
<a class="sourceLine" id="cb3-46" data-line-number="46"> title = {Temporal heterogeneity increases with spatial heterogeneity in ecological communities},</a>
<a class="sourceLine" id="cb3-47" data-line-number="47"> volume = {99},</a>
<a class="sourceLine" id="cb3-48" data-line-number="48"> copyright = {All rights reserved},</a>
<a class="sourceLine" id="cb3-49" data-line-number="49"> issn = {00129658},</a>
<a class="sourceLine" id="cb3-50" data-line-number="50"> url = {http://doi.wiley.com/10.1002/ecy.2154},</a>
<a class="sourceLine" id="cb3-51" data-line-number="51"> doi = {10.1002/ecy.2154},</a>
<a class="sourceLine" id="cb3-52" data-line-number="52"> language = {en},</a>
<a class="sourceLine" id="cb3-53" data-line-number="53"> number = {4},</a>
<a class="sourceLine" id="cb3-54" data-line-number="54"> urldate = {2018-04-16},</a>
<a class="sourceLine" id="cb3-55" data-line-number="55"> journal = {Ecology},</a>
<a class="sourceLine" id="cb3-56" data-line-number="56"> 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="cb3-57" data-line-number="57"> month = apr,</a>
<a class="sourceLine" id="cb3-58" data-line-number="58"> year = {2018},</a>
<a class="sourceLine" id="cb3-59" data-line-number="59"> pages = {858--865}</a>
<a class="sourceLine" id="cb3-60" data-line-number="60"> }</a>
<a class="sourceLine" id="cb3-61" data-line-number="61"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb3-62" data-line-number="62"><span class="kw"></literatureCited></span></a></code></pre></div>
<p><strong>Q:</strong> Markdown Support</p>
<p><strong>A:</strong> TextType elements can include GitHub Flavored Markdown using the new
<markdown> element. See the description for the <markdown> element
in <a href="https://github.com/NCEAS/eml/blob/master/xsd/eml-text.xsd">eml-text.xsd</a> for
more details on embedded images, inline citations, and formatting considerations
regarding special characters and indentation.</p>
<p>Example of markdown in EML 2.2.0:</p>
<div class="sourceCode" id="cb4"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb4-1" data-line-number="1"><span class="kw"><markdown></span></a>
<a class="sourceLine" id="cb4-2" data-line-number="2"> An introduction goes here.</a>
<a class="sourceLine" id="cb4-3" data-line-number="3"></a>
<a class="sourceLine" id="cb4-4" data-line-number="4"> It can include multiple paragraphs. And these paragraphs should have enough text to wrap in a wide browser. So, repeat that last thought. And these paragraphs should have enough text to wrap in a wide browser. So, repeat that last thought.</a>
<a class="sourceLine" id="cb4-5" data-line-number="5"></a>
<a class="sourceLine" id="cb4-6" data-line-number="6"> Text can cite other works, such as [@jones_2001], in which case the</a>
<a class="sourceLine" id="cb4-7" data-line-number="7"> associated key must be present as either the citation identifier in a</a>
<a class="sourceLine" id="cb4-8" data-line-number="8"> `bibtex` element in the EML document, or as the `id` attribute on one of the</a>
<a class="sourceLine" id="cb4-9" data-line-number="9"> `citation` elements in the EML document. These identifiers must be unique</a>
<a class="sourceLine" id="cb4-10" data-line-number="10"> across the document. </a>
<a class="sourceLine" id="cb4-11" data-line-number="11"></a>
<a class="sourceLine" id="cb4-12" data-line-number="12"> And bulleted lists are also supported:</a>
<a class="sourceLine" id="cb4-13" data-line-number="13"></a>
<a class="sourceLine" id="cb4-14" data-line-number="14"> - Science</a>
<a class="sourceLine" id="cb4-15" data-line-number="15"> - Engineering</a>
<a class="sourceLine" id="cb4-16" data-line-number="16"> - Math</a>
<a class="sourceLine" id="cb4-17" data-line-number="17"></a>
<a class="sourceLine" id="cb4-18" data-line-number="18"> It can also include equations:</a>
<a class="sourceLine" id="cb4-19" data-line-number="19"></a>
<a class="sourceLine" id="cb4-20" data-line-number="20"> $$\left( x + a \right)^{n} = \sum_{k = 0}^{n}{\left( \frac{n}{k} \right)x^{k}a^{n - k}}$$</a>
<a class="sourceLine" id="cb4-21" data-line-number="21"></a>
<a class="sourceLine" id="cb4-22" data-line-number="22"> Plus, it can include all of the other features of [Github Flavored Markdown (GFM)](https://github.github.com/gfm/).</a>
<a class="sourceLine" id="cb4-23" data-line-number="23"><span class="kw"></markdown></span></a></code></pre></div>
<p><strong>Q:</strong> Usage Citations</p>
<p><strong>A:</strong> EML 2.2.0 documents can include a non-comprehensive list of citations in
which the data were explicitly used via a <usageCitation> element, which
is a CitationType.</p>
<p>Example usageCitation element:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb5-1" data-line-number="1"><span class="kw"><dataset></span></a>
<a class="sourceLine" id="cb5-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb5-3" data-line-number="3"> <span class="kw"><usageCitation></span></a>
<a class="sourceLine" id="cb5-4" data-line-number="4"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb5-5" data-line-number="5"> @article{jones_2001,</a>
<a class="sourceLine" id="cb5-6" data-line-number="6"> title = {Managing scientific metadata},</a>
<a class="sourceLine" id="cb5-7" data-line-number="7"> volume = {5},</a>
<a class="sourceLine" id="cb5-8" data-line-number="8"> issn = {10897801},</a>
<a class="sourceLine" id="cb5-9" data-line-number="9"> url = {http://ieeexplore.ieee.org/lpdocs/epic03/wrapper.htm?arnumber=957896},</a>
<a class="sourceLine" id="cb5-10" data-line-number="10"> doi = {10.1109/4236.957896},</a>
<a class="sourceLine" id="cb5-11" data-line-number="11"> number = {5},</a>
<a class="sourceLine" id="cb5-12" data-line-number="12"> journal = {IEEE Internet Computing},</a>
<a class="sourceLine" id="cb5-13" data-line-number="13"> author = {Jones, Matthew B. and Berkley, Chad and Bojilova, Jivka and Schildhauer, Mark},</a>
<a class="sourceLine" id="cb5-14" data-line-number="14"> year = {2001},</a>
<a class="sourceLine" id="cb5-15" data-line-number="15"> pages = {59--68}</a>
<a class="sourceLine" id="cb5-16" data-line-number="16"> }</a>
<a class="sourceLine" id="cb5-17" data-line-number="17"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb5-18" data-line-number="18"> <span class="kw"></usageCitation></span></a>
<a class="sourceLine" id="cb5-19" data-line-number="19"> ...</a>
<a class="sourceLine" id="cb5-20" data-line-number="20"><span class="kw"></dataset></span></a></code></pre></div>
<p><strong>Q:</strong> Reference Publications</p>
<p><strong>A:</strong> For cases when a research paper illustrates the usage of a dataset, the
new <referencePublication> element can be used to associate the dataset
with the paper.</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb6-1" data-line-number="1"><span class="kw"><dataset></span></a>
<a class="sourceLine" id="cb6-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb6-3" data-line-number="3"> <span class="kw"><referencePublication></span></a>
<a class="sourceLine" id="cb6-4" data-line-number="4"> <span class="kw"><bibtex></span></a>
<a class="sourceLine" id="cb6-5" data-line-number="5"> @article{ludwig_2018,</a>
<a class="sourceLine" id="cb6-6" data-line-number="6"> title = {Permafrost carbon and nitrogen, Yukon-Kuskokwim Delta, Alaska},</a>
<a class="sourceLine" id="cb6-7" data-line-number="7"> url = {http://ecosphere.esa.org/article/yyyy.zzzzzzz},</a>
<a class="sourceLine" id="cb6-8" data-line-number="8"> doi = {10.xxxx/yyyy.zzzzzz},</a>
<a class="sourceLine" id="cb6-9" data-line-number="9"> journal = {EcoSphere},</a>
<a class="sourceLine" id="cb6-10" data-line-number="10"> author = {Ludwig, Sarah},</a>
<a class="sourceLine" id="cb6-11" data-line-number="11"> year = {2018}</a>
<a class="sourceLine" id="cb6-12" data-line-number="12"> }</a>
<a class="sourceLine" id="cb6-13" data-line-number="13"> <span class="kw"></bibtex></span></a>
<a class="sourceLine" id="cb6-14" data-line-number="14"> <span class="kw"></referencePublication></span></a>
<a class="sourceLine" id="cb6-15" data-line-number="15"> ...</a>
<a class="sourceLine" id="cb6-16" data-line-number="16"><span class="kw"></dataset></span></a></code></pre></div>
<p><strong>Q:</strong> Data Paper Support</p>
<p><strong>A:</strong> ESA and other societies are moving towards the publication of data papers
that include more complete narratives about a data set and its importance and
use. To support data papers, EML 2.2.0 includes new optional fields for
Introduction, Getting Started, and Acknowledgements, as well as markdown and
citation-related elements described elsewhere in this document.</p>
<p>See the <a href="https://github.com/NCEAS/eml/blob/master/src/test/resources/eml-data-paper.xml">example EML document for a data
paper</a>.</p>
<p><strong>Q:</strong> Dataset license</p>
<p><strong>A:</strong> Datasets can now include a <licensed> element along with a URL to a
license.</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb7-1" data-line-number="1"><span class="kw"><dataset></span></a>
<a class="sourceLine" id="cb7-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb7-3" data-line-number="3"> <span class="kw"><licensed></span></a>
<a class="sourceLine" id="cb7-4" data-line-number="4"> <span class="kw"><licenseName></span>Creative Commons Attribution 4.0 International<span class="kw"></licenseName></span></a>
<a class="sourceLine" id="cb7-5" data-line-number="5"> <span class="kw"><url></span>https://spdx.org/licenses/CC-BY-4.0.html<span class="kw"></url></span></a>
<a class="sourceLine" id="cb7-6" data-line-number="6"> <span class="kw"><identifier></span>CC-BY-4.0<span class="kw"></identifier></span></a>
<a class="sourceLine" id="cb7-7" data-line-number="7"> <span class="kw"></licensed></span></a>
<a class="sourceLine" id="cb7-8" data-line-number="8"> ...</a>
<a class="sourceLine" id="cb7-9" data-line-number="9"><span class="kw"></dataset></span></a></code></pre></div>
<p><strong>Q:</strong> Structured Funding Information</p>
<p><strong>A:</strong> EML 2.2.0 sees the addition of an <award> element to support
structured funding information for a research project. This is used as an
alternative or in addition to the <funding> element which is a text type.</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb8-1" data-line-number="1"><span class="kw"><project></span></a>
<a class="sourceLine" id="cb8-2" data-line-number="2"> ...</a>
<a class="sourceLine" id="cb8-3" data-line-number="3"> <span class="kw"><funding><para></span>Funding is from a grant from the National Science Foundation.<span class="kw"></para></funding></span></a>
<a class="sourceLine" id="cb8-4" data-line-number="4"> <span class="kw"><award></span></a>
<a class="sourceLine" id="cb8-5" data-line-number="5"> <span class="kw"><funderName></span>National Science Foundation<span class="kw"></funderName></span></a>
<a class="sourceLine" id="cb8-6" data-line-number="6"> <span class="kw"><funderIdentifier></span>https://doi.org/10.13039/00000001<span class="kw"></funderIdentifier></span></a>
<a class="sourceLine" id="cb8-7" data-line-number="7"> <span class="kw"><awardNumber></span>1546024<span class="kw"></awardNumber></span></a>
<a class="sourceLine" id="cb8-8" data-line-number="8"> <span class="kw"><title></span>Scientia Arctica: A Knowledge Archive for Discovery and Reproducible Science in the Arctic<span class="kw"></title></span></a>
<a class="sourceLine" id="cb8-9" data-line-number="9"> <span class="kw"><awardUrl></span>https://www.nsf.gov/awardsearch/showAward?AWD_ID=1546024<span class="kw"></awardUrl></span></a>
<a class="sourceLine" id="cb8-10" data-line-number="10"> <span class="kw"></award></span></a>
<a class="sourceLine" id="cb8-11" data-line-number="11"><span class="kw"></project></span></a></code></pre></div>
<p><strong>Q:</strong> “unkown” deprecated as <maintenanceUpdateFrequency> element value.</p>
<p><strong>A:</strong> Some EML documents have specified “unkown” instead of “unknown” for the
maintenanceUpdateFrequency because there is a typo in the list of allowed values
in eml-dataset.xsd. For EML 2.2.0, a value of “unknown” is added to the list,
while the the original value of “unkown” is kept in the enumeration for
backwards compatibility with a note that its use is deprecated.</p>
<p><strong>Q:</strong> Accommodating Semantic Metadata</p>
<p><strong>A:</strong>
See <a href="eml-semantic-annotations-primer.md">EML Semantic Annotation Primer</a></p>
<p>EML 2.2.0 supports entering terms from an ontology via <annotation>
elements to further describe items such as data attributes, entity groups, and
resource groups. Annotations are allowed in five locations in the EML document:</p>
<ul>
<li>in <code>attribute</code>, <code>entity</code>, and <code>dataset</code> (or other resource) elements</li>
<li>in an <code>/eml/annotations</code> root element</li>
<li>in <code>/eml/additionalMetadata</code></li>
</ul>
<p>When the annotation is embedded in a containing EML attribute element, the
annotation’s subject is that attribute:</p>
<div class="sourceCode" id="cb9"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb9-1" data-line-number="1"><span class="kw"><attribute</span><span class="ot"> id=</span><span class="st">"att.12"</span><span class="kw">></span></a>
<a class="sourceLine" id="cb9-2" data-line-number="2"> <span class="kw"><attributeName></span>biomass<span class="kw"></attributeName></span></a>
<a class="sourceLine" id="cb9-3" data-line-number="3"> ...</a>
<a class="sourceLine" id="cb9-4" data-line-number="4"> <span class="kw"><annotation></span></a>
<a class="sourceLine" id="cb9-5" data-line-number="5"> <span class="kw"><propertyURI</span><span class="ot"> label=</span><span class="st">"of characteristic"</span><span class="kw">></span>http://ecoinformatics.org/oboe/oboe.1.2/oboe-core.owl#ofCharacteristic<span class="kw"></propertyURI></span></a>
<a class="sourceLine" id="cb9-6" data-line-number="6"> <span class="kw"><valueURI</span><span class="ot"> label=</span><span class="st">"Mass"</span><span class="kw">></span>http://ecoinformatics.org/oboe/oboe.1.2/oboe-characteristics.owl#Mass<span class="kw"></valueURI></span></a>
<a class="sourceLine" id="cb9-7" data-line-number="7"> <span class="kw"></annotation></span></a>
<a class="sourceLine" id="cb9-8" data-line-number="8"> <span class="kw"><annotation></span></a>
<a class="sourceLine" id="cb9-9" data-line-number="9"> <span class="kw"><propertyURI</span><span class="ot"> label=</span><span class="st">"of entity"</span><span class="kw">></span>http://ecoinformatics.org/oboe/oboe.1.2/oboe-core.owl#ofEntity<span class="kw"></propertyURI></span></a>
<a class="sourceLine" id="cb9-10" data-line-number="10"> <span class="kw"><valueURI</span><span class="ot"> label=</span><span class="st">"Plant Sample"</span><span class="kw">></span>http://example.com/example-vocab-1.owl#PlantSample<span class="kw"></valueURI></span></a>
<a class="sourceLine" id="cb9-11" data-line-number="11"> <span class="kw"></annotation></span></a>
<a class="sourceLine" id="cb9-12" data-line-number="12"><span class="kw"></attribute></span></a></code></pre></div>
<p>For annotations in <code>/eml/annotations</code>, the subject of the annotation is
established using a references attribute that points at the id of the subject of
the annotation:</p>
<div class="sourceCode" id="cb10"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb10-1" data-line-number="1"><span class="kw"><annotations></span></a>
<a class="sourceLine" id="cb10-2" data-line-number="2"> <span class="kw"><annotation</span><span class="ot"> references=</span><span class="st">"CDR-biodiv-table"</span><span class="kw">></span></a>
<a class="sourceLine" id="cb10-3" data-line-number="3"> <span class="kw"><propertyURI</span><span class="ot"> label=</span><span class="st">"Subject"</span><span class="kw">></span>http://purl.org/dc/elements/1.1/subject<span class="kw"></propertyURI></span></a>
<a class="sourceLine" id="cb10-4" data-line-number="4"> <span class="kw"><valueURI</span><span class="ot"> label=</span><span class="st">"grassland biome"</span><span class="kw">></span>http://purl.obolibrary.org/obo/ENVO_01000177<span class="kw"></valueURI></span></a>
<a class="sourceLine" id="cb10-5" data-line-number="5"> <span class="kw"></annotation></span></a>
<a class="sourceLine" id="cb10-6" data-line-number="6"><span class="kw"></annotations></span></a></code></pre></div>
<p>For annotations in <code>/eml/additionalMetadata</code>, the subject is the element with
the id listed within the associated <describes> element:</p>
<div class="sourceCode" id="cb11"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb11-1" data-line-number="1"><span class="kw"><additionalMetadata></span></a>
<a class="sourceLine" id="cb11-2" data-line-number="2"> <span class="kw"><describes></span>adam.shepherd<span class="kw"></describes></span></a>
<a class="sourceLine" id="cb11-3" data-line-number="3"> <span class="kw"><metadata></span></a>
<a class="sourceLine" id="cb11-4" data-line-number="4"> <span class="kw"><annotation></span></a>
<a class="sourceLine" id="cb11-5" data-line-number="5"> <span class="kw"><propertyURI</span><span class="ot"> label=</span><span class="st">"member of"</span><span class="kw">></span>https://schema.org/memberOf<span class="kw"></propertyURI></span></a>
<a class="sourceLine" id="cb11-6" data-line-number="6"> <span class="kw"><valueURI</span><span class="ot"> label=</span><span class="st">"BCO-DMO"</span><span class="kw">></span>https://doi.org/10.17616/R37P4C<span class="kw"></valueURI></span></a>
<a class="sourceLine" id="cb11-7" data-line-number="7"> <span class="kw"></annotation></span></a>
<a class="sourceLine" id="cb11-8" data-line-number="8"> <span class="kw"></metadata></span></a>
<a class="sourceLine" id="cb11-9" data-line-number="9"><span class="kw"></additionalMetadata></span></a></code></pre></div>
<p><strong>Q:</strong> Support for ids in <taxonomicClassification> element</p>
<p><strong>A:</strong> <taxonomicClassification> elements can now include a reference to
external identifiers, e.g., to a code from a system like ITIS or WoRMS.</p>
<div class="sourceCode" id="cb12"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb12-1" data-line-number="1"><span class="kw"><taxonomicClassification</span><span class="ot"> id=</span><span class="st">"taxon_MAPY"</span><span class="kw">></span></a>
<a class="sourceLine" id="cb12-2" data-line-number="2"> <span class="kw"><taxonRankName></span>species<span class="kw"></taxonRankName></span></a>
<a class="sourceLine" id="cb12-3" data-line-number="3"> <span class="kw"><taxonRankValue></span>Macrocystis pyrifera<span class="kw"></taxonRankValue></span></a>
<a class="sourceLine" id="cb12-4" data-line-number="4"> <span class="kw"><commonName></span>Giant Kelp<span class="kw"></commonName></span></a>
<a class="sourceLine" id="cb12-5" data-line-number="5"> <span class="kw"><taxonId</span><span class="ot"> provider=</span><span class="st">"ITIS"</span><span class="kw">></span>11274<span class="kw"></taxonId></span></a>
<a class="sourceLine" id="cb12-6" data-line-number="6"> <span class="kw"><taxonId</span><span class="ot"> provider=</span><span class="st">"https://www.ncbi.nlm.nih.gov/taxonomy"</span><span class="kw">></span>35122<span class="kw"></taxonId></span></a>
<a class="sourceLine" id="cb12-7" data-line-number="7"><span class="kw"></taxonomicClassification></span></a></code></pre></div>
<p><strong>Q:</strong> How can I convert from earlier versions of EML?</p>
<p><strong>A:</strong> An XSL stylesheet is provided with the EML Utilities to convert valid EML
2.1-series documents to EML 2.2.0 (see
<a href="http://knb.ecoinformatics.org/software/eml/" class="uri">http://knb.ecoinformatics.org/software/eml/</a>). The stylesheet performs basic
tasks to create a template EML 2.2.0 document. For more information, see the
Utilities documentation.</p>
<p><strong>Q:</strong> Validity of new EML 2.2.0 documents</p>
<p><strong>A:</strong> Because of the flexibility allowed in EML, the stylesheet may encounter
EML 2.1.0/1 structures that cannot be transformed or that may result in invalid
EML 2.2.0 after processing. For example, by design <additionalMetadata>
sections are parsed laxly, and so it is possible for their content in
EML-2.1.0/1 to contain <access> trees which are invalid. Document authors
are advised to check the validity of their new EML 2.2.0 after transformation.
EML instance documents can be validated in these ways:</p>
<ol style="list-style-type: decimal">
<li><p>With the <a href="http://knb.ecoinformatics.org/emlparser/">online EML Parser</a>. The
online parser will validate all versions of EML.</p></li>
<li><p>Using the Parser that comes with EML. To execute it, change into the ‘lib’
directory of the EML release and run the ‘runEMLParser’ script passing your
EML instance file as a parameter. The script performs two actions: it checks
the validity of references and id attributes, and it validates the document
against the EML 2.2 schema. The EML parser included with the distribution is
capable of checking only EML 2.2.0 documents, and <em>cannot</em> be used to
validate earlier versions (e.g., EML 2.1.1).</p></li>
<li><p>If you are planning to contribute your EML 2.2.0 document to a Metacat
repository, note that the Metacat servlet checks all versions of incoming EML
for validity as part of the insertion process.</p></li>
</ol>
</div>
</section>
</div>
</div>
</div>
<a href="contributors.html" class="navigation navigation-prev " aria-label="Previous page"><i class="fa fa-angle-left"></i></a>
<a href="the-eml-module-and-resources.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>