[6] | 1 | C--VERSION:2005.04.08 |
---|
| 2 | C modified by Martin Vancoppenolle for use with LIM1D |
---|
| 3 | C read of forcing |
---|
| 4 | |
---|
| 5 | C ----------------------------------------------------------------------- |
---|
| 6 | C libUN : User level NetCDF READ / WRITE routines |
---|
| 7 | C |
---|
| 8 | C by Philippe Marbaix and Xavier Fettweis |
---|
| 9 | C |
---|
| 10 | C Compatible with NetCDF version 3.x (or above). |
---|
| 11 | C ----------------------------------------------------------------------- |
---|
| 12 | |
---|
| 13 | C User-frendly interface : |
---|
| 14 | C ------------------------ |
---|
| 15 | |
---|
| 16 | c CF_INI_FILE : Initialization of the netcf file |
---|
| 17 | c CF_CREATE_DIM : Create axis/dimensions |
---|
| 18 | c CF_CREATE_VAR : Create variables |
---|
| 19 | c CF_CREATE_FILE: Write the netcdf file |
---|
| 20 | c CF_WRITE : Write variables |
---|
| 21 | c CF_READ3D/2D : Read variables |
---|
| 22 | c CF_OPEN : Open netcdf file |
---|
| 23 | c CF_CLOSE : Close netcdf file |
---|
| 24 | |
---|
| 25 | C Main routines : |
---|
| 26 | C --------------- |
---|
| 27 | |
---|
| 28 | c UNscreate : General file creation routine, |
---|
| 29 | c defining multiple dimensions + attributes |
---|
| 30 | |
---|
| 31 | c UNwrite : General variables writting routine |
---|
| 32 | c (also updates 'range' attribute and variable if present) |
---|
| 33 | c Note: Use UNlwrite to write 2D planes in 3D variables |
---|
| 34 | |
---|
| 35 | c UN(s)read : Reading routine (grid coordinates + variable) |
---|
| 36 | |
---|
| 37 | C Complementary routines : |
---|
| 38 | C ------------------------ |
---|
| 39 | |
---|
| 40 | c UNparam : set optional parameters of libUN functions |
---|
| 41 | c UNwopen : re-open file for writting |
---|
| 42 | c UNropen : open file for reading |
---|
| 43 | c UNgtime : Find time index for a given time value |
---|
| 44 | c UNgindx : Generalization of UNgtime: find value in any 1D data. |
---|
| 45 | c UNfindx : modified version of UNgindx safe for non-monotonic data |
---|
| 46 | c UNclose : close the NetCDF file |
---|
| 47 | c UNwratt : Real attributes writting |
---|
| 48 | c UNwcatt : Characters attributes creation & writing |
---|
| 49 | |
---|
| 50 | C Double Precision : |
---|
| 51 | C ------------------ |
---|
| 52 | |
---|
| 53 | c To be in double precision, type this |
---|
| 54 | c > sed "s/REAL\*4/REAL\*8/g" libUN.f > libUN1.f |
---|
| 55 | c > sed "s/\_REAL/\_DOUBLE/g" libUN1.f > libUN2.f |
---|
| 56 | c > sed "s/NF\_FLOAT/NF\_DOUBLE/g" libUN2.f > libUNd.f |
---|
| 57 | c > rm -f libUN1.f libUN2.f |
---|
| 58 | |
---|
| 59 | C ----------------------------------------------------------------------- |
---|
| 60 | |
---|
| 61 | |
---|
| 62 | C +---------------------------+---------------------------------------+ |
---|
| 63 | C + Subroutine CD_INI_FILE : + Initialize the netcdf file + |
---|
| 64 | C +---------------------------+---------------------------------------+ |
---|
| 65 | |
---|
| 66 | SUBROUTINE CF_INI_FILE (filename, filetitle) |
---|
| 67 | |
---|
| 68 | c Input : |
---|
| 69 | c ======= |
---|
| 70 | |
---|
| 71 | c filename = name of the netcdf file |
---|
| 72 | c filetitle = title in the netcdf file |
---|
| 73 | |
---|
| 74 | IMPLICIT NONE |
---|
| 75 | |
---|
| 76 | INCLUDE 'libUN.inc' |
---|
| 77 | |
---|
| 78 | CHARACTER *(*) filename,filetitle |
---|
| 79 | |
---|
| 80 | CF_attnam(1) = 'actual_range' |
---|
| 81 | CF_attnum(1) = 2 |
---|
| 82 | |
---|
| 83 | CF_varnbrtot = 0 ! Initialization |
---|
| 84 | CF_dimnbrtot = -1 ! Initialization |
---|
| 85 | |
---|
| 86 | CF_filenam = filename |
---|
| 87 | CF_filetit = filetitle |
---|
| 88 | |
---|
| 89 | END SUBROUTINE CF_INI_FILE |
---|
| 90 | |
---|
| 91 | |
---|
| 92 | C +-----------------------------+-------------------------------------+ |
---|
| 93 | C + Subroutine CF_CREATE_DIM : + Create dimensions/axis + |
---|
| 94 | C +-----------------------------+-------------------------------------+ |
---|
| 95 | |
---|
| 96 | SUBROUTINE CF_CREATE_DIM (dimname,dimunits,dimdim,vallues) |
---|
| 97 | |
---|
| 98 | c Input : |
---|
| 99 | c ======= |
---|
| 100 | |
---|
| 101 | c dimname = name of the axis/dimension |
---|
| 102 | c dimunits = units of the axis/dimension |
---|
| 103 | c dimdim = dimensions of the axis/dimension |
---|
| 104 | c vallues = vallues of the axis/dimension |
---|
| 105 | |
---|
| 106 | IMPLICIT NONE |
---|
| 107 | |
---|
| 108 | INCLUDE 'libUN.inc' |
---|
| 109 | |
---|
| 110 | CHARACTER *(*) dimname,dimunits |
---|
| 111 | |
---|
| 112 | INTEGER dimdim,i |
---|
| 113 | REAL*4 vallues(dimdim) |
---|
| 114 | |
---|
| 115 | CF_dimnbrtot = CF_dimnbrtot + 1 |
---|
| 116 | |
---|
| 117 | CF_dimnbrtot = max(0,CF_dimnbrtot) |
---|
| 118 | |
---|
| 119 | CF_dimnam(CF_dimnbrtot) = dimname |
---|
| 120 | CF_dimnamuni(CF_dimnbrtot) = dimunits |
---|
| 121 | CF_dim(CF_dimnbrtot) = dimdim |
---|
| 122 | |
---|
| 123 | do i = 1,dimdim |
---|
| 124 | CF_dimval(i,CF_dimnbrtot) = vallues(i) |
---|
| 125 | enddo |
---|
| 126 | |
---|
| 127 | END SUBROUTINE CF_CREATE_DIM |
---|
| 128 | |
---|
| 129 | C +-----------------------------+-------------------------------------+ |
---|
| 130 | C + Subroutine CF_CREATE_VAR : + Create variables + |
---|
| 131 | C +-----------------------------+-------------------------------------+ |
---|
| 132 | |
---|
| 133 | SUBROUTINE CF_CREATE_VAR (varname,vartitle,varunits,varaxe4, |
---|
| 134 | . varaxe1,varaxe2,varaxe3) |
---|
| 135 | |
---|
| 136 | c Input : |
---|
| 137 | c ======= |
---|
| 138 | |
---|
| 139 | c varname = name of the variable |
---|
| 140 | c vartitle = title of the variable |
---|
| 141 | c varunits = units of the variable |
---|
| 142 | c varaxeX = axes used by the variable (T,X,Y,Z) |
---|
| 143 | |
---|
| 144 | IMPLICIT NONE |
---|
| 145 | |
---|
| 146 | INCLUDE 'libUN.inc' |
---|
| 147 | |
---|
| 148 | CHARACTER *(*) varname,vartitle,varunits |
---|
| 149 | CHARACTER *(*) varaxe1,varaxe2,varaxe3,varaxe4 |
---|
| 150 | |
---|
| 151 | CF_varnbrtot = max (0,CF_varnbrtot + 1) |
---|
| 152 | |
---|
| 153 | CF_varnam(CF_varnbrtot) = varname |
---|
| 154 | CF_varnamdim(1,CF_varnbrtot) = varaxe1 |
---|
| 155 | CF_varnamdim(2,CF_varnbrtot) = varaxe2 |
---|
| 156 | CF_varnamdim(3,CF_varnbrtot) = varaxe3 |
---|
| 157 | CF_varnamdim(4,CF_varnbrtot) = varaxe4 |
---|
| 158 | CF_varnamuni(CF_varnbrtot) = varunits |
---|
| 159 | CF_vardes(CF_varnbrtot) = vartitle |
---|
| 160 | |
---|
| 161 | END SUBROUTINE CF_CREATE_VAR |
---|
| 162 | |
---|
| 163 | C +--------------------------------------+----------------------------+ |
---|
| 164 | C + Subroutine CF_CREATE_VAR_VIA_FILE : + Create variables + |
---|
| 165 | C +--------------------------------------+----------------------------+ |
---|
| 166 | |
---|
| 167 | SUBROUTINE CF_CREATE_VAR_VIA_FILE (filename) |
---|
| 168 | |
---|
| 169 | c Input : |
---|
| 170 | c ======= |
---|
| 171 | |
---|
| 172 | c filename = name of the file containing informations |
---|
| 173 | c about the variables |
---|
| 174 | |
---|
| 175 | IMPLICIT NONE |
---|
| 176 | |
---|
| 177 | INCLUDE 'libUN.inc' |
---|
| 178 | |
---|
| 179 | CHARACTER*200 filename |
---|
| 180 | |
---|
| 181 | CHARACTER*120 tmpvar |
---|
| 182 | |
---|
| 183 | OPEN(unit=999,status='old',file=filename) |
---|
| 184 | |
---|
| 185 | 980 CONTINUE |
---|
| 186 | READ (999,'(A120)',end=990) tmpvar |
---|
| 187 | |
---|
| 188 | IF (tmpvar(1:4).eq.' ') THEN |
---|
| 189 | CF_varnbrtot = max (0,CF_varnbrtot + 1) |
---|
| 190 | READ (tmpvar,'(4x,5A9,A12,A50)') |
---|
| 191 | . CF_varnam(CF_varnbrtot), |
---|
| 192 | . CF_varnamdim(1,CF_varnbrtot), |
---|
| 193 | . CF_varnamdim(2,CF_varnbrtot), |
---|
| 194 | . CF_varnamdim(3,CF_varnbrtot), |
---|
| 195 | . CF_varnamdim(4,CF_varnbrtot), |
---|
| 196 | . CF_varnamuni(CF_varnbrtot), |
---|
| 197 | . CF_vardes(CF_varnbrtot) |
---|
| 198 | ENDIF |
---|
| 199 | |
---|
| 200 | GOTO 980 |
---|
| 201 | 990 CONTINUE |
---|
| 202 | |
---|
| 203 | END SUBROUTINE CF_CREATE_VAR_VIA_FILE |
---|
| 204 | |
---|
| 205 | C +------------------------------+------------------------------------+ |
---|
| 206 | C + Subroutine CF_CREATE_FILE : + Create the netcdf file + |
---|
| 207 | C +------------------------------+------------------------------------+ |
---|
| 208 | |
---|
| 209 | SUBROUTINE CF_CREATE_FILE (filename) |
---|
| 210 | |
---|
| 211 | c Input : |
---|
| 212 | c ======= |
---|
| 213 | |
---|
| 214 | c filename = name of the netcdf file |
---|
| 215 | |
---|
| 216 | IMPLICIT NONE |
---|
| 217 | |
---|
| 218 | INCLUDE 'libUN.inc' |
---|
| 219 | |
---|
| 220 | CHARACTER *(*) filename |
---|
| 221 | |
---|
| 222 | INTEGER i,j,id |
---|
| 223 | |
---|
| 224 | INTEGER UN1_dim(0:CF_dimnbrtot) |
---|
| 225 | |
---|
| 226 | REAL UN1_dimval(CF_dimmaxlen,0:CF_dimnbrtot) |
---|
| 227 | |
---|
| 228 | CHARACTER*31 UN1_dimnam(0:CF_dimnbrtot), |
---|
| 229 | . UN1_dimnamuni(0:CF_dimnbrtot) |
---|
| 230 | |
---|
| 231 | if(filename.ne.CF_filenam)then |
---|
| 232 | write(6,*) "ERROR: not "//CF_filenam |
---|
| 233 | stop |
---|
| 234 | endif |
---|
| 235 | |
---|
| 236 | DO i=0,CF_dimnbrtot |
---|
| 237 | UN1_dim(i) = CF_dim(i) |
---|
| 238 | UN1_dimnam(i) = CF_dimnam(i) |
---|
| 239 | UN1_dimnamuni(i) = CF_dimnamuni(i) |
---|
| 240 | DO j=1,CF_dim(i) |
---|
| 241 | UN1_dimval(j,i) = CF_dimval(j,i) |
---|
| 242 | END DO |
---|
| 243 | END DO |
---|
| 244 | |
---|
| 245 | call UNscreate (CF_filenam,CF_filetit,CF_dimnbrtot,UN1_dim, |
---|
| 246 | . CF_dimmaxlen, UN1_dimnam ,UN1_dimnamuni, |
---|
| 247 | . UN1_dimval, |
---|
| 248 | . CF_varmaxnbr,CF_varnbrtot,CF_varnam, |
---|
| 249 | . CF_varnamdim,CF_varnamuni,CF_vardes, |
---|
| 250 | . CF_attnbr,CF_attnam,CF_attnum,id) |
---|
| 251 | |
---|
| 252 | call UNclose (id) |
---|
| 253 | |
---|
| 254 | |
---|
| 255 | END SUBROUTINE CF_CREATE_FILE |
---|
| 256 | |
---|
| 257 | C +------------------------+------------------------------------------+ |
---|
| 258 | C + Subroutine CF_WRITE : + Writes variables + |
---|
| 259 | C +------------------------+------------------------------------------+ |
---|
| 260 | |
---|
| 261 | |
---|
| 262 | SUBROUTINE CF_WRITE (FILEname, VARname , itime, |
---|
| 263 | & Ni, Nj, Nlev, var) |
---|
| 264 | |
---|
| 265 | c Input : |
---|
| 266 | c ======= |
---|
| 267 | |
---|
| 268 | c FILEname = name of the netcdf file |
---|
| 269 | c VARname = name of variables |
---|
| 270 | c itime = index on time axis |
---|
| 271 | c Ni,Nj,Nlev = X,Y,Z dimension |
---|
| 272 | c var = array of vallues of the variable |
---|
| 273 | |
---|
| 274 | IMPLICIT NONE |
---|
| 275 | |
---|
| 276 | INCLUDE 'libUN.inc' |
---|
| 277 | |
---|
| 278 | CHARACTER *(*) FILEname,VARname |
---|
| 279 | INTEGER itime |
---|
| 280 | INTEGER Ni, Nj, Nlev,fileid |
---|
| 281 | REAL*4 var(Ni, Nj, Nlev) |
---|
| 282 | |
---|
| 283 | if(CF_filenamopened.ne.FILEname) then |
---|
| 284 | CALL UNwopen (FILEname,fileid) |
---|
| 285 | else |
---|
| 286 | fileid = CF_fileidopened |
---|
| 287 | endif |
---|
| 288 | |
---|
| 289 | CALL UNwrite (fileid,VARname ,itime,Ni, Nj, Nlev, var) |
---|
| 290 | |
---|
| 291 | if(CF_filenamopened.ne.FILEname) then |
---|
| 292 | call UNclose (fileid) |
---|
| 293 | endif |
---|
| 294 | |
---|
| 295 | END SUBROUTINE CF_WRITE |
---|
| 296 | |
---|
| 297 | C** +-------------------------+-----------------------------------------+ |
---|
| 298 | C** + Subroutine CF_READ1D : + Read variables + |
---|
| 299 | C** +-------------------------+-----------------------------------------+ |
---|
| 300 | |
---|
| 301 | SUBROUTINE CF_READ1D (FILEname, VARname , itime, |
---|
| 302 | . N, var) |
---|
| 303 | ! routine added by martin vancoppenolle to read 1D arrays |
---|
| 304 | |
---|
| 305 | c Input : |
---|
| 306 | c ======= |
---|
| 307 | |
---|
| 308 | c FILEname = name of the netcdf file |
---|
| 309 | c VARname = name of variables |
---|
| 310 | c itime = index on time axis |
---|
| 311 | c N = X dimension |
---|
| 312 | |
---|
| 313 | c Output : |
---|
| 314 | c ======== |
---|
| 315 | |
---|
| 316 | c var = array of values of the variable |
---|
| 317 | |
---|
| 318 | IMPLICIT NONE |
---|
| 319 | |
---|
| 320 | INCLUDE 'libUN.inc' |
---|
| 321 | |
---|
| 322 | CHARACTER *(*) FILEname,VARname |
---|
| 323 | CHARACTER*31 var_units,filetitle |
---|
| 324 | INTEGER N, itime,level |
---|
| 325 | REAL*4 var(N) |
---|
| 326 | |
---|
| 327 | INTEGER i,j,fileid |
---|
| 328 | |
---|
| 329 | if(CF_filenamopened.ne.FILEname) then |
---|
| 330 | CALL UNropen (FILEname,fileid,filetitle) |
---|
| 331 | else |
---|
| 332 | fileid = CF_fileidopened |
---|
| 333 | endif |
---|
| 334 | |
---|
| 335 | CALL UNsread (fileid, VARname, itime, 1, 1, 1, |
---|
| 336 | & N , 1 , 1,var_units, var) |
---|
| 337 | |
---|
| 338 | if(CF_filenamopened.ne.FILEname) then |
---|
| 339 | call UNclose (fileid) |
---|
| 340 | endif |
---|
| 341 | |
---|
| 342 | END SUBROUTINE CF_READ1D |
---|
| 343 | |
---|
| 344 | C** +-------------------------+-----------------------------------------+ |
---|
| 345 | C** + Subroutine CF_READ2D : + Read variables + |
---|
| 346 | C** +-------------------------+-----------------------------------------+ |
---|
| 347 | |
---|
| 348 | SUBROUTINE CF_READ2D (FILEname, VARname , itime, |
---|
| 349 | . Ni, Nj, Nlev, var) |
---|
| 350 | |
---|
| 351 | |
---|
| 352 | c Input : |
---|
| 353 | c ======= |
---|
| 354 | |
---|
| 355 | c FILEname = name of the netcdf file |
---|
| 356 | c VARname = name of variables |
---|
| 357 | c itime = index on time axis |
---|
| 358 | c Ni,Nj,Nlev = X,Y,Z dimension |
---|
| 359 | |
---|
| 360 | c Output : |
---|
| 361 | c ======== |
---|
| 362 | |
---|
| 363 | c var = array of vallues of the variable |
---|
| 364 | |
---|
| 365 | IMPLICIT NONE |
---|
| 366 | |
---|
| 367 | INCLUDE 'libUN.inc' |
---|
| 368 | |
---|
| 369 | CHARACTER *(*) FILEname,VARname |
---|
| 370 | CHARACTER*31 var_units,filetitle |
---|
| 371 | INTEGER Ni, Nj, Nlev,itime,level |
---|
| 372 | REAL*4 var(Ni, Nj) |
---|
| 373 | |
---|
| 374 | INTEGER i,j,fileid |
---|
| 375 | |
---|
| 376 | if(CF_filenamopened.ne.FILEname) then |
---|
| 377 | CALL UNropen (FILEname,fileid,filetitle) |
---|
| 378 | else |
---|
| 379 | fileid = CF_fileidopened |
---|
| 380 | endif |
---|
| 381 | |
---|
| 382 | CALL UNsread (fileid, VARname, itime, Nlev, 1, 1, |
---|
| 383 | & Ni , Nj , 1,var_units, var) |
---|
| 384 | |
---|
| 385 | if(CF_filenamopened.ne.FILEname) then |
---|
| 386 | call UNclose (fileid) |
---|
| 387 | endif |
---|
| 388 | |
---|
| 389 | END SUBROUTINE CF_READ2D |
---|
| 390 | |
---|
| 391 | C +-------------------------+-----------------------------------------+ |
---|
| 392 | C + Subroutine CF_READ3D : + Read variables + |
---|
| 393 | C +-------------------------+-----------------------------------------+ |
---|
| 394 | |
---|
| 395 | |
---|
| 396 | SUBROUTINE CF_READ3D (FILEname, VARname , itime, |
---|
| 397 | . Ni, Nj, Nlev, var) |
---|
| 398 | |
---|
| 399 | c Input : |
---|
| 400 | c ======= |
---|
| 401 | |
---|
| 402 | c FILEname = name of the netcdf file |
---|
| 403 | c VARname = name of variables |
---|
| 404 | c itime = index on time axis |
---|
| 405 | c Ni,Nj,Nlev = X,Y,Z dimension |
---|
| 406 | |
---|
| 407 | c Output : |
---|
| 408 | c ======== |
---|
| 409 | |
---|
| 410 | c var = array of vallues of the variable |
---|
| 411 | |
---|
| 412 | IMPLICIT NONE |
---|
| 413 | |
---|
| 414 | INCLUDE 'libUN.inc' |
---|
| 415 | |
---|
| 416 | CHARACTER *(*) FILEname,VARname |
---|
| 417 | CHARACTER*31 var_units,filetitle |
---|
| 418 | INTEGER Ni, Nj, Nlev,itime,level |
---|
| 419 | REAL*4 var(Ni, Nj,Nlev) |
---|
| 420 | |
---|
| 421 | INTEGER i,j,fileid |
---|
| 422 | |
---|
| 423 | if(CF_filenamopened.ne.FILEname) then |
---|
| 424 | CALL UNropen (FILEname,fileid,filetitle) |
---|
| 425 | else |
---|
| 426 | fileid = CF_fileidopened |
---|
| 427 | endif |
---|
| 428 | |
---|
| 429 | CALL UNsread (fileid, VARname, itime, 0, 1, 1, |
---|
| 430 | & Ni , Nj , Nlev,var_units, var) |
---|
| 431 | |
---|
| 432 | if(CF_filenamopened.ne.FILEname) then |
---|
| 433 | call UNclose (fileid) |
---|
| 434 | endif |
---|
| 435 | |
---|
| 436 | END SUBROUTINE CF_READ3D |
---|
| 437 | |
---|
| 438 | C** +------------------------+------------------------------------------+ |
---|
| 439 | C** + Subroutine CF_CLOSE : + Close the file + |
---|
| 440 | C** +------------------------+------------------------------------------+ |
---|
| 441 | |
---|
| 442 | SUBROUTINE CF_CLOSE (FILEname) |
---|
| 443 | |
---|
| 444 | IMPLICIT NONE |
---|
| 445 | |
---|
| 446 | INCLUDE 'libUN.inc' |
---|
| 447 | |
---|
| 448 | CHARACTER*(*) FILEname |
---|
| 449 | |
---|
| 450 | if(FILEname.eq.CF_filenamopened)then |
---|
| 451 | call UNclose (CF_fileidopened) |
---|
| 452 | else |
---|
| 453 | print *,FILEname//" not opened" |
---|
| 454 | endif |
---|
| 455 | |
---|
| 456 | CF_filenamopened = "" |
---|
| 457 | CF_fileidopened = 0 |
---|
| 458 | |
---|
| 459 | END SUBROUTINE CF_CLOSE |
---|
| 460 | |
---|
| 461 | C** +-----------------------+-------------------------------------------+ |
---|
| 462 | C** + Subroutine CF_OPEN : + open the file + |
---|
| 463 | C** +-----------------------+-------------------------------------------+ |
---|
| 464 | |
---|
| 465 | SUBROUTINE CF_OPEN (FILEname,FILEid) |
---|
| 466 | |
---|
| 467 | IMPLICIT NONE |
---|
| 468 | |
---|
| 469 | INCLUDE 'libUN.inc' |
---|
| 470 | |
---|
| 471 | INTEGER FILEid |
---|
| 472 | |
---|
| 473 | CHARACTER*(*) FILEname |
---|
| 474 | |
---|
| 475 | call UNwopen (FILEname,FILEid) |
---|
| 476 | |
---|
| 477 | CF_filenamopened = FILEname |
---|
| 478 | |
---|
| 479 | CF_fileidopened = FILEid |
---|
| 480 | |
---|
| 481 | END SUBROUTINE CF_OPEN |
---|
| 482 | |
---|
| 483 | C** +-------------------------+-----------------------------------------+ |
---|
| 484 | C** + Subroutine UNscreate : + + |
---|
| 485 | C** +-------------------------+ + |
---|
| 486 | C** + * Purpose : + |
---|
| 487 | C** + Create a NetCDF file, general version. + |
---|
| 488 | C** + (Staggered grids + other extensions to UNcreate) + |
---|
| 489 | C** + + |
---|
| 490 | C** + * How it works : calling routine must provide + |
---|
| 491 | C** + -a list of dimensions + |
---|
| 492 | C** + (size of each dimens., names, units and values of coordinates)+ |
---|
| 493 | C** + -a list of variables + |
---|
| 494 | C** + (units, number of dimensions, names of selected dimensions) + |
---|
| 495 | C** + + |
---|
| 496 | C** + INPUT : + |
---|
| 497 | C** + ------- + |
---|
| 498 | C** + + |
---|
| 499 | C** + General : + |
---|
| 500 | C** + FILEnam [char]: Name of the file to be created. + |
---|
| 501 | C** + title [char]: Title attribute + |
---|
| 502 | C** + + |
---|
| 503 | C** + Dimensions: + |
---|
| 504 | C** + TND : Total Number of SPATIAL dimensions + |
---|
| 505 | C** + Notice : Set "time" to dimension No 0 + |
---|
| 506 | C** + DFdim(0:TND) : # discrete values for each dimension + |
---|
| 507 | C** + Notice : DFdim(0).eq.0 + |
---|
| 508 | C** + -> UNLIMITED TIME (coord. not defined) + |
---|
| 509 | C** + WARNING: In this case, the NetCDF + |
---|
| 510 | C** + use a temporary space to duplicate + |
---|
| 511 | C** + the file -> NOT RECOMMENDED + |
---|
| 512 | C** + MXdim : Maximum value of DFdim, = arrays size + |
---|
| 513 | C** + NAMdim(0:TND) [char]: Name of dimensions, except time + |
---|
| 514 | C** + UNIdim(0:TND) [char]: Units of dimensions (attribute) + |
---|
| 515 | C** + VALdim(MXdim,0:TND)[R4]: Values of coordinate for each dimension+ |
---|
| 516 | C** + + |
---|
| 517 | C** + Variables: + |
---|
| 518 | C** + Dvs : Variable's definitions array sizes, + |
---|
| 519 | C** + Nvs : Number of defined variables(Nvs.le.Dvs)+ |
---|
| 520 | C** + name_vs (Dvs) [char]: name of variable. + |
---|
| 521 | C** + unit_vs (Dvs) [char]: physical units of variable (attribute) + |
---|
| 522 | C** + Sdim_vs (4,Dvs) [char]: name of Selected dims (in above list) + |
---|
| 523 | C** + Blanked or '-' elements = not used + |
---|
| 524 | C** + lnam_vs (Dvs) [char]: Long_name attribute (descript. of var.)+ |
---|
| 525 | C** + + |
---|
| 526 | C** + List of real attributes to all variables: + |
---|
| 527 | C** + Nra : Number of Real Attributes (.ge.1 !) + |
---|
| 528 | C** + NAMrat(Nra) [char]: NAMes of Real ATtributes (''=none) + |
---|
| 529 | C** + (initial value= 0; set it with UNwratt)+ |
---|
| 530 | C** + Nvals(Nra) : Number of values of these attributes. + |
---|
| 531 | C** + ! Currently limited to 1 value (scalar) or 2 (2 elements vector)+ |
---|
| 532 | C** + ! EXCEPTION: Setting the last attribute name to '[var]_range' + |
---|
| 533 | C** + does create a variable (!) for level-by-level range+ |
---|
| 534 | C** + (very usefull for 3D + time fields) + |
---|
| 535 | C** + + |
---|
| 536 | C** + NB : [char] variables may have any length. + |
---|
| 537 | C** + blanks characters are NOT ALLOWED in any variable, + |
---|
| 538 | C** + except the "title". + |
---|
| 539 | C** + and the NetCDF variables defined here are always real*4 + |
---|
| 540 | C** + + |
---|
| 541 | C** + OUTPUT : + |
---|
| 542 | C** + -------- + |
---|
| 543 | C** + FILEid : Index of the NetCDF file (remains open)+ |
---|
| 544 | C** +-------------------------------------------------------------------+ |
---|
| 545 | |
---|
| 546 | SUBROUTINE UNscreate (FILEnam, title, |
---|
| 547 | & TND, DFdim, MXdim, NAMdim, UNIdim, VALdim, |
---|
| 548 | & Dvs, Nvs, name_vs, Sdim_vs, unit_vs, lnam_vs, |
---|
| 549 | & Nra, NAMrat, Nvals, |
---|
| 550 | & FILEid ) |
---|
| 551 | |
---|
| 552 | C + |
---|
| 553 | IMPLICIT NONE |
---|
| 554 | |
---|
| 555 | INCLUDE 'libUN.inc' |
---|
| 556 | |
---|
| 557 | C + |
---|
| 558 | INTEGER icheck, MXND |
---|
| 559 | C ** Maximum number of dimensions |
---|
| 560 | parameter (MXND = 100) |
---|
| 561 | |
---|
| 562 | C + INPUT: |
---|
| 563 | C + - - - |
---|
| 564 | CHARACTER *(*) FILEnam |
---|
| 565 | CHARACTER *(*) title |
---|
| 566 | |
---|
| 567 | INTEGER TND, DFdim(0:TND), MXdim |
---|
| 568 | CHARACTER *(*) NAMdim(0:TND) |
---|
| 569 | CHARACTER *(*) UNIdim(0:TND) |
---|
| 570 | REAL*4 VALdim(MXdim,0:TND) |
---|
| 571 | |
---|
| 572 | INTEGER Nvs, Dvs |
---|
| 573 | CHARACTER *(*) name_vs(Dvs) |
---|
| 574 | CHARACTER *(*) Sdim_vs(4,Dvs) |
---|
| 575 | CHARACTER *(*) unit_vs(Dvs) |
---|
| 576 | CHARACTER *(*) lnam_vs(Dvs) |
---|
| 577 | |
---|
| 578 | INTEGER Nra |
---|
| 579 | CHARACTER *(*) NAMrat(Nra) |
---|
| 580 | CHARACTER*24 Host,Fdate |
---|
| 581 | CHARACTER*200 tmpchar |
---|
| 582 | INTEGER Nvals(Nra) |
---|
| 583 | |
---|
| 584 | C + OUTPUT: |
---|
| 585 | C + - - - - |
---|
| 586 | INTEGER FILEid |
---|
| 587 | |
---|
| 588 | C + LOCAL: |
---|
| 589 | C + - - - |
---|
| 590 | INTEGER VARSIZE |
---|
| 591 | EXTERNAL VARSIZE |
---|
| 592 | CHARACTER*(30) tmpchr |
---|
| 593 | INTEGER dimDID(0:MXND) |
---|
| 594 | INTEGER dimVID(0:MXND), vsVID, vrVID |
---|
| 595 | INTEGER dID(4), start(4), count(4), rdID(2) |
---|
| 596 | INTEGER mimaID |
---|
| 597 | INTEGER stride(4),imap(4) |
---|
| 598 | INTEGER Ndim_vs |
---|
| 599 | INTEGER ivs, igd, idi, ira, itmp |
---|
| 600 | INTEGER Nlen |
---|
| 601 | INTEGER dNlen(0:MXND) |
---|
| 602 | INTEGER Ierro, TTerr, ii,jj |
---|
| 603 | REAL*4 zero1(1), zero2(2) |
---|
| 604 | |
---|
| 605 | icheck= 0 !Debugging level |
---|
| 606 | |
---|
| 607 | |
---|
| 608 | C* 0. Initialisations |
---|
| 609 | C ------------------ |
---|
| 610 | IF (icheck.ge.1) WRITE(*,*) 'UNscreate : Begin' |
---|
| 611 | |
---|
| 612 | C + Routines which opens a file must reset libUN internals: |
---|
| 613 | CALL UNparam('RESET_PARAMS_',0.0) |
---|
| 614 | |
---|
| 615 | DO ii = 1,4 |
---|
| 616 | stride(ii) = 1 |
---|
| 617 | ENDDO |
---|
| 618 | zero1(1) = 0. |
---|
| 619 | zero2(1) = 0. |
---|
| 620 | zero2(2) = 0. |
---|
| 621 | TTerr = 0 !Total of error flags |
---|
| 622 | |
---|
| 623 | IF (TND .gt. MXND) THEN |
---|
| 624 | write(*,*)'UNscreate - Error: so much dimensions ?',TND |
---|
| 625 | END IF |
---|
| 626 | |
---|
| 627 | C Create a NetCDF file and enter define mode : |
---|
| 628 | C -------------------------------------------- |
---|
| 629 | IF (icheck.ge.2) WRITE(*,*) 'FILEnam :', FILEnam |
---|
| 630 | |
---|
| 631 | C ** getting FILEnam [char] size : |
---|
| 632 | Nlen = VARSIZE(FILEnam) |
---|
| 633 | |
---|
| 634 | Ierro=NF_CREATE(FILEnam(1:Nlen), NF_CLOBBER , FILEid) |
---|
| 635 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 636 | C ** identif. =>overwrite =error |
---|
| 637 | |
---|
| 638 | C* Time coordinate definition. |
---|
| 639 | C --------------------------- |
---|
| 640 | |
---|
| 641 | C ** Define dimension : |
---|
| 642 | IF (icheck.ge.3) WRITE(*,*) '# time iters.:', DFdim(0) |
---|
| 643 | IF (DFdim(0).eq.0.) THEN |
---|
| 644 | Ierro=NF_DEF_DIM(FILEid , 'time', NF_UNLIMITED, dimDID(0)) |
---|
| 645 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 646 | TTerr = TTerr + ABS(Ierro) |
---|
| 647 | ELSE |
---|
| 648 | Ierro=NF_DEF_DIM(FILEid , 'time', DFdim(0), dimDID(0)) |
---|
| 649 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 650 | TTerr = TTerr + ABS(Ierro) |
---|
| 651 | END IF |
---|
| 652 | dNlen(0)= 4 ! 4 characters in the name 'time'... |
---|
| 653 | IF (NAMdim(0)(1:4).ne.'time') THEN |
---|
| 654 | WRITE(*,*) 'Sorry, NAMdim(0) must be ''time'' .' |
---|
| 655 | STOP |
---|
| 656 | END IF |
---|
| 657 | |
---|
| 658 | C ** Define variable for the time coordinate values : |
---|
| 659 | dID(1) = dimDID(0) |
---|
| 660 | Ierro=NF_DEF_VAR(FILEid , 'time', NF_FLOAT,1 , dID, dimVID(0)) |
---|
| 661 | C ** ^^^^^^^^^^ FILEid var name type dims DIMid VARid |
---|
| 662 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 663 | TTerr = TTerr + ABS(Ierro) |
---|
| 664 | |
---|
| 665 | |
---|
| 666 | C Spatial coordinates definitions : DIMS and VARs (locations). |
---|
| 667 | C ------------------------------------------------------------ |
---|
| 668 | C |
---|
| 669 | DO igd = 1,TND !** BEGIN LOOP over all spatial dims |
---|
| 670 | IF (icheck.ge.3) WRITE(*,*) ' spatial dim:', NAMdim(igd) |
---|
| 671 | |
---|
| 672 | C ** getting NAMdim [char] size : |
---|
| 673 | Nlen = VARSIZE(NAMdim(igd)) |
---|
| 674 | dNlen(igd) = Nlen !For further use of NAMdim |
---|
| 675 | |
---|
| 676 | Ierro=NF_DEF_DIM(FILEid , NAMdim(igd)(1:Nlen), |
---|
| 677 | & DFdim(igd),dimDID(igd)) |
---|
| 678 | C **line1 ^^^^^^^^^^ FILEid | dim name |
---|
| 679 | C **line2 # values | VARid |
---|
| 680 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 681 | TTerr = TTerr + ABS(Ierro) |
---|
| 682 | |
---|
| 683 | dID(1) = dimDID(igd) |
---|
| 684 | Ierro=NF_DEF_VAR(FILEid , NAMdim(igd)(1:Nlen), |
---|
| 685 | & NF_FLOAT , 1 , dID ,dimVID(igd)) |
---|
| 686 | C **line1 ^^^^^^^^^^ FILEid | dim name |
---|
| 687 | C **line2 type | #dims | dimsIDs | VARid |
---|
| 688 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 689 | TTerr = TTerr + ABS(Ierro) |
---|
| 690 | |
---|
| 691 | END DO !** END LOOP over all spatial dims |
---|
| 692 | |
---|
| 693 | C Special coordinate definition: MinMax (for [var]_range) |
---|
| 694 | C ------------------------------------------------------- |
---|
| 695 | IF (NAMrat(Nra)(1:11).eq.'[var]_range') THEN |
---|
| 696 | |
---|
| 697 | Ierro=NF_DEF_DIM(FILEid, 'MinMax', 2, mimaID) |
---|
| 698 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 699 | ENDIF |
---|
| 700 | |
---|
| 701 | C Define the fields. |
---|
| 702 | C ------------------ |
---|
| 703 | |
---|
| 704 | DO ivs = 1,Nvs !**BEGIN LOOP on var. num. |
---|
| 705 | IF (icheck.ge.3) |
---|
| 706 | & WRITE (*,*) 'Defining variable ',name_vs(ivs) |
---|
| 707 | |
---|
| 708 | |
---|
| 709 | C Set space and time dimensions |
---|
| 710 | C - - - - - - - - - - - - - - - |
---|
| 711 | C ** Initialise number of dimensions : |
---|
| 712 | Ndim_vs= 0 |
---|
| 713 | |
---|
| 714 | DO idi = 1, 4 !** BEGIN LOOP on var dims. |
---|
| 715 | IF (Sdim_vs(idi,ivs)(1:1).ne.' ' |
---|
| 716 | & .and.Sdim_vs(idi,ivs)(1:1).ne.'-') THEN !**skip undefined. |
---|
| 717 | |
---|
| 718 | C ** getting Sdim_vs [char] size : |
---|
| 719 | Nlen = VARSIZE(Sdim_vs(idi,ivs)) |
---|
| 720 | |
---|
| 721 | C ** Searching for the dimension index from its name (Sdim_vs) |
---|
| 722 | igd = 0 |
---|
| 723 | DO WHILE (Sdim_vs(idi,ivs)(1:Nlen) |
---|
| 724 | & .ne. NAMdim(igd)(1:dNlen(igd)) ) |
---|
| 725 | IF (igd.eq.TND) THEN |
---|
| 726 | write(*,*)'UNscreate-ERROR: Dimension not found:', |
---|
| 727 | & Sdim_vs(idi,ivs)(1:Nlen) |
---|
| 728 | STOP |
---|
| 729 | END IF |
---|
| 730 | igd = igd + 1 |
---|
| 731 | END DO |
---|
| 732 | C ** Construct the dimensions id's for that variable (ivs): |
---|
| 733 | IF (icheck.ge.3) |
---|
| 734 | & WRITE (*,*) 'using dimension ',NAMdim(igd), dimDID(igd) |
---|
| 735 | Ndim_vs = Ndim_vs + 1 |
---|
| 736 | dID(Ndim_vs) = dimDID(igd) |
---|
| 737 | |
---|
| 738 | END IF |
---|
| 739 | END DO !** END LOOP on var dims. |
---|
| 740 | |
---|
| 741 | C Define our special [var]_range field for 4D variables |
---|
| 742 | C - - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 743 | IF (Ndim_vs.eq.4 |
---|
| 744 | & .and.NAMrat(Nra)(1:11).eq.'[var]_range') THEN |
---|
| 745 | |
---|
| 746 | Nlen = VARSIZE(name_vs(ivs)) |
---|
| 747 | rdID(1) = dID (3) !(4D variable, 3th dim = level) |
---|
| 748 | rdID(2) = mimaID !(for min, max) |
---|
| 749 | tmpchr = name_vs(ivs)(1:Nlen)//'_range' |
---|
| 750 | itmp = Nlen + 6 |
---|
| 751 | Ierro = NF_DEF_VAR(FILEid,tmpchr(1:itmp), |
---|
| 752 | & NF_FLOAT, 2, rdID, vrVID) |
---|
| 753 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 754 | TTerr = TTerr + ABS(Ierro) |
---|
| 755 | |
---|
| 756 | ENDIF |
---|
| 757 | |
---|
| 758 | C Define fields : |
---|
| 759 | C - - - - - - - - |
---|
| 760 | Nlen = VARSIZE(name_vs(ivs)) |
---|
| 761 | Ierro=NF_DEF_VAR(FILEid , name_vs(ivs)(1:Nlen), |
---|
| 762 | & NF_FLOAT, Ndim_vs, dID , vsVID) |
---|
| 763 | C **line1 ^^^^^^^^^^ FILEid | variable name |
---|
| 764 | C **line2 type | #dims | dimsIDs | VARid |
---|
| 765 | IF (Ierro.NE.NF_NOERR) |
---|
| 766 | & CALL HANDLE_ERR('UNscreate (field)', Ierro) |
---|
| 767 | TTerr = TTerr + ABS(Ierro) |
---|
| 768 | |
---|
| 769 | |
---|
| 770 | C Set the variable's attributes : |
---|
| 771 | C ------------------------------- |
---|
| 772 | |
---|
| 773 | C ** Units: |
---|
| 774 | C - - - - - |
---|
| 775 | C ** getting unit_vs [char] size : |
---|
| 776 | Nlen = VARSIZE(unit_vs(ivs)) |
---|
| 777 | |
---|
| 778 | Ierro= NF_PUT_ATT_TEXT(FILEid , vsVID ,'units', |
---|
| 779 | & Nlen ,unit_vs(ivs)(1:Nlen)) |
---|
| 780 | c **line1 ^^^^^^^^^^^^^^^ FILEid |var.id | attr.name |
---|
| 781 | C **line2 length | attr.value |
---|
| 782 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 783 | TTerr = TTerr + ABS(Ierro) |
---|
| 784 | |
---|
| 785 | C ** Special case : units = sigma |
---|
| 786 | C - - - - - - - - - - - - - - - - |
---|
| 787 | C In this case, CV convention advises to write the following |
---|
| 788 | C attribute : positive = down |
---|
| 789 | C |
---|
| 790 | Nlen = VARSIZE(lnam_vs(ivs)) |
---|
| 791 | |
---|
| 792 | IF ( unit_vs(ivs)(1:Nlen) .EQ. '[sigma]' |
---|
| 793 | & .OR. unit_vs(ivs)(1:Nlen) .EQ. 'sigma_level' ) THEN |
---|
| 794 | IF (icheck.ge.3) THEN |
---|
| 795 | WRITE(*,*) 'Unit = sigma -> setting positive attr' |
---|
| 796 | ENDIF |
---|
| 797 | |
---|
| 798 | Ierro= NF_PUT_ATT_TEXT(FILEid , vsVID ,'positive', |
---|
| 799 | & 4 ,'down') |
---|
| 800 | c **line1 ^^^^^^^^^^^^^^^ FILEid |var.id | attr.name |
---|
| 801 | C **line2 length | attr.value |
---|
| 802 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 803 | ENDIF |
---|
| 804 | |
---|
| 805 | C ** "long_name": |
---|
| 806 | C - - - - - - - - |
---|
| 807 | Nlen = VARSIZE(lnam_vs(ivs)) |
---|
| 808 | |
---|
| 809 | IF (icheck.ge.3) |
---|
| 810 | & WRITE (*,*) 'Write long_name ',lnam_vs(ivs)(1:Nlen) |
---|
| 811 | |
---|
| 812 | Ierro=NF_PUT_ATT_TEXT(FILEid , vsVID ,'long_name', |
---|
| 813 | & Nlen ,lnam_vs(ivs)(1:Nlen) ) |
---|
| 814 | |
---|
| 815 | do jj=1,Nlen |
---|
| 816 | if(lnam_vs(ivs)(jj:jj).eq." ") lnam_vs(ivs)(jj:jj)="_" |
---|
| 817 | if(lnam_vs(ivs)(jj:jj).eq.".") lnam_vs(ivs)(jj:jj)="_" |
---|
| 818 | if(lnam_vs(ivs)(jj:jj).eq."(") lnam_vs(ivs)(jj:jj)="_" |
---|
| 819 | if(lnam_vs(ivs)(jj:jj).eq.")") lnam_vs(ivs)(jj:jj)="_" |
---|
| 820 | if(lnam_vs(ivs)(jj:jj).eq."/") lnam_vs(ivs)(jj:jj)="_" |
---|
| 821 | enddo |
---|
| 822 | |
---|
| 823 | Ierro=NF_PUT_ATT_TEXT(FILEid , vsVID ,'standard_name', |
---|
| 824 | & Nlen ,lnam_vs(ivs)(1:Nlen) ) |
---|
| 825 | |
---|
| 826 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 827 | TTerr = TTerr + ABS(Ierro) |
---|
| 828 | |
---|
| 829 | |
---|
| 830 | C ** From the list of real attributes (input argument) : |
---|
| 831 | C - - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 832 | C |
---|
| 833 | DO ira = 1, Nra |
---|
| 834 | IF (NAMrat(ira)(1:1).ne.' ') THEN |
---|
| 835 | IF (NAMrat(ira)(1:11).eq.'valid_range') THEN |
---|
| 836 | |
---|
| 837 | C ** The "valid_range" special attribute : |
---|
| 838 | Ierro=NF_PUT_ATT_REAL(FILEid ,vsVID ,'valid_range' , |
---|
| 839 | & NF_FLOAT,2 , ValRange) |
---|
| 840 | TTerr = TTerr + ABS(Ierro) |
---|
| 841 | |
---|
| 842 | ELSE IF (NAMrat(ira)(1:11).ne.'[var]_range') THEN |
---|
| 843 | |
---|
| 844 | C ** All "regular" attributes : |
---|
| 845 | Nlen = VARSIZE(NAMrat(ira)) |
---|
| 846 | IF (Nvals(ira).eq.1) THEN |
---|
| 847 | Ierro=NF_PUT_ATT_REAL(FILEid,vsVID,NAMrat(ira)(1:Nlen), |
---|
| 848 | & NF_FLOAT, Nvals , zero1 ) |
---|
| 849 | TTerr = TTerr + ABS(Ierro) |
---|
| 850 | ELSE IF (Nvals(ira).eq.2) THEN |
---|
| 851 | Ierro=NF_PUT_ATT_REAL(FILEid,vsVID,NAMrat(ira)(1:Nlen), |
---|
| 852 | & NF_FLOAT, Nvals , zero2 ) |
---|
| 853 | TTerr = TTerr + ABS(Ierro) |
---|
| 854 | c |
---|
| 855 | END IF |
---|
| 856 | END IF |
---|
| 857 | END IF |
---|
| 858 | END DO |
---|
| 859 | |
---|
| 860 | END DO ! **END LOOP on var. num. |
---|
| 861 | |
---|
| 862 | C Set 'unit' attribute for the dimensions: |
---|
| 863 | C ---------------------------------------- |
---|
| 864 | |
---|
| 865 | DO igd = 0,TND !** BEGIN LOOP over all spatial dims |
---|
| 866 | |
---|
| 867 | C ** getting NAMdim [char] size : |
---|
| 868 | Nlen = VARSIZE(UNIdim(igd)) |
---|
| 869 | |
---|
| 870 | Ierro=NF_PUT_ATT_TEXT(FILEid , dimVID(igd),'units', |
---|
| 871 | & Nlen , UNIdim(igd) ) |
---|
| 872 | |
---|
| 873 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 874 | |
---|
| 875 | Nlen = VARSIZE(NAMdim(igd)) |
---|
| 876 | |
---|
| 877 | Ierro=NF_PUT_ATT_TEXT(FILEid , dimVID(igd),'long_name', |
---|
| 878 | & Nlen , NAMdim(igd) ) |
---|
| 879 | |
---|
| 880 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 881 | |
---|
| 882 | Ierro=NF_PUT_ATT_TEXT(FILEid , dimVID(igd),'standard_name', |
---|
| 883 | & Nlen , NAMdim(igd) ) |
---|
| 884 | |
---|
| 885 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 886 | TTerr = TTerr + ABS(Ierro) |
---|
| 887 | |
---|
| 888 | ENDDO |
---|
| 889 | |
---|
| 890 | C Global attribute(s). |
---|
| 891 | C -------------------- |
---|
| 892 | |
---|
| 893 | C ** Title (some general file descriptor) : |
---|
| 894 | C ** getting unit_vs [char] size : |
---|
| 895 | |
---|
| 896 | Nlen = VARSIZE(title) |
---|
| 897 | |
---|
| 898 | Ierro=NF_PUT_ATT_TEXT(FILEid ,NF_GLOBAL,'title', |
---|
| 899 | & Nlen ,title(1:Nlen) ) |
---|
| 900 | |
---|
| 901 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 902 | |
---|
| 903 | |
---|
| 904 | Nlen = VARSIZE(CF_institution) |
---|
| 905 | |
---|
| 906 | Ierro=NF_PUT_ATT_TEXT(FILEid ,NF_GLOBAL,'institution', |
---|
| 907 | & Nlen ,CF_institution) |
---|
| 908 | |
---|
| 909 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 910 | |
---|
| 911 | c CALL HostNm(Host, Ierro) |
---|
| 912 | |
---|
| 913 | tmpchar="libUN ("//CF_libUN_version//") - "//FDate() |
---|
| 914 | c & " - "//Host |
---|
| 915 | |
---|
| 916 | Nlen = VARSIZE(tmpchar) |
---|
| 917 | |
---|
| 918 | Ierro=NF_PUT_ATT_TEXT(FILEid ,NF_GLOBAL,'history', |
---|
| 919 | & Nlen ,tmpchar) |
---|
| 920 | |
---|
| 921 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 922 | |
---|
| 923 | |
---|
| 924 | Nlen = VARSIZE(NF_INQ_LIBVERS()) |
---|
| 925 | |
---|
| 926 | Ierro=NF_PUT_ATT_TEXT(FILEid ,NF_GLOBAL,'netcdf', |
---|
| 927 | & Nlen ,NF_INQ_LIBVERS()) |
---|
| 928 | |
---|
| 929 | |
---|
| 930 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 931 | TTerr = TTerr + ABS(Ierro) |
---|
| 932 | |
---|
| 933 | |
---|
| 934 | C Leave define mode (!file remains open ) |
---|
| 935 | C --------------------------------------- |
---|
| 936 | Ierro=NF_ENDDEF(FILEid) |
---|
| 937 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 938 | TTerr = TTerr + ABS(Ierro) |
---|
| 939 | |
---|
| 940 | |
---|
| 941 | C Writing of dimensions coordinates. |
---|
| 942 | C ---------------------------------- |
---|
| 943 | |
---|
| 944 | C ** Time : |
---|
| 945 | C - - - - - |
---|
| 946 | |
---|
| 947 | start(1)= 1 !Vector of starting indexes values |
---|
| 948 | count(1)= DFdim(0) !Vector of total # indexes values |
---|
| 949 | IF (icheck.ge.3) |
---|
| 950 | & WRITE (*,*) 'Write coords for ',NAMdim(0),count(1) |
---|
| 951 | |
---|
| 952 | C ** Set 'imap' to write with NCVPTG; NCVPT could be enough ? |
---|
| 953 | C ** (imap tells NetCDF about the memory locations of var, |
---|
| 954 | C ** we choose NCVPTG because |
---|
| 955 | C ** only a portion of VALdim is written.) |
---|
| 956 | imap(1) = 1 |
---|
| 957 | imap(2) = 0 ! Not used : write only 1 coord. |
---|
| 958 | |
---|
| 959 | Ierro=NF_PUT_VARM_REAL(FILEid ,dimVID(0), start , count, |
---|
| 960 | & stride , imap , VALdim(1,0) ) |
---|
| 961 | C **line 1 ^^^^^^^^^^^^^^^ ID file| id var. |read from... |#data |
---|
| 962 | C **line 2 step |re-arrang|variable(beg.) |
---|
| 963 | C ** (^^^^stride is not used) |
---|
| 964 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 965 | |
---|
| 966 | |
---|
| 967 | C ** Space coordinates : |
---|
| 968 | C - - - - - - - - - - - - |
---|
| 969 | |
---|
| 970 | DO igd = 1,TND !** BEGIN LOOP over all spatial dims |
---|
| 971 | |
---|
| 972 | start(1)= 1 |
---|
| 973 | count(1)= DFdim(igd) |
---|
| 974 | IF (icheck.ge.3) |
---|
| 975 | & WRITE (*,*) 'Write coords for ',NAMdim(igd),count(1) |
---|
| 976 | |
---|
| 977 | |
---|
| 978 | Ierro=NF_PUT_VARM_REAL(FILEid ,dimVID(igd),start , count, |
---|
| 979 | & stride , imap ,VALdim(1,igd)) |
---|
| 980 | C ** ^^^^^^^^^^^^^^^^ see above |
---|
| 981 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNscreate', Ierro) |
---|
| 982 | |
---|
| 983 | TTerr = TTerr + ABS(Ierro) |
---|
| 984 | |
---|
| 985 | END DO !** END LOOP over all spatial dims |
---|
| 986 | |
---|
| 987 | C Stop if an error occured. |
---|
| 988 | C ------------------------- |
---|
| 989 | |
---|
| 990 | IF (TTerr.ne.0) THEN |
---|
| 991 | STOP 'UNscreate : Sorry, an error occured.' |
---|
| 992 | ENDIF |
---|
| 993 | |
---|
| 994 | C + |
---|
| 995 | RETURN |
---|
| 996 | END SUBROUTINE UNscreate |
---|
| 997 | |
---|
| 998 | C** +-------------------------+-----------------------------------------+ |
---|
| 999 | C** + Subroutine UNwrite : + + |
---|
| 1000 | C** +-------------------------+ + |
---|
| 1001 | C** + * Writes a variable into a NetCDF file, + |
---|
| 1002 | C** + (the NetCDF file must have been created (or re-opened) and + |
---|
| 1003 | C** + closed after all writing operations). + |
---|
| 1004 | C** + * Automatically updates attribute 'actual_range' if available + |
---|
| 1005 | C** + " " special var. '[var]_range' " + |
---|
| 1006 | C** + + |
---|
| 1007 | C** + INPUT : + |
---|
| 1008 | C** + FILEid : input file identifier (from UNcreate OR NetCDF open) + |
---|
| 1009 | C** + VARname : name given to the variable to write (must be in file)+ |
---|
| 1010 | C** + itime : No of time step to write to + |
---|
| 1011 | C** + Ni,Nj,Nlev: dimensions of 'var' + |
---|
| 1012 | C** + ! Nlev= 1 for 2D and 1D input variables. + |
---|
| 1013 | C** + Nj = 1 for 1D input variables. + |
---|
| 1014 | C** + NB: can not write 1 level of 3D var only (->UNlwrite)+ |
---|
| 1015 | C** + + |
---|
| 1016 | C** + var : The variable to be writen + |
---|
| 1017 | C** + + |
---|
| 1018 | C** + REMARK : + |
---|
| 1019 | C** + Truncation of input data is permited: + |
---|
| 1020 | C** + If the dim of "var" > dim in the NetCDF file, + |
---|
| 1021 | C** + "var" is automatically truncted. However, this => WARNING + |
---|
| 1022 | C** + message, UNLESS a specific truncation was "announced" + |
---|
| 1023 | C** + in var: + |
---|
| 1024 | C** + To truncate the first dim to Li, let var(Ni,1,1) = Li + |
---|
| 1025 | C** + To truncate the 2nd dim to Lj, let var(1,Nj,1) = Lj + |
---|
| 1026 | C** + ... (this has no effect exept cancel the "WARNING" message) + |
---|
| 1027 | C** +-------------------------------------------------------------------+ |
---|
| 1028 | |
---|
| 1029 | SUBROUTINE UNwrite (FILEid , VARname , itime, |
---|
| 1030 | & Ni, Nj, Nlev, var) |
---|
| 1031 | |
---|
| 1032 | IMPLICIT NONE |
---|
| 1033 | |
---|
| 1034 | INCLUDE 'libUN.inc' |
---|
| 1035 | |
---|
| 1036 | INTEGER icheck |
---|
| 1037 | |
---|
| 1038 | INTEGER Lvnam |
---|
| 1039 | PARAMETER (Lvnam=20) |
---|
| 1040 | |
---|
| 1041 | C ** input |
---|
| 1042 | INTEGER FILEid |
---|
| 1043 | INTEGER itime |
---|
| 1044 | INTEGER Ni, Nj, Nlev |
---|
| 1045 | CHARACTER *(*) VARname |
---|
| 1046 | REAL*4 var(Ni, Nj, Nlev) |
---|
| 1047 | |
---|
| 1048 | C ** local : |
---|
| 1049 | INTEGER MXlv |
---|
| 1050 | PARAMETER (MXlv=500) |
---|
| 1051 | C ^^^^Maximal # levels for a special output |
---|
| 1052 | INTEGER VARSIZE |
---|
| 1053 | EXTERNAL VARSIZE |
---|
| 1054 | INTEGER NVRi, NVRj, NVRlev |
---|
| 1055 | INTEGER Ierro, TTerr, Nvatts, vtype |
---|
| 1056 | INTEGER dimID(4), dimSIZ(4), count(4) |
---|
| 1057 | INTEGER start(4),stride(4),imap(4) |
---|
| 1058 | CHARACTER*(Lvnam) dimNAM(4) |
---|
| 1059 | CHARACTER*(Lvnam) recname |
---|
| 1060 | CHARACTER*(30) tmpchr |
---|
| 1061 | INTEGER varVID |
---|
| 1062 | INTEGER VNlen, NDIMvar, NSDIvar, tiDI, itmp |
---|
| 1063 | INTEGER iz, ii, jj, ll |
---|
| 1064 | INTEGER iUNLIMDIM |
---|
| 1065 | REAL*4 chkdim |
---|
| 1066 | REAL*4 Arange(2),sValRange(2) |
---|
| 1067 | REAL*4 Srange(MXlv,2) |
---|
| 1068 | LOGICAL OkRange |
---|
| 1069 | |
---|
| 1070 | icheck= 0 !** 'debugging' level |
---|
| 1071 | TTerr = 0 !** 'total number of errors |
---|
| 1072 | |
---|
| 1073 | IF (icheck.ge.1) WRITE(*,*) 'UNwrite : Begin' |
---|
| 1074 | |
---|
| 1075 | C* 1. Get the variable field and dims IDs |
---|
| 1076 | C ---------------------------------------- |
---|
| 1077 | |
---|
| 1078 | IF (icheck.ge.2) WRITE(*,*) 'FILEid :', FILEid |
---|
| 1079 | |
---|
| 1080 | C ** getting VARname size : |
---|
| 1081 | VNlen = VARSIZE (VARname) |
---|
| 1082 | IF (icheck.ge.3) WRITE(*,*) 'VNlen :', VNlen |
---|
| 1083 | IF (icheck.ge.2) WRITE(*,*) 'VARname :', VARname (1:VNlen) |
---|
| 1084 | |
---|
| 1085 | C ** variable field ID : |
---|
| 1086 | Ierro=NF_INQ_VARID (FILEid, VARname (1:VNlen), varVID) |
---|
| 1087 | |
---|
| 1088 | C ** Cancel writing if an error occured : variable undefined ? |
---|
| 1089 | IF (Ierro.ne.0.and.icheck.ge.1) THEN |
---|
| 1090 | WRITE(*,*) 'UNwrite Info : Variable ',VARname(1:VNlen) |
---|
| 1091 | & ,' not found -> not written.' |
---|
| 1092 | END IF |
---|
| 1093 | IF (Ierro.ne.0) GOTO 9999 !** UNwrite_end |
---|
| 1094 | |
---|
| 1095 | |
---|
| 1096 | C ** Inquire about the number of dimensions in var : |
---|
| 1097 | C ** |
---|
| 1098 | Ierro=NF_INQ_VAR(FILEid , varVID, recname, vtype, |
---|
| 1099 | & NDIMvar, dimID, Nvatts) |
---|
| 1100 | C ** line1 id/file id/var var name var type |
---|
| 1101 | C ** line2 # dims id/dims #attributes |
---|
| 1102 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwrite', Ierro) |
---|
| 1103 | |
---|
| 1104 | IF (icheck.ge.2) WRITE(*,*) 'Ierro1. ', Ierro |
---|
| 1105 | |
---|
| 1106 | |
---|
| 1107 | C* 2. Dimensions : inquire about file + compare with input data. |
---|
| 1108 | C ------------------------------------------------------------- |
---|
| 1109 | |
---|
| 1110 | C 2.1 Inquire dimensions names and sizes : |
---|
| 1111 | C + - - - - - - - - - - - - - - - - - - - - - |
---|
| 1112 | DO iz = 1,4 |
---|
| 1113 | dimSIZ(iz)=0 |
---|
| 1114 | dimNAM(iz)=' ' |
---|
| 1115 | C ** Set any unused dimension to "0" size / no name |
---|
| 1116 | END DO |
---|
| 1117 | DO iz = 1,NDIMvar |
---|
| 1118 | Ierro=NF_INQ_DIM(FILEid , dimID(iz), dimNAM(iz), dimSIZ(iz)) |
---|
| 1119 | C ** id/file id/dim dimname dimsize |
---|
| 1120 | C ** !output output |
---|
| 1121 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwrite', Ierro) |
---|
| 1122 | END DO |
---|
| 1123 | IF (icheck.ge.3) WRITE(*,*) 'NDIMvar ',NDIMvar |
---|
| 1124 | IF (icheck.ge.3) WRITE(*,*) 'Ierro 2.0',Ierro |
---|
| 1125 | |
---|
| 1126 | C 2.2 Set writing region according to field dimension : 2D or 3D |
---|
| 1127 | C + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1128 | C ** Set horizontal dimensions (default, for most data) : |
---|
| 1129 | count(1) = Ni |
---|
| 1130 | count(2) = Nj |
---|
| 1131 | C + ** Other default values: |
---|
| 1132 | count(3) = 0 |
---|
| 1133 | count(4) = 0 |
---|
| 1134 | start(1) = 1 |
---|
| 1135 | start(2) = 1 |
---|
| 1136 | start(3) = 1 |
---|
| 1137 | start(4) = 1 |
---|
| 1138 | |
---|
| 1139 | C +- ------3D+time variable in file----------- |
---|
| 1140 | IF (NDIMvar.eq.4) THEN |
---|
| 1141 | C ** 3D space + time: |
---|
| 1142 | NSDIvar = 3 ! # space dims |
---|
| 1143 | tiDI = 4 ! No. of the time dim |
---|
| 1144 | C ** write 3D space: |
---|
| 1145 | start(3) = 1 ! Start of index 3 in var (here = vert. levs) |
---|
| 1146 | count(3) = Nlev ! # values of index 3 in var |
---|
| 1147 | C ** write one time step: |
---|
| 1148 | start(4) = itime |
---|
| 1149 | count(4) = 1 |
---|
| 1150 | C +- ------3D *OR* 2D+time var in file-------- |
---|
| 1151 | ELSE IF (NDIMvar.eq.3) THEN |
---|
| 1152 | IF (Nlev.EQ.1) THEN |
---|
| 1153 | C ** 2D space + time (standard use of UNlib): |
---|
| 1154 | NSDIvar = 2 |
---|
| 1155 | tiDI = 3 |
---|
| 1156 | C ** ...write one time step: |
---|
| 1157 | start(3) = itime |
---|
| 1158 | count(3) = 1 |
---|
| 1159 | ELSE |
---|
| 1160 | C ** 3D (no time slice): |
---|
| 1161 | NSDIvar = 3 |
---|
| 1162 | tiDI = 0 |
---|
| 1163 | C ** ...write 3rd dimension: |
---|
| 1164 | start(3) = 1 |
---|
| 1165 | count(3) = Nlev |
---|
| 1166 | ENDIF |
---|
| 1167 | C +- ------2D *OR* 1D+time var in file-------- |
---|
| 1168 | ELSE IF (NDIMvar.eq.2) THEN |
---|
| 1169 | IF (Nj.EQ.1 .AND. dimNAM(2)(1:4).EQ.'time') THEN |
---|
| 1170 | C ** Write a 1D vector at time= itime: |
---|
| 1171 | NSDIvar = 1 |
---|
| 1172 | tiDI = 2 |
---|
| 1173 | start(2) = itime |
---|
| 1174 | count(2) = 1 |
---|
| 1175 | ELSE |
---|
| 1176 | C ** Usual MAR 2D space (no time): |
---|
| 1177 | NSDIvar = 2 |
---|
| 1178 | tiDI = 0 |
---|
| 1179 | END IF |
---|
| 1180 | C +- ------1D *OR* 0D+time var in file-------- |
---|
| 1181 | ELSE IF (NDIMvar.eq.1) THEN |
---|
| 1182 | C ** 1D space or time |
---|
| 1183 | IF (Ni.eq.1) THEN |
---|
| 1184 | C ** Write a single element (at itime) |
---|
| 1185 | start(1) = itime |
---|
| 1186 | count(1) = 1 |
---|
| 1187 | count(2) = 0 |
---|
| 1188 | NSDIvar = 0 |
---|
| 1189 | tiDI = 1 |
---|
| 1190 | ELSE |
---|
| 1191 | C ** Write a vector (use only "space" dim 1) |
---|
| 1192 | NSDIvar = 1 |
---|
| 1193 | tiDI = 0 |
---|
| 1194 | count(2)= 0 |
---|
| 1195 | END IF |
---|
| 1196 | ELSE |
---|
| 1197 | WRITE(*,*) 'UNwrite ERROR : data field dimension ?' |
---|
| 1198 | STOP |
---|
| 1199 | END IF |
---|
| 1200 | |
---|
| 1201 | C 2.3 Compare file dimensions to input data. |
---|
| 1202 | C + - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1203 | C ** Save variable size for use as "valid" size (-> range): |
---|
| 1204 | NVRi = Ni |
---|
| 1205 | NVRj = Nj |
---|
| 1206 | NVRlev = Nlev |
---|
| 1207 | C ** Space dimensions : |
---|
| 1208 | IF (NSDIvar.GT.0) THEN |
---|
| 1209 | DO iz = 1,NSDIvar |
---|
| 1210 | IF (dimSIZ(iz).gt.count(iz)) THEN |
---|
| 1211 | write(*,*) 'UNwrite - WARNING: ' |
---|
| 1212 | write(*,*) ' Your field ',VARname,' has an empty part.' |
---|
| 1213 | write(*,*) ' (for the dimension:',dimNAM(iz),')' |
---|
| 1214 | ELSE IF (dimSIZ(iz).lt.count(iz)) THEN |
---|
| 1215 | C ** Do display "warning" only if truncation |
---|
| 1216 | C was not "correctly announced" (see header) |
---|
| 1217 | C (NVR... => stop here when updating the range attribute) |
---|
| 1218 | IF (iz.EQ.1) THEN |
---|
| 1219 | chkdim = var(Ni,1,1) |
---|
| 1220 | NVRi = dimSIZ(1) |
---|
| 1221 | ELSE IF (iz.EQ.2) THEN |
---|
| 1222 | chkdim = var(1,Nj,1) |
---|
| 1223 | NVRj = dimSIZ(2) |
---|
| 1224 | ELSE IF (iz.EQ.3) THEN |
---|
| 1225 | chkdim = var(1,1,Nlev) |
---|
| 1226 | NVRlev = dimSIZ(3) |
---|
| 1227 | ELSE |
---|
| 1228 | chkdim = 0.0 |
---|
| 1229 | ENDIF |
---|
| 1230 | Ierro= NF_INQ_UNLIMDIM (FILEid, iUNLIMDIM) |
---|
| 1231 | IF (dimID(iz).NE.iUNLIMDIM) THEN |
---|
| 1232 | IF (ABS(chkdim-dimSIZ(iz)).GT. 0.1 ) THEN |
---|
| 1233 | write(*,*) 'UNwrite - WARNING: ' |
---|
| 1234 | write(*,*) ' Your field ',VARname,' will be truncated.' |
---|
| 1235 | write(*,*) ' (for the dimension:',dimNAM(iz),')' |
---|
| 1236 | ENDIF |
---|
| 1237 | count(iz) = dimSIZ(iz) |
---|
| 1238 | ENDIF |
---|
| 1239 | END IF |
---|
| 1240 | END DO |
---|
| 1241 | END IF |
---|
| 1242 | |
---|
| 1243 | C ** Time dimension (when defined): |
---|
| 1244 | IF (tiDI.ne.0) THEN |
---|
| 1245 | IF (itime.gt.dimSIZ(tiDI)) THEN |
---|
| 1246 | IF (icheck.ge.1) WRITE(*,*) 'Time limit, ID', dimID(tiDI) |
---|
| 1247 | Ierro= NF_INQ_UNLIMDIM (FILEid, iUNLIMDIM) |
---|
| 1248 | IF (dimID(tiDI).NE.iUNLIMDIM) THEN |
---|
| 1249 | WRITE(*,*) 'UNwrite - ERROR: ' |
---|
| 1250 | WRITE(*,*) ' Time index out of range ' |
---|
| 1251 | STOP |
---|
| 1252 | ENDIF |
---|
| 1253 | END IF |
---|
| 1254 | END IF |
---|
| 1255 | |
---|
| 1256 | IF (icheck.ge.2) WRITE(*,*) 'Ierro2. ', Ierro |
---|
| 1257 | IF (icheck.ge.2) WRITE(*,*) 'Dimension names :',dimNAM |
---|
| 1258 | IF (icheck.ge.2) WRITE(*,*) 'dimSIZ :',dimSIZ |
---|
| 1259 | IF (icheck.ge.2) WRITE(*,*) 'count :',count |
---|
| 1260 | IF (icheck.ge.2) WRITE(*,*) 'start :',start |
---|
| 1261 | IF (icheck.ge.2) WRITE(*,*) 'dimID :',dimID |
---|
| 1262 | |
---|
| 1263 | C* 3. Write variable. |
---|
| 1264 | C ------------------ |
---|
| 1265 | |
---|
| 1266 | C ** Set 'imap' and WRITE with NCVPTG: |
---|
| 1267 | C ** NOTE : since the arrays (grid_*) may be over-dimensionned, |
---|
| 1268 | C ** we use the 'generalised' writing routine NCVPTG |
---|
| 1269 | C ** (imap tells NetCDF about the memory locations of var) |
---|
| 1270 | imap(1) = 1 |
---|
| 1271 | imap(2) = imap(1) * Ni ! 1st dim of var = Ni |
---|
| 1272 | imap(3) = imap(2) * Nj ! 2nd dim of var = Nj |
---|
| 1273 | imap(4) = 0 ! (not used: 0 or 1 time step) |
---|
| 1274 | DO iz=1,4 |
---|
| 1275 | stride(iz)=1 |
---|
| 1276 | END DO |
---|
| 1277 | C ** NOTE: stride is not used. |
---|
| 1278 | |
---|
| 1279 | Ierro=NF_PUT_VARM_REAL(FILEid , varVID , start , count, |
---|
| 1280 | & stride , imap , var(1,1,1) ) |
---|
| 1281 | C ** line1: id/file | id/var |read from...|#data |
---|
| 1282 | C ** line2: step |re-arrang|variable(beg.) |
---|
| 1283 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwrite', Ierro) |
---|
| 1284 | |
---|
| 1285 | IF (icheck.ge.2) WRITE(*,*) 'Ierro3.2', Ierro |
---|
| 1286 | |
---|
| 1287 | C* 4a. Update 'actual_range' attribute. |
---|
| 1288 | C ------------------------------------ |
---|
| 1289 | |
---|
| 1290 | C If 'actual_range' available, get its current value: |
---|
| 1291 | C - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1292 | |
---|
| 1293 | C ** Get the old min and max values: |
---|
| 1294 | Ierro=NF_GET_ATT_REAL(FILEid ,varVID ,'actual_range' , |
---|
| 1295 | & Arange ) |
---|
| 1296 | c **line1 ^^^^^^^^^^^^^^ FILEid |var.id | attr.name |
---|
| 1297 | C **line2 value |
---|
| 1298 | |
---|
| 1299 | C ** Cancel if an error occured : attribute undefined ? |
---|
| 1300 | IF (Ierro.ne.0.and.icheck.ge.1) THEN |
---|
| 1301 | WRITE(*,*) 'UNwrite Info : attribute actual_range ' |
---|
| 1302 | & ,' not found -> not written.' |
---|
| 1303 | END IF |
---|
| 1304 | IF (Ierro.ne.0) GOTO 9990 !** Next section |
---|
| 1305 | |
---|
| 1306 | C If 'valid_range' available, get its current value: |
---|
| 1307 | C - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1308 | |
---|
| 1309 | C ** Get the min/max valid range (outside = missing val): |
---|
| 1310 | Ierro=NF_GET_ATT_REAL(FILEid ,varVID ,'valid_range' , |
---|
| 1311 | & sValRange) |
---|
| 1312 | IF (Ierro.ne.0) THEN |
---|
| 1313 | sValRange(1)=ValRange(1) |
---|
| 1314 | sValRange(2)=ValRange(2) |
---|
| 1315 | END IF |
---|
| 1316 | |
---|
| 1317 | C Update the min an max |
---|
| 1318 | C - - - - - - - - - - - |
---|
| 1319 | |
---|
| 1320 | C **If this is the first pass, initialise min and max: |
---|
| 1321 | IF ( Arange(1).EQ. NF_FILL_REAL |
---|
| 1322 | . .OR. (Arange(1).EQ. 0.0 .AND. Arange(2).EQ. 0.0) ) THEN |
---|
| 1323 | OkRange = .false. |
---|
| 1324 | ELSE |
---|
| 1325 | OkRange = .true. |
---|
| 1326 | ENDIF |
---|
| 1327 | |
---|
| 1328 | DO ll=1, NVRlev |
---|
| 1329 | DO jj=1, NVRj |
---|
| 1330 | DO ii=1, NVRi |
---|
| 1331 | IF ( var(ii,jj,ll).GE.sValRange(1) |
---|
| 1332 | & .AND. var(ii,jj,ll).LE.sValRange(2)) THEN |
---|
| 1333 | IF (OkRange) THEN |
---|
| 1334 | Arange(1) = MIN(Arange(1), var(ii,jj,ll)) |
---|
| 1335 | Arange(2) = MAX(Arange(2), var(ii,jj,ll)) |
---|
| 1336 | ELSE |
---|
| 1337 | Arange(1) = var(ii,jj,ll) |
---|
| 1338 | Arange(2) = var(ii,jj,ll) |
---|
| 1339 | OkRange = .true. |
---|
| 1340 | ENDIF |
---|
| 1341 | ENDIF |
---|
| 1342 | ENDDO |
---|
| 1343 | ENDDO |
---|
| 1344 | ENDDO |
---|
| 1345 | IF (icheck.ge.2) WRITE(*,*) 'Arange',Arange |
---|
| 1346 | |
---|
| 1347 | C Set attribute. |
---|
| 1348 | C - - - - - - - - |
---|
| 1349 | |
---|
| 1350 | Ierro=NF_PUT_ATT_REAL(FILEid ,varVID ,'actual_range' , |
---|
| 1351 | & NF_FLOAT,2 ,Arange) |
---|
| 1352 | c **line1 ^^^^^^^^^^^^^^^ FILEid |var.id | attr.name |
---|
| 1353 | C **line2 type |len | attr.value |
---|
| 1354 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwrite', Ierro) |
---|
| 1355 | TTerr = TTerr + ABS(Ierro) |
---|
| 1356 | |
---|
| 1357 | C ** Next section: |
---|
| 1358 | 9990 CONTINUE |
---|
| 1359 | |
---|
| 1360 | C* 5. Update the optional '[var]_range' special variable. |
---|
| 1361 | C ------------------------------------------------------ |
---|
| 1362 | IF (NDIMvar.eq.4.and.Nlev.lt.MXlv) THEN |
---|
| 1363 | |
---|
| 1364 | C If '[var]_range' available, get its current value: |
---|
| 1365 | C - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1366 | |
---|
| 1367 | C ** Get ID of variable [var]_range : |
---|
| 1368 | tmpchr = VARname(1:VNlen)//'_range' |
---|
| 1369 | itmp = VNlen + 6 |
---|
| 1370 | Ierro=NF_INQ_VARID(FILEid, tmpchr(1:itmp), varVID) |
---|
| 1371 | |
---|
| 1372 | C ** Cancel if an error occured : undefined ? |
---|
| 1373 | IF (Ierro.ne.0.and.icheck.ge.1) THEN |
---|
| 1374 | WRITE(*,*) 'UNwrite Info : [var]_range ' |
---|
| 1375 | & ,' not found -> not written.' |
---|
| 1376 | END IF |
---|
| 1377 | IF (Ierro.ne.0) GOTO 9999 !** UNwrite_end |
---|
| 1378 | |
---|
| 1379 | C ** Get the old min and max values: |
---|
| 1380 | C ** NOTE : |
---|
| 1381 | C ** we use the 'generalised' reading routine NCVGTG |
---|
| 1382 | C ** (imap tells NetCDF about the memory locations of var) |
---|
| 1383 | imap(1) = 1 |
---|
| 1384 | imap(2) = imap(1) * MXlv |
---|
| 1385 | start(1)= 1 |
---|
| 1386 | start(2)= 1 |
---|
| 1387 | count(1)= Nlev |
---|
| 1388 | count(2)= 2 |
---|
| 1389 | |
---|
| 1390 | C ** (See UNread for explanations about NCVGTG) |
---|
| 1391 | Ierro=NF_GET_VARM_REAL(FILEid, varVID, start, count, |
---|
| 1392 | & stride, imap , Srange(1,1) ) |
---|
| 1393 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwrite', Ierro) |
---|
| 1394 | |
---|
| 1395 | C Update the min an max |
---|
| 1396 | C - - - - - - - - - - - |
---|
| 1397 | C **If this is the first pass, initialise min and max: |
---|
| 1398 | C **(Constant fields shall not be accounted for) |
---|
| 1399 | DO ll=1, Nlev |
---|
| 1400 | IF (Srange(ll,1).eq.Srange(ll,2)) THEN |
---|
| 1401 | Srange(ll,1) = var(1,1,ll) |
---|
| 1402 | Srange(ll,2) = var(1,1,ll) |
---|
| 1403 | ENDIF |
---|
| 1404 | ENDDO |
---|
| 1405 | |
---|
| 1406 | DO jj=1, NVRj |
---|
| 1407 | DO ii=1, NVRi |
---|
| 1408 | DO ll=1, NVRlev |
---|
| 1409 | Srange(ll,1) = MIN(Srange(ll,1), var(ii,jj,ll)) |
---|
| 1410 | Srange(ll,2) = MAX(Srange(ll,2), var(ii,jj,ll)) |
---|
| 1411 | ENDDO |
---|
| 1412 | ENDDO |
---|
| 1413 | ENDDO |
---|
| 1414 | IF (icheck.ge.4) WRITE(*,*) 'Srange',Srange |
---|
| 1415 | |
---|
| 1416 | |
---|
| 1417 | C Set special variable [var]_range |
---|
| 1418 | C - - - - - - - - - - - - - - - - - |
---|
| 1419 | C **(See UNread for explanations abtout NCVPTG) |
---|
| 1420 | |
---|
| 1421 | Ierro=NF_PUT_VARM_REAL(FILEid , varVID , start, count, |
---|
| 1422 | & stride , imap , Srange(1,1) ) |
---|
| 1423 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwrite', Ierro) |
---|
| 1424 | |
---|
| 1425 | ENDIF ! End Section 5. |
---|
| 1426 | |
---|
| 1427 | C UNwrite_end |
---|
| 1428 | C ----------- |
---|
| 1429 | IF (icheck.ge.2) WRITE(*,*) 'Errors count:',TTerr |
---|
| 1430 | IF (icheck.ge.2) WRITE(*,*) 'UNwrite : End' |
---|
| 1431 | 9999 CONTINUE |
---|
| 1432 | RETURN |
---|
| 1433 | END |
---|
| 1434 | C** |
---|
| 1435 | C** +-------------------------+-----------------------------------------+ |
---|
| 1436 | C** + Subroutine UNlwrite : + + |
---|
| 1437 | C** +-------------------------+ + |
---|
| 1438 | C** + * Writes a 2D horizontal LEVEL into a 3D+time NetCDF variable + |
---|
| 1439 | C** + OR a 1D vector into a 2D+time + |
---|
| 1440 | C** + -- ---- -- + |
---|
| 1441 | C** + (SEE ALSO : UNwrite, for all dimensions - this a pecular case + |
---|
| 1442 | C** + Note: 1D vectors are writen in the 1st dim of 2D+time) + |
---|
| 1443 | C** + + |
---|
| 1444 | C** + * Automatically updates attribute 'actual_range' if available + |
---|
| 1445 | C** + " " special var. '[var]_range' " + |
---|
| 1446 | C** + + |
---|
| 1447 | C** + INPUT : + |
---|
| 1448 | C** + FILEid : input file identifier (from UNcreate OR NetCDF open) + |
---|
| 1449 | C** + VARname : name given to the variable to write (must be in file)+ |
---|
| 1450 | C** + itime : No of time step to write to + |
---|
| 1451 | C** + level : No of level to write to + |
---|
| 1452 | C** + Ni, Nj : dimensions of 'var'... + |
---|
| 1453 | C** + var : A 2D variable to be writen + |
---|
| 1454 | C** +-------------------------------------------------------------------+ |
---|
| 1455 | |
---|
| 1456 | SUBROUTINE UNlwrite (FILEid , VARname , itime, |
---|
| 1457 | & ilev, Ni, Nj, var) |
---|
| 1458 | |
---|
| 1459 | IMPLICIT NONE |
---|
| 1460 | |
---|
| 1461 | INCLUDE 'libUN.inc' |
---|
| 1462 | |
---|
| 1463 | INTEGER icheck |
---|
| 1464 | |
---|
| 1465 | INTEGER Lvnam |
---|
| 1466 | PARAMETER (Lvnam=20) |
---|
| 1467 | |
---|
| 1468 | C ** input |
---|
| 1469 | INTEGER FILEid |
---|
| 1470 | INTEGER itime, ilev |
---|
| 1471 | INTEGER Ni, Nj |
---|
| 1472 | CHARACTER *(*) VARname |
---|
| 1473 | REAL*4 var(Ni, Nj) |
---|
| 1474 | |
---|
| 1475 | C ** local : |
---|
| 1476 | INTEGER VARSIZE |
---|
| 1477 | EXTERNAL VARSIZE |
---|
| 1478 | INTEGER Ierro, TTerr, Nvatts, vtype |
---|
| 1479 | INTEGER dimID(4), dimSIZ(4), count(4) |
---|
| 1480 | INTEGER start(4),stride(4),imap(4) |
---|
| 1481 | INTEGER iUNLIMDIM |
---|
| 1482 | CHARACTER*(Lvnam) dimNAM(4) |
---|
| 1483 | CHARACTER*(Lvnam) recname |
---|
| 1484 | CHARACTER*(30) tmpchr |
---|
| 1485 | INTEGER varVID |
---|
| 1486 | INTEGER VNlen, NDIMvar, NSDIvar, tiDI, ilDI, itmp |
---|
| 1487 | INTEGER iz, ii, jj |
---|
| 1488 | LOGICAL OkRange |
---|
| 1489 | REAL*4 Arange(2), sValRange(2) |
---|
| 1490 | REAL*4 Srange(2) |
---|
| 1491 | |
---|
| 1492 | icheck= 0 !** 'debugging' level |
---|
| 1493 | TTerr = 0 !** 'total numbe of errors |
---|
| 1494 | |
---|
| 1495 | IF (icheck.ge.1) WRITE(*,*) 'UNlwrite : Begin' |
---|
| 1496 | |
---|
| 1497 | C* 1. Get the variable field and dims IDs |
---|
| 1498 | C ---------------------------------------- |
---|
| 1499 | |
---|
| 1500 | IF (icheck.ge.2) WRITE(*,*) 'FILEid :', FILEid |
---|
| 1501 | |
---|
| 1502 | C ** getting VARname size : |
---|
| 1503 | VNlen = VARSIZE (VARname) |
---|
| 1504 | IF (icheck.ge.3) WRITE(*,*) 'VNlen :',VNlen |
---|
| 1505 | IF (icheck.ge.2) WRITE(*,*) 'VARname :', VARname (1:VNlen) |
---|
| 1506 | |
---|
| 1507 | C ** variable field ID : |
---|
| 1508 | Ierro=NF_INQ_VARID (FILEid, VARname (1:VNlen), varVID) |
---|
| 1509 | |
---|
| 1510 | C ** Cancel writing if an error occured : variable undefined ? |
---|
| 1511 | IF (Ierro.ne.0.and.icheck.ge.1) THEN |
---|
| 1512 | WRITE(*,*) 'UNlwrite Info : Variable ',VARname(1:VNlen) |
---|
| 1513 | & ,' not found -> not written.' |
---|
| 1514 | END IF |
---|
| 1515 | IF (Ierro.ne.0) GOTO 9999 !** UNlwrite_end |
---|
| 1516 | |
---|
| 1517 | |
---|
| 1518 | C ** Inquire about the number of dimensions in var : |
---|
| 1519 | C ** |
---|
| 1520 | Ierro=NF_INQ_VAR(FILEid , varVID, recname, vtype, |
---|
| 1521 | & NDIMvar, dimID, Nvatts) |
---|
| 1522 | C ** line1 id/file id/var var name var type |
---|
| 1523 | C ** line2 # dims id/dims #attributes |
---|
| 1524 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNlwrite', Ierro) |
---|
| 1525 | |
---|
| 1526 | IF (icheck.ge.2) WRITE(*,*) 'Ierro1. ', Ierro |
---|
| 1527 | |
---|
| 1528 | |
---|
| 1529 | C* 2. Dimensions : inquire about file + compare with input data. |
---|
| 1530 | C ------------------------------------------------------------- |
---|
| 1531 | |
---|
| 1532 | C 2.1 Inquire dimensions names and sizes : |
---|
| 1533 | C + - - - - - - - - - - - - - - - - - - - - - |
---|
| 1534 | DO iz = 1,4 |
---|
| 1535 | dimSIZ(iz)=0 |
---|
| 1536 | dimNAM(iz)=' ' |
---|
| 1537 | C ** Set any unused dimension to "0" size / no name |
---|
| 1538 | END DO |
---|
| 1539 | |
---|
| 1540 | DO iz = 1,NDIMvar |
---|
| 1541 | Ierro=NF_INQ_DIM(FILEid , dimID(iz), dimNAM(iz), dimSIZ(iz)) |
---|
| 1542 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNlwrite', Ierro) |
---|
| 1543 | C ** id/file id/dim dimname dimsize error |
---|
| 1544 | C ** !output output |
---|
| 1545 | END DO |
---|
| 1546 | IF (icheck.ge.3) WRITE(*,*) 'NDIMvar ',NDIMvar |
---|
| 1547 | IF (icheck.ge.3) WRITE(*,*) 'Ierro 2.0',Ierro |
---|
| 1548 | |
---|
| 1549 | C 2.2 Set writing region according to field dimension : 3D |
---|
| 1550 | C + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1551 | C ** Set horizontal dimensions (all field dims): |
---|
| 1552 | count(1) = Ni |
---|
| 1553 | count(2) = Nj |
---|
| 1554 | start(1) = 1 |
---|
| 1555 | start(2) = 1 |
---|
| 1556 | C +- ------ 3D+time var in file-------- |
---|
| 1557 | IF (NDIMvar.eq.4) THEN |
---|
| 1558 | NSDIvar = 2 ! # input space dims (for a 2D level) |
---|
| 1559 | tiDI = 4 ! No. of the time dim |
---|
| 1560 | C ** write one level (set the level No) : |
---|
| 1561 | start(3) = ilev ! Start of index 3 in var |
---|
| 1562 | count(3) = 1 ! # values of index 3 in var |
---|
| 1563 | ilDI = 3 |
---|
| 1564 | C ** write one time step: |
---|
| 1565 | start(4) = itime |
---|
| 1566 | count(4) = 1 |
---|
| 1567 | C +- ------ 2D+time var in file-------- |
---|
| 1568 | ELSE IF (NDIMvar.eq.3) THEN |
---|
| 1569 | NSDIvar = 1 ! # input space dims (for a 1D vector) |
---|
| 1570 | tiDI = 3 ! No. of the time dim |
---|
| 1571 | C ** write one "level" - here a 1D vector in the 1st dim. |
---|
| 1572 | start(2) = ilev ! Start of index 2 in var |
---|
| 1573 | count(2) = 1 ! # values of index 3 in var |
---|
| 1574 | ilDI = 2 |
---|
| 1575 | C ** write one time step: |
---|
| 1576 | start(3) = itime |
---|
| 1577 | count(3) = 1 |
---|
| 1578 | ELSE |
---|
| 1579 | WRITE(*,*) 'UNlwrite ERROR : data field dimension ?' |
---|
| 1580 | WRITE(*,*) ' NB: UNlwrite = only for (2 or) 3D +time.' |
---|
| 1581 | STOP |
---|
| 1582 | END IF |
---|
| 1583 | |
---|
| 1584 | C 2.3 Compare file dimensions to input data. |
---|
| 1585 | C + - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1586 | C ** Space dimensions : |
---|
| 1587 | DO iz = 1,NSDIvar |
---|
| 1588 | IF (dimSIZ(iz).gt.count(iz)) THEN |
---|
| 1589 | write(*,*) 'UNlwrite - WARNING: ' |
---|
| 1590 | write(*,*) ' Your field ',VARname,' has an empty part.' |
---|
| 1591 | write(*,*) ' (for the dimension:',dimNAM(iz),')' |
---|
| 1592 | ELSE IF (dimSIZ(iz).lt.count(iz)) THEN |
---|
| 1593 | write(*,*) 'UNlwrite - WARNING: ' |
---|
| 1594 | write(*,*) ' Your field ',VARname,' will be truncated.' |
---|
| 1595 | write(*,*) ' (for the dimension:',dimNAM(iz),')' |
---|
| 1596 | count(iz) = dimSIZ(iz) |
---|
| 1597 | END IF |
---|
| 1598 | END DO |
---|
| 1599 | |
---|
| 1600 | C ** Space dimensions - check if requested level exists: |
---|
| 1601 | IF (dimSIZ(ilDI).lt.ilev) THEN |
---|
| 1602 | write(*,*) 'UNlwrite - ERROR: ' |
---|
| 1603 | write(*,*) ' The requested level =',ilev |
---|
| 1604 | write(*,*) ' does not exist in the field ',VARname |
---|
| 1605 | write(*,*) ' (for the dimension:',dimNAM(ilDI),')' |
---|
| 1606 | STOP |
---|
| 1607 | END IF |
---|
| 1608 | |
---|
| 1609 | C ** Time dimension (when defined): |
---|
| 1610 | IF (tiDI.ne.0) THEN |
---|
| 1611 | IF (itime.gt.dimSIZ(tiDI)) THEN |
---|
| 1612 | IF (icheck.ge.1) WRITE(*,*) 'Time limit, ID', dimID(tiDI) |
---|
| 1613 | Ierro= NF_INQ_UNLIMDIM (FILEid, iUNLIMDIM) |
---|
| 1614 | IF (dimID(tiDI).NE.iUNLIMDIM) THEN |
---|
| 1615 | WRITE(*,*) 'UNlwrite - ERROR: ' |
---|
| 1616 | WRITE(*,*) ' Time index out of range ' |
---|
| 1617 | STOP |
---|
| 1618 | ENDIF |
---|
| 1619 | END IF |
---|
| 1620 | END IF |
---|
| 1621 | |
---|
| 1622 | IF (icheck.ge.2) WRITE(*,*) 'Ierro2. ', Ierro |
---|
| 1623 | IF (icheck.ge.2) WRITE(*,*) 'Dimension names :',dimNAM |
---|
| 1624 | IF (icheck.ge.3) WRITE(*,*) 'dimSIZ :',dimSIZ |
---|
| 1625 | IF (icheck.ge.3) WRITE(*,*) 'count :',count |
---|
| 1626 | IF (icheck.ge.3) WRITE(*,*) 'start :',start |
---|
| 1627 | IF (icheck.ge.3) WRITE(*,*) 'dimID :',dimID |
---|
| 1628 | |
---|
| 1629 | C* 3. Write variable. |
---|
| 1630 | C ------------------ |
---|
| 1631 | |
---|
| 1632 | C ** Set 'imap' and WRITE with NCVPTG: |
---|
| 1633 | C ** NOTE : since the arrays (grid_*) may be over-dimensionned, |
---|
| 1634 | C ** we use the 'generalised' writing routine NCVPTG |
---|
| 1635 | C ** (imap tells NetCDF about the memory locations of var) |
---|
| 1636 | imap(1) = 1 |
---|
| 1637 | imap(2) = imap(1) * Ni ! 1st dim of var = Ni |
---|
| 1638 | imap(3) = imap(2) * Nj ! (not used: 1 level...) |
---|
| 1639 | imap(4) = 0 ! (not used: 0 or 1 time step) |
---|
| 1640 | DO iz=1,4 |
---|
| 1641 | stride(iz)=1 |
---|
| 1642 | END DO |
---|
| 1643 | C ** NOTE: stride is not used. |
---|
| 1644 | |
---|
| 1645 | Ierro=NF_PUT_VARM_REAL (FILEid , varVID , start , count, |
---|
| 1646 | & stride , imap , var(1,1) ) |
---|
| 1647 | C ** line1: id/file | id/var |read from...|#data |
---|
| 1648 | C ** line2: step |re-arrang|variable(beg.) |
---|
| 1649 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNlwrite', Ierro) |
---|
| 1650 | |
---|
| 1651 | IF (icheck.ge.2) WRITE(*,*) 'Ierro3.2', Ierro |
---|
| 1652 | |
---|
| 1653 | C* 4a. Update 'actual_range' attribute. |
---|
| 1654 | C ------------------------------------ |
---|
| 1655 | |
---|
| 1656 | C If 'actual_range' available, get its current value: |
---|
| 1657 | C - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1658 | |
---|
| 1659 | C ** Get the old min and max values: |
---|
| 1660 | Ierro=NF_GET_ATT_REAL(FILEid ,varVID ,'actual_range' , |
---|
| 1661 | & Arange ) |
---|
| 1662 | c **line1 ^^^^^^^^^^^^^^^ FILEid |var.id | attr.name |
---|
| 1663 | C **line2 value |
---|
| 1664 | |
---|
| 1665 | C ** Cancel if an error occured : attribute undefined ? |
---|
| 1666 | IF (Ierro.ne.0.and.icheck.ge.1) THEN |
---|
| 1667 | WRITE(*,*) 'UNlwrite Info : attribute actual_range ' |
---|
| 1668 | & ,' not found -> not written.' |
---|
| 1669 | END IF |
---|
| 1670 | IF (Ierro.ne.0) GOTO 9990 !** Next section |
---|
| 1671 | |
---|
| 1672 | C If 'valid_range' available, get its current value: |
---|
| 1673 | C - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1674 | |
---|
| 1675 | C ** Get the min/max valid range (outside = missing val): |
---|
| 1676 | Ierro=NF_GET_ATT_REAL(FILEid ,varVID ,'valid_range' , |
---|
| 1677 | & sValRange) |
---|
| 1678 | IF (Ierro.ne.0) THEN |
---|
| 1679 | sValRange(1)=ValRange(1) |
---|
| 1680 | sValRange(1)=ValRange(2) |
---|
| 1681 | END IF |
---|
| 1682 | |
---|
| 1683 | C Update the min an max |
---|
| 1684 | C - - - - - - - - - - - |
---|
| 1685 | |
---|
| 1686 | C **If this is the first pass, initialise min and max: |
---|
| 1687 | IF ( Arange(1).EQ. NF_FILL_REAL |
---|
| 1688 | . .OR. (Arange(1).EQ. 0.0 .AND. Arange(2).EQ. 0.0) ) THEN |
---|
| 1689 | OkRange = .false. |
---|
| 1690 | ELSE |
---|
| 1691 | OkRange = .true. |
---|
| 1692 | ENDIF |
---|
| 1693 | |
---|
| 1694 | DO jj=1, Nj |
---|
| 1695 | DO ii=1, Ni |
---|
| 1696 | IF ( var(ii,jj).GE.sValRange(1) |
---|
| 1697 | & .AND. var(ii,jj).LE.sValRange(2)) THEN |
---|
| 1698 | IF (OkRange) THEN |
---|
| 1699 | Arange(1) = MIN(Arange(1), var(ii,jj)) |
---|
| 1700 | Arange(2) = MAX(Arange(2), var(ii,jj)) |
---|
| 1701 | ELSE |
---|
| 1702 | Arange(1) = var(ii,jj) |
---|
| 1703 | Arange(2) = var(ii,jj) |
---|
| 1704 | OkRange = .true. |
---|
| 1705 | ENDIF |
---|
| 1706 | ENDIF |
---|
| 1707 | ENDDO |
---|
| 1708 | ENDDO |
---|
| 1709 | IF (icheck.ge.2) WRITE(*,*) 'Arange',Arange |
---|
| 1710 | |
---|
| 1711 | C Set attribute. |
---|
| 1712 | C - - - - - - - - |
---|
| 1713 | |
---|
| 1714 | Ierro=NF_PUT_ATT_REAL(FILEid ,varVID ,'actual_range' , |
---|
| 1715 | & NF_FLOAT,2 ,Arange ) |
---|
| 1716 | c **line1 ^^^^^^^^^^^^^^^ FILEid |var.id | attr.name |
---|
| 1717 | C **line2 type |len | attr.value |
---|
| 1718 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNlwrite', Ierro) |
---|
| 1719 | TTerr = TTerr + ABS(Ierro) |
---|
| 1720 | |
---|
| 1721 | C ** Next section: |
---|
| 1722 | 9990 CONTINUE |
---|
| 1723 | |
---|
| 1724 | |
---|
| 1725 | C* 5. Update the optional '[var]_range' special variable. |
---|
| 1726 | C ------------------------------------------------------ |
---|
| 1727 | IF (NDIMvar.eq.4) THEN |
---|
| 1728 | |
---|
| 1729 | C If '[var]_range' available, get its current value: |
---|
| 1730 | C - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 1731 | |
---|
| 1732 | C ** Get ID of variable [var]_range : |
---|
| 1733 | tmpchr = VARname(1:VNlen)//'_range' |
---|
| 1734 | itmp = VNlen + 6 |
---|
| 1735 | Ierro=NF_INQ_VARID (FILEid, tmpchr(1:itmp), varVID) |
---|
| 1736 | |
---|
| 1737 | C ** Cancel if an error occured : undefined ? |
---|
| 1738 | IF (Ierro.ne.0.and.icheck.ge.1) THEN |
---|
| 1739 | WRITE(*,*) 'UNlwrite Info : [var]_range ' |
---|
| 1740 | & ,' not found -> not written.' |
---|
| 1741 | END IF |
---|
| 1742 | IF (Ierro.ne.0) GOTO 9999 !** UNlwrite_end |
---|
| 1743 | |
---|
| 1744 | C ** Get the old min and max values: |
---|
| 1745 | C ** NOTE : |
---|
| 1746 | C ** we use the 'generalised' reading routine NCVGTG |
---|
| 1747 | C ** (imap tells NetCDF about the memory locations of var) |
---|
| 1748 | imap(1) = 1 |
---|
| 1749 | imap(2) = 0 ! Not used (write only 1 lev) |
---|
| 1750 | start(1)= ilev |
---|
| 1751 | count(1)= 1 |
---|
| 1752 | start(2)= 1 |
---|
| 1753 | count(2)= 2 |
---|
| 1754 | |
---|
| 1755 | C ** (See UNread for explanations abtout NCVGTG) |
---|
| 1756 | Ierro=NF_GET_VARM_REAL(FILEid, varVID, start ,count, |
---|
| 1757 | & stride, imap , Srange(1) ) |
---|
| 1758 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNlwrite', Ierro) |
---|
| 1759 | |
---|
| 1760 | C Update the min an max |
---|
| 1761 | C - - - - - - - - - - - |
---|
| 1762 | C **If this is the first pass, initialise min and max: |
---|
| 1763 | C **(Constant fields shall not be accounted for) |
---|
| 1764 | IF (Srange(1).eq.Srange(2)) THEN |
---|
| 1765 | Srange(1) = var(1,1) |
---|
| 1766 | Srange(2) = var(1,1) |
---|
| 1767 | ENDIF |
---|
| 1768 | |
---|
| 1769 | DO jj=1, Nj |
---|
| 1770 | DO ii=1, Ni |
---|
| 1771 | Srange(1) = MIN(Srange(1), var(ii,jj)) |
---|
| 1772 | Srange(2) = MAX(Srange(2), var(ii,jj)) |
---|
| 1773 | ENDDO |
---|
| 1774 | ENDDO |
---|
| 1775 | IF (icheck.ge.4) WRITE(*,*) 'Srange',Srange |
---|
| 1776 | |
---|
| 1777 | |
---|
| 1778 | C Set special variable [var]_range |
---|
| 1779 | C - - - - - - - - - - - - - - - - - |
---|
| 1780 | C **(See UNread for explanations abtout NCVPTG) |
---|
| 1781 | |
---|
| 1782 | Ierro=NF_PUT_VARM_REAL(FILEid , varVID , start , count, |
---|
| 1783 | & stride , imap , Srange(1) ) |
---|
| 1784 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNlwrite', Ierro) |
---|
| 1785 | |
---|
| 1786 | ENDIF ! End Section 5. |
---|
| 1787 | |
---|
| 1788 | C UNlwrite_end |
---|
| 1789 | C ----------- |
---|
| 1790 | IF (icheck.ge.2) WRITE(*,*) 'Errors count:',TTerr |
---|
| 1791 | IF (icheck.ge.2) WRITE(*,*) 'UNlwrite : End' |
---|
| 1792 | 9999 CONTINUE |
---|
| 1793 | RETURN |
---|
| 1794 | END |
---|
| 1795 | C** |
---|
| 1796 | C** +-------------------------+-----------------------------------------+ |
---|
| 1797 | C** + Subroutine UNread : + + |
---|
| 1798 | C** +-------------------------+ + |
---|
| 1799 | C** + * Reads a model variable from a NetCDF file, + |
---|
| 1800 | C** + and reads the coordinates of the grid upon wich it is defined. + |
---|
| 1801 | C** + (the NetCDF file must have been opened and must be closed + |
---|
| 1802 | C** + after all reading operations). May read an x-y subregion. + |
---|
| 1803 | C** + + |
---|
| 1804 | C** + INPUT : + |
---|
| 1805 | C** + FILEid : input file identifier (from NetCDF open) + |
---|
| 1806 | C** + VARname : name of the requested variable. + |
---|
| 1807 | C** + time : [integer*4] is the time index of the data field to read + |
---|
| 1808 | C** + level: [integer*4] (usefull for 3D-space fields only) : + |
---|
| 1809 | C** + if not=0 --> = no of the level + |
---|
| 1810 | C** + -> output is 2D (l_dim = 1) + |
---|
| 1811 | C** + if =0 --> read ALL levels + |
---|
| 1812 | C** + -> output is 3D + |
---|
| 1813 | C** + i_dbeg, j_dbeg : horizontal indexes of requested region + |
---|
| 1814 | C** + in input data file + |
---|
| 1815 | C** + i_dim, j_dim, l_dim : ...the dimensions of 'var', + |
---|
| 1816 | C** + = the dimensions of the sub-region to read + |
---|
| 1817 | C** + ! l_dim = 1 if level not=0 + |
---|
| 1818 | C** + ! j_dim = 1 if var is 1D + |
---|
| 1819 | C** + OUTPUT : + |
---|
| 1820 | C** + varax1[i_dim] (real ) + |
---|
| 1821 | C** + varax2[j_dim]: Horizontal coordinates in the file (lat/lon,...)+ |
---|
| 1822 | C** + varlev[l_dim]: vertical coordinate of the levels + |
---|
| 1823 | C** + (! when level not=0, only varlev(1) is defined) + |
---|
| 1824 | C** + var_units : physical units of var. + |
---|
| 1825 | C** + var[i_dim,j_dim,l_dim] : + |
---|
| 1826 | C** + data field values + |
---|
| 1827 | C** + (var must be defined, and is REAL ) + |
---|
| 1828 | C** + + |
---|
| 1829 | C** +-------------------------------------------------------------------+ |
---|
| 1830 | |
---|
| 1831 | SUBROUTINE UNread |
---|
| 1832 | & (FILEid , VARname , time, level, i_dbeg, j_dbeg, |
---|
| 1833 | & i_dim , j_dim , l_dim , |
---|
| 1834 | & varax1 , varax2 , varlev, |
---|
| 1835 | & var_units, var) |
---|
| 1836 | |
---|
| 1837 | IMPLICIT NONE |
---|
| 1838 | INCLUDE 'libUN.inc' |
---|
| 1839 | |
---|
| 1840 | INTEGER icheck |
---|
| 1841 | |
---|
| 1842 | INTEGER Lvnam |
---|
| 1843 | PARAMETER (Lvnam=20) |
---|
| 1844 | |
---|
| 1845 | C ** input |
---|
| 1846 | INTEGER FILEid |
---|
| 1847 | INTEGER time, level, i_dbeg, j_dbeg |
---|
| 1848 | INTEGER i_dim, j_dim, l_dim |
---|
| 1849 | CHARACTER *(*) VARname |
---|
| 1850 | |
---|
| 1851 | C ** output |
---|
| 1852 | REAL*4 varax1(i_dim), varax2(j_dim), varlev(l_dim) |
---|
| 1853 | CHARACTER *(*) var_units |
---|
| 1854 | REAL*4 var (i_dim, j_dim, l_dim) |
---|
| 1855 | |
---|
| 1856 | C ** local : |
---|
| 1857 | INTEGER VARSIZE |
---|
| 1858 | EXTERNAL VARSIZE |
---|
| 1859 | REAL*4 varmin,varmax |
---|
| 1860 | INTEGER Ierro, Nvatts, vtype |
---|
| 1861 | INTEGER dimID(4), dimSIZ(4), dimREG(4) |
---|
| 1862 | INTEGER start(4),begREG(4),count(4),stride(4),imap(4) |
---|
| 1863 | CHARACTER*(Lvnam) dimNAM(4) |
---|
| 1864 | CHARACTER*(Lvnam) dNAMver, dNAMtim |
---|
| 1865 | CHARACTER*(Lvnam) recname |
---|
| 1866 | CHARACTER*(10) Routine |
---|
| 1867 | INTEGER ax1VID, ax2VID, verVID, timVID, varVID |
---|
| 1868 | INTEGER VNlen, varNUMDIM |
---|
| 1869 | INTEGER ii,jj,ll,z |
---|
| 1870 | |
---|
| 1871 | icheck= 0 |
---|
| 1872 | C* 0. Initialisations |
---|
| 1873 | C ------------------ |
---|
| 1874 | Routine= 'UNread' |
---|
| 1875 | IF (icheck.ge.1) WRITE(*,*) 'UNread : Begin' |
---|
| 1876 | |
---|
| 1877 | DO ii = 1,4 |
---|
| 1878 | stride(ii) = 1 |
---|
| 1879 | begREG(ii) = 1 |
---|
| 1880 | start (ii) = 1 |
---|
| 1881 | ENDDO |
---|
| 1882 | |
---|
| 1883 | C* 1. Get the variable field and dims IDs |
---|
| 1884 | C ---------------------------------------- |
---|
| 1885 | |
---|
| 1886 | IF (icheck.ge.3) WRITE(*,*) 'FILEid :', FILEid |
---|
| 1887 | |
---|
| 1888 | C ** getting VARname size : |
---|
| 1889 | VNlen = VARSIZE(VARname) |
---|
| 1890 | IF (icheck.ge.3) WRITE(*,*) 'VNlen :',VNlen |
---|
| 1891 | IF (icheck.ge.2) WRITE(*,*) 'VARname :', VARname (1:VNlen) |
---|
| 1892 | |
---|
| 1893 | C ** variable field ID : |
---|
| 1894 | Ierro=NF_INQ_VARID (FILEid, VARname (1:VNlen), varVID) |
---|
| 1895 | |
---|
| 1896 | C* 1b. Handle non-existing variables |
---|
| 1897 | C --------------------------------- |
---|
| 1898 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 1899 | IF (Ierro.EQ.NF_ENOTVAR .AND. iVarWarn.LE.1) THEN |
---|
| 1900 | IF (iVarWarn.EQ.1) THEN |
---|
| 1901 | write(*,*) 'WARNING (UNsread): variable not found:' |
---|
| 1902 | write(*,*) ' ',varName |
---|
| 1903 | ENDIF |
---|
| 1904 | DO ll=1,l_dim |
---|
| 1905 | DO jj=1,j_dim |
---|
| 1906 | DO ii=1,i_dim |
---|
| 1907 | var (ii,jj,ll)=VarRepl |
---|
| 1908 | ENDDO |
---|
| 1909 | ENDDO |
---|
| 1910 | ENDDO |
---|
| 1911 | RETURN ! EXIT SUBROUTINE, read nothing |
---|
| 1912 | ENDIF |
---|
| 1913 | WRITE(*,*) 'Error reading variable: ', VARname(1:VNlen) |
---|
| 1914 | CALL HANDLE_ERR('UNsread',Ierro) |
---|
| 1915 | ENDIF |
---|
| 1916 | |
---|
| 1917 | C 1c. Inquire about the number of dimensions in var |
---|
| 1918 | C ------------------------------------------------- |
---|
| 1919 | |
---|
| 1920 | Ierro=NF_INQ_VAR(FILEid , varVID, recname, vtype, |
---|
| 1921 | & varNUMDIM, dimID, Nvatts ) |
---|
| 1922 | C ** line1 id/file id/var var name var type |
---|
| 1923 | C ** line2 # dims id/dims #attributes |
---|
| 1924 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNsread', Ierro) |
---|
| 1925 | |
---|
| 1926 | IF (icheck.ge.3) WRITE(*,*) 'Ierro1. ', Ierro |
---|
| 1927 | |
---|
| 1928 | C* 2. Dimensions : in the reading region and in the file. |
---|
| 1929 | C ------------------------------------------------------ |
---|
| 1930 | |
---|
| 1931 | C ** inquire dimensions names and sizes : |
---|
| 1932 | DO z = 1,varNUMDIM |
---|
| 1933 | Ierro=NF_INQ_DIM(FILEid , dimID(z), dimNAM(z), dimSIZ(z)) |
---|
| 1934 | C ** id/file id/dim dimname dimsize |
---|
| 1935 | C ** !output output |
---|
| 1936 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR(Routine, Ierro) |
---|
| 1937 | END DO |
---|
| 1938 | |
---|
| 1939 | C ** In this version, we read only a xy subregion of the file : |
---|
| 1940 | dimREG(1) = i_dim |
---|
| 1941 | dimREG(2) = j_dim |
---|
| 1942 | begREG(1) = i_dbeg |
---|
| 1943 | begREG(2) = j_dbeg |
---|
| 1944 | IF (begREG(1).lt.1) begREG(1) = 1 |
---|
| 1945 | IF (begREG(2).lt.1) begREG(2) = 1 |
---|
| 1946 | |
---|
| 1947 | C ** Set reading region according to field dimension : 2D or 3D |
---|
| 1948 | IF (varNUMDIM.eq.4) THEN |
---|
| 1949 | C ** for 3D fields : |
---|
| 1950 | IF (level.gt.0) THEN |
---|
| 1951 | C ** one level is read : |
---|
| 1952 | dimREG(3) = 1 |
---|
| 1953 | begREG(3) = level |
---|
| 1954 | dNAMver = dimNAM(3) |
---|
| 1955 | ELSE |
---|
| 1956 | C ** all levels are read : |
---|
| 1957 | dimREG(3) = l_dim |
---|
| 1958 | begREG(3) = 1 |
---|
| 1959 | dNAMver = dimNAM(3) |
---|
| 1960 | END IF |
---|
| 1961 | C ** one time step is read: |
---|
| 1962 | dimREG(4) = 1 |
---|
| 1963 | begREG(4) = time |
---|
| 1964 | dNAMtim = dimNAM(4) |
---|
| 1965 | ELSE IF (varNUMDIM.eq.3) THEN |
---|
| 1966 | C ** for 2D space fields + time: |
---|
| 1967 | C ** one time step is read: |
---|
| 1968 | dimREG(3) = 1 |
---|
| 1969 | begREG(3) = time |
---|
| 1970 | dNAMtim = dimNAM(3) |
---|
| 1971 | dimREG(4) = 0 |
---|
| 1972 | begREG(4) = 0 |
---|
| 1973 | dimNAM(4) = 'none' |
---|
| 1974 | ELSE IF (varNUMDIM.eq.2) THEN |
---|
| 1975 | C ** for 2D fields : |
---|
| 1976 | C ** no time step is read: |
---|
| 1977 | dimREG(3) = 0 |
---|
| 1978 | begREG(3) = 0 |
---|
| 1979 | dNAMtim = 'none' |
---|
| 1980 | dimNAM(3) = 'none' |
---|
| 1981 | dimREG(4) = 0 |
---|
| 1982 | begREG(4) = 0 |
---|
| 1983 | dimNAM(4) = 'none' |
---|
| 1984 | ELSE IF (varNUMDIM.eq.1) THEN |
---|
| 1985 | C ** for 1D variable : |
---|
| 1986 | C ** not assumed to be on a XYZ grid, |
---|
| 1987 | C ** just read a vector |
---|
| 1988 | dimREG(1) = 1 ! this was added by Martin Vancop for 1d vectors |
---|
| 1989 | begREG(1) = time ! this was added by Martin Vancop for 1d vectors |
---|
| 1990 | dimREG(2) = 0 |
---|
| 1991 | begREG(2) = 0 |
---|
| 1992 | dimNAM(2) = 'none' |
---|
| 1993 | dimREG(3) = 0 |
---|
| 1994 | begREG(3) = 0 |
---|
| 1995 | dimNAM(3) = 'none' |
---|
| 1996 | dNAMtim = 'none' |
---|
| 1997 | dimREG(4) = 0 |
---|
| 1998 | begREG(4) = 0 |
---|
| 1999 | dimNAM(4) = 'none' |
---|
| 2000 | ELSE |
---|
| 2001 | WRITE(*,*) 'UNread ERROR : data field dimension ?' |
---|
| 2002 | STOP |
---|
| 2003 | END IF |
---|
| 2004 | |
---|
| 2005 | DO z = 1,varNUMDIM |
---|
| 2006 | IF (begREG(z).gt.dimSIZ(z)) THEN |
---|
| 2007 | write(*,*) 'UNread - ERROR : requested area out ' |
---|
| 2008 | write(*,*) ' of file area. ' |
---|
| 2009 | write(*,*) ' (for the dimension:' , dimNAM(z) , ')' |
---|
| 2010 | STOP |
---|
| 2011 | END IF |
---|
| 2012 | IF (dimSIZ(z).lt.(dimREG(z)+begREG(z)- 1) ) THEN |
---|
| 2013 | write(*,*) 'UNread - WARNING : empty portion in field, ' |
---|
| 2014 | write(*,*) ' requested region > file contents ' |
---|
| 2015 | write(*,*) ' (for the dimension:' , dimNAM(z) , ')' |
---|
| 2016 | dimREG(z) = dimSIZ(z) - begREG(z) + 1 |
---|
| 2017 | END IF |
---|
| 2018 | END DO |
---|
| 2019 | |
---|
| 2020 | IF (icheck.ge.3) WRITE(*,*) 'Ierro2. ', Ierro |
---|
| 2021 | IF (icheck.ge.2) WRITE(*,*) 'Dimension names :',dimNAM |
---|
| 2022 | IF (icheck.ge.2) WRITE(*,*) 'dimSIZ :',dimSIZ |
---|
| 2023 | IF (icheck.ge.2) WRITE(*,*) 'dimREG :',dimREG |
---|
| 2024 | IF (icheck.ge.2) WRITE(*,*) 'begREG :',begREG |
---|
| 2025 | IF (icheck.ge.3) WRITE(*,*) 'dimID :',dimID |
---|
| 2026 | |
---|
| 2027 | C* 3. Get the variables IDs for the grid points locations. |
---|
| 2028 | C ------------------------------------------------------- |
---|
| 2029 | |
---|
| 2030 | IF (varNUMDIM.ge.2) THEN |
---|
| 2031 | Ierro=NF_INQ_VARID (FILEid, dimNAM(1), ax1VID) |
---|
| 2032 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2033 | IF (Ierro.EQ.NF_ENOTVAR) THEN |
---|
| 2034 | WRITE(*,*) 'Coordinate values not found:',dimNAM(1) |
---|
| 2035 | ENDIF |
---|
| 2036 | CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2037 | ENDIF |
---|
| 2038 | Ierro=NF_INQ_VARID (FILEid, dimNAM(2), ax2VID) |
---|
| 2039 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2040 | IF (Ierro.EQ.NF_ENOTVAR) THEN |
---|
| 2041 | WRITE(*,*) 'Coordinate values not found:',dimNAM(2) |
---|
| 2042 | ENDIF |
---|
| 2043 | CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2044 | ENDIF |
---|
| 2045 | ENDIF |
---|
| 2046 | IF (varNUMDIM.ge.3) THEN |
---|
| 2047 | Ierro=NF_INQ_VARID (FILEid, dNAMtim, timVID) |
---|
| 2048 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2049 | IF (Ierro.EQ.NF_ENOTVAR) THEN |
---|
| 2050 | WRITE(*,*) 'Coordinate values not found:',dNAMtim |
---|
| 2051 | ENDIF |
---|
| 2052 | CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2053 | ENDIF |
---|
| 2054 | END IF |
---|
| 2055 | IF (varNUMDIM.eq.4) THEN |
---|
| 2056 | Ierro=NF_INQ_VARID (FILEid, dNAMver, verVID) |
---|
| 2057 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2058 | IF (Ierro.EQ.NF_ENOTVAR) THEN |
---|
| 2059 | WRITE(*,*) 'Coordinate values not found:',dNAMver |
---|
| 2060 | ENDIF |
---|
| 2061 | CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2062 | ENDIF |
---|
| 2063 | END IF |
---|
| 2064 | C ** id/file name id/var |
---|
| 2065 | |
---|
| 2066 | IF (icheck.ge.3) WRITE(*,*) 'Ierro3. ', Ierro |
---|
| 2067 | |
---|
| 2068 | C* 4. Get attributes. |
---|
| 2069 | C ------------------ |
---|
| 2070 | |
---|
| 2071 | IF (varNUMDIM.ge.2) THEN !Not for 1D vectors (special case) |
---|
| 2072 | C ** units attribute |
---|
| 2073 | Ierro=NF_GET_ATT_TEXT (FILEid , varVID, 'units', |
---|
| 2074 | & var_units) |
---|
| 2075 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2076 | IF (Ierro.EQ.NF_ENOTATT) THEN |
---|
| 2077 | write(*,*) 'Note (UNread): units not found for' |
---|
| 2078 | write(*,*) ' ',varName |
---|
| 2079 | var_units=' ' |
---|
| 2080 | ELSE |
---|
| 2081 | CALL HANDLE_ERR('UNread',Ierro) |
---|
| 2082 | ENDIF |
---|
| 2083 | ENDIF |
---|
| 2084 | |
---|
| 2085 | IF (icheck.ge.2) WRITE(*,*) 'var_units :', var_units |
---|
| 2086 | ENDIF |
---|
| 2087 | |
---|
| 2088 | C* 5. Get values. |
---|
| 2089 | C -------------- |
---|
| 2090 | C* 5.1 ...for the grid points locations. |
---|
| 2091 | C ------------------------------------- |
---|
| 2092 | |
---|
| 2093 | C ** Horizontal : always read, except for 1D vectors |
---|
| 2094 | IF (varNUMDIM.ge.2) THEN |
---|
| 2095 | count(1)=dimREG(1) |
---|
| 2096 | start(1)=begREG(1) |
---|
| 2097 | Ierro=NF_GET_VARA_REAL(FILEid ,ax1VID,start,count,varax1) |
---|
| 2098 | C ** id/file id/var from #data data |
---|
| 2099 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2100 | count(1)=dimREG(2) |
---|
| 2101 | start(1)=begREG(2) |
---|
| 2102 | Ierro=NF_GET_VARA_REAL(FILEid ,ax2VID,start,count,varax2) |
---|
| 2103 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2104 | ENDIF |
---|
| 2105 | |
---|
| 2106 | C ** vertical : only for 3D fields. |
---|
| 2107 | IF (varNUMDIM.eq.4) THEN |
---|
| 2108 | start(1) =begREG(3) |
---|
| 2109 | count(1) =dimREG(3) |
---|
| 2110 | Ierro = NF_GET_VARA_REAL(FILEid ,verVID,start,count,varlev) |
---|
| 2111 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2112 | END IF |
---|
| 2113 | |
---|
| 2114 | IF (icheck.ge.3) WRITE(*,*) 'Ierro5.1', Ierro |
---|
| 2115 | |
---|
| 2116 | C* 5.2 ...for the the variable. |
---|
| 2117 | C ---------------------------- |
---|
| 2118 | |
---|
| 2119 | C ** Set 'imap' and READ with NCVGTG: |
---|
| 2120 | C ** NOTE : |
---|
| 2121 | C ** we use the 'generalised' reading routine NCVGTG |
---|
| 2122 | C ** (imap tells NetCDF about the memory locations of var) |
---|
| 2123 | imap(1) = 1 |
---|
| 2124 | imap(2) = imap(1) * i_dim ! 1st dim of var = i_dim |
---|
| 2125 | imap(3) = imap(2) * j_dim ! 2nd dim of var = j_dim |
---|
| 2126 | imap(4) = 0 ! Should NEVER be used |
---|
| 2127 | Ierro=NF_GET_VARM_REAL(FILEid , varVID ,begREG , dimREG, |
---|
| 2128 | & stride , imap ,var(1,1,1) ) |
---|
| 2129 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR(Routine, Ierro) |
---|
| 2130 | |
---|
| 2131 | IF (icheck.ge.3) WRITE(*,*) 'Ierro5.2', Ierro |
---|
| 2132 | |
---|
| 2133 | C* 6. Check data |
---|
| 2134 | C ------------- |
---|
| 2135 | IF (ireadchk.GE.1) THEN |
---|
| 2136 | varmax = var (1,1,1) |
---|
| 2137 | varmin = var (1,1,1) |
---|
| 2138 | DO ll=1,l_dim |
---|
| 2139 | DO jj=1,j_dim |
---|
| 2140 | DO ii=1,i_dim |
---|
| 2141 | var(ii,jj,ll)=var(ii,jj,ll)+0.0E0 |
---|
| 2142 | C This fixes underflow values but must compile with -fpe1 |
---|
| 2143 | varmax = MAX(var (ii,jj,ll),varmax) |
---|
| 2144 | varmin = MIN(var (ii,jj,ll),varmin) |
---|
| 2145 | ENDDO |
---|
| 2146 | ENDDO |
---|
| 2147 | ENDDO |
---|
| 2148 | IF (varmin.LT.vReadMin .OR. varmax.GT.vReadMax) THEN |
---|
| 2149 | write(*,*) 'WARNING (UNread): variable ', VARname |
---|
| 2150 | write(*,*) ' is out of specified bounds;' |
---|
| 2151 | write(*,*) ' min is:', varmin |
---|
| 2152 | write(*,*) ' max is:', varmax |
---|
| 2153 | ENDIF |
---|
| 2154 | ENDIF |
---|
| 2155 | |
---|
| 2156 | IF (icheck.ge.2) WRITE(*,*) 'UNread : End' |
---|
| 2157 | |
---|
| 2158 | END SUBROUTINE UNread |
---|
| 2159 | |
---|
| 2160 | C** |
---|
| 2161 | C** +-------------------------+-----------------------------------------+ |
---|
| 2162 | C** + Subroutine UNsread : + + |
---|
| 2163 | C** +-------------------------+ + |
---|
| 2164 | C** + * Reads a model variable from a NetCDF file, + |
---|
| 2165 | C** + SIMPLIFIED VERSION of UNread : does NOT read coordinates. + |
---|
| 2166 | C** + + |
---|
| 2167 | C** + + |
---|
| 2168 | C** + INPUT : + |
---|
| 2169 | C** + FILEid : input file identifier (from NetCDF open) + |
---|
| 2170 | C** + VARname : name of the requested variable. + |
---|
| 2171 | C** + time : [integer*4] is the time index of the data field to read + |
---|
| 2172 | C** + level: [integer*4] (usefull for 3D-space fields only) : + |
---|
| 2173 | C** + if not=0 --> = no of the level + |
---|
| 2174 | C** + -> output is 2D (l_dim = 1) + |
---|
| 2175 | C** + if =0 --> read ALL levels + |
---|
| 2176 | C** + -> output is 3D + |
---|
| 2177 | C** + i_dbeg, j_dbeg : horizontal indexes of requested region + |
---|
| 2178 | C** + in input data file + |
---|
| 2179 | C** + i_dim, j_dim, l_dim : ...the dimensions of 'var', + |
---|
| 2180 | C** + = the dimensions of the sub-region to read + |
---|
| 2181 | C** + ! l_dim = 1 if level not=0 + |
---|
| 2182 | C** + ! j_dim = 1 if var is 1D + |
---|
| 2183 | C** + OUTPUT : + |
---|
| 2184 | C** + var_units : physical units of var. + |
---|
| 2185 | C** + var[i_dim,j_dim,l_dim] : + |
---|
| 2186 | C** + data field values + |
---|
| 2187 | C** + (var must be defined, and is REAL ) + |
---|
| 2188 | C** + + |
---|
| 2189 | C** +-------------------------------------------------------------------+ |
---|
| 2190 | |
---|
| 2191 | SUBROUTINE UNsread |
---|
| 2192 | & (FILEid, VARname, time, level, i_dbeg, j_dbeg, |
---|
| 2193 | & i_dim , j_dim , l_dim, |
---|
| 2194 | & var_units, var) |
---|
| 2195 | |
---|
| 2196 | |
---|
| 2197 | |
---|
| 2198 | IMPLICIT NONE |
---|
| 2199 | |
---|
| 2200 | C ** input |
---|
| 2201 | INTEGER FILEid |
---|
| 2202 | INTEGER time, level, i_dbeg, j_dbeg |
---|
| 2203 | INTEGER i_dim, j_dim, l_dim |
---|
| 2204 | CHARACTER *(*) VARname |
---|
| 2205 | |
---|
| 2206 | C ** output |
---|
| 2207 | CHARACTER *(*) var_units |
---|
| 2208 | REAL*4 var (i_dim, j_dim, l_dim) |
---|
| 2209 | REAL*4 varax1(i_dim), varax2(j_dim), varlev(l_dim) |
---|
| 2210 | |
---|
| 2211 | call UNread (FILEid , VARname , time, level, i_dbeg, j_dbeg, |
---|
| 2212 | & i_dim , j_dim , l_dim , |
---|
| 2213 | & varax1 , varax2 , varlev, |
---|
| 2214 | & var_units, var) |
---|
| 2215 | |
---|
| 2216 | |
---|
| 2217 | END SUBROUTINE UNsread |
---|
| 2218 | |
---|
| 2219 | C** +-------------------------+-----------------------------------------+ |
---|
| 2220 | C** + Subroutine UNwcatt : + + |
---|
| 2221 | C** +-------------------------+ + |
---|
| 2222 | C** + *Character Attributes creation and (over)writing + |
---|
| 2223 | C** + (the NetCDF file must be open, in data mode) + |
---|
| 2224 | C** + *WARNING: this routine (may?) use a temporary disk space + |
---|
| 2225 | C** + equal to the file length (duplicate the file) + |
---|
| 2226 | C** + + |
---|
| 2227 | C** + INPUT : + |
---|
| 2228 | C** + FILEid : input file identifier (from UNcreate OR NetCDF open) + |
---|
| 2229 | C** + varnam : name of variable to which attribute shall be attached+ |
---|
| 2230 | C** + or 'GLOBAL_ATT' + |
---|
| 2231 | C** + attnam : name of writen attribute. + |
---|
| 2232 | C** + attval : string to be assigned to attribute. + |
---|
| 2233 | C** + (never inclulde more than 3 consecutive blanks !) + |
---|
| 2234 | c** + + |
---|
| 2235 | C** + Note : all arguments except FILEid are strings of any length + |
---|
| 2236 | C** +-------------------------------------------------------------------+ |
---|
| 2237 | |
---|
| 2238 | SUBROUTINE UNwcatt (FILEid , varnam, attnam, attval) |
---|
| 2239 | |
---|
| 2240 | INCLUDE 'libUN.inc' |
---|
| 2241 | |
---|
| 2242 | C **Input: |
---|
| 2243 | |
---|
| 2244 | INTEGER FILEid |
---|
| 2245 | CHARACTER*(*) varnam |
---|
| 2246 | CHARACTER*(*) attnam |
---|
| 2247 | CHARACTER*(*) attval |
---|
| 2248 | |
---|
| 2249 | C **Local: |
---|
| 2250 | INTEGER VARSIZE |
---|
| 2251 | EXTERNAL VARSIZE |
---|
| 2252 | INTEGER Nlen, Ierro, varVID, Vlen, TTerr |
---|
| 2253 | INTEGER icheck |
---|
| 2254 | icheck= 0 !** 'debugging' level |
---|
| 2255 | |
---|
| 2256 | IF (icheck.ge.1) WRITE(*,*) 'UNwcatt : Begin' |
---|
| 2257 | |
---|
| 2258 | C* Get the variable ID |
---|
| 2259 | C ------------------- |
---|
| 2260 | |
---|
| 2261 | IF (icheck.ge.2) WRITE(*,*) 'FILEid :', FILEid |
---|
| 2262 | |
---|
| 2263 | C ** getting varnam size : |
---|
| 2264 | Nlen = VARSIZE(varnam) |
---|
| 2265 | |
---|
| 2266 | C ** Case of global attributes: |
---|
| 2267 | IF (varnam(1:Nlen).EQ.'GLOBAL_ATT') THEN |
---|
| 2268 | varVID=NF_GLOBAL |
---|
| 2269 | |
---|
| 2270 | ELSE |
---|
| 2271 | |
---|
| 2272 | C ** Get variable ID to which att is attached to: |
---|
| 2273 | Ierro=NF_INQ_VARID (FILEid , varnam(1:Nlen), varVID) |
---|
| 2274 | TTerr = ABS(Ierro) |
---|
| 2275 | |
---|
| 2276 | C ** Cancel writing if an error occured : variable undefined ? |
---|
| 2277 | IF (Ierro.ne.0) THEN |
---|
| 2278 | WRITE(*,*) 'UNwcatt -ERROR : Variable ',varnam(1:Nlen) |
---|
| 2279 | & ,' not found -> not written.' |
---|
| 2280 | END IF |
---|
| 2281 | IF (Ierro.ne.0) RETURN !** UNwcatt_end |
---|
| 2282 | |
---|
| 2283 | ENDIF |
---|
| 2284 | |
---|
| 2285 | C Switch to Define Mode, |
---|
| 2286 | C because attribute may be created or change size. |
---|
| 2287 | C -------------------------------------------------- |
---|
| 2288 | Ierro=NF_REDEF (FILEid) |
---|
| 2289 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwcatt', Ierro) |
---|
| 2290 | |
---|
| 2291 | C Set attribute. |
---|
| 2292 | C -------------- |
---|
| 2293 | |
---|
| 2294 | C ** getting attnam [char] size : |
---|
| 2295 | Nlen = VARSIZE(attnam) |
---|
| 2296 | C ** getting attval [char] size : |
---|
| 2297 | Vlen = VARSIZE(attval) |
---|
| 2298 | |
---|
| 2299 | Ierro=NF_PUT_ATT_TEXT(FILEid ,varVID ,attnam(1:Nlen), |
---|
| 2300 | & Vlen ,attval(1:Vlen) ) |
---|
| 2301 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwcatt', Ierro) |
---|
| 2302 | c **line1^^^^ FILEid |var.id | attr.name |
---|
| 2303 | C **line2 type | len | attr.value | flag |
---|
| 2304 | TTerr = TTerr + ABS(Ierro) |
---|
| 2305 | |
---|
| 2306 | |
---|
| 2307 | C Leave define mode (!file remains open ) |
---|
| 2308 | C --------------------------------------- |
---|
| 2309 | Ierro=NF_ENDDEF(FILEid ) |
---|
| 2310 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwcatt', Ierro) |
---|
| 2311 | |
---|
| 2312 | RETURN |
---|
| 2313 | END |
---|
| 2314 | |
---|
| 2315 | C** +-------------------------+-----------------------------------------+ |
---|
| 2316 | C** + Subroutine UNwratt : + + |
---|
| 2317 | C** +-------------------------+ + |
---|
| 2318 | C** + *Real attributes writing - ! Can not create new attrib ! + |
---|
| 2319 | C** + (the NetCDF file must be open) + |
---|
| 2320 | C** + + |
---|
| 2321 | C** + INPUT : + |
---|
| 2322 | C** + FILEid : input file identifier (from UNcreate OR NetCDF open) + |
---|
| 2323 | C** + varnam : name given to the variable to write (must be in file)+ |
---|
| 2324 | C** + attnam : name of treated attribute. + |
---|
| 2325 | c** + Nvals : Number of values of that attribute + |
---|
| 2326 | C** + atvalsi(Nvals) : Real vector of values for attribute. + |
---|
| 2327 | c** + + |
---|
| 2328 | C** +-------------------------------------------------------------------+ |
---|
| 2329 | |
---|
| 2330 | C WARNING: this routine uses a temporary disk space |
---|
| 2331 | C equal to the file length (duplicate the file) |
---|
| 2332 | C (its use is NOT recommended) |
---|
| 2333 | |
---|
| 2334 | SUBROUTINE UNwratt (FILEid , varnam, attnam, Nvals, atvals) |
---|
| 2335 | |
---|
| 2336 | INCLUDE 'libUN.inc' |
---|
| 2337 | |
---|
| 2338 | C **Input: |
---|
| 2339 | |
---|
| 2340 | INTEGER FILEid , Nvals |
---|
| 2341 | CHARACTER*(*) varnam |
---|
| 2342 | CHARACTER*(*) attnam |
---|
| 2343 | REAL*4 atvals(Nvals) |
---|
| 2344 | |
---|
| 2345 | C **Local: |
---|
| 2346 | INTEGER VARSIZE |
---|
| 2347 | EXTERNAL VARSIZE |
---|
| 2348 | INTEGER Nlen, Ierro, varVID |
---|
| 2349 | INTEGER icheck, TTerr |
---|
| 2350 | icheck= 0 !** 'debugging' level |
---|
| 2351 | TTerr = 0 |
---|
| 2352 | |
---|
| 2353 | IF (icheck.ge.1) WRITE(*,*) 'UNwratt : Begin' |
---|
| 2354 | |
---|
| 2355 | C* Get the variable ID |
---|
| 2356 | C ------------------- |
---|
| 2357 | IF (icheck.ge.2) WRITE(*,*) 'FILEid :', FILEid |
---|
| 2358 | |
---|
| 2359 | C ** getting varnam size : |
---|
| 2360 | Nlen = VARSIZE(varnam) |
---|
| 2361 | |
---|
| 2362 | C ** variable ID : |
---|
| 2363 | Ierro=NF_INQ_VARID(FILEid , varnam(1:Nlen), varVID) |
---|
| 2364 | TTerr = TTerr + ABS(Ierro) |
---|
| 2365 | |
---|
| 2366 | C ** Cancel writing if an error occured : variable undefined ? |
---|
| 2367 | IF (Ierro.ne.0) THEN |
---|
| 2368 | WRITE(*,*) 'UNwratt -ERROR : Variable ',varnam(1:Nlen) |
---|
| 2369 | & ,' not found -> not written.' |
---|
| 2370 | END IF |
---|
| 2371 | IF (Ierro.ne.0) GOTO 9999 !** UNwratt_end |
---|
| 2372 | |
---|
| 2373 | |
---|
| 2374 | C Set attribute. |
---|
| 2375 | C -------------- |
---|
| 2376 | |
---|
| 2377 | C ** getting attnam [char] size : |
---|
| 2378 | Nlen = VARSIZE(attnam) |
---|
| 2379 | |
---|
| 2380 | Ierro=NF_PUT_ATT_REAL(FILEid ,varVID ,attnam(1:Nlen), |
---|
| 2381 | & NF_FLOAT,nvals ,atvals ) |
---|
| 2382 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNwratt', Ierro) |
---|
| 2383 | c **line1^^^^FILEid |var.id | attr.name |
---|
| 2384 | C **line2 type | attr.value | flag |
---|
| 2385 | TTerr = TTerr + ABS(Ierro) |
---|
| 2386 | |
---|
| 2387 | |
---|
| 2388 | 9999 continue |
---|
| 2389 | RETURN |
---|
| 2390 | END |
---|
| 2391 | |
---|
| 2392 | C** +-------------------------+-----------------------------------------+ |
---|
| 2393 | C** + Subroutine UNwopen : + libUN (0896) + |
---|
| 2394 | C** +-------------------------+-----------------------------------------+ |
---|
| 2395 | C** + * Open a NetCDF file for writing. + |
---|
| 2396 | C** + + |
---|
| 2397 | C** + INPUT : + |
---|
| 2398 | C** + FILEnam : file name + |
---|
| 2399 | C** + + |
---|
| 2400 | C** + OUTPUT : + |
---|
| 2401 | C** + FILEid : NetCDF file identifier ('logical unit') + |
---|
| 2402 | C** +---------------------------------------------------------------7++++ |
---|
| 2403 | |
---|
| 2404 | SUBROUTINE UNwopen (FILEnam, FILEid ) |
---|
| 2405 | |
---|
| 2406 | IMPLICIT NONE |
---|
| 2407 | INCLUDE 'libUN.inc' |
---|
| 2408 | |
---|
| 2409 | C ** input |
---|
| 2410 | CHARACTER*(*) FILEnam |
---|
| 2411 | |
---|
| 2412 | C ** output |
---|
| 2413 | INTEGER FILEid |
---|
| 2414 | |
---|
| 2415 | C ** local : |
---|
| 2416 | INTEGER Ierro |
---|
| 2417 | INTEGER icheck |
---|
| 2418 | |
---|
| 2419 | icheck=0 |
---|
| 2420 | |
---|
| 2421 | C + Routines which opens a file must reset libUN internals: |
---|
| 2422 | CALL UNparam('RESET_PARAMS_',0.0) |
---|
| 2423 | |
---|
| 2424 | C ** Open NetCDF file, for read-only: |
---|
| 2425 | C ----------------------------------- |
---|
| 2426 | Ierro=NF_OPEN(FILEnam,NF_WRITE,FILEid) |
---|
| 2427 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2428 | WRITE(*,*) 'Error opening file: ', FILEnam |
---|
| 2429 | CALL HANDLE_ERR('UNwopen', Ierro) |
---|
| 2430 | ENDIF |
---|
| 2431 | |
---|
| 2432 | |
---|
| 2433 | 9999 continue |
---|
| 2434 | RETURN |
---|
| 2435 | END |
---|
| 2436 | |
---|
| 2437 | |
---|
| 2438 | |
---|
| 2439 | C** +-------------------------+-----------------------------------------+ |
---|
| 2440 | C** + Subroutine UNropen : + libUN (0896) + |
---|
| 2441 | C** +-------------------------+-----------------------------------------+ |
---|
| 2442 | C** + * Open a NetCDF file for reading, + |
---|
| 2443 | C** + + |
---|
| 2444 | C** + INPUT : + |
---|
| 2445 | C** + FILEnam : file name + |
---|
| 2446 | C** + + |
---|
| 2447 | C** + OUTPUT : + |
---|
| 2448 | C** + FILEid : NetCDF file identifier ('logical unit') + |
---|
| 2449 | C** + FILEtit : title of the NetCDF file + |
---|
| 2450 | C** + ! [CHAR], must be defined (length > length(title) !) + |
---|
| 2451 | C** +---------------------------------------------------------------7++++ |
---|
| 2452 | |
---|
| 2453 | SUBROUTINE UNropen (FILEnam, FILEid , FILEtit) |
---|
| 2454 | |
---|
| 2455 | IMPLICIT NONE |
---|
| 2456 | INCLUDE 'libUN.inc' |
---|
| 2457 | |
---|
| 2458 | C ** input |
---|
| 2459 | CHARACTER*(*) FILEnam |
---|
| 2460 | |
---|
| 2461 | C ** output |
---|
| 2462 | INTEGER FILEid |
---|
| 2463 | CHARACTER*(*) FILEtit |
---|
| 2464 | |
---|
| 2465 | C ** local : |
---|
| 2466 | INTEGER Ierro |
---|
| 2467 | INTEGER icheck |
---|
| 2468 | |
---|
| 2469 | icheck=0 |
---|
| 2470 | |
---|
| 2471 | IF (icheck.ge.2) WRITE(*,*) 'UNropen: Begin' |
---|
| 2472 | IF (icheck.ge.2) WRITE(*,*) 'FILEnam: ', FILEnam |
---|
| 2473 | |
---|
| 2474 | C + Routines which opens a file must reset libUN internals: |
---|
| 2475 | CALL UNparam('RESET_PARAMS_',0.0) |
---|
| 2476 | |
---|
| 2477 | C ** Open NetCDF file, for read-only: |
---|
| 2478 | C ----------------------------------- |
---|
| 2479 | Ierro=NF_OPEN(FILEnam,NF_NOWRITE,FILEid) |
---|
| 2480 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2481 | WRITE(*,*) 'Error opening file: ', FILEnam |
---|
| 2482 | CALL HANDLE_ERR('UNropen', Ierro) |
---|
| 2483 | ENDIF |
---|
| 2484 | |
---|
| 2485 | |
---|
| 2486 | C ** Read title attribute, |
---|
| 2487 | C ------------------------ |
---|
| 2488 | |
---|
| 2489 | C ** Read attribute: |
---|
| 2490 | Ierro=NF_GET_ATT_TEXT(FILEid, NF_GLOBAL, 'title', |
---|
| 2491 | & FILEtit) |
---|
| 2492 | |
---|
| 2493 | C ** Display message if an error occured : |
---|
| 2494 | C ** no title or title too long ? |
---|
| 2495 | IF (Ierro.ne.0) THEN |
---|
| 2496 | WRITE(*,*) 'UNropen WARNING: no title or title too long' |
---|
| 2497 | END IF |
---|
| 2498 | IF (icheck.ge.2) WRITE(*,*) 'UNropen: End' |
---|
| 2499 | |
---|
| 2500 | 9999 continue |
---|
| 2501 | RETURN |
---|
| 2502 | END |
---|
| 2503 | |
---|
| 2504 | C** +-------------------------+-----------------------------------------+ |
---|
| 2505 | C** + Subroutine UNgtime : + libUN (0896) + |
---|
| 2506 | C** +-------------------------+-----------------------------------------+ |
---|
| 2507 | C** + * From a given value of desired 'time' coordinate, + |
---|
| 2508 | C** + gets the coordinate index ('iteration no') + found time value + |
---|
| 2509 | C** + + |
---|
| 2510 | C** + INPUT : + |
---|
| 2511 | C** + FILEid : NetCDF file identifier (from UNropen) + |
---|
| 2512 | C** + RQtime : ReQuested time + |
---|
| 2513 | C** + + |
---|
| 2514 | C** + OUTPUT : + |
---|
| 2515 | C** + RDtime : The last time for wich RDtime .le. RQtime + |
---|
| 2516 | C** + Ftime : The next time value Following RDtime + |
---|
| 2517 | C** + (-1 if it would be after end-of-file) + |
---|
| 2518 | C** + it : The time index : RDtime = time(it) + |
---|
| 2519 | C** +---------------------------------------------------------------7++++ |
---|
| 2520 | |
---|
| 2521 | SUBROUTINE UNgtime (FILEid, RQtime, RDtime, Ftime, it) |
---|
| 2522 | |
---|
| 2523 | IMPLICIT NONE |
---|
| 2524 | INCLUDE 'libUN.inc' |
---|
| 2525 | |
---|
| 2526 | INTEGER Lvnam |
---|
| 2527 | PARAMETER (Lvnam=20) |
---|
| 2528 | |
---|
| 2529 | C ** input |
---|
| 2530 | INTEGER FILEid |
---|
| 2531 | REAL*4 RQtime |
---|
| 2532 | |
---|
| 2533 | C ** output |
---|
| 2534 | REAL*4 RDtime, Ftime |
---|
| 2535 | INTEGER it |
---|
| 2536 | |
---|
| 2537 | C ** local : |
---|
| 2538 | INTEGER Ierro, timVID |
---|
| 2539 | INTEGER timDID |
---|
| 2540 | REAL*4 gtim |
---|
| 2541 | INTEGER K, KHI, KLO, Kmax |
---|
| 2542 | INTEGER Mindex(1) |
---|
| 2543 | INTEGER icheck |
---|
| 2544 | CHARACTER*(Lvnam) dimNAM(1) |
---|
| 2545 | |
---|
| 2546 | icheck= 0 |
---|
| 2547 | |
---|
| 2548 | C ** Kmax= nb pas de temps dans le fichier, = dim(time): |
---|
| 2549 | C ** - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 2550 | C |
---|
| 2551 | Ierro=NF_INQ_DIMID(FILEid, 'time', timDID) |
---|
| 2552 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgtime', Ierro) |
---|
| 2553 | C **^^ Dimension'time' NetCDF index |
---|
| 2554 | |
---|
| 2555 | Ierro=NF_INQ_DIM(FILEid, timDID , dimNAM, Kmax ) |
---|
| 2556 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgtime', Ierro) |
---|
| 2557 | C ** id/file id/dim dimname dimsize error |
---|
| 2558 | C ** !output output |
---|
| 2559 | |
---|
| 2560 | C ** Read/Search the requested time step. |
---|
| 2561 | C ** - - - - - - - - - - - - - - - - - - - |
---|
| 2562 | |
---|
| 2563 | Ierro=NF_INQ_VARID(FILEid, 'time',timVID) |
---|
| 2564 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgtime', Ierro) |
---|
| 2565 | C **^^ Variable 'time' NetCDF index |
---|
| 2566 | |
---|
| 2567 | KLO=1 |
---|
| 2568 | KHI=Kmax |
---|
| 2569 | |
---|
| 2570 | 1 IF (KHI-KLO.GT.1) THEN |
---|
| 2571 | K=(KHI+KLO)/2 |
---|
| 2572 | |
---|
| 2573 | C ** Set the position of the needed time step: |
---|
| 2574 | Mindex(1)= K |
---|
| 2575 | C ** Get 1 time value (gtim = time(K)): |
---|
| 2576 | Ierro=NF_GET_VAR1_REAL(FILEid, timVID, Mindex, gtim) |
---|
| 2577 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgtime', Ierro) |
---|
| 2578 | |
---|
| 2579 | IF(gtim.GT.RQtime)THEN |
---|
| 2580 | KHI=K |
---|
| 2581 | ELSE |
---|
| 2582 | KLO=K |
---|
| 2583 | ENDIF |
---|
| 2584 | GOTO 1 |
---|
| 2585 | ENDIF |
---|
| 2586 | it= KLO |
---|
| 2587 | C ** read RDtime= time(KLO) |
---|
| 2588 | Mindex(1)= KLO |
---|
| 2589 | Ierro=NF_GET_VAR1_REAL(FILEid, timVID, Mindex, RDtime) |
---|
| 2590 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgtime', Ierro) |
---|
| 2591 | C ** read Ftime= time(KHI) |
---|
| 2592 | Mindex(1)= KHI |
---|
| 2593 | Ierro=NF_GET_VAR1_REAL(FILEid, timVID, Mindex, Ftime) |
---|
| 2594 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgtime', Ierro) |
---|
| 2595 | |
---|
| 2596 | C ** IF the last available time step is before |
---|
| 2597 | C ** the requested time, then KHI and KLO are the |
---|
| 2598 | C ** two last available time step. Correct this : |
---|
| 2599 | IF (RQtime.ge.Ftime) THEN |
---|
| 2600 | RDtime= Ftime |
---|
| 2601 | it = KHI |
---|
| 2602 | Ftime= -1.0 |
---|
| 2603 | ENDIF |
---|
| 2604 | |
---|
| 2605 | RETURN |
---|
| 2606 | END |
---|
| 2607 | |
---|
| 2608 | C** +-------------------------+-----------------------------------------+ |
---|
| 2609 | C** + Subroutine UNgindx : + libUN (0199) + |
---|
| 2610 | C** +-------------------------+-----------------------------------------+ |
---|
| 2611 | C** + * From a given value of a desired coordinate, + |
---|
| 2612 | C** + gets the coordinate index + found the coresp. coordinate value + |
---|
| 2613 | C** + + |
---|
| 2614 | C** + INPUT : + |
---|
| 2615 | C** + FILEid : NetCDF file identifier (from UNropen) + |
---|
| 2616 | C** + Cname : The name of the coordinate + |
---|
| 2617 | C** + RQval : The requested value for that coordinate + |
---|
| 2618 | C** + + |
---|
| 2619 | C** + OUTPUT : + |
---|
| 2620 | C** + RDval : The last value for wich RDval .le. RQval + |
---|
| 2621 | C** + Fval : The next val value Following RDval + |
---|
| 2622 | C** + (-1 if it would be after end-of-file) + |
---|
| 2623 | C** + indx : The val index : RDval = value_of_Cname(it) + |
---|
| 2624 | C** +---------------------------------------------------------------7++++ |
---|
| 2625 | |
---|
| 2626 | SUBROUTINE UNgindx (FILEid, Cname, RQval, RDval, Fval, indx) |
---|
| 2627 | |
---|
| 2628 | IMPLICIT NONE |
---|
| 2629 | INCLUDE 'libUN.inc' |
---|
| 2630 | |
---|
| 2631 | INTEGER Lvnam |
---|
| 2632 | PARAMETER (Lvnam=20) |
---|
| 2633 | |
---|
| 2634 | C ** input |
---|
| 2635 | INTEGER FILEid |
---|
| 2636 | CHARACTER *(*) Cname |
---|
| 2637 | REAL*4 RQval |
---|
| 2638 | |
---|
| 2639 | C ** output |
---|
| 2640 | REAL*4 RDval, Fval |
---|
| 2641 | INTEGER indx |
---|
| 2642 | |
---|
| 2643 | C ** local : |
---|
| 2644 | INTEGER VARSIZE |
---|
| 2645 | EXTERNAL VARSIZE |
---|
| 2646 | REAL*4 gval |
---|
| 2647 | INTEGER Ierro |
---|
| 2648 | INTEGER varDID, VNlen, varVID, varNUMDIM |
---|
| 2649 | INTEGER Nvatts, vtype |
---|
| 2650 | INTEGER K, KHI, KLO, Kmax |
---|
| 2651 | INTEGER Mindex(1), dimID(4) |
---|
| 2652 | INTEGER icheck |
---|
| 2653 | CHARACTER*(Lvnam) dimNAM(4) |
---|
| 2654 | CHARACTER*13 recname |
---|
| 2655 | |
---|
| 2656 | icheck= 0 |
---|
| 2657 | |
---|
| 2658 | C ** Kmax= nb pas de temps dans le fichier, = dim(val): |
---|
| 2659 | C ** - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 2660 | C ** get Cname string size : |
---|
| 2661 | VNlen = VARSIZE (Cname) |
---|
| 2662 | C |
---|
| 2663 | C ** get variable ID : |
---|
| 2664 | Ierro=NF_INQ_VARID(FILEid , Cname (1:VNlen), varVID) |
---|
| 2665 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgindex', Ierro) |
---|
| 2666 | C |
---|
| 2667 | C ** Inquire about the id of the dimension: |
---|
| 2668 | C ** |
---|
| 2669 | Ierro=NF_INQ_VAR(FILEid , varVID, recname, vtype, |
---|
| 2670 | & varNUMDIM, dimID , Nvatts) |
---|
| 2671 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgindex', Ierro) |
---|
| 2672 | C ** line1 id/file id/var var name var type |
---|
| 2673 | C ** line2 # dims id/dims #attributes |
---|
| 2674 | varDID = dimID(1) |
---|
| 2675 | C ^^^At last, the id of the relevant dimension. |
---|
| 2676 | |
---|
| 2677 | Ierro=NF_INQ_DIM(FILEid, varDID , dimNAM, Kmax ) |
---|
| 2678 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgindex', Ierro) |
---|
| 2679 | C ** id/file id/dim dimname dimsize error |
---|
| 2680 | C ** !output output |
---|
| 2681 | C ** (Kmax is what we needed: size of the dimension) |
---|
| 2682 | |
---|
| 2683 | C ** Read/Search the requested val step. |
---|
| 2684 | C ** - - - - - - - - - - - - - - - - - - - |
---|
| 2685 | |
---|
| 2686 | KLO=1 |
---|
| 2687 | KHI=Kmax |
---|
| 2688 | |
---|
| 2689 | 1 IF (KHI-KLO.GT.1) THEN |
---|
| 2690 | K=(KHI+KLO)/2 |
---|
| 2691 | |
---|
| 2692 | C ** Set the position of the needed val step: |
---|
| 2693 | Mindex(1)= K |
---|
| 2694 | C ** Get 1 val value (gval = val(K)): |
---|
| 2695 | Ierro=NF_GET_VAR1_REAL(FILEid, varVID, Mindex, gval) |
---|
| 2696 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgindex', Ierro) |
---|
| 2697 | |
---|
| 2698 | IF(gval.GT.RQval)THEN |
---|
| 2699 | KHI=K |
---|
| 2700 | ELSE |
---|
| 2701 | KLO=K |
---|
| 2702 | ENDIF |
---|
| 2703 | GOTO 1 |
---|
| 2704 | ENDIF |
---|
| 2705 | indx= KLO |
---|
| 2706 | C ** read RDval= val(KLO) |
---|
| 2707 | Mindex(1)= KLO |
---|
| 2708 | Ierro=NF_GET_VAR1_REAL(FILEid, varVID, Mindex, RDval) |
---|
| 2709 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgindex', Ierro) |
---|
| 2710 | C ** read Fval= val(KHI) |
---|
| 2711 | Mindex(1)= KHI |
---|
| 2712 | Ierro=NF_GET_VAR1_REAL(FILEid, varVID, Mindex, Fval) |
---|
| 2713 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNgindex', Ierro) |
---|
| 2714 | |
---|
| 2715 | C ** IF the last available val step is before |
---|
| 2716 | C ** the requested val, then KHI and KLO are the |
---|
| 2717 | C ** two last available val step. Correct this : |
---|
| 2718 | IF (RQval.ge.Fval) THEN |
---|
| 2719 | RDval= Fval |
---|
| 2720 | indx = KHI |
---|
| 2721 | Fval= -1.0 |
---|
| 2722 | ENDIF |
---|
| 2723 | |
---|
| 2724 | RETURN |
---|
| 2725 | END |
---|
| 2726 | |
---|
| 2727 | C** +-------------------------+-----------------------------------------+ |
---|
| 2728 | C** + Subroutine UNfindx : + (libUN 2003)+ |
---|
| 2729 | C** +-------------------------+-----------------------------------------+ |
---|
| 2730 | C** + * Intended to replace UNgindx or UNgtime + |
---|
| 2731 | C** + From a given value of a desired coordinate, + |
---|
| 2732 | C** + gets the coordinate index + the coresp. coordinate value + |
---|
| 2733 | C** + This version solves the issue of Dates at year change + |
---|
| 2734 | C** + occuring because 1 jan is < 31 dec. Not optimised. + |
---|
| 2735 | C** + + |
---|
| 2736 | C** + INPUT : + |
---|
| 2737 | C** + FILEid : NetCDF file identifier (from UNropen) + |
---|
| 2738 | C** + Cname : The name of the coordinate + |
---|
| 2739 | C** + RQval : The requested value for that coordinate + |
---|
| 2740 | C** + + |
---|
| 2741 | C** + OUTPUT : + |
---|
| 2742 | C** + RDval : The file value closest to RQval + |
---|
| 2743 | C** + Fval : The next value in the file + |
---|
| 2744 | C** + (-1 if after file end) + |
---|
| 2745 | C** + (This is mainly for compatibility with older version)+ |
---|
| 2746 | C** + indx : The val index : RDval = value_of_Cname(it) + |
---|
| 2747 | C** + (-1 may be returned if the value can't be found) + |
---|
| 2748 | C** +---------------------------------------------------------------7++++ |
---|
| 2749 | |
---|
| 2750 | SUBROUTINE UNfindx (FILEid, Cname, RQval, RDval, Fval, indx) |
---|
| 2751 | |
---|
| 2752 | IMPLICIT NONE |
---|
| 2753 | INCLUDE 'libUN.inc' |
---|
| 2754 | |
---|
| 2755 | INTEGER Lvnam |
---|
| 2756 | PARAMETER (Lvnam=20) |
---|
| 2757 | |
---|
| 2758 | C ** input |
---|
| 2759 | INTEGER FILEid |
---|
| 2760 | CHARACTER *(*) Cname |
---|
| 2761 | REAL*4 RQval |
---|
| 2762 | |
---|
| 2763 | C ** output |
---|
| 2764 | REAL*4 RDval, Fval |
---|
| 2765 | INTEGER indx |
---|
| 2766 | |
---|
| 2767 | C ** local : |
---|
| 2768 | INTEGER VARSIZE |
---|
| 2769 | EXTERNAL VARSIZE |
---|
| 2770 | REAL*4 gval, bmatch, gdist |
---|
| 2771 | INTEGER Ierro |
---|
| 2772 | INTEGER varDID, VNlen, varVID, varNUMDIM |
---|
| 2773 | INTEGER Nvatts, vtype |
---|
| 2774 | INTEGER K, KHI, KLO, Kmax |
---|
| 2775 | INTEGER Mindex(1), dimID(4) |
---|
| 2776 | INTEGER icheck |
---|
| 2777 | CHARACTER*(Lvnam) dimNAM(4) |
---|
| 2778 | CHARACTER*13 recname |
---|
| 2779 | |
---|
| 2780 | icheck= 0 |
---|
| 2781 | |
---|
| 2782 | C ** Kmax= nb pas de temps dans le fichier, = dim(val): |
---|
| 2783 | C ** - - - - - - - - - - - - - - - - - - - - - - - - - - |
---|
| 2784 | C ** get Cname string size : |
---|
| 2785 | VNlen = VARSIZE (Cname) |
---|
| 2786 | C |
---|
| 2787 | C ** get variable ID : |
---|
| 2788 | Ierro=NF_INQ_VARID(FILEid , Cname (1:VNlen), varVID) |
---|
| 2789 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNfindex', Ierro) |
---|
| 2790 | C |
---|
| 2791 | C ** Inquire about the id of the dimension: |
---|
| 2792 | C ** |
---|
| 2793 | Ierro=NF_INQ_VAR(FILEid , varVID, recname, vtype, |
---|
| 2794 | & varNUMDIM, dimID , Nvatts) |
---|
| 2795 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNfindex', Ierro) |
---|
| 2796 | C ** line1 id/file id/var var name var type |
---|
| 2797 | C ** line2 # dims id/dims #attributes |
---|
| 2798 | varDID = dimID(1) |
---|
| 2799 | C ^^^At last, the id of the relevant dimension. |
---|
| 2800 | |
---|
| 2801 | Ierro=NF_INQ_DIM(FILEid, varDID , dimNAM, Kmax ) |
---|
| 2802 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNfindex', Ierro) |
---|
| 2803 | C ** id/file id/dim dimname dimsize error |
---|
| 2804 | C ** !output output |
---|
| 2805 | C ** (Kmax is what we needed: size of the dimension) |
---|
| 2806 | |
---|
| 2807 | C ** Read/Search the requested val step. |
---|
| 2808 | C ** - - - - - - - - - - - - - - - - - - - |
---|
| 2809 | |
---|
| 2810 | C This is a workaround, not optimised as stated above. |
---|
| 2811 | C We simply look at all values sequencially. |
---|
| 2812 | C |
---|
| 2813 | bmatch=1.E10 |
---|
| 2814 | KLO=-1 |
---|
| 2815 | |
---|
| 2816 | DO K=1,KMAX |
---|
| 2817 | |
---|
| 2818 | C ** Get 1 val value (gval = val(K)): |
---|
| 2819 | Mindex(1)= K |
---|
| 2820 | Ierro=NF_GET_VAR1_REAL(FILEid, varVID, Mindex, gval) |
---|
| 2821 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNfindex', Ierro) |
---|
| 2822 | |
---|
| 2823 | gdist=ABS(gval-RQval) |
---|
| 2824 | IF (gdist.LT.bmatch) THEN |
---|
| 2825 | |
---|
| 2826 | bmatch=gdist |
---|
| 2827 | KLO=K |
---|
| 2828 | |
---|
| 2829 | ENDIF |
---|
| 2830 | |
---|
| 2831 | ENDDO |
---|
| 2832 | |
---|
| 2833 | indx= KLO |
---|
| 2834 | |
---|
| 2835 | KHI = min((KLO+1),KMAX) |
---|
| 2836 | |
---|
| 2837 | C ** read values... |
---|
| 2838 | |
---|
| 2839 | Mindex(1)= KLO |
---|
| 2840 | Ierro=NF_GET_VAR1_REAL(FILEid, varVID, Mindex, RDval) |
---|
| 2841 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNfindex', Ierro) |
---|
| 2842 | C ** read Fval= val(KHI) |
---|
| 2843 | Mindex(1)= KHI |
---|
| 2844 | Ierro=NF_GET_VAR1_REAL(FILEid, varVID, Mindex, Fval) |
---|
| 2845 | IF (Ierro.NE.NF_NOERR) CALL HANDLE_ERR('UNfindex', Ierro) |
---|
| 2846 | |
---|
| 2847 | IF (KHI.EQ.KLO) THEN |
---|
| 2848 | Fval= -1.0 |
---|
| 2849 | ENDIF |
---|
| 2850 | |
---|
| 2851 | IF (bmatch.GT.1.E9) THEN |
---|
| 2852 | Fval= -1.0 |
---|
| 2853 | indx= -1 |
---|
| 2854 | ENDIF |
---|
| 2855 | |
---|
| 2856 | RETURN |
---|
| 2857 | END |
---|
| 2858 | |
---|
| 2859 | C** +-------------------------+-----------------------------------------+ |
---|
| 2860 | C** + Subroutine UNclose : + libUN (0300) + |
---|
| 2861 | C** +-------------------------+-----------------------------------------+ |
---|
| 2862 | C** + * Close the desired file + |
---|
| 2863 | C** + Created to suppress the need the directly call a netcdf + |
---|
| 2864 | C** + routine from a program + |
---|
| 2865 | C** + + |
---|
| 2866 | C** + INPUT : + |
---|
| 2867 | C** + FILEid : NetCDF file identifier (from UNropen) + |
---|
| 2868 | C** +---------------------------------------------------------------7++++ |
---|
| 2869 | |
---|
| 2870 | SUBROUTINE UNCLOSE(FILEid) |
---|
| 2871 | |
---|
| 2872 | IMPLICIT NONE |
---|
| 2873 | INCLUDE 'libUN.inc' |
---|
| 2874 | |
---|
| 2875 | integer Ierro, FILEid |
---|
| 2876 | |
---|
| 2877 | Ierro=NF_CLOSE(FILEid) |
---|
| 2878 | IF (Ierro.NE.NF_NOERR) THEN |
---|
| 2879 | CALL HANDLE_ERR('UNclose', Ierro) |
---|
| 2880 | ENDIF |
---|
| 2881 | |
---|
| 2882 | END |
---|
| 2883 | |
---|
| 2884 | C** +-------------------------+-----------------------------------------+ |
---|
| 2885 | C** + Subroutine UNparam : + libUN (0202) + |
---|
| 2886 | C** +-------------------------+-----------------------------------------+ |
---|
| 2887 | C** + Changes some global libUN parameters + |
---|
| 2888 | C** + NB: default values are set at first libUN call + |
---|
| 2889 | C** + + |
---|
| 2890 | C** + + |
---|
| 2891 | C** + INPUT : pname name of the parameters to set + |
---|
| 2892 | C** + pvalue the requested new value + |
---|
| 2893 | C** + + |
---|
| 2894 | C** +---------------------------------------------------------------7++++ |
---|
| 2895 | |
---|
| 2896 | SUBROUTINE UNparam(pname,pvalue) |
---|
| 2897 | |
---|
| 2898 | IMPLICIT NONE |
---|
| 2899 | |
---|
| 2900 | INCLUDE 'libUN.inc' |
---|
| 2901 | |
---|
| 2902 | CHARACTER*(*) pname |
---|
| 2903 | REAL*4 pvalue |
---|
| 2904 | |
---|
| 2905 | LOGICAL Lstart |
---|
| 2906 | SAVE Lstart |
---|
| 2907 | DATA Lstart /.true./ |
---|
| 2908 | |
---|
| 2909 | IF (pname.EQ.'RESET_PARAMS_') THEN |
---|
| 2910 | IF (Lstart.OR.pvalue.GT.0.5) THEN |
---|
| 2911 | vMissVal= 1.0E21 ! for missing values |
---|
| 2912 | VarRepl = vMissVal ! for missing VARIABLES |
---|
| 2913 | ValRange(1)= -vMissVal/10. |
---|
| 2914 | ValRange(2)= vMissVal/10. |
---|
| 2915 | iVarWarn= 2 |
---|
| 2916 | vReadMin = 0.0 |
---|
| 2917 | vReadMax = 0.0 |
---|
| 2918 | ireadchk = 0 |
---|
| 2919 | Lstart = .false. |
---|
| 2920 | ENDIF |
---|
| 2921 | |
---|
| 2922 | ELSE IF (pname.EQ.'NOVAR_REPLACE') THEN |
---|
| 2923 | VarRepl = pvalue |
---|
| 2924 | |
---|
| 2925 | ELSE IF (pname.EQ.'NOVAR_WARNING') THEN |
---|
| 2926 | iVarWarn= NINT(pvalue) |
---|
| 2927 | |
---|
| 2928 | ELSE IF (pname.EQ.'VALID_RANGE_MIN') THEN |
---|
| 2929 | ValRange(1) = pvalue |
---|
| 2930 | |
---|
| 2931 | ELSE IF (pname.EQ.'VALID_RANGE_MAX') THEN |
---|
| 2932 | ValRange(2) = pvalue |
---|
| 2933 | |
---|
| 2934 | ELSE IF (pname.EQ.'READOVER_WARN') THEN |
---|
| 2935 | vReadMin = - pvalue |
---|
| 2936 | vReadMax = pvalue |
---|
| 2937 | ireadchk = 1 |
---|
| 2938 | |
---|
| 2939 | ELSE IF (pname.EQ.'READ_MIN_WARN') THEN |
---|
| 2940 | vReadMin = pvalue |
---|
| 2941 | ireadchk = 1 |
---|
| 2942 | |
---|
| 2943 | ELSE IF (pname.EQ.'READ_MAX_WARN') THEN |
---|
| 2944 | vReadMax = pvalue |
---|
| 2945 | ireadchk = 1 |
---|
| 2946 | |
---|
| 2947 | ELSE |
---|
| 2948 | write(*,*) 'UNparam (libUN) Error: ' |
---|
| 2949 | write(*,*) ' parameter undefined:', pname |
---|
| 2950 | |
---|
| 2951 | ENDIF |
---|
| 2952 | |
---|
| 2953 | END |
---|
| 2954 | |
---|
| 2955 | C** +-------------------------+-----------------------------------------+ |
---|
| 2956 | SUBROUTINE UNversion(UNver,NCDFver) |
---|
| 2957 | C** +-------------------------+-----------------------------------------+ |
---|
| 2958 | |
---|
| 2959 | IMPLICIT NONE |
---|
| 2960 | INCLUDE 'libUN.inc' |
---|
| 2961 | |
---|
| 2962 | CHARACTER*80 UNver,NCDFver |
---|
| 2963 | |
---|
| 2964 | UNver = '2005.03.31' |
---|
| 2965 | NCDFver= NF_INQ_LIBVERS() |
---|
| 2966 | |
---|
| 2967 | END |
---|
| 2968 | |
---|
| 2969 | C** +-------------------------------------------------------------------+ |
---|
| 2970 | FUNCTION VARSIZE(CHAvar) |
---|
| 2971 | C** +-------------------------------------------------------------------+ |
---|
| 2972 | IMPLICIT NONE |
---|
| 2973 | integer maxcha,iz,VARSIZE |
---|
| 2974 | parameter (maxcha=512) |
---|
| 2975 | character*(*) CHAvar |
---|
| 2976 | character*(maxcha) CHAtmp |
---|
| 2977 | |
---|
| 2978 | WRITE(CHAtmp,'(A)') CHAvar |
---|
| 2979 | iz = 0 |
---|
| 2980 | do while ((CHAtmp(iz+1:iz+3).ne.' ').and.(iz+3.le.maxcha)) |
---|
| 2981 | iz = iz + 1 |
---|
| 2982 | end do |
---|
| 2983 | VARSIZE = iz |
---|
| 2984 | |
---|
| 2985 | RETURN |
---|
| 2986 | END |
---|
| 2987 | |
---|
| 2988 | |
---|
| 2989 | C** +-------------------------------------------------------------------+ |
---|
| 2990 | SUBROUTINE HANDLE_ERR(LOCATION, STATUS) |
---|
| 2991 | C** +-------------------------------------------------------------------+ |
---|
| 2992 | IMPLICIT NONE |
---|
| 2993 | |
---|
| 2994 | INCLUDE 'libUN.inc' |
---|
| 2995 | |
---|
| 2996 | character*(*) LOCATION |
---|
| 2997 | integer STATUS |
---|
| 2998 | IF (STATUS.NE.NF_NOERR) THEN |
---|
| 2999 | WRITE(*,*) 'IN ROUTINE ', LOCATION |
---|
| 3000 | WRITE(*,*) NF_STRERROR(STATUS) |
---|
| 3001 | STOP 'Stopped' |
---|
| 3002 | ENDIF |
---|
| 3003 | END |
---|
| 3004 | |
---|
| 3005 | C UN library: history of fixed bugs and updates. |
---|
| 3006 | C ---------------------------------------------- |
---|
| 3007 | C |
---|
| 3008 | C 961206 - UNgtime, trouble at end-of-file |
---|
| 3009 | C 961218 - - all -, display 'artificial' errors |
---|
| 3010 | C 970318 - again, display 'artificial' errors |
---|
| 3011 | C 971028 - (3 sub),'syntax'error on Cray computer |
---|
| 3012 | C 971105 - Allowed variable "imap(1)", =8 for Cray |
---|
| 3013 | C 980705 - "single element" extension to UNwrite. |
---|
| 3014 | C 980709 - bug fixes (start) in UNwrite & UNlwrite |
---|
| 3015 | C ("DATA" statement incorrectly used). |
---|
| 3016 | C 980825 - Changed default "stride" to 1 for v3.x |
---|
| 3017 | C 981222 - bug fix: allow UNwrite for unlim dims. |
---|
| 3018 | C note that this should be tested. |
---|
| 3019 | C 990110 - Added "UNgindx" = general. of UNgtime |
---|
| 3020 | C - Removed all "DATA" and all "//" in write |
---|
| 3021 | C (the later should improve compatibility) |
---|
| 3022 | C 990128 - UNwrite: added a "no warning" option. |
---|
| 3023 | C 990323 - UNwrite: added 1D+time capability. |
---|
| 3024 | C 990807 - UNwrite: added 3D-notime capability. |
---|
| 3025 | C ----------------------------------------------------------------------- |
---|
| 3026 | C 000404 - Major upgrade: compatibility with |
---|
| 3027 | C NetCDF v3.4 |
---|
| 3028 | C - NOTE: Types other than REAL may be |
---|
| 3029 | C accepted in UNread, but not tested |
---|
| 3030 | C ----------------------------------------------------------------------- |
---|
| 3031 | C 000614 - Bug fixes: uninitialised error count |
---|
| 3032 | C in UNwcatt, bug in UNclose. |
---|
| 3033 | C 000620 - Bug fix: UNropen (args. of get title fn) |
---|
| 3034 | C 000713 - Bug fix: UNgtime (missing arg in a call) |
---|
| 3035 | C (last tree caused by 000404 upgrade) |
---|
| 3036 | C ----------------------------------------------------------------------- |
---|
| 3037 | C 000928 - UNlwrite: added 2D+time capability. |
---|
| 3038 | C 001008 - All: CHARACTER*(*) declaration for units |
---|
| 3039 | C and longer strings for intern. variables |
---|
| 3040 | C 010417 - UNread: added var not found info |
---|
| 3041 | C UNropen: added file not found info |
---|
| 3042 | C 010715 - UNwrite + UNlwrite: |
---|
| 3043 | C fixed bug / unlimited time dim |
---|
| 3044 | C 0107xx - UNwrite: |
---|
| 3045 | C missing values -> not in "range" |
---|
| 3046 | C 020130 - All: |
---|
| 3047 | C .removed obsolete warnings about |
---|
| 3048 | C double precision in files. |
---|
| 3049 | C .added a version (libUN_dbl) with |
---|
| 3050 | C REAL*8 as arguments - but still |
---|
| 3051 | C creates REAL*4 in files. |
---|
| 3052 | C 020526 - Added UNparam function, |
---|
| 3053 | C which provide optional features such |
---|
| 3054 | C as missing variable behavior control |
---|
| 3055 | C 020808 - Very simple fix for underflows while |
---|
| 3056 | C reading some files; must use -fpe1 |
---|
| 3057 | C Fixed a bug -> out of range msg |
---|
| 3058 | C 030121 - Enabled some non-standard NetCDF files |
---|
| 3059 | C (missing units...) -> new warnings |
---|
| 3060 | C rather then program stop. |
---|
| 3061 | C 030215 - Added UNfindx for non-monotonic data |
---|
| 3062 | C 030215 - Removed warning related to UNLIM dims |
---|
| 3063 | C 030311 - Added VALID_RANGE attribute (option) |
---|
| 3064 | C (if set, the range is accounted for |
---|
| 3065 | C in the min/max set while writing vars) |
---|
| 3066 | C 040902 - Improvements to "valid_range" attribute |
---|
| 3067 | C - Added attribute "positive=down" |
---|
| 3068 | C if units are sigma or sigma_level |
---|
| 3069 | C 050331 - Added "user friendly" interfaces |
---|