Project

General

Profile

metacat / lib / style / common / templates / metacatui / genericGuide.tmpl @ 9780

1

    
2
	<article style="font-size: .5em" id="RegistryGuide">
3
		<div class="container">
4
		
5
			<div class="row-fluid">
6
				<!--<h2>Registry Guide</h2>-->
7
				<p class="lead">
8
					Guide for Completing the Data [% config.type %] Form
9
				</p>
10
				<p>
11
					This guide provides information on how to complete the registration form.
12
					There are multiple sections to the form, and some fields are required
13
					(denoted by an asterisk * or in a tooltip), while others are optional.
14
				</p>
15
				<p>	
16
					Information on individual fields and examples for their content are provided below.
17
				</p>
18
			</div>
19
			
20
			<div class="row-fluid">
21
				<h4><a name="BasicInformation">Basic Information</a></h4>
22
				<p>
23
					*Data Set Title:
24
					A descriptive title of the data set. The title should
25
					provide enough information for someone casually scanning a list of data
26
					sets to know whether the data are relevant to them. This implies that the
27
					data context should be indicated in the title without making the title be
28
					too long. In general, the title should indicate what kind of data were
29
					collected and the spatial, taxonomic, and temporal extents the data set
30
					covers.
31
				</p>
32
				<p>
33
					Funding: Add the award number from the funding agency. Type in
34
					a keyword to look up award numbers. Multiple award numbers can be separated by commas.
35
				</p>
36
				
37
				<div>
38
					<em>Examples of descriptive titles: </em>
39
					<ul>
40
						<li>Hastings Reserve (CA) Small Mammal Trapline Data from 1972 to 1988.</li>
41
						<li>Tassajara Hot Springs Reserve Water Chemistry Data from 1990 to 2000.</li>
42
					</ul>
43
				</div>
44
				<div>
45
					<em>Examples of incomplete titles: </em>
46
					<ul>
47
						<li>Mammals Data</li>
48
						<li>Water Chemistry Data</li>
49
					</ul>	
50
				</div>
51
					
52
				[% IF cfg == 'nceas' %]
53
				<span class="text-info">*NCEAS Project(s):</span>
54
				<p>Select one or more
55
					NCEAS activities from the list to indicate that the data set is
56
					affiliated with that working group or activity.  We use "affiliation" 
57
					in a rather permissive sense to mean, for example, that the data set was or has
58
					been generated by the activity; that the owner of the data is affiliated
59
					with the activity; that the data set is owned by the activity; etc. Both
60
					derived data sets that result from synthesis activities and original raw data
61
					sets that contribute to synthesis can be included in the repository and should
62
					be associated with the appropriate NCEAS activities.
63
				</p>
64
				[% END %]
65

    
66
				[% IF cfg == 'esa' || cfg == 'ltss' %]  
67

    
68
				<span class="text-info">*Organization Name:</span>
69
				<p>The name of the organization with which the data set is
70
					affiliated. We use "affiliation" in a rather permissive sense to mean, for example, that the data set was or has
71
					been generated at the organization; that the owner of the data is affiliated
72
					with the organization or was affiliated with the organization when the data
73
					set was generated; that the data set is owned by the organization; etc.
74
				</p>
75
				
76
				<div>
77
					<em>Examples of correct organization names: </em>
78
					<ul>
79
						<li>University of Michigan Biological Station</li>
80
						<li>Duke University FACE Facility</li>
81
						<li>National Center for Ecological Analysis and Synthesis</li>
82
					</ul>
83
				</div>
84
				<div>
85
					<em>Examples of incorrect organization names: </em>
86
					<ul>
87
						<li>Michigan Station</li>
88
						<li>Duke University</li>
89
						<li>University of California Santa Barbara</li>
90
					</ul>	
91
				</div>				
92

    
93
				[% END %]
94

    
95
				[% IF cfg == 'obfs' || cfg == 'nrs' || cfg == 'specnet'%]
96

    
97
				<span class="text-info">*[% config.site | ucfirst %] Name:</span>
98
				<p>Select a [% config.site %] from the drop-down list to indicate that the data set is
