Functions to regrid and store regional fluxes (basis functions) 
into multiple layer maps at coarse resolution 
 
 
Authors: L. Feng, Edinburgh University
History: v0.9, 2012.06.28
History: v0.95, 2013.01.21
 
Classes:
=============================================================
1. region_flux_cl: class for mult-layer regional fluxes 
 
 
Functions:
==============================================================
1.  extract_region_flux: extract regional fluxes from 0.5x0.5 to 
multi-layer maps

Modules
		ESA.surface.divide_region ESA.util.flux_regrid ESA.util.geo_constant ESA.atmosphere.gc_grid_2d ESA.util.gen_plots ESA.atmosphere.ctm_grid_2d ESA.util.message_m ESA.util.otool_ncfile_io numpy ESA.util.otool_obj ESA.util.otool_var_io pylab

Classes
		region_flux_cl   class region_flux_cl     class for mult-layer regional fluxes     Methods defined here: __init__(self, filename, fopen, fread, fclose, fio_keywords={}, **keywords)

Functions
		extract_region_flux(flux_flnm, out_ncflnm, ctm_grd, do_debug=False, **keywords) Extract regional fluxes to a multi-layer map    Inputs: -------------------------------------------------------- 1. flux_flnm:<str>: name for single-layer regional map and flux 2. out_ncflnm:<str>: name for the name map file  3. ctm_grd:<ctm_grd_2d>: class for output model grid 4. do_debug:<T/F>: debug  5. keywords:<dict>: extra inputs    ---Reserved keywords --->varnames:<list, t:str>: names for lon,lat and map in original map file  --->reg_id_lst:<list, t:id>: ids for regions to be splited  --->nsub_lon_lst:<list, t:int>: number of subregions along longitudes  --->nsub_lat_lst: <list, t:int>: number of subregions along latitudes

Data
		def_flux_varnames = ['longitude', 'latitude', 'map', 'flux', 'area', 'pid'] def_fluxflnm = 'reg_flux_144_05x05.nc' def_nreg = 144 def_reg_id_lst = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, ...]