MERIS IDL General Purpose Tools

Issue 1.1 November 2000

Interfacing w/ Neural Networks

Last modified: Fri Oct 27 15:16:12 2000.

• CALL_NN_FUNC
• INPUT_DATA_NN

Routine Descriptions

 NAME:
 	call_nn_func	

 PURPOSE:
	Run the NN and gives the 3 outputs: CHL2,SPM, YS. 

 CATEGORY:
	NN

 CALLING SEQUENCE:
	nn_input,FILE_INP=file_inp
 
 INPUTS:
       all values are passed with keywords (see below)

 OPTIONAL INPUTS:
       NN_FILE - file holding neural network file
       INP_ARR - array w/ 11 columns holding input values : 
        thetas(rad),thetav(rad),delta_phi(rad),reflectances bands 1-7+9 

 KEYWORD PARAMETERS:
	FILE_INP=file_inp

 OUTPUTS:
	Output is a three-column array holding :
	 Chl2  (mg/m3)
	 Odoc or Ys  (m-1)
	 Spm   (g/m3)

 OPTIONAL OUTPUTS:
	None

 COMMON BLOCKS:
	Called the programs 	/use_nn.c
				/makefile
	Created the program use_nn.so

 SIDE EFFECTS:
	None

 RESTRICTIONS:
	Attention this procedure uses the files stored in /u9/car/nn/

 PROCEDURE:
	None

 EXAMPLE:
       result=call_nn_func(FILE_INP='$IDL_LOCAL/NN/inputs_nn.txt')

 MODIFICATION HISTORY:

 created by Carolina Gabarro Prats, ACRI S.A. , July 1999
       car@acri.fr

(See $IDL_LOCAL/NN/call_nn_func.pro)

 NAME:
      input_data_NN

 PURPOSE:
      Prepares the data to the format needed for the NN. 
      Conversion of the reflectances to logarithm and normalization.

 CATEGORY:

      NN

 CALLING SEQUENCE:

     input_data_NN,FILENAME=filename,FILE_INP=file_inp,FILE_OUT=file_out,
     geometry=geom
 
 INPUTS:

      The file that contains the 8 reflectances. Can be defined in the
      KEYWORD ro use the  by default file:  $IDL_LOCAL/NN/val_inp_no_conv.txt
     

 OPTIONAL INPUTS:

      None
      
 KEYWORD PARAMETERS:

      FILENAME : Is the product from extract the max and min
      values of reflectances.
      FILE_INP : File that contains the reflectances to be converted
      to the log scale. Vector of 8 doubles
      FILE_OUT : File that containes the reflectances already converted to the
      NN mode. Vector of 11 doubles
      GEOMETRY : Is a vector of 3 doubles that containes the geometry
      theta_s,theta_v,delta_phi

 OUTPUTS:

      The 11 values converted to the NN format. These will be the
      inputs of the NN. It can be tape in the KEYword  FILE_OUT,or
      use the  by default file:
       $IDL_LOCAL/NN/inputs_nn.txt

 OPTIONAL OUTPUTS:

      None

 COMMON BLOCKS:

       None

 SIDE EFFECTS:

       None

 RESTRICTIONS:

      None

 PROCEDURE:

     None

 EXAMPLE:



     res=input_data_nn(FILENAME='/megs_aux/products/pu_ocean2/case2.11.01.prd',$
     FILE_INP='$IDL_LOCAL/NN/val_inp_no_conv.txt',$
     FILE_OUT='$IDL_LOCAL/NN/inputs_nn.txt',GEOMETRY=[10.0,20.0,60.0])


 MODIFICATION HISTORY:

     created by Carolina Gabarro Prats, ACRI S.A. , July 1999
     car@acri.fr

(See $IDL_LOCAL/NN/input_data_NN.pro)