README_uflib
06/19/02 C.Ludescher-Furth

See http://w3.pppl.gov/~pshare/help/ufiles_hlp.html
---------------------------------------------------

o w1duf.pro, w2duf.pro, w3duf.pro
  call c wrappers for uflib write routines.

o readuf.pro
  call c wrappers for uflib read routines.

o The libufshr.so routines allow the calling of the uflib
  library routines from IDL.
  c_uf1dw   -- write 1D Ufile
  c_uf2dw   -- write 2D Ufile
  c_uf3dw   -- write 3D Ufile
  c_getdims -- read Ufile header
  c_uf1dr   -- read 1D Ufile
  c_uf2dr   -- read 2D Ufile
  c_uf3dr   -- read 3D Ufile
        Routines called are:
	         ufsetr_
                    / ufhdck_
   	ufopwr_     / ufoprd_
   	uf{1,2}dwr_ / uf{1,2}drd_
   	         ufclos_


o To access uflib IDL routines at PPPL:

     - Add /p/beast/<arch>/lib to your $LD_LIBRARY_PATH.
	   arch = {Sun,Linux,Alpha}
     - Add +/p/beast/idl to your $IDL_PATH.
    
     See /usr/ntcc/etc/.transprc{_csh}     

o IDL Example for 2D Write
    w2duf,' ',dir,'EFIT01_',shot,'Q',ny,nx,nsc,transpose(q),time,psin1,$
    scval,sclab,iproc,$
    flab,xlab,ylab,shdate,mach,cmt,ierr
  
o IDL Example for Read
   readuf,'/u/ludesche/data','R',37065,'BE2',      $ ;input
            shdate,mach,ierr,                      $ ;output
            nsc,scval,sclab,iproc,f,x,nx,flab,xlab $
            y,ny,ylab                                  ; for 2,3D files
            z,nz,zlab                                  ; for 3D file