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
|
C****************************************************************************
C* NCSA HDF *
C* Software Development Group *
C* National Center for Supercomputing Applications *
C* University of Illinois at Urbana-Champaign *
C* 605 E. Springfield, Champaign IL 61820 *
C* *
C* For conditions of distribution and use, see the accompanying *
C* hdf/COPYING file. *
C* *
C****************************************************************************
C
C $Id: mfsdff.for,v 1.5 1999/04/27 20:08:00 epourmal Exp $
C
C----------------------------------------------------------------------
C Name: sdfstart
C Purpose: call scstart, open file
C Inputs: path: Name of file to be opened
C access: DFACC_READ, DFACC_WRITE, DFACC_CREATE,
C or any bitwise-or of the above.
C Returns: 0 on success, FAIL on failure with error set
C Users: Fortran stub routine
C----------------------------------------------------------------------
integer function sfstart(filename, access)
character*(*) filename
integer access, scstart
sfstart = scstart(filename, access, len(filename))
return
end
C----------------------------------------------------------------------
C Name: sdfn2index
C Purpose: call scn2index to return an index
C Inputs: id: file
C name: name of data set
C Returns: 0 on success, FAIL on failure with error set
C Users: Fortran stub routine
C----------------------------------------------------------------------
integer function sfn2index(id, name)
character*(*) name
integer id, scn2index
sfn2index = scn2index(id, name, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfcreate
C Purpose: call sccreate to create a new dataset
C Inputs: id: file
C name: name of data set
C nt: number type
C rank: rank
C dims: sizes of dimensions
C Returns: 0 on success, FAIL on failure with error set
C Users: Fortran stub routine
C----------------------------------------------------------------------
integer function sfcreate(id, name, nt, rank, dims)
character*(*) name
integer id, nt, rank, sccreate
integer dims(*)
sfcreate = sccreate(id, name, nt, rank, dims, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfsdmstr
C Purpose: set strings for this dimension
C Inputs: id: dimension id
C label,unit,format: strings to be set
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfsdmstr(id, label, unit, format)
character*(*) label, unit, format
integer len, id
integer scsdimstr
sfsdmstr = scsdimstr(id, label, unit, format,
+ len(label), len(unit), len(format))
return
end
C----------------------------------------------------------------------
C Name: sfsdmname
C Purpose: set name of this dimension
C Inputs: id: dimension id
C name: the name
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfsdmname(id, name)
character*(*) name
integer len, id
integer scsdimname
sfsdmname = scsdimname(id, name, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfsdtstr
C Purpose: set strings for this data set
C Inputs: id: dimension id
C label,unit,format,coordsys: strings to be set
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfsdtstr(id, l, u, f, c)
character*(*) l, u, f, c
integer len, id
integer scsdatstr
sfsdtstr = scsdatstr(id, l, u, f, c,
+ len(l), len(u), len(f), len(c))
return
end
C----------------------------------------------------------------------
C Name: sfgdtstr
C Purpose: get strings for this data set
C Inputs: id: dimension id
C Outputs: label,unit,format,coordsys: strings to be gotten
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfgdtstr(id, label, unit, format, coord, mlen)
character*(*) label, unit, format, coord
integer len, id, mlen
integer scgdatstrs
sfgdtstr = scgdatstrs(id, label, unit, format, coord,
+ len(label), len(unit), len(format), len(coord), mlen)
return
end
C----------------------------------------------------------------------
C Name: sfgdmstr
C Purpose: get strings for this dimension
C Inputs: id: dimension id
C Outputs: label,unit,format: strings to be gotten
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfgdmstr(id, label, unit, format, mlen)
character*(*) label, unit, format
integer len, id
integer scgdimstrs
sfgdmstr = scgdimstrs(id, label, unit, format,
+ len(label), len(unit), len(format), mlen)
return
end
C----------------------------------------------------------------------
C Name: sfginfo
C Purpose: get basic info about this data set
C Inputs: id: dataset id
C Outputs: name, rank, nt, dims, nattrs
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfginfo(id, name, rank, dims, nt, nattr)
character*(*) name
integer rank, nt, nattr
integer dims(*)
integer scginfo, len
sfginfo = scginfo(id, name, rank, dims, nt, nattr, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfgainfo
C Purpose: get basic info about an attribute
C Inputs: id: dataset id
C number: attribute number
C Outputs: name, nt, count
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfgainfo(id, number, name, nt, count)
character*(*) name
integer nt, number
integer scgainfo, len
sfgainfo = scgainfo(id, number, name, nt, count, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfgdinfo
C Purpose: get basic info about a dimension
C Inputs: id: dim id
C Outputs: name, nt, sz, nattr
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfgdinfo(id, name, sz, nt, nattr)
character*(*) name
integer sz, nt, nattr
integer scgdinfo, len
sfgdinfo = scgdinfo(id, name, sz, nt, nattr, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfscatt
C Purpose: create (or modify an existing) char attribute
C Inputs: id: id of object to attribute-ize
C Outputs: name, nt, count, data
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfscatt(id,name,nt,count,data)
character*(*) name, data
integer nt
integer scscatt, len
sfscatt = scscatt(id,name,nt,count,data,len(name))
return
end
C----------------------------------------------------------------------
C Name: sfsnatt
C Purpose: create (or modify an existing) numeric attribute
C Inputs: id: id of object to attribute-ize
C Outputs: name, nt, count, data
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C----------------------------------------------------------------------
integer function sfsnatt(id, name, nt, count, data)
character*(*) name
integer nt, data
integer scsnatt, len
sfsnatt = scsnatt(id, name, nt, count, data, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfsattr
C Purpose: for backward compatability. Calls scsattr to
C create (or modify an existing) attribute
C Inputs: id: id of object to attribute-ize
C Outputs: name, nt, count, data
C Returns: 0 on success, -1 on failure with DFerror set
C Users: HDF Fortran programmers
C Remarks: This function should be phased out in the future.
C----------------------------------------------------------------------
integer function sfsattr(id, name, nt, count, data)
character*(*) name, data
integer nt
integer scsattr, len
sfsattr = scsattr(id, name, nt, count, data, len(name))
return
end
C----------------------------------------------------------------------
C Name: sffattr
C Purpose: call scfattr, find an attribute
C Inputs: id: Object to look at
C name: name of attribute
C Returns: attribute number on success, FAIL on failure with error set
C Users: Fortran stub routine
C----------------------------------------------------------------------
integer function sffattr(id, name)
character*(*) name
integer id, scfattr
sffattr = scfattr(id, name, len(name))
return
end
C----------------------------------------------------------------------
C Name: sfsextf
C Purpose: call scsextf to store data in an external file
C Inputs: id: sds id
C fname: name of external file
C offset: Number of bytes from the beginning of the
C external file to where the data starts
C Returns: 0 on success, FAIL on failure with error set
C Users: Fortran stub routine
C----------------------------------------------------------------------
integer function sfsextf(id, fname, offset)
character*(*) fname
integer id, offset, scsextf
sfsextf = scsextf(id, fname, offset, len(fname))
return
end
C-------------------------------------------------------------------------
C Name: sfgichnk
C Purpose: get Info on SDS
C Inputs: id - data set ID
C Outputs: dim_length - chunk dimensions (if any)
C comp_flag:
C -1 - SDS is non-chunked
C 0 - SDS is chunked without compression
C 1 - SDS is chunked and compressed with
C RLE, GZIP or SKPHUFF
C 2 - SDS is chunked and compressed with
C NBIT
C Returns: 0 on success, -1 on failure
C Calls: scgichnk (C stub for SD setchunk function)
C-------------------------------------------------------------------------
INTEGER function sfgichnk(id, dim_length, comp_flag)
INTEGER id, dim_length(*), comp_flag
INTEGER scgichnk
sfgichnk = scgichnk(id, dim_length, comp_flag)
return
end
C-------------------------------------------------------------------------
C Name: sfrcchnk
C Purpose: read the specified chunk of CHARACTER data to the SDS
C Inputs: id - data set ID
C start - chunk coordinates
C char_data - buffer the data will be read into
C Returns: 0 on success, -1 on failure
C Calls: scrcchnk (C stub for SDwriteChunk function)
C Users: HDF Fortran programmers
C-------------------------------------------------------------------------
INTEGER function sfrcchnk(id, start, char_data)
C
INTEGER id, start(*)
CHARACTER*(*) char_data(*)
INTEGER scrcchnk
C
sfrcchnk = scrcchnk(id, start, char_data)
C
return
end
C-------------------------------------------------------------------------
C Name: sfrchnk
C Purpose: read the specified chunk of NUMERIC data to the SDS
C Inputs: id - data set ID
C start - chunk coordinates
C num_data - buffer the numeric data will be read into
C Returns: 0 on success, -1 on failure
C Calls: scrchnk (C stub for SDwriteChunk function)
C Users: HDF Fortran programmers
C-------------------------------------------------------------------------
INTEGER function sfrchnk(id, start, num_data)
C
INTEGER id, start(*), num_data(*)
INTEGER scrchnk
C
sfrchnk = scrchnk(id, start, num_data)
C
return
end
C-------------------------------------------------------------------------
C Name: sfscchnk
C Purpose: set the maximum number of chunks to cache
C Inputs: id - data set ID
C maxcache - max number of chunks to cache
C flags - flags =0, HDF_CACHEALL
C Currently only 0 can be passed.
C Returns: 0 on success, -1 on failure
C Calls: scscchnk (C stub for SDsetchunkcache function)
C Users: HDF Fortran programmers
C-------------------------------------------------------------------------
INTEGER function sfscchnk(id, maxcache, flags)
C
INTEGER id, maxcache, flags
INTEGER scscchnk
C
sfscchnk = scscchnk(id, maxcache, flags)
C
return
end
C-------------------------------------------------------------------------
C Name: sfschnk
C Purpose: make the SDS a chunked SDS
C Inputs: id - data set ID
C dim_length - chunk dimensions
C comp_type - type of compression
C supports the following compression types:
C ( see hcomp.h file)
C COMP_CODE_NONE = 0
C COMP_CODE_RLE = 1
C COMP_CODE_NBIT = 2
C COMP_CODE_SKPHUFF = 3
C COMP_CODE_DEFLATE = 4
C comp_prm - compression parameters array
C For
C Adaptive Huffman
C comp_prm(1) = skphuff_skp_size
C GZIP
C comp_prm(1) = deflate_level
C NBIT
C comp_prm(1) = nbit_sign_ext
C comp_prm(2) = nbit_fill_one
C comp_prm(3) = nbit_start_bit
C comp_prm(4) = nbit_bit_len
C
C NOTE: IT IS USER's responsibility to pass correct compression
C parameters for each type of compression
C
C
C Returns: 0 on success, -1 on failure
C Calls: scschnk (C stub for SD setchunk function)
C-------------------------------------------------------------------------
INTEGER function sfschnk(id, dim_length, comp_type,comp_prm)
INTEGER id, dim_length(*), comp_type, comp_prm(*)
INTEGER scschnk
sfschnk = scschnk(id, dim_length, comp_type, comp_prm)
return
end
C-------------------------------------------------------------------------
C Name: sfwcchnk
C Purpose: write the specified chunk of CHARACTER data to the SDS
C Inputs: id - data set ID
C start - chunk coordinates
C char_data - buffer containing data to be written
C Returns: 0 on success, -1 on failure
C Calls: scwcchnk (C stub for SDwriteChunk function)
C Users: HDF Fortran programmers
C-------------------------------------------------------------------------
INTEGER function sfwcchnk(id, start, char_data)
C
INTEGER id, start(*)
CHARACTER*(*) char_data(*)
INTEGER scwcchnk
C
sfwcchnk = scwcchnk(id, start, char_data)
C
return
end
C-------------------------------------------------------------------------
C Name: sfwchnk
C Purpose: write the specified chunk of NUMERIC data to the SDS
C Inputs: id - data set ID
C start - chunk coordinates
C num_data - buffer containing data to be written
C Returns: 0 on success, -1 on failure
C Calls: scwchnk (C stub for SDwriteChunk function)
C Users: HDF Fortran programmers
C-------------------------------------------------------------------------
INTEGER function sfwchnk(id, start, num_data)
C
INTEGER id, start(*), num_data(*)
INTEGER scwchnk
C
sfwchnk = scwchnk(id, start, num_data)
C
return
end
C-------------------------------------------------------------------------
C Name: sfscompress
C Purpose: compress SDS
C Inputs: id - data set ID
C comp_type - type of compression
C supports the following compression types:
C ( see hcomp.h file)
C COMP_CODE_NONE = 0
C COMP_CODE_RLE =1
C COMP_CODE_SKPHUFF = 3
C COMP_CODE_DEFLATE = 4
C comp_prm - compression parameter array:
C comp_prm(1) = deflate_level for GZIP
C comp_prm(1) = skphuff_skp_size for ADAPTIVE HUFFMAN
C NOTE: IT IS USER's responsibility to pass correct compression
C parameters for each type of compression
C
C Returns: 0 on success, -1 on failure
C Calls: scscompress (C stub for SD setchunk function)
C-------------------------------------------------------------------------
INTEGER function sfscompress(id, comp_type,comp_prm)
INTEGER id, comp_type, comp_prm(*)
INTEGER scscompress
sfscompress = scscompress(id, comp_type, comp_prm)
return
end
C-------------------------------------------------------------------------
C Name: sfchempty
C Purpose: checks whether an SDS is empty ( data has not been written)
C Inputs: id - data set ID
C Outputs: flag - 1 if SDS is empty, 0 otherwise
C Returns: 0 on success, -1 on failure
C Calls: scchempty (C stub for SDcheckempty function)
C Users: HDF Fortran programmers
C-------------------------------------------------------------------------
INTEGER function sfchempty(id, flag)
C
INTEGER id, flag
INTEGER scchempty
C
sfchempty = scchempty(id, flag)
C
return
end
|