99
					affiliated with the [% config.site %]. We use "affiliation" in a rather
100
					permissive sense to mean, for example, that the data set was or has
101
					been generated at the [% config.site %]; that the owner is affiliated
102
					with the [% config.site %] or was affiliated with the [% config.site %] when the data
103
					set was generated; or that the data set is owned by the [% config.site %]; etc.
104
				</p>
105
				<p><em>Note: </em>
106
					If the data were collected at a site other than a
107
					[% config.site %] listed in the drop-down menu, you can indicate so in the
108
					abstract and/or title. You can also indicate this in the keywords
109
					with a locality keyword.
110
				</p> 
111

    
112
				[% END %]
113

    
114
			</div>
115
			
116
			<div class="row-fluid">
117
				<h4><a name="DataSetOriginator">People and Organizations</a></h4> 
118

    
119
				<p>
120
					Add one or more people, organizations, or position names
121
					associated with the dataset. At least one entry with a Creator role is
122
					required, and creators will be listed in the dataset citation. The person
123
					responsible for developing the data set. Other roles include, for example,
124
					the principal investigator in a collaborative project, the first author of
125
					the main publication using the data set, etc. The organization name, e-mail,
126
					online link, phone, fax, and address information are optional.
127
				</p>
128
				<p>
129
					Use the Add Person or Organization button to add entries to
130
					the list. Use the Edit icon (pencil) to change an entry. Use the Update
131
					Person or Organization button to update the entry, or Add Person or
132
					Organization to duplicate a changed entry. If you have entered several
133
					associated parties and want to change the order in which they appear, use
134
					the up and down arrows.
135
				</p>
136

    
137
				<p>*First Name: The given name(s) of the person.</p>
138
				
139
				<p>*Last Name: The last name (surname) of the person.</p>
140
				
141
				<p>Organization Name: The name of the organization from which
142
				the data set originated, if any</p>
143
				
144
				<p>Position Name: A named position in an organization from which
145
				the data set originated, if any.</p>
146

    
147
				<p>E-Mail: The e-mail address by which the person or organization can be contacted.</p>
148
				
149
				<p>Phone: The phone number of the person or organization, including the area code (999-999-9999).</p>
150
				
151
				<p>FAX: The fax number of the person or organization, including the area code (999-999-9999).</p>
152
				
153
				<p>Street Information: A comma-separated list of street number, street, unit,
154
				etc.<br> <em>Example: </em> 735 State Street, Suite 300</p>
155
				
156
				<p>City: The city name of the person or organization's
157
				address.</p>
158
				
159
				<p>U.S. State or Territory: Select a U.S. state or territory
160
				from the drop-down menu for the principal data set owner's address. If the
161
				address is not in the United States, used the "Other State/Province" field
162
				below. For a shortcut, press the first letter of the state on your keyboard
163
				(e.g., M-key to skip to Maine).</p>
164
				
165
				<p>Other State/Province: A non-U.S. state or a province for the
166
				person or organization's address.</p>
167
				
168
				<p>Postal Code: The postal code or ZIP code for the person or organization's address.</p>
169
				
170
				<p>Country: The country for the person or organization's
171
				address.</p>
172
			
173
			</div>
174
						
175
			<div class="row-fluid">
176
				<h4><a name="DataSetAbstract">*Data Set Abstract</a></h4>
177
				<p>Short (maximum of 350 words) summary of the purpose and content of the data set. 
178
					Entering a data set abstract is required.
179
				</p>
180
				<p>
181
					<em>Example: </em> Data were collected every year in summer and fall from
182
					1967 to 1979. Trapping was conducted only in the fall from 1980 to
183
					1988. For each specimen taken, data were recorded on species, date,
184
					location, time, sex, and body measurements including total length,
185
					length of tail, length of hind foot, length of ear, and body mass.
186
					The purpose of the data was to index the population size of all
187
					species present over a long time period.
188
				</p>
189
				
190
			</div>
191
			
192
			<div class="row-fluid">
193
				<h4><a name="KeywordInformation">Keyword Information</a></h4>
