|
1
|
<?xml version="1.0"?>
|
|
2
|
<xs:schema targetNamespace="eml://ecoinformatics.org/physical-2.0.0rc1" xmlns="eml://ecoinformatics.org/physical-2.0.0rc1" xmlns:doc="eml://ecoinformatics.org/documentation-2.0.0rc1" xmlns:lit="eml://ecoinformatics.org/literature-2.0.0rc1" xmlns:res="eml://ecoinformatics.org/resource-2.0.0rc1" xmlns:xs="http://www.w3.org/2001/XMLSchema">
|
|
3
|
<xs:import namespace="eml://ecoinformatics.org/documentation-2.0.0rc1" schemaLocation="eml-documentation.xsd"/>
|
|
4
|
<xs:import namespace="eml://ecoinformatics.org/literature-2.0.0rc1" schemaLocation="eml-literature.xsd"/>
|
|
5
|
<xs:import namespace="eml://ecoinformatics.org/resource-2.0.0rc1" schemaLocation="eml-resource.xsd"/>
|
|
6
|
<xs:annotation>
|
|
7
|
<xs:documentation>
|
|
8
|
'$RCSfile: eml-physical.xsd,v $'
|
|
9
|
Copyright: 1997-2002 Regents of the University of California,
|
|
10
|
University of New Mexico, and
|
|
11
|
Arizona State University
|
|
12
|
Sponsors: National Center for Ecological Analysis and Synthesis and
|
|
13
|
Partnership for Interdisciplinary Studies of Coastal Oceans,
|
|
14
|
University of California Santa Barbara
|
|
15
|
Long-Term Ecological Research Network Office,
|
|
16
|
University of New Mexico
|
|
17
|
Center for Environmental Studies, Arizona State University
|
|
18
|
Other funding: National Science Foundation (see README for details)
|
|
19
|
The David and Lucile Packard Foundation
|
|
20
|
|
|
21
|
For Details: http://knb.ecoinformatics.org/
|
|
22
|
'$Author: cjones $'
|
|
23
|
'$Date: 2002/09/16 23:40:58 $'
|
|
24
|
'$Revision: 1.43 $'
|
|
25
|
|
|
26
|
This program is free software; you can redistribute it and/or modify
|
|
27
|
it under the terms of the GNU General Public License as published by
|
|
28
|
the Free Software Foundation; either version 2 of the License, or
|
|
29
|
(at your option) any later version.
|
|
30
|
|
|
31
|
This program is distributed in the hope that it will be useful,
|
|
32
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
33
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
34
|
GNU General Public License for more details.
|
|
35
|
|
|
36
|
You should have received a copy of the GNU General Public License
|
|
37
|
along with this program; if not, write to the Free Software
|
|
38
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
39
|
</xs:documentation>
|
|
40
|
<xs:appinfo>
|
|
41
|
<doc:moduleDocs>
|
|
42
|
<doc:moduleName>eml-physical</doc:moduleName>
|
|
43
|
<doc:moduleDescription>The eml-physical module describes the external
|
|
44
|
and internal physical characteristics of a data object as well as the
|
|
45
|
information required for its distribution. Examples of the external
|
|
46
|
physical characteristics of a data object would be the filename, size,
|
|
47
|
compression, encoding methods, and authentication of a file (or byte
|
|
48
|
stream) that resides on a filesystem or the name of a database table
|
|
49
|
if the data object resides in a relational database. Internal
|
|
50
|
physical characteristics describe the format of the data object being
|
|
51
|
described. Examples are Microsoft Access 2000, ASCII, or UTF-8. It
|
|
52
|
also includes the information needed to parse the data object to
|
|
53
|
extract the entity and its attributes from the data object.
|
|
54
|
Distribution information describes how to retrieve the data object.
|
|
55
|
The retrieval information can be either online with connection
|
|
56
|
information, a URL for example, or offline with the data object
|
|
57
|
residing on an archival tape.
|
|
58
|
</doc:moduleDescription>
|
|
59
|
<doc:recommendedUsage>Any data object that is being desribed by EML
|
|
60
|
needs this information so the entities and attributes that reside with
|
|
61
|
in the data object can be extracted.
|
|
62
|
</doc:recommendedUsage>
|
|
63
|
<doc:standAlone>yes</doc:standAlone>
|
|
64
|
</doc:moduleDocs>
|
|
65
|
</xs:appinfo>
|
|
66
|
</xs:annotation>
|
|
67
|
<xs:element name="physical" type="PhysicalType">
|
|
68
|
<xs:annotation>
|
|
69
|
<xs:appinfo>
|
|
70
|
<doc:tooltip>Physical structure.</doc:tooltip>
|
|
71
|
<doc:summary>Physical structure of an entity or entities.</doc:summary>
|
|
72
|
<doc:description>The content model for physical is a CHOICE between
|
|
73
|
"references" and all of the elements that let you describe the
|
|
74
|
internal/external characteristics and distribution of a data object
|
|
75
|
(e.g., dataObject, dataFormat, distribution.) A physical element can
|
|
76
|
contain a reference to an physical element defined elsewhere. Using
|
|
77
|
a reference means that the referenced physical is identical, not just
|
|
78
|
in name but identical in its complete description.
|
|
79
|
</doc:description>
|
|
80
|
<doc:lineage>The eml-physical was introduced into EML 1.4 as
|
|
81
|
eml-file.</doc:lineage>
|
|
82
|
</xs:appinfo>
|
|
83
|
</xs:annotation>
|
|
84
|
</xs:element>
|
|
85
|
<xs:complexType name="PhysicalType">
|
|
86
|
<xs:choice>
|
|
87
|
<xs:sequence>
|
|
88
|
<xs:element name="objectName" type="xs:string"/>
|
|
89
|
<xs:element name="size" minOccurs="0">
|
|
90
|
<xs:annotation>
|
|
91
|
<xs:appinfo>
|
|
92
|
<doc:tooltip>Data object size</doc:tooltip>
|
|
93
|
<doc:summary>Describes the physical size of the
|
|
94
|
data object.</doc:summary>
|
|
95
|
<doc:description>This element contains information of the
|
|
96
|
physical size of the entity, typically in
|
|
97
|
bytes.</doc:description>
|
|
98
|
<doc:example><![CDATA[<entitySize unit="bytes">13</entitySize>]]></doc:example>
|
|
99
|
<doc:lineage>The entitySize was introduced into EML
|
|
100
|
1.4.</doc:lineage>
|
|
101
|
</xs:appinfo>
|
|
102
|
</xs:annotation>
|
|
103
|
<xs:complexType>
|
|
104
|
<xs:simpleContent>
|
|
105
|
<xs:extension base="xs:string">
|
|
106
|
<xs:attribute name="unit" use="optional" default="bytes">
|
|
107
|
<xs:annotation>
|
|
108
|
<xs:appinfo>
|
|
109
|
<doc:tooltip>Unit of measurement</doc:tooltip>
|
|
110
|
<doc:summary>Unit of measurement for the entity
|
|
111
|
size, typically bytes</doc:summary>
|
|
112
|
<doc:description>This element gives the unit of
|
|
113
|
measurement for the size of the entity, and is
|
|
114
|
typically bytes.</doc:description>
|
|
115
|
<doc:example><![CDATA[<entitySize unit="bytes">13</entitySize>]]></doc:example>
|
|
116
|
<doc:lineage>The unit was introduced into EML
|
|
117
|
1.4.</doc:lineage>
|
|
118
|
</xs:appinfo>
|
|
119
|
</xs:annotation>
|
|
120
|
</xs:attribute>
|
|
121
|
</xs:extension>
|
|
122
|
</xs:simpleContent>
|
|
123
|
</xs:complexType>
|
|
124
|
</xs:element>
|
|
125
|
<xs:element name="authentication" minOccurs="0" maxOccurs="unbounded">
|
|
126
|
<xs:annotation>
|
|
127
|
<xs:appinfo>
|
|
128
|
<doc:tooltip>Authentication method</doc:tooltip>
|
|
129
|
<doc:summary>A value, typically a checksum, used to
|
|
130
|
authenticate that the bitstream delivered to the user is
|
|
131
|
identical to the original.</doc:summary>
|
|
132
|
<doc:description>This element describes authentication
|
|
133
|
procedures or techniques, typically by giving a checksum
|
|
134
|
method (e.g., MD5) and checksum value for the
|
|
135
|
bytestream.</doc:description>
|
|
136
|
<doc:example><![CDATA[<authentication method="MD5">
|
|
137
|
f5b2177ea03aea73de12da81f896fe40</authentication>]]></doc:example>
|
|
138
|
<doc:lineage>The authentication element was introduced into
|
|
139
|
EML 1.4.</doc:lineage>
|
|
140
|
</xs:appinfo>
|
|
141
|
</xs:annotation>
|
|
142
|
<xs:complexType>
|
|
143
|
<xs:simpleContent>
|
|
144
|
<xs:extension base="xs:string">
|
|
145
|
<xs:attribute name="method" type="xs:string" use="optional">
|
|
146
|
<xs:annotation>
|
|
147
|
<xs:appinfo>
|
|
148
|
<doc:tooltip>Authentication method</doc:tooltip>
|
|
149
|
<doc:summary>The method used to calculate an
|
|
150
|
authentication checksum.</doc:summary>
|
|
151
|
<doc:description>This element names the method used
|
|
152
|
to calculate and authentication checksum that can
|
|
153
|
be used to validate a bytestream. Typical checksum
|
|
154
|
methods include MD5 and CRC.</doc:description>
|
|
155
|
<doc:example><![CDATA[<authentication method="MD5">
|
|
156
|
f5b2177ea03aea73de12da81f896fe40</authentication>]]></doc:example>
|
|
157
|
<doc:lineage>The authentication element was
|
|
158
|
introduced into EML 1.4.</doc:lineage>
|
|
159
|
</xs:appinfo>
|
|
160
|
</xs:annotation>
|
|
161
|
</xs:attribute>
|
|
162
|
</xs:extension>
|
|
163
|
</xs:simpleContent>
|
|
164
|
</xs:complexType>
|
|
165
|
</xs:element>
|
|
166
|
<xs:element name="compressionMethod" type="xs:string" minOccurs="0">
|
|
167
|
<xs:annotation>
|
|
168
|
<xs:appinfo>
|
|
169
|
<doc:tooltip>Entity's compression method</doc:tooltip>
|
|
170
|
<doc:summary>Name of the entity's compression
|
|
171
|
method</doc:summary>
|
|
172
|
<doc:description>This element describes any compression
|
|
173
|
methods used to compress the entity, such as zip, compress,
|
|
174
|
etc.</doc:description>
|
|
175
|
<doc:lineage>The compressed element was introduced into EML
|
|
176
|
1.4.</doc:lineage>
|
|
177
|
</xs:appinfo>
|
|
178
|
</xs:annotation>
|
|
179
|
</xs:element>
|
|
180
|
<xs:element name="encodingMethod" type="xs:string" minOccurs="0">
|
|
181
|
<xs:annotation>
|
|
182
|
<xs:appinfo>
|
|
183
|
<doc:tooltip>Encoding Method</doc:tooltip>
|
|
184
|
<doc:summary>Method used for encoding the
|
|
185
|
entity</doc:summary>
|
|
186
|
<doc:description>This element describes the entity's
|
|
187
|
encoded method, such as MIME base64 encoding or binhex
|
|
188
|
encoding.</doc:description>
|
|
189
|
<doc:lineage>The encoded element was introduced into EML
|
|
190
|
1.4.</doc:lineage>
|
|
191
|
</xs:appinfo>
|
|
192
|
</xs:annotation>
|
|
193
|
</xs:element>
|
|
194
|
<xs:element name="characterEncoding" type="xs:string" minOccurs="0">
|
|
195
|
<xs:annotation>
|
|
196
|
<xs:appinfo>
|
|
197
|
<doc:tooltip>Character Encoding</doc:tooltip>
|
|
198
|
<doc:summary>Contains the name of the chracter encoding
|
|
199
|
used for the data.</doc:summary>
|
|
200
|
<doc:description>This element contains the name of the
|
|
201
|
character encoding. This is typically ASCII or UTF-8, or
|
|
202
|
one of the other common encodings.</doc:description>
|
|
203
|
<doc:example><![CDATA[<characterEncoding>UTF-8</characterEncoding>]]></doc:example>
|
|
204
|
<doc:lineage>Introduced in EML 2.0</doc:lineage>
|
|
205
|
</xs:appinfo>
|
|
206
|
</xs:annotation>
|
|
207
|
</xs:element>
|
|
208
|
<xs:element name="dataFormat">
|
|
209
|
<xs:annotation>
|
|
210
|
<xs:appinfo>
|
|
211
|
<doc:tooltip>Data format</doc:tooltip>
|
|
212
|
<doc:summary>Describes the internal physical format
|
|
213
|
of a data object.</doc:summary>
|
|
214
|
<doc:description>This element is the parent which is a CHOICE
|
|
215
|
between four possible internal physical formats
|
|
216
|
which describe the internal
|
|
217
|
physical characteristics of the data object. Using this
|
|
218
|
information the user should be able construct the entity
|
|
219
|
and attributes described in those modules. Note that this is
|
|
220
|
the format of the
|
|
221
|
physical file itself.</doc:description>
|
|
222
|
<doc:lineage>The format element was introduced into EML
|
|
223
|
1.4.</doc:lineage>
|
|
224
|
</xs:appinfo>
|
|
225
|
</xs:annotation>
|
|
226
|
<xs:complexType>
|
|
227
|
<xs:choice>
|
|
228
|
<xs:annotation>
|
|
229
|
<xs:appinfo>
|
|
230
|
<doc:tooltip>Generic binary format</doc:tooltip>
|
|
231
|
<doc:summary>Generic binary format</doc:summary>
|
|
232
|
<doc:description>Documentation for a generic binary
|
|
233
|
format</doc:description>
|
|
234
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
235
|
</xs:appinfo>
|
|
236
|
</xs:annotation>
|
|
237
|
<xs:element name="textFormat">
|
|
238
|
<xs:complexType>
|
|
239
|
<xs:sequence>
|
|
240
|
<xs:element name="numHeaderLines" minOccurs="0"/>
|
|
241
|
<xs:element name="numFooterLines" minOccurs="0"/>
|
|
242
|
<xs:element name="recordDelimiter" type="xs:string" maxOccurs="unbounded">
|
|
243
|
<xs:annotation>
|
|
244
|
<xs:appinfo>
|
|
245
|
<doc:tooltip>Record delimiter character</doc:tooltip>
|
|
246
|
<doc:summary>Character used to delimit
|
|
247
|
records.</doc:summary>
|
|
248
|
<doc:description>This element specifies the record
|
|
249
|
delimiter character when the format is text. The
|
|
250
|
record delimiter is usually a newline (\n) on UNIX, a
|
|
251
|
carriage return (\r) on MacOS, or both (\r\n) on
|
|
252
|
Windows/DOS. Multiline records are usually delimited
|
|
253
|
with two line ending characters, for example on UNIX
|
|
254
|
it would be two newline characters
|
|
255
|
(\n\n).</doc:description>
|
|
256
|
<doc:example><![CDATA[<recordDelimiter>\n\r</recordDelimiter>]]></doc:example>
|
|
257
|
<doc:lineage>The recordDelimiter element was
|
|
258
|
introduced into EML 1.4.</doc:lineage>
|
|
259
|
</xs:appinfo>
|
|
260
|
</xs:annotation>
|
|
261
|
</xs:element>
|
|
262
|
<xs:choice>
|
|
263
|
<xs:element name="simpleDelimited">
|
|
264
|
<xs:complexType>
|
|
265
|
<xs:sequence>
|
|
266
|
<xs:element name="fieldDelimiter" type="xs:string" maxOccurs="unbounded"/>
|
|
267
|
<xs:element name="maxRecordLength" type="xs:unsignedLong" minOccurs="0"/>
|
|
268
|
<xs:element name="quoteCharacter" type="xs:string" minOccurs="0" maxOccurs="unbounded">
|
|
269
|
<xs:annotation>
|
|
270
|
<xs:appinfo>
|
|
271
|
<doc:tooltip>Quote character</doc:tooltip>
|
|
272
|
<doc:summary>Character used to quote values for
|
|
273
|
delimiter escaping</doc:summary>
|
|
274
|
<doc:description>This element specifies a character
|
|
275
|
to be used in the entity for quoting values so that
|
|
276
|
field delimeters can be used within the value. This
|
|
277
|
basically allows delimeter "escaping". The
|
|
278
|
quoteChacter is typically a " or '.</doc:description>
|
|
279
|
<doc:example><![CDATA[<quoteCharacter>"</quoteCharacter>]]></doc:example>
|
|
280
|
<doc:lineage>The quoteCharacter element was taken
|
|
281
|
from the NBII standard.</doc:lineage>
|
|
282
|
</xs:appinfo>
|
|
283
|
</xs:annotation>
|
|
284
|
</xs:element>
|
|
285
|
<xs:element name="literalCharacter" type="xs:string" minOccurs="0" maxOccurs="unbounded">
|
|
286
|
<xs:annotation>
|
|
287
|
<xs:appinfo>
|
|
288
|
<doc:tooltip>Literal character</doc:tooltip>
|
|
289
|
<doc:summary>Character used to escape other
|
|
290
|
characters</doc:summary>
|
|
291
|
<doc:description>This element specifies a character
|
|
292
|
to be used for escaping character values so that the
|
|
293
|
following character is treated as its literal value.
|
|
294
|
This allows "escaping" for special characters like
|
|
295
|
quotes, commas, and spaces when they aren't intended
|
|
296
|
as a delimiter value. The literalCharacter is
|
|
297
|
typicallya \.</doc:description>
|
|
298
|
<doc:example><![CDATA[<literalCharacter>\</literalCharacter>]]></doc:example>
|
|
299
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
300
|
</xs:appinfo>
|
|
301
|
</xs:annotation>
|
|
302
|
</xs:element>
|
|
303
|
</xs:sequence>
|
|
304
|
</xs:complexType>
|
|
305
|
</xs:element>
|
|
306
|
<xs:element name="complex">
|
|
307
|
<xs:complexType>
|
|
308
|
<xs:sequence>
|
|
309
|
<xs:choice maxOccurs="unbounded">
|
|
310
|
<xs:element name="textFixed">
|
|
311
|
<xs:annotation>
|
|
312
|
<xs:appinfo>
|
|
313
|
<doc:tooltip>ASCII fixed delimited</doc:tooltip>
|
|
314
|
<doc:summary>Describes physical format of entities
|
|
315
|
and attributes delimitedby special characters like commas
|
|
316
|
and spaces.</doc:summary>
|
|
317
|
<doc:description>Describes physical format of entities
|
|
318
|
and attributes delimitedby special characters like commas
|
|
319
|
and spaces.</doc:description>
|
|
320
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
321
|
</xs:appinfo>
|
|
322
|
</xs:annotation>
|
|
323
|
<xs:complexType>
|
|
324
|
<xs:sequence>
|
|
325
|
<xs:element name="fieldWidth" type="xs:unsignedLong">
|
|
326
|
<xs:annotation>
|
|
327
|
<xs:appinfo>
|
|
328
|
<doc:tooltip>Field width</doc:tooltip>
|
|
329
|
<doc:summary>FieldWidth specification for fixed
|
|
330
|
field length.</doc:summary>
|
|
331
|
<doc:description>FixedWidth fields have a set
|
|
332
|
length, thus the end of the field can always be
|
|
333
|
determined by adding the fieldWidth to the
|
|
334
|
starting column number.</doc:description>
|
|
335
|
<doc:example>any positive integer, see example
|
|
336
|
in "delimeter" description</doc:example>
|
|
337
|
<doc:lineage>The fieldWidth element was
|
|
338
|
introduced into EML 1.4. Semantics changed to
|
|
339
|
work identically to the NBII DTD.</doc:lineage>
|
|
340
|
</xs:appinfo>
|
|
341
|
</xs:annotation>
|
|
342
|
</xs:element>
|
|
343
|
<xs:element name="lineNumber" type="xs:unsignedLong" minOccurs="0">
|
|
344
|
<xs:annotation>
|
|
345
|
<xs:appinfo>
|
|
346
|
<doc:tooltip>Physical Line Number</doc:tooltip>
|
|
347
|
<doc:summary>The line on which the data field
|
|
348
|
is found, when the data record is written over
|
|
349
|
more than one physical line in the
|
|
350
|
file.</doc:summary>
|
|
351
|
<doc:description>A single logical data record
|
|
352
|
may be written over several physical lines in a
|
|
353
|
file, with no special marker to indicate the
|
|
354
|
end of a record. In such cases, the relative
|
|
355
|
location of a data field must be indicated by
|
|
356
|
both relative row and column
|
|
357
|
number.</doc:description>
|
|
358
|
<doc:example>3</doc:example>
|
|
359
|
<doc:lineage>Introduced into EML
|
|
360
|
2.0.</doc:lineage>
|
|
361
|
</xs:appinfo>
|
|
362
|
</xs:annotation>
|
|
363
|
</xs:element>
|
|
364
|
<xs:element name="fieldStartColumn" type="xs:long" minOccurs="0">
|
|
365
|
<xs:annotation>
|
|
366
|
<xs:appinfo>
|
|
367
|
<doc:tooltip>Start column</doc:tooltip>
|
|
368
|
<doc:summary>The starting column number for a
|
|
369
|
fixed format attribute.</doc:summary>
|
|
370
|
<doc:description>FixedWidth fields have a set
|
|
371
|
length, thus the end of the field can always be
|
|
372
|
determined by adding the fieldWidth to the
|
|
373
|
starting column number.</doc:description>
|
|
374
|
<doc:example>any positive integer, see example
|
|
375
|
in "delimiter" description</doc:example>
|
|
376
|
<doc:lineage>Introduced into EML
|
|
377
|
2.0.</doc:lineage>
|
|
378
|
</xs:appinfo>
|
|
379
|
</xs:annotation>
|
|
380
|
</xs:element>
|
|
381
|
<xs:element name="numPhysicalLines" type="xs:unsignedInt" minOccurs="0">
|
|
382
|
<xs:annotation>
|
|
383
|
<xs:appinfo>
|
|
384
|
<doc:tooltip>Number of physical lines</doc:tooltip>
|
|
385
|
<doc:summary>The number of physical lines in the file
|
|
386
|
spanned by a single logical data
|
|
387
|
record.</doc:summary>
|
|
388
|
<doc:description>A single logical data record may be
|
|
389
|
written over several physical lines in a file, with
|
|
390
|
no special marker to indicate the end of a record. In
|
|
391
|
such cases, it is necessary to know the number of
|
|
392
|
lines per record in order to correctly read
|
|
393
|
them.</doc:description>
|
|
394
|
<doc:example>3</doc:example>
|
|
395
|
<doc:lineage>Introduced into EML 2.0.</doc:lineage>
|
|
396
|
</xs:appinfo>
|
|
397
|
</xs:annotation>
|
|
398
|
</xs:element>
|
|
399
|
<xs:element name="maxRecordLength" type="xs:unsignedLong" minOccurs="0"/>
|
|
400
|
</xs:sequence>
|
|
401
|
</xs:complexType>
|
|
402
|
</xs:element>
|
|
403
|
<xs:element name="textDelimited">
|
|
404
|
<xs:annotation>
|
|
405
|
<xs:appinfo>
|
|
406
|
<doc:tooltip>ASCII field delimited</doc:tooltip>
|
|
407
|
<doc:summary>Describes physical format of entities
|
|
408
|
and attributes delimitedby special characters like commas
|
|
409
|
and spaces.</doc:summary>
|
|
410
|
<doc:description>Describes physical format of entities
|
|
411
|
and attributes delimitedby special characters like commas
|
|
412
|
and spaces.</doc:description>
|
|
413
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
414
|
</xs:appinfo>
|
|
415
|
</xs:annotation>
|
|
416
|
<xs:complexType>
|
|
417
|
<xs:sequence>
|
|
418
|
<xs:element name="fieldDelimiter" type="xs:string">
|
|
419
|
<xs:annotation>
|
|
420
|
<xs:appinfo>
|
|
421
|
<doc:tooltip>Attribute delimiter</doc:tooltip>
|
|
422
|
<doc:summary>The end of the attribute (field) is
|
|
423
|
delimited by a special character called a field
|
|
424
|
delimiter.</doc:summary>
|
|
425
|
<doc:description>
|
|
426
|
Variable width format fields (attributes) can vary
|
|
427
|
in their
|
|
428
|
field length, thus the end of the field is
|
|
429
|
delimited by a special character called a
|
|
430
|
field delimiter (typically a comma or a space).
|
|
431
|
Data sets are generally classified as fixedWidth
|
|
432
|
format or variableWidth format, but we have
|
|
433
|
determined that this is actually a per-field
|
|
434
|
classification because one may encounter
|
|
435
|
fixedWidth fields mixed together in the same
|
|
436
|
data file with variableWidth fields.
|
|
437
|
In our encoding scheme, the start of each field
|
|
438
|
is assumed to be the column after the last column
|
|
439
|
of the previous field, or the first column
|
|
440
|
if this is the first field in the dataset, unless
|
|
441
|
the starting column is explicity enumerated using the
|
|
442
|
"fieldStartColumn" element.
|
|
443
|
The end column for each field is classified
|
|
444
|
using either a special character delimeter indicated
|
|
445
|
using the filedDelimiter element,
|
|
446
|
or a fixed field length indicated by using the
|
|
447
|
"fieldWidth"
|
|
448
|
element. The delimiter for the last field in the
|
|
449
|
data set can be omitted.
|
|
450
|
variableWidth fields can vary in their field length,
|
|
451
|
and the end of
|
|
452
|
the field is delimited by a special character
|
|
453
|
called a field delimiter, usually a comma or
|
|
454
|
a tab character. fixedWidth fields have a set
|
|
455
|
length, and so the end of the field can always
|
|
456
|
be determined by adding the fieldWidth to the
|
|
457
|
starting column number. Here is an example:
|
|
458
|
Assume we have the following data in a data set:
|
|
459
|
May,100aaaa,1.2,
|
|
460
|
April,200aaaa,3.4,
|
|
461
|
June,300bbbb,4.6,
|
|
462
|
The metadata indicating the physical layout of the
|
|
463
|
4 fields would include the
|
|
464
|
following:
|
|
465
|
<![CDATA[
|
|
466
|
<delimiter>,</delimiter>
|
|
467
|
<fieldWidth>3</fieldWidth>
|
|
468
|
<fieldWidth>3</fieldWidth>
|
|
469
|
<delimiter>,</delimiter>
|
|
470
|
]]>
|
|
471
|
In a strictly fixed format file, the metadata would
|
|
472
|
be slightly different:
|
|
473
|
May100aaaa1.2
|
|
474
|
Apr200aaaa3.4
|
|
475
|
Jun300bbbb4.6
|
|
476
|
<![CDATA[
|
|
477
|
<fieldWidth>3</fieldWidth>
|
|
478
|
<fieldWidth>3</fieldWidth>
|
|
479
|
<fieldWidth>4</fieldWidth>
|
|
480
|
<fieldWidth>3</fieldWidth>
|
|
481
|
]]>
|
|
482
|
or, one could explicitly describe the starting columns:
|
|
483
|
<![CDATA[
|
|
484
|
<fieldStartColumn>1</fieldStartColumn>
|
|
485
|
<fieldWidth>3</fieldWidth>
|
|
486
|
<fieldStartColumn>4</fieldStartColumn>
|
|
487
|
<fieldWidth>3</fieldWidth>
|
|
488
|
<fieldStartColumn>7</fieldStartColumn>
|
|
489
|
<fieldWidth>4</fieldWidth>
|
|
490
|
<fieldStartColumn>11</fieldStartColumn>
|
|
491
|
<fieldWidth>3</fieldWidth>
|
|
492
|
]]></doc:description>
|
|
493
|
<doc:example>comma, tab, white space,
|
|
494
|
etc.</doc:example>
|
|
495
|
<doc:lineage>The delimiter element was introduced
|
|
496
|
into EML 1.4. Semantics changed to work identically
|
|
497
|
to the NBII DTD, and then modified to fit more
|
|
498
|
cases.</doc:lineage>
|
|
499
|
</xs:appinfo>
|
|
500
|
</xs:annotation>
|
|
501
|
</xs:element>
|
|
502
|
<xs:element name="lineNumber" type="xs:unsignedLong" minOccurs="0">
|
|
503
|
<xs:annotation>
|
|
504
|
<xs:appinfo>
|
|
505
|
<doc:tooltip>Physical Line Number</doc:tooltip>
|
|
506
|
<doc:summary>The line on which the data field
|
|
507
|
is found, when the data record is written over
|
|
508
|
more than one physical line in the
|
|
509
|
file.</doc:summary>
|
|
510
|
<doc:description>A single logical data record
|
|
511
|
may be written over several physical lines in a
|
|
512
|
file, with no special marker to indicate the
|
|
513
|
end of a record. In such cases, the relative
|
|
514
|
location of a data field must be indicated by
|
|
515
|
both relative row and column
|
|
516
|
number.</doc:description>
|
|
517
|
<doc:example>3</doc:example>
|
|
518
|
<doc:lineage>Introduced into EML
|
|
519
|
2.0.</doc:lineage>
|
|
520
|
</xs:appinfo>
|
|
521
|
</xs:annotation>
|
|
522
|
</xs:element>
|
|
523
|
<xs:element name="maxRecordLength" type="xs:unsignedLong" minOccurs="0"/>
|
|
524
|
<xs:element name="quoteCharacter" type="xs:string" minOccurs="0" maxOccurs="unbounded">
|
|
525
|
<xs:annotation>
|
|
526
|
<xs:appinfo>
|
|
527
|
<doc:tooltip>Quote character</doc:tooltip>
|
|
528
|
<doc:summary>Character used to quote values for
|
|
529
|
delimiter escaping</doc:summary>
|
|
530
|
<doc:description>This element specifies a character
|
|
531
|
to be used in the entity for quoting values so that
|
|
532
|
field delimeters can be used within the value. This
|
|
533
|
basically allows delimeter "escaping". The
|
|
534
|
quoteChacter is typically a " or '.</doc:description>
|
|
535
|
<doc:example><![CDATA[<quoteCharacter>"</quoteCharacter>]]></doc:example>
|
|
536
|
<doc:lineage>The quoteCharacter element was taken
|
|
537
|
from the NBII standard.</doc:lineage>
|
|
538
|
</xs:appinfo>
|
|
539
|
</xs:annotation>
|
|
540
|
</xs:element>
|
|
541
|
<xs:element name="literalCharacter" type="xs:string" minOccurs="0" maxOccurs="unbounded">
|
|
542
|
<xs:annotation>
|
|
543
|
<xs:appinfo>
|
|
544
|
<doc:tooltip>Literal character</doc:tooltip>
|
|
545
|
<doc:summary>Character used to escape other
|
|
546
|
characters</doc:summary>
|
|
547
|
<doc:description>This element specifies a character
|
|
548
|
to be used for escaping character values so that the
|
|
549
|
following character is treated as its literal value.
|
|
550
|
This allows "escaping" for special characters like
|
|
551
|
quotes, commas, and spaces when they aren't intended
|
|
552
|
as a delimiter value. The literalCharacter is
|
|
553
|
typicallya \.</doc:description>
|
|
554
|
<doc:example><![CDATA[<literalCharacter>\</literalCharacter>]]></doc:example>
|
|
555
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
556
|
</xs:appinfo>
|
|
557
|
</xs:annotation>
|
|
558
|
</xs:element>
|
|
559
|
</xs:sequence>
|
|
560
|
</xs:complexType>
|
|
561
|
</xs:element>
|
|
562
|
</xs:choice>
|
|
563
|
</xs:sequence>
|
|
564
|
</xs:complexType>
|
|
565
|
</xs:element>
|
|
566
|
</xs:choice>
|
|
567
|
</xs:sequence>
|
|
568
|
</xs:complexType>
|
|
569
|
</xs:element>
|
|
570
|
<xs:element name="formatType">
|
|
571
|
<xs:complexType>
|
|
572
|
<xs:sequence>
|
|
573
|
<xs:element name="formatName" type="xs:string">
|
|
574
|
<xs:annotation>
|
|
575
|
<xs:appinfo>
|
|
576
|
<doc:tooltip>Format Name</doc:tooltip>
|
|
577
|
<doc:summary>Name of the internal format of the
|
|
578
|
data object</doc:summary>
|
|
579
|
<doc:description>Name of the internal format of the
|
|
580
|
data object</doc:description>
|
|
581
|
<doc:example>
|
|
582
|
Microsoft Excel
|
|
583
|
</doc:example>
|
|
584
|
<doc:lineage>The formatName element was
|
|
585
|
introduced into EML 2.0</doc:lineage>
|
|
586
|
</xs:appinfo>
|
|
587
|
</xs:annotation>
|
|
588
|
</xs:element>
|
|
589
|
<xs:element name="formatVersion" type="xs:string" minOccurs="0">
|
|
590
|
<xs:annotation>
|
|
591
|
<xs:appinfo>
|
|
592
|
<doc:tooltip>Format Version</doc:tooltip>
|
|
593
|
<doc:summary>Version of the internal format of the
|
|
594
|
data object</doc:summary>
|
|
595
|
<doc:description>Version of the internal format of the
|
|
596
|
data object</doc:description>
|
|
597
|
<doc:example>
|
|
598
|
2000 (9.0.2720)
|
|
599
|
</doc:example>
|
|
600
|
<doc:lineage>The formatVersion element was
|
|
601
|
introduced into EML 2.0</doc:lineage>
|
|
602
|
</xs:appinfo>
|
|
603
|
</xs:annotation>
|
|
604
|
</xs:element>
|
|
605
|
<xs:element name="citation" type="lit:CitationType" minOccurs="0">
|
|
606
|
<xs:annotation>
|
|
607
|
<xs:appinfo>
|
|
608
|
<doc:tooltip>citation</doc:tooltip>
|
|
609
|
<doc:summary>Data object is an eml-literature document.
|
|
610
|
</doc:summary>
|
|
611
|
<doc:description>Data object conforms to the
|
|
612
|
EML standard for citation as defined in the XML schema
|
|
613
|
for eml-literature.</doc:description>
|
|
614
|
<doc:example>
|
|
615
|
eml-literature.xml
|
|
616
|
</doc:example>
|
|
617
|
<doc:lineage>The citation element was
|
|
618
|
introduced into EML 2.0</doc:lineage>
|
|
619
|
</xs:appinfo>
|
|
620
|
</xs:annotation>
|
|
621
|
</xs:element>
|
|
622
|
</xs:sequence>
|
|
623
|
</xs:complexType>
|
|
624
|
</xs:element>
|
|
625
|
<xs:element name="binaryRasterInfo">
|
|
626
|
<xs:annotation>
|
|
627
|
<xs:appinfo>
|
|
628
|
<doc:tooltip>raster image parameters</doc:tooltip>
|
|
629
|
<doc:summary>contains binary raster data header
|
|
630
|
parameters</doc:summary>
|
|
631
|
<doc:description>The binaryRasterInfo element is a
|
|
632
|
container for various parameters used to described the
|
|
633
|
contents of binary raster image files. In this case, it is
|
|
634
|
based on a white paper on the ESRI site that describes the
|
|
635
|
header information used for BIP and BIL files ("Extendable
|
|
636
|
Image Formats for ArcView GIS 3.1 and
|
|
637
|
3.2").</doc:description>
|
|
638
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
639
|
</xs:appinfo>
|
|
640
|
</xs:annotation>
|
|
641
|
<xs:complexType>
|
|
642
|
<xs:sequence>
|
|
643
|
<xs:element name="nrows" type="xs:int">
|
|
644
|
<xs:annotation>
|
|
645
|
<xs:appinfo>
|
|
646
|
<doc:tooltip>Number of rows</doc:tooltip>
|
|
647
|
<doc:summary>The number of rows in the image.
|
|
648
|
</doc:summary>
|
|
649
|
<doc:description>The number of rows in the image.
|
|
650
|
Rows are parallel to the x-axis of the map coordinate
|
|
651
|
system. There is no default.</doc:description>
|
|
652
|
<doc:example>400</doc:example>
|
|
653
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
654
|
</xs:appinfo>
|
|
655
|
</xs:annotation>
|
|
656
|
</xs:element>
|
|
657
|
<xs:element name="ncols" type="xs:int">
|
|
658
|
<xs:annotation>
|
|
659
|
<xs:appinfo>
|
|
660
|
<doc:tooltip>Number of columns</doc:tooltip>
|
|
661
|
<doc:summary>The number of columns in the image.
|
|
662
|
</doc:summary>
|
|
663
|
<doc:description>The number of columns in the image.
|
|
664
|
Columns are parallel to the y-axis of the map
|
|
665
|
coordinate system. There is no
|
|
666
|
default.</doc:description>
|
|
667
|
<doc:example>600</doc:example>
|
|
668
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
669
|
</xs:appinfo>
|
|
670
|
</xs:annotation>
|
|
671
|
</xs:element>
|
|
672
|
<xs:element name="orientation" nillable="true" minOccurs="0">
|
|
673
|
<xs:annotation>
|
|
674
|
<xs:appinfo>
|
|
675
|
<doc:tooltip>Entity's record
|
|
676
|
orientation</doc:tooltip>
|
|
677
|
<doc:summary>Specification of the binary raster
|
|
678
|
entity's record orientation.</doc:summary>
|
|
679
|
<doc:description>This element contains specification
|
|
680
|
of the binary raster entity's record orientation by
|
|
681
|
defining the element's attribute "columnorrow". The
|
|
682
|
binary raster will be column major if the raster is
|
|
683
|
to be displayed column by column from the byte
|
|
684
|
stream, or row major if it is to be displayed row by
|
|
685
|
row from the byte stream.</doc:description>
|
|
686
|
<doc:example>The valid attribute values are
|
|
687
|
"columnmajor" or "rowmajor". If the attribute is not
|
|
688
|
specified, "columnmajor" is used.</doc:example>
|
|
689
|
<doc:lineage>The orientation element was introduced
|
|
690
|
into EML 2.0</doc:lineage>
|
|
691
|
</xs:appinfo>
|
|
692
|
</xs:annotation>
|
|
693
|
<xs:complexType>
|
|
694
|
<xs:attribute name="columnOrRow" use="optional" default="columnMajor">
|
|
695
|
<xs:annotation>
|
|
696
|
<xs:appinfo>
|
|
697
|
<doc:tooltip>Attribute of orientation
|
|
698
|
element</doc:tooltip>
|
|
699
|
<doc:summary>Specification of the entity's record
|
|
700
|
orientation.</doc:summary>
|
|
701
|
<doc:description>This attribute specifies the
|
|
702
|
entity's record orientation.</doc:description>
|
|
703
|
<doc:example>The valid attribute values are
|
|
704
|
"columnmajor" or "rowmajor". If the attribute is
|
|
705
|
not specified, "columnmajor" is
|
|
706
|
used.</doc:example>
|
|
707
|
<doc:lineage>The columnorrow attribute was
|
|
708
|
introduced into EML 1.4.</doc:lineage>
|
|
709
|
</xs:appinfo>
|
|
710
|
</xs:annotation>
|
|
711
|
<xs:simpleType>
|
|
712
|
<xs:restriction base="xs:string">
|
|
713
|
<xs:enumeration value="columnMajor"/>
|
|
714
|
<xs:enumeration value="rowMajor"/>
|
|
715
|
</xs:restriction>
|
|
716
|
</xs:simpleType>
|
|
717
|
</xs:attribute>
|
|
718
|
</xs:complexType>
|
|
719
|
</xs:element>
|
|
720
|
<xs:element name="nbands" type="xs:int" minOccurs="0">
|
|
721
|
<xs:annotation>
|
|
722
|
<xs:appinfo>
|
|
723
|
<doc:tooltip>Number of Bands</doc:tooltip>
|
|
724
|
<doc:summary>The number of spectral bands in the
|
|
725
|
image.</doc:summary>
|
|
726
|
<doc:description>The number of spectral bands in the
|
|
727
|
image. The default is 1.</doc:description>
|
|
728
|
<doc:example>1</doc:example>
|
|
729
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
730
|
</xs:appinfo>
|
|
731
|
</xs:annotation>
|
|
732
|
</xs:element>
|
|
733
|
<xs:element name="nbits" type="xs:int" minOccurs="0">
|
|
734
|
<xs:annotation>
|
|
735
|
<xs:appinfo>
|
|
736
|
<doc:tooltip>Number of Bits</doc:tooltip>
|
|
737
|
<doc:summary>The number of bits per pixel per
|
|
738
|
band.</doc:summary>
|
|
739
|
<doc:description>The number of bits per pixel per
|
|
740
|
band. Acceptable values are 1, 4, 8, 16, and 32. The
|
|
741
|
default value is eight bits per pixel per band. For a
|
|
742
|
true color image with three bands (R, G, B) stored
|
|
743
|
using eight bits for each pixel in each band, nbits
|
|
744
|
equals eight and nbands equals three, for a total of
|
|
745
|
twenty-four bits per pixel. For an image with nbits
|
|
746
|
equal to one, nbands must also equal
|
|
747
|
one.</doc:description>
|
|
748
|
<doc:example>8</doc:example>
|
|
749
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
750
|
</xs:appinfo>
|
|
751
|
</xs:annotation>
|
|
752
|
</xs:element>
|
|
753
|
<xs:element name="byteorder" type="xs:string" minOccurs="0">
|
|
754
|
<xs:annotation>
|
|
755
|
<xs:appinfo>
|
|
756
|
<doc:tooltip>Byte Order</doc:tooltip>
|
|
757
|
<doc:summary>The byte order in which image pixel
|
|
758
|
values are stored.</doc:summary>
|
|
759
|
<doc:description>The byte order in which image pixel
|
|
760
|
values are stored. The byte order is important for
|
|
761
|
sixteen-bit images, with two bytes per pixel.
|
|
762
|
Acceptable values are I - Intel byte order (Silicon
|
|
763
|
Graphics, DEC Alpha, PC) Also known as little endian.
|
|
764
|
M - Motorola byte order (Sun, HP, etc.) Also known as
|
|
765
|
big-endian. The default byte order is the same as
|
|
766
|
that of the host machine executing the
|
|
767
|
software.</doc:description>
|
|
768
|
<doc:example>I or M</doc:example>
|
|
769
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
770
|
</xs:appinfo>
|
|
771
|
</xs:annotation>
|
|
772
|
</xs:element>
|
|
773
|
<xs:element name="layout" type="xs:string" minOccurs="0">
|
|
774
|
<xs:annotation>
|
|
775
|
<xs:appinfo>
|
|
776
|
<doc:tooltip>Layout</doc:tooltip>
|
|
777
|
<doc:summary>The organization of the bands in the
|
|
778
|
image file.</doc:summary>
|
|
779
|
<doc:description>The organization of the bands in the
|
|
780
|
image file. Acceptable values are bil - Band
|
|
781
|
interleaved by line. bip - Band interleaved by pixel.
|
|
782
|
bsq - Band sequential. The default layout is
|
|
783
|
bil.</doc:description>
|
|
784
|
<doc:example>bil, bip, bsq</doc:example>
|
|
785
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
786
|
</xs:appinfo>
|
|
787
|
</xs:annotation>
|
|
788
|
</xs:element>
|
|
789
|
<xs:element name="skipbytes" type="xs:string" minOccurs="0">
|
|
790
|
<xs:annotation>
|
|
791
|
<xs:appinfo>
|
|
792
|
<doc:tooltip>Skip Bytes</doc:tooltip>
|
|
793
|
<doc:summary>The number of bytes of data in the
|
|
794
|
image file to skip in order to reach the start of the
|
|
795
|
image data.</doc:summary>
|
|
796
|
<doc:description>The number of bytes of data in the
|
|
797
|
image file to skip in order to reach the start of the
|
|
798
|
image data. This keyword allows you to bypass any
|
|
799
|
existing image header information in the file. The
|
|
800
|
default value is zero bytes.</doc:description>
|
|
801
|
<doc:example>0</doc:example>
|
|
802
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
803
|
</xs:appinfo>
|
|
804
|
</xs:annotation>
|
|
805
|
</xs:element>
|
|
806
|
<xs:element name="ulxmap" type="xs:string" minOccurs="0">
|
|
807
|
<xs:annotation>
|
|
808
|
<xs:appinfo>
|
|
809
|
<doc:tooltip>upper left X map coordinate</doc:tooltip>
|
|
810
|
<doc:summary>The x-axis map coordinate of the
|
|
811
|
center of the upper-left pixel.</doc:summary>
|
|
812
|
<doc:description>The x-axis map coordinate of the
|
|
813
|
center of the upper-left pixel. If this parameter is
|
|
814
|
specified, ulymap must also be set, otherwise a
|
|
815
|
default value is used.</doc:description>
|
|
816
|
<doc:example>340000</doc:example>
|
|
817
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
818
|
</xs:appinfo>
|
|
819
|
</xs:annotation>
|
|
820
|
</xs:element>
|
|
821
|
<xs:element name="ulymap" type="xs:string" minOccurs="0">
|
|
822
|
<xs:annotation>
|
|
823
|
<xs:appinfo>
|
|
824
|
<doc:tooltip>upper left Y map coordinate</doc:tooltip>
|
|
825
|
<doc:summary>The y-axis map coordinate of the
|
|
826
|
center of the upper-left pixel.</doc:summary>
|
|
827
|
<doc:description>The y-axis map coordinate of the
|
|
828
|
center of the upper-left pixel. If you specify this
|
|
829
|
parameter, set ulxmap, too, otherwise a default value
|
|
830
|
is used.</doc:description>
|
|
831
|
<doc:example>6486666</doc:example>
|
|
832
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
833
|
</xs:appinfo>
|
|
834
|
</xs:annotation>
|
|
835
|
</xs:element>
|
|
836
|
<xs:element name="xdim" type="xs:string" minOccurs="0">
|
|
837
|
<xs:annotation>
|
|
838
|
<xs:appinfo>
|
|
839
|
<doc:tooltip>X dimension</doc:tooltip>
|
|
840
|
<doc:summary>The x-dimension of a pixel in map
|
|
841
|
units.</doc:summary>
|
|
842
|
<doc:description>The x-dimension of a pixel in map
|
|
843
|
units. If this parameter is specified, ydim must also
|
|
844
|
be set, otherwise a default value is
|
|
845
|
used.</doc:description>
|
|
846
|
<doc:example>16.665</doc:example>
|
|
847
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
848
|
</xs:appinfo>
|
|
849
|
</xs:annotation>
|
|
850
|
</xs:element>
|
|
851
|
<xs:element name="ydim" type="xs:string" minOccurs="0">
|
|
852
|
<xs:annotation>
|
|
853
|
<xs:appinfo>
|
|
854
|
<doc:tooltip>Y dimension</doc:tooltip>
|
|
855
|
<doc:summary>The y-dimension of a pixel in map
|
|
856
|
units.</doc:summary>
|
|
857
|
<doc:description>The y-dimension of a pixel in map
|
|
858
|
units. If this parameter is specified, xdim must also
|
|
859
|
be set, otherwise a default value is
|
|
860
|
used.</doc:description>
|
|
861
|
<doc:example>16.665</doc:example>
|
|
862
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
863
|
</xs:appinfo>
|
|
864
|
</xs:annotation>
|
|
865
|
</xs:element>
|
|
866
|
<xs:element name="bandrowbytes" type="xs:string" minOccurs="0">
|
|
867
|
<xs:annotation>
|
|
868
|
<xs:appinfo>
|
|
869
|
<doc:tooltip>Bytes per band per row</doc:tooltip>
|
|
870
|
<doc:summary>The number of bytes per band per
|
|
871
|
row.</doc:summary>
|
|
872
|
<doc:description>The number of bytes per band per
|
|
873
|
row. This must be an integer. This keyword is used
|
|
874
|
only with BIL files when there are extra bits at the
|
|
875
|
end of each band within a row that must be
|
|
876
|
skipped.</doc:description>
|
|
877
|
<doc:example>3</doc:example>
|
|
878
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
879
|
</xs:appinfo>
|
|
880
|
</xs:annotation>
|
|
881
|
</xs:element>
|
|
882
|
<xs:element name="totalrowbytes" type="xs:string" minOccurs="0">
|
|
883
|
<xs:annotation>
|
|
884
|
<xs:appinfo>
|
|
885
|
<doc:tooltip>Total bytes of data per row</doc:tooltip>
|
|
886
|
<doc:summary>The total number of bytes of data
|
|
887
|
per row.</doc:summary>
|
|
888
|
<doc:description>The total number of bytes of data
|
|
889
|
per row. Use totalrowbytes when there are extra
|
|
890
|
trailing bits at the end of each
|
|
891
|
row.</doc:description>
|
|
892
|
<doc:example>8</doc:example>
|
|
893
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
894
|
</xs:appinfo>
|
|
895
|
</xs:annotation>
|
|
896
|
</xs:element>
|
|
897
|
<xs:element name="bandgapbytes" type="xs:string" minOccurs="0">
|
|
898
|
<xs:annotation>
|
|
899
|
<xs:appinfo>
|
|
900
|
<doc:tooltip>Bytes between bands</doc:tooltip>
|
|
901
|
<doc:summary>The number of bytes between bands in
|
|
902
|
a BSQ format image.</doc:summary>
|
|
903
|
<doc:description>The number of bytes between bands in
|
|
904
|
a BSQ format image. The default is
|
|
905
|
zero.</doc:description>
|
|
906
|
<doc:example>1</doc:example>
|
|
907
|
<doc:lineage>Introduced in EML 2.0.</doc:lineage>
|
|
908
|
</xs:appinfo>
|
|
909
|
</xs:annotation>
|
|
910
|
</xs:element>
|
|
911
|
</xs:sequence>
|
|
912
|
</xs:complexType>
|
|
913
|
</xs:element>
|
|
914
|
</xs:choice>
|
|
915
|
</xs:complexType>
|
|
916
|
</xs:element>
|
|
917
|
<xs:element name="distribution" type="PhysicalDistributionType" minOccurs="0" maxOccurs="unbounded">
|
|
918
|
<xs:annotation>
|
|
919
|
<xs:appinfo>
|
|
920
|
<doc:tooltip>Distribution Information</doc:tooltip>
|
|
921
|
<doc:summary>Information on how the resource is distributed
|
|
922
|
online and offline</doc:summary>
|
|
923
|
<doc:description>This element provides information on how the
|
|
924
|
resource is distributed online and offline. Connections to online
|
|
925
|
systems can be described as URLs and as a list of relevant
|
|
926
|
connection parameters.</doc:description>
|
|
927
|
<doc:lineage>Derived from distribution elements in the FGDC
|
|
928
|
standard.</doc:lineage>
|
|
929
|
</xs:appinfo>
|
|
930
|
</xs:annotation>
|
|
931
|
</xs:element>
|
|
932
|
</xs:sequence>
|
|
933
|
<xs:element name="references" type="xs:string"/>
|
|
934
|
</xs:choice>
|
|
935
|
<xs:attribute name="id" type="xs:string" use="optional"/>
|
|
936
|
<xs:attribute name="system" type="xs:string" use="optional"/>
|
|
937
|
<xs:attribute name="scope" type="res:ScopeType" use="optional" default="document"/>
|
|
938
|
</xs:complexType>
|
|
939
|
<xs:complexType name="PhysicalDistributionType">
|
|
940
|
<xs:choice>
|
|
941
|
<xs:choice>
|
|
942
|
<xs:element name="online">
|
|
943
|
<xs:annotation>
|
|
944
|
<xs:appinfo>
|
|
945
|
<doc:tooltip>Online Distribution Information</doc:tooltip>
|
|
946
|
<doc:summary>Distribution information for accessing the
|
|
947
|
resource online.</doc:summary>
|
|
948
|
<doc:description>Distribution information for accessing the
|
|
949
|
resource online, represented either as a URL or as a series of
|
|
950
|
named parameters that are needed in order to
|
|
951
|
connect. The URL field is provided for the simple cases where a
|
|
952
|
file is available for download directly from a web server or
|
|
953
|
other similar server and a complex connection protocol is not
|
|
954
|
needed. The connection field provides an alternative where a
|
|
955
|
complex protocol needs to be named and described, along with
|
|
956
|
the necessary parameters needed for the connection.
|
|
957
|
</doc:description>
|
|
958
|
</xs:appinfo>
|
|
959
|
</xs:annotation>
|
|
960
|
<xs:complexType>
|
|
961
|
<xs:sequence>
|
|
962
|
<xs:choice>
|
|
963
|
<xs:element name="url">
|
|
964
|
<xs:annotation>
|
|
965
|
<xs:appinfo>
|
|
966
|
<doc:tooltip>Download site URL</doc:tooltip>
|
|
967
|
<doc:summary>A URL (Uniform Resource Locator) from which
|
|
968
|
this resource can be downloaded or information can be
|
|
969
|
obtained about downloading it.</doc:summary>
|
|
970
|
<doc:description>A URL (Uniform Resource Locator) from
|
|
971
|
which this resource can be downloaded or additional
|
|
972
|
information can be obtained. If accessing the URL would
|
|
973
|
directly return the data stream, then the "function"
|
|
974
|
attribute should be set to "download". If the URL
|
|
975
|
provides further information about downloading the
|
|
976
|
object but does not directly return the data stream, then
|
|
977
|
the "function" attribute should be set to "information".
|
|
978
|
If the "function" attribute is omitted, then "download"
|
|
979
|
is implied for the URL function.
|
|
980
|
In more complex cases where a non-standard connection
|
|
981
|
must be established that complies with application
|
|
982
|
specific procedures beyond what can be described in the
|
|
983
|
simple URL, then the "connection" element should
|
|
984
|
be used instead of the URL element.</doc:description>
|
|
985
|
<doc:example>
|
|
986
|
http://data.org/getdata?id=98332</doc:example>
|
|
987
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
988
|
Metadata</doc:lineage>
|
|
989
|
</xs:appinfo>
|
|
990
|
</xs:annotation>
|
|
991
|
<xs:complexType>
|
|
992
|
<xs:simpleContent>
|
|
993
|
<xs:extension base="xs:anyURI">
|
|
994
|
<xs:attribute name="function" type="res:FunctionType" use="optional" default="download"/>
|
|
995
|
</xs:extension>
|
|
996
|
</xs:simpleContent>
|
|
997
|
</xs:complexType>
|
|
998
|
</xs:element>
|
|
999
|
<xs:element name="connection">
|
|
1000
|
<xs:annotation>
|
|
1001
|
<xs:appinfo>
|
|
1002
|
<doc:tooltip>Connection</doc:tooltip>
|
|
1003
|
<doc:summary>A description of the information needed
|
|
1004
|
to make an application connection to a data service.
|
|
1005
|
</doc:summary>
|
|
1006
|
<doc:description>A description of the information needed
|
|
1007
|
to make an application connection to a data service.
|
|
1008
|
The connection starts with a connectionDefinition which
|
|
1009
|
lists all of the parameters needed for the connection
|
|
1010
|
and possible default values for each. It then includes a
|
|
1011
|
list of parameter values, one for each parameter, that
|
|
1012
|
override the defaults for this particular connection.
|
|
1013
|
One parameter element should exist for every
|
|
1014
|
parameterDefinition that is present in the
|
|
1015
|
connectionDefinition, except that parameters that were
|
|
1016
|
defined with a defaultValue in their parameterDefinition
|
|
1017
|
can be ommitted from the connection and the default
|
|
1018
|
will be used. All information about how to use the
|
|
1019
|
parameters to establish a session and extract data is
|
|
1020
|
present in the connectionDefinition, possibly implicitly
|
|
1021
|
by naming a connection schemeName that is well-known.
|
|
1022
|
</doc:description>
|
|
1023
|
</xs:appinfo>
|
|
1024
|
</xs:annotation>
|
|
1025
|
<xs:complexType>
|
|
1026
|
<xs:choice>
|
|
1027
|
<xs:sequence>
|
|
1028
|
<xs:element name="connectionDefinition" type="res:ConnectionDefinitionType">
|
|
1029
|
<xs:annotation>
|
|
1030
|
<xs:appinfo>
|
|
1031
|
<doc:tooltip>Connection Definition</doc:tooltip>
|
|
1032
|
<doc:summary>Definition of the connection protocol
|
|
1033
|
to be used for this connection.</doc:summary>
|
|
1034
|
<doc:description>Definition of the connection
|
|
1035
|
protocol to be used for this connection. The
|
|
1036
|
definition has a "scheme" which identifies the
|
|
1037
|
protocol by name, and a detailed description of
|
|
1038
|
the scheme and its required parameters.
|
|
1039
|
</doc:description>
|
|
1040
|
</xs:appinfo>
|
|
1041
|
</xs:annotation>
|
|
1042
|
</xs:element>
|
|
1043
|
<xs:element name="parameter" minOccurs="0" maxOccurs="unbounded">
|
|
1044
|
<xs:annotation>
|
|
1045
|
<xs:appinfo>
|
|
1046
|
<doc:tooltip>Parameter</doc:tooltip>
|
|
1047
|
<doc:summary>A parameter to be used to make this
|
|
1048
|
connection.</doc:summary>
|
|
1049
|
<doc:description>A parameter to be used to make
|
|
1050
|
this connection. This value overrides any
|
|
1051
|
default value that may have been provided in the
|
|
1052
|
connection definition.
|
|
1053
|
</doc:description>
|
|
1054
|
</xs:appinfo>
|
|
1055
|
</xs:annotation>
|
|
1056
|
<xs:complexType>
|
|
1057
|
<xs:sequence>
|
|
1058
|
<xs:element name="name" type="xs:string">
|
|
1059
|
<xs:annotation>
|
|
1060
|
<xs:appinfo>
|
|
1061
|
<doc:tooltip>Parameter Name</doc:tooltip>
|
|
1062
|
<doc:summary>Name of the parameter to be
|
|
1063
|
used to make this connection.</doc:summary>
|
|
1064
|
<doc:description>The name of the parameter
|
|
1065
|
to be used to make this connection.
|
|
1066
|
</doc:description>
|
|
1067
|
<doc:example>hostname</doc:example>
|
|
1068
|
</xs:appinfo>
|
|
1069
|
</xs:annotation>
|
|
1070
|
</xs:element>
|
|
1071
|
<xs:element name="value" type="xs:string">
|
|
1072
|
<xs:annotation>
|
|
1073
|
<xs:appinfo>
|
|
1074
|
<doc:tooltip>Parameter Value</doc:tooltip>
|
|
1075
|
<doc:summary>The value of the parameter to
|
|
1076
|
be used to make this connection.
|
|
1077
|
</doc:summary>
|
|
1078
|
<doc:description>The value of the parameter
|
|
1079
|
to be used to make this connection. This
|
|
1080
|
value overrides any default value that may
|
|
1081
|
have been provided in the connection
|
|
1082
|
definition.</doc:description>
|
|
1083
|
<doc:example>nceas.ucsb.edu</doc:example>
|
|
1084
|
</xs:appinfo>
|
|
1085
|
</xs:annotation>
|
|
1086
|
</xs:element>
|
|
1087
|
</xs:sequence>
|
|
1088
|
</xs:complexType>
|
|
1089
|
</xs:element>
|
|
1090
|
</xs:sequence>
|
|
1091
|
<xs:element name="references" type="xs:string">
|
|
1092
|
<xs:annotation>
|
|
1093
|
<xs:appinfo>
|
|
1094
|
<doc:tooltip>References</doc:tooltip>
|
|
1095
|
<doc:summary>The id of another connection in this
|
|
1096
|
EML document to be used to provide the connection
|
|
1097
|
information.
|
|
1098
|
</doc:summary>
|
|
1099
|
<doc:description>The id of another connection in
|
|
1100
|
this EML document to be used to provide the
|
|
1101
|
connection information. This is used instead of
|
|
1102
|
duplicating connection information when an identical
|
|
1103
|
connection needs to be used multiple times in an
|
|
1104
|
EML document.</doc:description>
|
|
1105
|
</xs:appinfo>
|
|
1106
|
</xs:annotation>
|
|
1107
|
</xs:element>
|
|
1108
|
</xs:choice>
|
|
1109
|
<xs:attribute name="id" type="xs:string" use="optional"/>
|
|
1110
|
<xs:attribute name="system" type="xs:string" use="optional"/>
|
|
1111
|
<xs:attribute name="scope" type="res:ScopeType" use="optional" default="document"/>
|
|
1112
|
</xs:complexType>
|
|
1113
|
</xs:element>
|
|
1114
|
</xs:choice>
|
|
1115
|
</xs:sequence>
|
|
1116
|
</xs:complexType>
|
|
1117
|
</xs:element>
|
|
1118
|
<xs:element name="offline">
|
|
1119
|
<xs:annotation>
|
|
1120
|
<xs:appinfo>
|
|
1121
|
<doc:tooltip>medium of the resource</doc:tooltip>
|
|
1122
|
<doc:summary>the medium on which this resource is distributed,
|
|
1123
|
either digitally or as hardcopy</doc:summary>
|
|
1124
|
<doc:description>the medium on which this resource is distributed
|
|
1125
|
digitally, such as 3.5" floppy disk, or various tape media types,
|
|
1126
|
or 'hardcopy'</doc:description>
|
|
1127
|
<doc:example>CD-ROM, 3.5 in. floppy disk, Zip disk</doc:example>
|
|
1128
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1129
|
Metadata</doc:lineage>
|
|
1130
|
</xs:appinfo>
|
|
1131
|
</xs:annotation>
|
|
1132
|
<xs:complexType>
|
|
1133
|
<xs:sequence>
|
|
1134
|
<xs:element name="mediumName" type="xs:string" minOccurs="0">
|
|
1135
|
<xs:annotation>
|
|
1136
|
<xs:appinfo>
|
|
1137
|
<doc:tooltip>Medium name</doc:tooltip>
|
|
1138
|
<doc:summary>Name of the medium that for this resource
|
|
1139
|
distribution</doc:summary>
|
|
1140
|
<doc:description>Name of the medium on which this resource
|
|
1141
|
is distributed. Can be various digital media such as tapes
|
|
1142
|
and disks, or printed media which can collectively be
|
|
1143
|
termed 'hardcopy'.</doc:description>
|
|
1144
|
<doc:example>Tape, 3.5 inch Floppy Disk,
|
|
1145
|
hardcopy</doc:example>
|
|
1146
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1147
|
Metadata</doc:lineage>
|
|
1148
|
</xs:appinfo>
|
|
1149
|
</xs:annotation>
|
|
1150
|
</xs:element>
|
|
1151
|
<xs:element name="mediumDensity" type="xs:string" minOccurs="0">
|
|
1152
|
<xs:annotation>
|
|
1153
|
<xs:appinfo>
|
|
1154
|
<doc:tooltip>density of the digital medium</doc:tooltip>
|
|
1155
|
<doc:summary>the density of the digital medium if this is
|
|
1156
|
relevant.</doc:summary>
|
|
1157
|
<doc:description>the density of the digital medium if this
|
|
1158
|
is relevant. Used mainly for floppy disks or
|
|
1159
|
tape.</doc:description>
|
|
1160
|
<doc:example>High Density (HD), Double Density
|
|
1161
|
(DD)</doc:example>
|
|
1162
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1163
|
Metadata</doc:lineage>
|
|
1164
|
</xs:appinfo>
|
|
1165
|
</xs:annotation>
|
|
1166
|
</xs:element>
|
|
1167
|
<xs:element name="mediumDensityUnits" type="xs:string" minOccurs="0">
|
|
1168
|
<xs:annotation>
|
|
1169
|
<xs:appinfo>
|
|
1170
|
<doc:tooltip>units of a numerical density</doc:tooltip>
|
|
1171
|
<doc:summary>a numerical density's units</doc:summary>
|
|
1172
|
<doc:description>if a density is given numerically, the
|
|
1173
|
units should be given here.</doc:description>
|
|
1174
|
<doc:example>B/cm</doc:example>
|
|
1175
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1176
|
Metadata</doc:lineage>
|
|
1177
|
</xs:appinfo>
|
|
1178
|
</xs:annotation>
|
|
1179
|
</xs:element>
|
|
1180
|
<xs:element name="mediumVolume" type="xs:string" minOccurs="0">
|
|
1181
|
<xs:annotation>
|
|
1182
|
<xs:appinfo>
|
|
1183
|
<doc:tooltip>storage volume</doc:tooltip>
|
|
1184
|
<doc:summary>total volume of the storage
|
|
1185
|
medium</doc:summary>
|
|
1186
|
<doc:description>the total volume of the storage medium on
|
|
1187
|
which this resource is shipped.</doc:description>
|
|
1188
|
<doc:example>650 MB</doc:example>
|
|
1189
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1190
|
Metadata</doc:lineage>
|
|
1191
|
</xs:appinfo>
|
|
1192
|
</xs:annotation>
|
|
1193
|
</xs:element>
|
|
1194
|
<xs:element name="mediumFormat" type="xs:string" minOccurs="0" maxOccurs="unbounded">
|
|
1195
|
<xs:annotation>
|
|
1196
|
<xs:appinfo>
|
|
1197
|
<doc:tooltip>medium format</doc:tooltip>
|
|
1198
|
<doc:summary>format of the medium on which the resource is
|
|
1199
|
shipped.</doc:summary>
|
|
1200
|
<doc:description>the file system format of the medium on
|
|
1201
|
which the resource is shipped</doc:description>
|
|
1202
|
<doc:example>NTFS, FAT32, EXT2, QIK80</doc:example>
|
|
1203
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1204
|
Metadata</doc:lineage>
|
|
1205
|
</xs:appinfo>
|
|
1206
|
</xs:annotation>
|
|
1207
|
</xs:element>
|
|
1208
|
<xs:element name="mediumNote" type="xs:string" minOccurs="0">
|
|
1209
|
<xs:annotation>
|
|
1210
|
<xs:appinfo>
|
|
1211
|
<doc:tooltip>note about the media</doc:tooltip>
|
|
1212
|
<doc:summary>note about the media</doc:summary>
|
|
1213
|
<doc:description>any additional pertinent information about
|
|
1214
|
the media</doc:description>
|
|
1215
|
<doc:lineage>ISO CD 19115.3, Geographic information -
|
|
1216
|
Metadata</doc:lineage>
|
|
1217
|
</xs:appinfo>
|
|
1218
|
</xs:annotation>
|
|
1219
|
</xs:element>
|
|
1220
|
</xs:sequence>
|
|
1221
|
</xs:complexType>
|
|
1222
|
</xs:element>
|
|
1223
|
<xs:element name="inline">
|
|
1224
|
<xs:complexType>
|
|
1225
|
<xs:sequence>
|
|
1226
|
<xs:any maxOccurs="unbounded"/>
|
|
1227
|
</xs:sequence>
|
|
1228
|
</xs:complexType>
|
|
1229
|
</xs:element>
|
|
1230
|
</xs:choice>
|
|
1231
|
<xs:element name="references" type="xs:string"/>
|
|
1232
|
</xs:choice>
|
|
1233
|
<xs:attribute name="id" type="xs:string" use="optional"/>
|
|
1234
|
<xs:attribute name="system" type="xs:string" use="optional"/>
|
|
1235
|
<xs:attribute name="scope" type="res:ScopeType" use="optional" default="document"/>
|
|
1236
|
</xs:complexType>
|
|
1237
|
</xs:schema>
|