rain.h File Reference

Header file for acquiring rainfall grid_io data. More...

#include "gridmap.h"
#include "globals.h"

Include dependency graph for rain.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	rain_data_wmm (float *)
VOIDP	nalloc (unsigned mem_size, const char var_name[])
	Allocate memory for a variable.
Variables
applicationStruct	rain_struct
char	rain_binfilename [335]
char *	ModelPath
char *	ProjName

---

Detailed Description

Header file for acquiring rainfall grid_io data.

This defines or declares variables & functions that are global to rain_inp.c.

Note: documented with Doxygen, which expects specific syntax within special comments.

The Everglades Landscape Model (ELM).
last updated: Jan 2005

Definition in file rain.h.

---

Function Documentation

int rain_data_wmm

(

float *

)

rainfall data array

Definition at line 26 of file rain_inp.c.

Referenced by cell_dyn1().

{

  int i,j,k; 
  int success = 1, fail = -1;
  int stat = success;
  char gridmapfilename[335];

  if(SimTime.TIME==0)  {      

     // cleanUp(*elm_wmm_map, rainSME);
      
                /* elm_OG_map is data structure containing the mapping attributes at two scales */
      elm_wmm_map = elm_OG_map;

      if(elm_wmm_map == NULL) {
          sprintf(msgStr, "Mapping grids and setting up rain data...");
          usrErr0(msgStr);
          
          sprintf(gridmapfilename, "%s%s/Data/gridmapping.txt", ModelPath, ProjName );   
          stat = mapGrids(gridmapfilename);
          elm_wmm_map = elm_OG_map;
      }

      if(debug > 4) {
          printGridMap();
          sprintf(msgStr,"rain_data_wmm==> Finished mapping grids");
          usrErr (msgStr);
      }

      sprintf(rain_binfilename, "%s%s/Data/rain.BIN", ModelPath, ProjName );

/* initializing data structures, move pointer to initial date (gridmap.c) */
      stat = initDataStruct(rain_binfilename,&rain_struct);

      if(debug > 4) {
              /* printELM2Grid_io(); */
              /*drawELM2Grid_io(); */
          sprintf(msgStr,"rain_data_wmm==> Finished initializing");
          usrErr (msgStr); 
      }

  } /* end of SimTime.TIME=0 */
  
  
  if(rain_struct.day >= rain_struct.recRead) {      /* process the data in batch */
      sprintf(msgStr,"\nProcessing batch of rain data...");
      usrErr (msgStr); 
      stat = processData(rain_binfilename,&rain_struct);

      if(debug > 4 ) {
              /*printBatchData(rainWMM,gridio_batch_len,widCnt);*/ /* TODO: remove this printBatchData function when sure is no longer needed */
          sprintf(msgStr,"rain_data_wmm==> Finished processing data");
          usrErr (msgStr); 
      }
  } /* end of if */


  if (rain_struct.day < rain_struct.recRead) {      /* pass the data day by day */
    returnData(rainSME,&rain_struct);   
    /* change the unit here */
    for(i = 0; i < s0; i++) {
      for(j = 0; j < s1; j++) {
        k = i*s1+j;
        rainSME[T((i+1),(j+1))] = rain_struct.dataELM[k] * conv_inTOtenths_mm;  /* convert data from inches to tenths of mm */
      }
    } 

    if(debug > 4) {
      sprintf(msgStr,"rain_data_wmm==> Finished returning data");
      usrErr (msgStr); 
    }

  } /* end of if */
    
  return success;
}

VOIDP nalloc	(	unsigned	mem_size,
		const char	var_name[]
	)

Allocate memory for a variable.

Parameters:

	mem_size	The size of memory space
	var_name	The variable's name

Returns:

Pointer to that memory

Definition at line 1857 of file Driver_Utilities.c.

{
  VOIDP rp;

  
  if(mem_size == 0) return(NULL);
  rp = (VOIDP)malloc( mem_size );
  total_memory += mem_size;
  fasync(stderr);
  if( rp == NULL ) {
    fprintf(stderr,"Sorry, out of memory(%d): %s\n",mem_size,var_name);
    Exit(0);
  }
  fmulti(stderr);
  return(rp);
}

---

Variable Documentation

applicationStruct rain_struct

Definition at line 18 of file rain.h.

Referenced by rain_data_wmm().

char rain_binfilename[335]

grid_io binary data file name

Definition at line 20 of file rain.h.

Referenced by rain_data_wmm().

char* ModelPath

Environment variables used in model

ModelPath environment variable, base pathname for executable and input data
ProjName environment variable, the name of the model project
DriverPath environment variable, base pathname for source code
OS_TYPE environment variable, the type of operating system being used (informational purpose only, not used in code)

Definition at line 40 of file driver_utilities.h.

char * ProjName

Definition at line 40 of file driver_utilities.h.