194
				<p>Provide information for as many keywords as needed. The information is provided in groups of three 
195
					fields: keyword, keyword type, and keyword thesaurus. Repeat steps 1-4 below for each additional keyword.
196
				</p>
197
				<p>Have a look at the <a href="http://gcmd.nasa.gov/Resources/valids/gcmd_parameters.html" target="nasa">NASA Global Change Master Directory
198
					(GCMD)</a> (particularly under EARTH SCIENCE > Biosphere) and see if you can find keywords that appropriately describe your data set.  
199
					If not, use your own keywords.
200
				</p>
201
				<p><span class="text-info">1. Keyword: </span>
202
					Enter a word or phrase that describes your data set.</p>
203
				<p><span class="text-info">2. Keyword Type: </span>
204
					Select the keyword type (a term used to group similar keywords). The different types are ("none" is the default):
205

    
206
					<ul>
207
						<li>Theme: the keyword identifies a particular subject or topic.</li>
208
						<li>Place: the keyword identifies a place.</li>
209
						<li>Stratum: the keyword identifies the layer(s) of any deposited substance.</li>
210
						<li>Temporal: the keyword identifies a time period related to the data set.
211
						<li>Taxonomic: the keyword identifies a particular taxon.</li>
212
					</ul>
213
				</p>
214
				<p><span class="text-info">3. Keyword Thesaurus: </span>
215
					Select whether you used the NASA Global Change Master Directory (GCMD) or not to choose your keywords.
216
				</p>
217
				<p>
218
					<span class="text-info">4. Click</span> on the <b>"Add Keyword"</b> button to add the keyword information provided.
219
				</p>
220
				<p>To edit a keyword entry, click on the keyword entered, change the keyword, keyword type, and/or keyword 
221
					thesaurus, and click on the area just right of the thesaurus drop-down menu (the text field and the drop-down menus will disappear).  To delete an entry, click on the "X". 
222
					If you have entered several keywords and want to change the order in which they appear, use the blue up and down arrows.
223
				</p>
224
				
225
			</div>	
226

    
227
			<div class="row-fluid">
228
				<h4><a name="TemporalCoverageOfData">Temporal Coverage of Data</a></h4>
229
				<p><span class="text-info">*Start Date: </span>
230
					The first year, month, and
231
					day of the collection/creation of the data set. A start date is required. Type in the year (yyyy), and choose the month and the day from the
232
					drop-down menus.
233
				</p>
234
				<p><span class="text-info">Stop Date:</span>
235
					The last year, month, and
236
					day for the collection/creation of the data set. Type in the year, and choose the month and the day from the drop-down menus.
237
				</p>
238
				<p>
239
					<em>Note: </em> Leave "Stop Date" blank if your data set is open-ended.
240
				</p>
241
			</div>
242
			
243
			<div class="row-fluid">
244
				<h4><a name="SpatialCoverageOfData">Spatial Coverage of Data</a></h4> 
245
				<p><span class="text-info">*Geographic Description:</span>
246
					Enter a general description of the geographic area in which the data were collected. This can be a simple place name (e.g., Santa Barbara) or a fuller description.
247
					This field supplements the coordinates provided below and helps orient the data user about the general location of the study.
248
				</p>
249
				<p><span class="text-info">*Coordinates:</span>
250
					The latitude and longitude
251
					coordinates (in degrees, minutes and seconds) of the location where the data were collected. At least one lat/long pair is required. From the drop-down menus, select 
252
					the North (N) or South (S) orientation for the latitudes, and the West (W) or East (E) orientation for the longitudes.
253
				</p>
254
				<p>
255
					If you enter <b>one coordinate pair only</b>: This indicates a point location.
256
				</p>
257
				<p>If you enter <b>both coordinate pairs</b>: This indicates a
258
					bounding box. The first coordinate pair is the northwest corner and
259
					the second coordinate pair is the southeast corner of the bounding
260
					box.
261
				</p>
262
			</div>	
263

    
264
			<div class="row-fluid">
265
				<h4><a name="TaxonomicCoverage">Taxonomic Coverage of Data</a></h4>
