1 | ;+ |
---|
2 | ; |
---|
3 | ; @file_comments |
---|
4 | ; read the f77 unformatted files used in Oasis (version < 2.5) |
---|
5 | ; |
---|
6 | ; @categories |
---|
7 | ; Reading |
---|
8 | ; |
---|
9 | ; @param FILENAME {in}{required} |
---|
10 | ; the filename |
---|
11 | ; |
---|
12 | ; @param VARNAME {in}{required} |
---|
13 | ; the name of the variable to be read |
---|
14 | ; |
---|
15 | ; @param JPI {in}{required} |
---|
16 | ; |
---|
17 | ; @param jpj {in}{required} |
---|
18 | ; the size of the 2d array to be read |
---|
19 | ; |
---|
20 | ; @keyword I2 |
---|
21 | ; @keyword I4 |
---|
22 | ; @keyword I8 |
---|
23 | ; @keyword R4 |
---|
24 | ; to change the default format (R8) of the data to be read. |
---|
25 | ; |
---|
26 | ; @returns |
---|
27 | ; a 2d array |
---|
28 | ; |
---|
29 | ; @examples |
---|
30 | ; |
---|
31 | ; IDL> a=read_oasis('grids_orca_t106','a106.lon',320,160) |
---|
32 | ; IDL> m=read_oasis('masks_orca_t106','or1t.msk',182,149,/i4) |
---|
33 | ; |
---|
34 | ; see also |
---|
35 | ; |
---|
36 | ; IDL> scanoasis,'grids_orca_t106' |
---|
37 | ; |
---|
38 | ; @history |
---|
39 | ; Sebastien Masson (smasson\@lodyc.jussieu.fr) |
---|
40 | ; July 01, 2002 |
---|
41 | ; @version |
---|
42 | ; $Id$ |
---|
43 | ; |
---|
44 | ;- |
---|
45 | FUNCTION read_oasis, filename, varname, jpi, jpj, I2=I2, I4=i4, I8=i8, R4=r4 |
---|
46 | ; |
---|
47 | compile_opt idl2, strictarrsubs |
---|
48 | ; |
---|
49 | |
---|
50 | openr, unit, filename, /f77_unformatted, /get_lun, /swap_if_little_endian $ |
---|
51 | , error=err |
---|
52 | if err ne 0 then begin |
---|
53 | ras = report(!err_string) |
---|
54 | return, -1 |
---|
55 | endif |
---|
56 | |
---|
57 | char8 = '12345678' |
---|
58 | readu, unit, char8 |
---|
59 | ; print, char8 |
---|
60 | found = char8 EQ varname |
---|
61 | |
---|
62 | WHILE NOT EOF(unit) AND found NE 1 DO BEGIN |
---|
63 | readu, unit |
---|
64 | if EOF(unit) then begin |
---|
65 | ras = report(varname+' not found in '+filename) |
---|
66 | return, -1 |
---|
67 | endif |
---|
68 | readu, unit, char8 |
---|
69 | ; print, char8 |
---|
70 | found = char8 EQ varname |
---|
71 | ENDWHILE |
---|
72 | case 1 of |
---|
73 | keyword_set(i2):res = intarr(jpi, jpj) |
---|
74 | keyword_set(i4):res = lonarr(jpi, jpj) |
---|
75 | keyword_set(i8):res = lon64arr(jpi, jpj) |
---|
76 | keyword_set(r4):res = fltarr(jpi, jpj) |
---|
77 | ELSE:res = dblarr(jpi, jpj) |
---|
78 | endcase |
---|
79 | |
---|
80 | readu, unit, res |
---|
81 | |
---|
82 | free_lun,unit |
---|
83 | |
---|
84 | return, res |
---|
85 | end |
---|