266
				<p>
267
					Provide a list of the taxa that are associated with this data set. 
268
					This includes taxa for which the data set contains measurements, and taxa
269
					for which the data have relevance in less direct ways.  In general, if a
270
					data user searching for a particular taxonomic name should find this data set,
271
					then the taxon should be included in this list.
272
				</p>
273
				<p>
274
					Please check the <a href=
275
					"http://darwin.zoology.gla.ac.uk/~rpage/MyToL/www/index.php" target="darwin">Glasgow Taxonomic Name Server</a> or the <a href=
276
					"http://www.itis.usda.gov/" target="itis">Integrated Taxonomic Information System</a> for correct spelling 
277
					of taxonomic names.
278
				</p>
279
				<p>For each taxon, follow the three steps below:
280
					<ol>
281
						<li>
282
							<span class="text-info">Taxonomic Rank:</span> Enter the level in the taxonomic hierarchy 
283
							(Kingdom, Phylum, Class, Order, Family, Genus, or Species).
284
						</li>
285
						<li>
286
							<span class="text-info">Taxonomic Name:</span> Enter the scientific name for the level 
287
							entered under Taxonomic Rank (e.g., <i>Animalia</i>, <i>Chordata</i>, <i>Mammalia</i>, <i>Carnivoria</i>, <i>Ursidae</i>, <i>Ursus</i>, or <i>Ursus arctos</i>).
288
						</li>
289
						<li>
290
							<span class="text-info">Click</span> on the <b>"Add Taxon"</b> button to add the taxonomic information.
291
						</li>
292
					</ol>
293
				</p>
294
				<p>
295
					To edit an entry, click on the taxonomic information entered, change the taxonomic rank and/or name, and click on the area just right of the text field for the name (the two text 
296
					fields will disappear).  To delete an entry, click on the "X". If you have entered several taxa and want to change the order in which they appear, use the blue up and 
297
					down arrows.
298
				</p>
299
				<p>
300
					<span class="text-info">Taxonomic Reference:</span> The name
301
					or complete citation of the source(s) used for identifying and naming taxa (e.g., name of a field guide, key, or nomenclature revision). 
302
				</p>
303
			</div>
304
			
305
			<div class="row-fluid">
306
				<h4><a name="Methods">Data Collection Methods</a></h4> 
307
				<p>
308
					<span class="text-info">Method Title:</span> A title for the method used to generate
309
					the data (e.g., Measure of zooplankton abundance using radial quadrat sub-sampling).
310
				</p>
311
				<p>
312
					<span class="text-info">Method Description:</span> Description of the method used.  
313
					This is intended to be a general method description that is suitable to help potential users of the data decide if the data are appropriate for their purposes.  
314
					You can add multiple paragraphs to the description by clicking on the "Add Paragraph to Method Description"
315
					button (paragraphs added by using the ENTER key in the Method Description field will not appear as paragraphs in the submitted form).
316
				</p>
317
				<p>
318
					<span class="text-info">Extent of Study Description:</span>
319
					Describe the temporal, spatial and taxonomic extent of the study, supplementing
320
					the information on coverage provided above. For example, if the temporal
321
					coverage of the data is 1990-2000, you might provide details about any years
322
					that were missed or the months in which sampling actually occurred. If you
323
					provide information in this field (Extent of Study Description), then you must also provide
324
					a Method Title, a Method Description and a Sampling Description.
325
				</p>
326
				<p>
327
					<span class="text-info">Sampling Description:</span>
328
					Describe the sampling design of the study. For example, you might describe
329
					the way in which treatments were assigned to sampling units.  If you provide
330
					information in this field (Sampling Description), then you must also provide
331
					a a Method Title, a Method Description and an Extent of Study Description.
332
				</p>
333
			</div>
334
			
335
			<div class="row-fluid">
336
				<h4><a name="DataSetContactAddress">Data Set Contact</a></h4>
337
				<p>
338
					Contact information of the person to be contacted for more information on the data
339
					set or to obtain the data set itself. This is analogous to the Principal Data Set Owner information above. Please 
340
					<a href="[% cgiPrefix %]/register-dataset.cgi?cfg=[%cfg%]&amp;stage=guide#DataSetOriginator" target="_self">see that section</a> for more information on filling out the 
341
					individual fields. If the Data Set Contact and the Principal Data Set Owner are the same, check the box provided.
342
				</p>
343
			</div>
344
			
345
			<div class="row-fluid">
346
				<h4><a name="DistributionIinformation">Distribution Information</a></h4> 
347
				<p>
348
					<span class="text-info">
349
					<a name=Site-specificCode></a>
350
					Data Set Identifier:</span> If available, please enter a name or number that uniquely identifies and describes concisely the data set. 
351
					Alternatively, provide other pertinent information that can identify and locate the data set within your site's data management system. 
352

    
353
[% IF cfg == 'obfs' || cfg == 'nrs' || cfg == 'specnet'%]
354
Keep in mind that this information, although not required, can be extremely useful
355
for locating the data set at a [% config.site %].
356
[%END%]
357
				</p>
358
				<p>
359
					<span class="text-info">*Data Medium:</span>
360
					Specify whether the data medium is 
361
					digital (e.g., computer file) or hardcopy (e.g., paper), or specify any other type of data medium the data are recorded on (e.g., video tape).
362
				</p>
363
				<p>
364
					*Usage Rights:
365
					[% IF cfg == 'metacatui' &&  config.abbrev == 'ARCTIC' %]
366
						Choose either the:
367
						<ul>
368
							<li>
369
								<a href="https://creativecommons.org/publicdomain/zero/1.0/">
370
									Creative Commons Public Domain Dedication (CC-0)
371
								</a>
372
							</li>
373
							<li>
374
								<a href="https://creativecommons.org/licenses/by/4.0/">
375
									Creative Commons Attribution License(CC-BY)
376
								</a>	
377
							</li>
378
						</ul>
379
						Choosing CC-0, you waive your interest in your work and place the
380
						work as completely as possible in the public domain so others may freely
381
						use the work without restriction under copyright or database law.
382
						Attribution for your work is still expected according to norms in your
383
						research field. Choosing CC-BY licenses your work, and you let others
384
						copy, distribute, display, and perform your copyrighted work, and
385
						derivative works based upon it, but only if they give you appropriate
386
						credit. For more information on choosing, see the
387
						<a href="https://blog.datadryad.org/2011/10/05/why-does-dryad-use-cc0/">Dryad discussion</a> 
388
						and the 
389
						<a href="http://www.bitlaw.com/copyright/unprotected.html">Bitlaw commentary</a>.
390
					[% ELSE %]
391
						Specify the usage rights that apply to the data set (e.g., no restrictions, 
392
						obtain permission from data set owner(s), cite the data set in publications, etc.). 
393
					[% END %]
394
				</p>
395
				<p>
396
					<span class="text-info">URL:</span> If available, provide a link for the
397
					location of more metadata or the data set itself (this URL should be as permanent as possible).
398
				</p>
399
				<p>
400
					<a name="AdditionalInformation"></a>
401
					<span class="text-info">Additional Information:</span> 
402
					Add any additional information here that you deem relevant to the data set, which has not been covered in the form.  For example, if the data set is in the form 
403
					of a computer file, you could specify the file format here (e.g., Excel, Access, FoxPro, DBase, etc.).
404
				</p>	
405

    
406
			</div>
407
			
408
			<div class="row-fluid">
409
				<h4><a name="UploadData">Data File Upload</a></h4> 
410
				<p>
411
					Select files from your computer to include in the data package submission. Text-based data files (e.g., CSV) are preferred, but there is no restriction on the file type.
412
					Multiple files can be included in the package.
413
				</p>
414
				<p>
415
					Ideally, data files will be made publicly accessible on submission, but we recognize there are some cases where access to the data should be restricted until a later date.
416
					Select the appropriate permission level for each file as it is attached to the package. Files can be 'unattached' using the delete button.
417
				</p>
418

    
419
			</div>
420

    
421
		</div>
422
	</article>