From dfc184d3e987915d723d7a2f554f960c3db50119 Mon Sep 17 00:00:00 2001 From: embrown Date: Mon, 14 Nov 2016 11:11:16 -0800 Subject: [PATCH 1/6] Working on converting cdutil documentation to RST format. --- Lib/create_landsea_mask.py | 35 +++-- Lib/netcdfwriter.py | 3 +- Lib/region.py | 22 +-- Lib/times.py | 270 ++++++++++++++++++++++--------------- Lib/vertical.py | 103 ++++++++------ 5 files changed, 258 insertions(+), 175 deletions(-) diff --git a/Lib/create_landsea_mask.py b/Lib/create_landsea_mask.py index a106989..2d204a2 100644 --- a/Lib/create_landsea_mask.py +++ b/Lib/create_landsea_mask.py @@ -1,6 +1,7 @@ import cdms2,MV2,sys,os import cdat_info + def create_surrounds(data): sh=list(data.shape) L=data.getAxis(1) @@ -94,6 +95,7 @@ def map2four(data,target,regridTool='regrid2'): return out + def improve(mask,navy_frac_t,threshold_1,threshold_2,UL,UC,UR,ML,MR,LL,LC,LR,regridTool='regrid2'): mask_approx = map2four(mask,mask.getGrid(),regridTool=regridTool) diff = navy_frac_t - mask_approx @@ -159,19 +161,28 @@ def improve(mask,navy_frac_t,threshold_1,threshold_2,UL,UC,UR,ML,MR,LL,LC,LR,reg mask2.setAxisList(mask.getAxisList()) return mask2 + def generateLandSeaMask(target,source=None,threshold_1 = .2, threshold_2 = .3,regridTool='regrid2'): - """ Generates a best guess mask on any rectilinear grid, using the method described in PCMDI's report #58 - see: http://www-pcmdi.llnl.gov/publications/ab58.html - Input: - target: either a MV2 object with a grid, or a cdms2 grid (rectilinear grid only) - source: A fractional (0 to 1.) land sea mask, where 1 means all land - threshold_1 (optional): criteria 1 for detecting cells with possible increment see report for detail - difference threshold - threshold_2 (optional): criteria 2 for detecting cells with possible increment see report for detail - water/land content threshold - regridTool: which cdms2 regridder tool to use, default is regrid2 - Output: - landsea maks on target grid + """ + Generates a best guess mask on any rectilinear grid, using the method described in `PCMDI's report #58`_ + + .. _PCMDI's report #58: http://www-pcmdi.llnl.gov/publications/pdf/58.pdf + + :param target: either a MV2 object with a grid, or a cdms2 grid (rectilinear grid only) + :type target: MV2 or cdms2 + :param source: A fractional (0 to 1.) land sea mask, where 1 means all land + :type source: float + :param threshold_1: criteria 1 for detecting cells with possible increment see report for detail + difference threshold + :type threshold_1: float + :param threshold_2: criteria 2 for detecting cells with possible increment see report for detail + water/land content threshold + :type threshold_2: float + :param regridTool: which cdms2 regridder tool to use, default is regrid2 + :type regridTool: + + :returns: landsea mask on target grid + :rtype: """ cdat_info.pingPCMDIdb("cdat","cdutil.generateLandSeaMask") if cdms2.isVariable(target): diff --git a/Lib/netcdfwriter.py b/Lib/netcdfwriter.py index 722a3cc..32d35c5 100644 --- a/Lib/netcdfwriter.py +++ b/Lib/netcdfwriter.py @@ -5,7 +5,8 @@ import cdms2 def writenetcdf (slab, filename, mode="a"): - """writenetcdf(slab, filename, mode="a") writes slab to the file. + """ + writenetcdf(slab, filename, mode="a") writes slab to the file. modes: 'a' append 'w' replace 'r' replace (for legacy code only, deprecated) diff --git a/Lib/region.py b/Lib/region.py index 1479cf7..f99fa7c 100644 --- a/Lib/region.py +++ b/Lib/region.py @@ -2,7 +2,7 @@ from cdms2.selectors import SelectorComponent import cdat_info class DomainComponent(SelectorComponent): - '''gets a domain, and by default adjusts the bounds to the domain + """gets a domain, and by default adjusts the bounds to the domain or if exact is set to 0 or None gets all the domain that has parts of the domain requested, also post processing allows you to apply a mask dimension names can be passed as keywords, @@ -10,10 +10,10 @@ class DomainComponent(SelectorComponent): Overwritting an axis (2 keywords or keyword + argument) is not allowed Example of use: NH=cdms.selectors.Selector(domain(latitude=(0.,90.))) - ''' + """ def __init__(self,*args,**kargs): - ''' initialise some value such as tolerances for equality''' + """ initialise some value such as tolerances for equality""" self.args=args self.kargs=kargs self.atol=kargs.get('atol',1.E-8) @@ -36,7 +36,7 @@ def __str__(self): return s def specify(self,slab,axes,specification,confined_by,aux): - ''' First part: confine the slab within a Domain wide enough to do the exact in post''' + """ First part: confine the slab within a Domain wide enough to do the exact in post""" import string,copy from numpy.ma import minimum,maximum # myconfined is for later, we can't confine a dimension twice with an argument plus a keyword or 2 keywords @@ -146,11 +146,11 @@ def specify(self,slab,axes,specification,confined_by,aux): return 0 def same(self,data,value): - ''' Check if data is basically the same than value''' + """ Check if data is basically the same than value""" return abs(data-value)fbound and b0[0]>> cyclecentroid=cyclicalcentroid(s,bounds) + + :param s: A slab (cdms2 TransientVariable) + :type s: cdms2.tvariable.TransientVariable + :param bounds: The bounds of the overall thing + :param coords: The coordinates spanned by each subset + + :returns: A slab representing the cyclecentroid, which is the same shape as s but without the 1st dim + :rtype: cdms2.tvariable.TransientVariable + """ if coords is None: coords=s.getAxis(0).getBounds() # if MV2 then gets the bounds from there n=len(coords) @@ -73,7 +81,7 @@ def cyclicalcentroid(s,bounds,coords=None): return numpy.sqrt(xc*xc+yc*yc)/numpy.sqrt(2.) def getMonthString(my_list): - '''Given a list of month creates the string representing the sequence''' + """Given a list of month creates the string representing the sequence""" if not type(my_list) in [types.ListType,types.TupleType]: my_list=[my_list] dic = { @@ -90,9 +98,15 @@ def getMonthString(my_list): def getMonthIndex(my_str): """ Given a string representing a month or a season (common abrev) - Returns the ordered indices of the month + Returns the ordered indices of the month. Author: Krishna Achutarao Date: April 2001 + + :param my_str: string reperesenting month or season + :type my_str: str + + :returns: The ordered indices of the month + :rtype: list """ my_str = string.upper(my_str) mon_list = ['JANUARY', 'FEBRUARY', 'MARCH', 'APRIL', 'MAY', 'JUNE', 'JULY', @@ -130,7 +144,15 @@ def getMonthIndex(my_str): def isMonthly(s): - '''This function test if the data are monthly data from the time axis''' + """ + This function test if the data are monthly data from the time axis. + + :param s: A cdms2 TransientVariable + :type s: cdms2.tvariable.TransientVariable + + :returns: An integer flag indicating whether s has monthly data (1), or does not (0). + :rtype: int + """ tim=s.getTime() units=tim.units monthly=1 @@ -142,18 +164,27 @@ def isMonthly(s): def mergeTime(ds,statusbar=1,fill_value=1.e20): - ''' - Merge chronologically a bunch of slab + """ + Merge chronologically a bunch of slabs Version 1.0 Author: Charles Doutriaux, doutriaux1@llnl.gov - Usage: - mymerged=mergeTime(ds) - where: - ds is a list or an array of slabs to merge, each slab MUST be in chronological order - Output: - a slab merging all the slab of ds - order is the order of the first slab - ''' + + :Example: + + .. doctest:: times_mergeTime + + >>> mymerged=mergeTime(ds) + + :param ds: A list or an array of slabs to merge. Each slab MUST be in chronological order. + :type ds: list + :param statusbar: Integer flag indicating whether to show status bar or not. + :type statusbar: int + :param fill_value: Float used to set the fill value of the generated slab. + :type fill_value: float + + :returns: A slab merging all the slabs of ds. Order is the order of the first slab + :rtype: cdms2.tvariable.TransientVariable + """ allNone = True for s in ds: if s is not None: @@ -257,13 +288,21 @@ def mergeTime(ds,statusbar=1,fill_value=1.e20): def switchCalendars(t1,u1,c1,u2,c2=None): - ''' - converts a relative time from one calendar to another, assuming that they are in different calendar - Usage: cvreltime(t1,c1,u2,c2) - where t1 is cdtime reltime object or a value (then u1 is needed) - c1,c2 are cdtime calendars - u1, u2 the units in the final calendar - ''' + """ + Converts a relative time from one calendar to another, assuming that they are in different calendars + + :Example: + + .. doctest:: times_switchCalendars + + >>> switchCalendars(t1,c1,u2,c2) + + :param t1: A cdtime reltime object or a value. If it is a value, then u1 is needed. + :param c1: cdtime calendar + :param c2: cdtime calendar + :param u1: units in the calendar to be converted + :param u2: units in the final calendar + """ if not (type(t1)==types.IntType or type(t1)==types.FloatType): c2=u2 u2=c1 @@ -279,9 +318,10 @@ def switchCalendars(t1,u1,c1,u2,c2=None): class TimeSlicer: - ''' + """ Author : Charles Doutriaux: doutriaux1@llnl.gov Date: April 2001 + Returns masked average of specific time slices "slicer" determine which slices of the Transient Variable (TV) are processed "criteria" gets TV (with time dimension) and returns a "timeless" mask, used to mask the averaged slices @@ -351,7 +391,7 @@ class TimeSlicer: TS=TimeSlicer(slicerfunc,criteriafunc) myres=TS(myslab,[[slicerarg,[criteriaarg]]) myresdeparture=TS(myslab,[[slicerarg,[criteriaarg,ref]]] - ''' + """ def __init__(self,slicerfunction=None,criteriafunction=None): self.slicer=slicerfunction self.criteria=criteriafunction @@ -360,16 +400,14 @@ def __init__(self,slicerfunction=None,criteriafunction=None): self.title='' def get(self,slab,slicerarg=None,criteriaarg=None,statusbar=None,weights=False,sum=False): - ''' - Returns the slices wanted, appropriately masked - Input: - slab : the slab on which to operate - sliceruserargument : anything your slicer function needs, default is None - criteriauserargument: anything your criteria function needs, default is None - statusbar=None : statusbar ? - Output: - out : averaged and masked slices of slab - ''' + """ + :param slab: the slab on which to operate + :param slicerarg: anything your slicer function needs, default is None + :param criteriaarg: anything your criteria function needs, default is None + :param statusbar: see :py:func:`statusbar` for details + + :returns: averaged and masked slices of slab + """ # Makes sure time is first @@ -440,18 +478,15 @@ def get(self,slab,slicerarg=None,criteriaarg=None,statusbar=None,weights=False,s def departures(self,slab,slicerarg=None,criteriaarg=None,ref=None,statusbar=None,sum=False): - ''' - Returns the departures of slab from the result of get - Input: - slab : slab from which the we want to get the departure - sliceruserargument : anything your slicer function needs, default is None - criteriauserargument: anything your criteria function needs, default is None - (ref): optional : result from get or equivalent precomputed - statusbar : statusbar stuff (see statusbar function for details) - - Output: - out : departure of slab from ref - ''' + """ + :param slab: slab from which the we want to get the departure + :param slicerarg: anything your slicer function needs, default is None + :param criteriaarg: anything your criteria function needs, default is None + :param ref: result from get or equivalent precomputed + :param statusbar: see :py:func:`statusbar` for details + + :returns: The departures of slab from the result of get + """ sliced=TimeSlicer.get(self,slab,slicerarg,criteriaarg,statusbar=statusbar,sum=sum) if sliced is None: @@ -485,19 +520,18 @@ def departures(self,slab,slicerarg=None,criteriaarg=None,ref=None,statusbar=None else: return out - def average(self,slab,slices,bounds,norm,criteriaarg=None,statusbar=None,weights=False,sum=False): - ''' - Return the average of the result of slicer - Input: - slab : the slab on which to operate - slices : the slices for each part - bounds : the length of each slice - norm : the actual length of each "season" - criteriaarg : arguments for criteria thing - Output: - out : the average of slab, masked by criteria - ''' + """ + Return the average of the result of slicer + + :param slab: the slab on which to operate + :param slices: the slices for each part + :param bounds: the length of each slice + :param norm: the actual length of each "season" + :param criteriaarg: arguments for criteria thing + + :returns: the average of slab, masked by criteria + """ n=len(slices) sh=list(slab.shape) sh[0]=n @@ -592,20 +626,20 @@ def statusbar2(self,statusbar): def monthBasedSlicer(tim,arg=None): - ''' + """ slicer function for the TimeSlicer class select months Author : Charles Doutriaux, doutriaux1@llnl.gov Original Date: April 2001 Last Modified: October, 2001 Input: - - tim: time axis - - arg: character string representing the desired month/season or integer(s) + :param tim: time axis + :param arg: character string representing the desired month/season or integer(s) also you can pass a list of the months you want (string or integer) you can mix integer and strings Output: - - ''' + """ # First convert the input if not type(arg) in [types.ListType , types.TupleType]: arg=[arg] @@ -739,21 +773,21 @@ def monthBasedSlicer(tim,arg=None): def dayBasedSlicer(tim,arg=None): - ''' + """ slicer function for the TimeSlicer class select days Author : Charles Doutriaux, doutriaux1@llnl.gov Original Date: June, 2003 - Last Modified: ... - Input: - - tim: time axis - - arg: character string representing the desired day/days or day number(s) (jan 1st, is day 0, feb 29th is day 59.5...) + + :param tim: time axis + :param arg: string representing the desired day/days or day number(s) (jan 1st, is day 0, feb 29th is day 59.5...) day are represented as "Jan-01" "January-01" "jan-1", "1-january", case does not matter - days can be represented by 2 number but then month is assumed to be first ! e.g "01-25" = "jan-25" + days can be represented by 2 numbers but then month is assumed to be first ! e.g "01-25" = "jan-25" you can mix definitions + :type arg: str Output: - - ''' + """ # First convert the input if not type(arg) in [types.ListType , types.TupleType]: arg=[arg] @@ -925,28 +959,28 @@ def weekday(a,calendar=None): def generalCriteria(slab,mask,spread,arg): - ''' + """ Default Conditions: - 50% of the data - AND - Centroid < x (in absolute value), centroid is always between 0 (perfect and 1, none perfect) - by default centroid is not used - + 50% of the data + AND + Centroid < x (in absolute value), centroid is always between 0 (perfect) and 1, (not perfect) + by default centroid is not used + Author: Charles Doutriaux, doutriaux1@llnl.gov Usage: generalCriteria(slab,sliced,slices,arg) - slab : the original slab - mask: the actual percentage of data in each subset used to produce the slab - the bounds of its first (time) dimension must be correct - they will be used by centroid - spread: the begining and end time of the slice processed - arg: + :param slab: the original slab + :param mask: the actual percentage of data in each subset used to produce the slab + the bounds of its first (time) dimension must be correct + they will be used by centroid + :param spread: the begining and end time of the slice processed + :param arg: A list of arguments First represent the % of value present to retain a slice Second represent the value of the centroid (between 0: perfect and 1: bad If you do not want to use one these criteria pass None - if you would rather use a cyclicalcnetroid pass: "cyclical" as an Xtra argument - ''' + if you would rather use a cyclicalcnetroid pass: "cyclical" as an extra argument + """ # Reads the arguments slab=MV2.asVariable(slab) sh=slab.shape @@ -980,8 +1014,10 @@ def generalCriteria(slab,mask,spread,arg): slab=numpy.ma.masked_where(numpy.ma.greater_equal(c,centro),slab) return slab + def setAxisTimeBoundsDaily(axis,frequency=1): - """ Sets the bounds correctly for the time axis (beginning to end of day) + """ + Sets the bounds correctly for the time axis (beginning to end of day) Usage: tim=s.getTime() cdutil.times.setAxisTimeBoundsMonthly(tim,frequency=1) @@ -1017,8 +1053,10 @@ def setAxisTimeBoundsDaily(axis,frequency=1): tim.setBounds(bnds) return + def setSlabTimeBoundsDaily(slab,frequency=1): - """Sets the bounds correctly for the time axis (beginning to end of day) + """ + Sets the bounds correctly for the time axis (beginning to end of day) for 'frequency'-daily data Usage: cdutil.times.setSlabTimeBoundsDaily(slab,frequency=1) @@ -1031,8 +1069,10 @@ def setSlabTimeBoundsDaily(slab,frequency=1): setAxisTimeBoundsDaily(tim,frequency=frequency) return + def setTimeBoundsDaily(obj,frequency=1): - """Sets the bounds correctly for the time axis (beginning to end of day) + """ + Sets the bounds correctly for the time axis (beginning to end of day) for 'frequency'-daily data Usage: cdutil.times.setSlabTimeBoundsDaily(slab,frequency=1) @@ -1049,8 +1089,10 @@ def setTimeBoundsDaily(obj,frequency=1): setSlabTimeBoundsDaily(obj,frequency=frequency) return + def setAxisTimeBoundsMonthly(axis,stored=0): - """ Sets the bounds correctly for the time axis (beginning to end of month) + """ + Sets the bounds correctly for the time axis (beginning to end of month) Set stored to 1 to indicate that your data are stored at the end of the month Usage: tim=s.getTime() @@ -1083,17 +1125,19 @@ def setAxisTimeBoundsMonthly(axis,stored=0): tim.setBounds(bnds) return + def setSlabTimeBoundsMonthly(slab,stored=0): """ Sets the bounds correctly for the time axis for monthly data stored without bounds. Set stored to 1 to indicate that your data are stored at the end of the month Usage: cdutil.times.setSlabTimeBoundsMonthly(slab,stored=0) -""" + """ tim=slab.getTime() setAxisTimeBoundsMonthly(tim,stored=stored) return + def setTimeBoundsMonthly(obj,stored=0): """ Sets the bounds correctly for the time axis (beginning to end of month) Set stored to 1 to indicate that your data are stored at the end of the month @@ -1135,6 +1179,7 @@ def setAxisTimeBoundsYearly(axis): tim.setBounds(bnds) return + def setSlabTimeBoundsYearly(slab): """ Sets the bounds correctly for the time axis for yearly data Usage: @@ -1144,6 +1189,7 @@ def setSlabTimeBoundsYearly(slab): setAxisTimeBoundsYearly(tim) return + def setTimeBoundsYearly(obj): """ Sets the bounds correctly for the time axis for yearly data Usage: @@ -1267,14 +1313,14 @@ def month_restore(self,merged,slab): del(slab.__saved_time__) def get(self,slab,slicerarg=None,criteriaarg=None,statusbar=None,sum=False): - '''Get the seasons asked for and return them in chronological order + """Get the seasons asked for and return them in chronological order i.e. if you asked for DJF and JJA and the first season of your dataset is JJA you will have a JJA first !!!! Check your time axis coordinate !!! slicerarg will be ignored it is recomended to use Season(slab,criteria=mycriteriaarguments) syntax rather than Season(slab,None,None,mycriteriaarguments) Now for the original doc of the get function see get2__doc__: - ''' + """ cdat_info.pingPCMDIdb("cdat","cdutil.times.Seasons.get -%s-" % self.seasons) u=self.month_fix(slab) s=[] @@ -1293,12 +1339,12 @@ def get(self,slab,slicerarg=None,criteriaarg=None,statusbar=None,sum=False): return m def departures(self,slab,slicerarg=None,criteriaarg=None,ref=None,statusbar=None,sum=False): - ''' Return the departures for the list of season you specified, returned in chronological order + """ Return the departures for the list of season you specified, returned in chronological order i.e. if you asked for DJF and JJA and the first season of your dataset is JJA you will have a JJA first !!!! Check your time axis coordinate !!! To pass a specific array from which to compute departures, please pass 1 per season (or None if we should compute it) for info one default departures see: departures2.__doc__ - ''' + """ cdat_info.pingPCMDIdb("cdat","cdutil.times.Seasons.departures -%s-" % self.seasons) u=self.month_fix(slab) if not cdms2.isVariable(ref) and ref is not None: @@ -1343,7 +1389,7 @@ def departures(self,slab,slicerarg=None,criteriaarg=None,ref=None,statusbar=None return m def climatology(self,slab,criteriaarg=None,criteriaargclim=None,statusbar=None,sum=False): - ''' Compute the climatology from a slab + """ Compute the climatology from a slab Input: slab criteriaarg : the argument for criteria function when slicing the season (and clim) @@ -1353,7 +1399,7 @@ def climatology(self,slab,criteriaarg=None,criteriaargclim=None,statusbar=None,s The Average of the seasons in the order passed when constructing it i.e if DJF and JJA are asked, the output will have the average DJF first, then the average JJA 2 criteria can be passed one for the slicing part and one for the climatology part - ''' + """ cdat_info.pingPCMDIdb("cdat","cdutil.times.Seasons.climatology -%s-" % self.seasons) u=self.month_fix(slab) #if criteriaargclim is None: criteriaargclim=criteriaarg diff --git a/Lib/vertical.py b/Lib/vertical.py index 167b7d4..60ee75f 100644 --- a/Lib/vertical.py +++ b/Lib/vertical.py @@ -10,19 +10,26 @@ def reconstructPressureFromHybrid(ps, A, B, Po): """ Reconstruct the Pressure field on sigma levels, from the surface pressure - Input - Ps : Surface pressure - A,B,Po: Hybrid Convertion Coefficients, such as: p=B.ps+A.Po - Ps: surface pressure - B,A are 1D : sigma levels - Po and Ps must have same units - - Output - Pressure field - Such as P=B*Ps+A*Po - - Example - P=reconstructPressureFromHybrid(ps,A,B,Po) + + :param Ps: Surface pressure + :param A: Hybrid Conversion Coefficient, such as: p=B.ps+A.Po. + :param B: Hybrid Conversion Coefficient, such as: p=B.ps+A.Po. + :param Po: Hybrid Conversion Coefficient, such as: p=B.ps+A.Po + :param Ps: surface pressure + + .. note:: + + A and B are 1d sigma levels. + Po and Ps must have same units. + + + :returns: Pressure field, such as P=B*Ps+A*Po. + + :Example: + + .. doctest:: vertical_reconstructPressureFromHybrid + + >>> P=reconstructPressureFromHybrid(ps,A,B,Po) """ # Compute the pressure for the sigma levels cdat_info.pingPCMDIdb( @@ -50,23 +57,35 @@ def linearInterpolation( A, I, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z'): """ - Linear interpolation - to interpolate a field from some levels to another set of levels - Value below "surface" are masked + Linear interpolation to interpolate a field from some levels to another set of levels + Values below "surface" are masked. - Input - A : array to interpolate - I : interpolation field (usually Pressure or depth) from TOP (level 0) to BOTTOM (last level), i.e P value going up with each level - levels : levels to interplate to (same units as I), default levels are:[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000] - axis: axis over which to do the linear interpolation, default is 'z', accepted: '1' '(myaxis)' - I and levels must have same units + :param A: array to interpolate + :type A: + :param I: interpolation field (usually Pressure or depth) from TOP (level 0) to BOTTOM (last level) + i.e P value going up with each level. + :type I: + :param levels: levels to interpolate to (same units as I). + Default levels:[100000, 92500, 85000, 70000, 60000, 50000, 40000, + 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000] + :type levels: + :param axis: Axis over which to do the linear interpolation. + Can provide either an int representing axis index, or the axis name. + Default: 'z'. + :type axis: str or int - Output - array on new levels (levels) + .. note:: - Examples: - A=interpolate(A,I,levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000]) + I and levels must have same units + + :returns: array on new levels (levels) + + :Examples: + + .. doctest:: vertical_linearInterpolation + + >>> A=interpolate(A,I) # interpolates A over default levels """ cdat_info.pingPCMDIdb("cdat", "cdutil.vertical.linearInterpolation") @@ -154,23 +173,29 @@ def logLinearInterpolation( A, P, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z'): """ - Log-linear interpolation - to convert a field from sigma levels to pressure levels - Value below surface are masked + Log-linear interpolation to convert a field from sigma levels to pressure levels. + Values below surface are masked. + + :param A: array on sigma levels + :type A: + :param P: pressure field from TOP (level 0) to BOTTOM (last level) + :type P: + :param levels: pressure levels to interplate to (same units as P), default levels are:[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000] + :type levels: + :param axis: axis over which to do the linear interpolation, default is 'z', accepted: '1' '(myaxis)' + :type axis: + + .. note:: + + P and levels must have same units - Input - A : array on sigma levels - P : pressure field from TOP (level 0) to BOTTOM (last level) - levels : pressure levels to interplate to (same units as P), default levels are:[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000] - axis: axis over which to do the linear interpolation, default is 'z', accepted: '1' '(myaxis)' + :returns: array on pressure levels (levels) - P and levels must have same units + :Example: - Output - array on pressure levels (levels) + .. doctest:: vertical_logLinearInterpolation - Examples: - A=logLinearInterpolation(A,P),levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000]) + >>> A=logLinearInterpolation(A,P) # interpolate A using pressure field P over the default levels """ cdat_info.pingPCMDIdb("cdat", "cdutil.vertical.logLinearInterpolation") From 19c4d514472cce2ce7303c249ccfe34ff86c0877 Mon Sep 17 00:00:00 2001 From: embrown Date: Mon, 14 Nov 2016 13:15:53 -0800 Subject: [PATCH 2/6] Copying VariablesMatcher.doc information out to docstrings. --- Lib/region.py | 6 ++-- Lib/retrieve.py | 91 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 95 insertions(+), 2 deletions(-) diff --git a/Lib/region.py b/Lib/region.py index f99fa7c..7d0c522 100644 --- a/Lib/region.py +++ b/Lib/region.py @@ -2,13 +2,15 @@ from cdms2.selectors import SelectorComponent import cdat_info class DomainComponent(SelectorComponent): - """gets a domain, and by default adjusts the bounds to the domain + """ Gets a domain, and by default adjusts the bounds to the domain or if exact is set to 0 or None gets all the domain that has parts of the domain requested, also post processing allows you to apply a mask dimension names can be passed as keywords, but if no name is passed arguments are taken in order and applied to the corresponding axis Overwritting an axis (2 keywords or keyword + argument) is not allowed - Example of use: + + :Example: + NH=cdms.selectors.Selector(domain(latitude=(0.,90.))) """ diff --git a/Lib/retrieve.py b/Lib/retrieve.py index 1efaddb..5844b4c 100644 --- a/Lib/retrieve.py +++ b/Lib/retrieve.py @@ -141,6 +141,11 @@ def _get_type(self): class WeightedGridMaker(object): + """The WeightedGridMaker generates a cdms grid object (see cdms documentation for a description) + and may also associate a WeightsMaker object with that grid. The WeightedGridMaker object may be used by the + VariableConditioner object to define a "target" grid to which the variable will be mapped. + The WeightedGridMaker must be either provided with a cdms grid object or with information needed to generate a grid. + """ def __init__(self, source=None, var=None, @@ -149,6 +154,46 @@ def __init__(self, nlon=None,flon=None,dellon=None, weightsMaker=None ): + """ + + :param source: a cdms grid object or a file name (in which case the keyword "var" must be defined). + Other keywords (except "var" and "WeightsMaker") will be ignored if "source" is a file name. + :type source: + + :param var: the name of the variable that is needed from the file specified in the "source" argument + (except when "source" refers directly to a grid object, in which case this argument is ignored). + :type var: str + + :param nlat: the number of latitudes spanning the domain (which is ignored if "source" is a file name). + :type nlat: float + + :param flat: the location of the first latitude (which is ignored if "source" is a file name or if "type" is + 'gaussian' or 'equal'). + :type flat: float + + :param dellat: the latitude spacing (which is ignored if "source" is a file name or if "type" is + 'gaussian' or 'equal'). + :type dellat: float + + :param grid_type: the type of grid that will be generated. Options include: 'uniform' (equally spaced), + 'gaussian' (for use with spectral models), and 'equal' (for latitude spacing giving equal area grid + cells as in the lmd5 model). This keyword will be ignored if "source" is a file name. + :type grid_type: str + + :param nlon: the number of longitudes spanning the domain (which is ignored if "source" is a file name). + :type nlon: float + + :param flon: the location of the first longitude (which by default is set to 0.0 but is ignored if "source" + is a file name). + :type flon: float + + :param dellon: the longitude spacing (which is ignored if the "source" is a file name). + :type dellon: float + + :param weightsMaker: a :py:class:`WeightsMaker` object that should occupy the same grid as that returned by + :py:class:`WeightedGridMaker`. + :type weightsMaker: :py:class:`WeightsMaker` + """ self.longitude=GridAxis() self.latitude=GridAxis() self.longitude.n=nlon @@ -254,7 +299,53 @@ class VariableConditionerError(WeightedGridMakerError): pass class VariableConditioner(object): + """The VariableConditioner constructor must be provided either with a transient variable or with information + that will be used to define a masked variable. Optional, additional information may be provided to indicate + how the data should be mapped to a new grid, what masks should be applied, and how to scale and offset the data + (to transform, for example, to alternative units). """ def __init__(self,source,var=None,weightsMaker=None,weightedGridMaker=None,offset=0.,slope=1.,cdmsArguments=None,cdmsKeywords=None,id=None,preprocess=None,preprocessKeywords={},comments=''): + """ + :param source: a file name or a transient variable. If an array is passed, a second associated array may also + be passed (in which case source is a tuple), which contains the fraction of each grid cell + for which the data value applies. This fraction will be used if the variable is regridded. + :type source: + + :param var: the name of the variable that is needed from the file specified in the "source" argument + (except when "source" refers directly to a variable, in which case this argument is ignored). + :type var: str + + :param cdmsArguments: a tuple or list of optional arguments used when retrieving a variable with cdms. + For example, cdmsArguments=(cdutil.region.NH) specifies that data should be retrieved from the + Northern Hemisphere only). See the cdms documentation for more information. + :type cdmsArguments: tuple + + :param cdmsKeywords: a dictionary defining "keyword:value" pairs used when retrieving a variable with cdms. + For example, cdmsKeywords= {'latitude:(-90.0, 0.0)} specifies that data should be retrieved from the + Southern Hemisphere only. See the cdms documentation for more information. + :type cdmsKeywords: dict + + :param weightsMaker: a WeightsMaker object that should be applied to the masked variable (before any regridding). + :type weightsMaker: + + :param weightedGridMaker: a WeightedGridMaker object that defines the target grid to which the data should be + mapped. + + .. note:: + + If a WeightsMaker is associated with the WeightedGridMaker object, then that mask will be + applied to the data after regridding. + :type weightedGridMaker: :py:class:`WeightsMaker` + + :param offset: used to change units of the variable by multiplying the data by "slope" and adding "offset" to the result. + :type offset: float + + :param slope: used to change units of the variable by multiplying the data by "slope" and adding "offset" to the result. + :type slope: float + + :param id: a string that can be used to identify your VariableConditioner object, + but it is purely informational and not used otherwise. + :type id: str + """ self.id=id self.var=var self.offset=offset From c2a8738be7ec4f878f069222cc0a2dc6658bf1f6 Mon Sep 17 00:00:00 2001 From: embrown Date: Mon, 14 Nov 2016 14:54:32 -0800 Subject: [PATCH 3/6] Copying VariablesMatcher.doc information out to docstrings. --- Lib/retrieve.py | 66 +++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 64 insertions(+), 2 deletions(-) diff --git a/Lib/retrieve.py b/Lib/retrieve.py index 5844b4c..8ca7899 100644 --- a/Lib/retrieve.py +++ b/Lib/retrieve.py @@ -16,7 +16,53 @@ def __init__(self,args): self.args=args class WeightsMaker(object): + """ + The WeightsMaker generates a transient variable containing fractions (between 0 and 1), with the value 0 identifying + which cells should be excluded from consideration (i.e., masked out). In calculating the mean value of a variable, + these fractions are typically used to "weight" grid cells + (in addition to possibly weighting by the area of the grid cell). In the simplest case, only 0's and 1's will be + generated, indicating which cells will be masked or not. + """ def __init__(self,source=None,var=None,values=None,actions=[MV2.equal,],combiningActions=[MV2.multiply,]): + """ + :param source: either a file name or a transient variable. + :type source: str + + :param var: the name of the variable that is needed from the file specified in the "source" argument + (except when "source" is a transient variable, in which case this argument is ignored). + :type var: str + + :param values: a list (with the same number of elements as the "actions" list) containing the values that will + be passed to each function contained in the "actions" list. If "values" is defined as a list or tuple + whose first element is 'input', then the variable passed to action is not the one referred to by + "source" but the one sent to the "get" function (i.e. when the function is executed). + :type values: list + + :param actions: a list (or a tuple) of functions that will be used by the WeightsMaker to create the weights. + Each of these functions must accept two arguments: the first argument is an array + (of the same shape as the mask), and the second is a scalar or a tuple. + For example, "actions=MV.equal" will generate weights with 1's assigned to cells where elements of the + array equal to the scalar specified in values (see below) and 0's assigned to all other cells. + By default the array passed to the function is the one defined by "source," but an alternative "source" + can be passed at the time of the mask creation (see the "get" and "values" explanations below). + The default action (if "actions" is set to None) is: MV.equal. + :type actions: list or tuple + + :param combiningActions: a list (with one element less than the number of elements in the "actions" list) + containing functions used to combine the actions of the functions specified in the "actions" list. + There is no need to define combiningActions when there is only one "action" defined. + The first "combining-action" will be used to produce a new temporary mask representing the result of + combining the first and second masks generated by the functions specified in the "actions" list. + This result will be used subsequently with the result of action 3 and the second "combiningAction", + and so on. The default logical action is MV.multiply. + :type combiningActions: list + + .. note:: + + When calling the get function of the WeightsMaker object, the variable being processed may be passed, + allowing a mask to be generated based on the data itself. (If, for example, the WeightsMaker is passed + values=["input", 273.15] and actions=[MV.less], temperatures below freezing would be masked.) + """ if type(source)==types.StringType: self.file=source self.mask=None @@ -336,10 +382,12 @@ def __init__(self,source,var=None,weightsMaker=None,weightedGridMaker=None,offse applied to the data after regridding. :type weightedGridMaker: :py:class:`WeightsMaker` - :param offset: used to change units of the variable by multiplying the data by "slope" and adding "offset" to the result. + :param offset: used to change units of the variable by multiplying the data by "slope" and adding "offset" + to the result. :type offset: float - :param slope: used to change units of the variable by multiplying the data by "slope" and adding "offset" to the result. + :param slope: used to change units of the variable by multiplying the data by "slope" and adding "offset" + to the result. :type slope: float :param id: a string that can be used to identify your VariableConditioner object, @@ -624,6 +672,20 @@ class VariablesMatcherError(VariableConditionerError): pass class VariablesMatcher(object): + """ + The VariablesMatcher is defined to facilitate comparisons of two different variables by preprocessing them and + ensuring that they are expressed in the same units and are placed on a common grid. + Preprocessing includes selection of the spatial domain and time-period and provides for various masking and + regridding options. + + The VariablesMatcher relies on three different kinds of supporting objects: the VariableConditioner, + the WeightedGridMaker, and the WeightsMaker. The VariableConditioner can modify a field in various ways + (e.g., applying masks, mapping it to a new grid, applying scale factors and adding a constant to it, which is useful + in transforming the units). The WeightsMaker defines a mask, and the WeightedGridMaker defines a grid + (and possibly associates a WeightsMaker object with it). The WeightsMaker object will be described first, because + it may be needed by the other two. The WeightedGridMaker will be described next because it may be needed by the + VariableConditioner. + """ def __init__(self,variableConditioner1=None,variableConditioner2=None,externalVariableConditioner=None,weightedGridMaker=None,cdmsArguments=[],cdmsKeywords={}): # First VariableConditioner if isinstance(variableConditioner1,VariableConditioner): From 479a00ba4b32318bc6df7c2b2413e4318a49356c Mon Sep 17 00:00:00 2001 From: embrown Date: Mon, 14 Nov 2016 15:11:41 -0800 Subject: [PATCH 4/6] Copying VariablesMatcher.doc information out to docstrings. --- Lib/retrieve.py | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/Lib/retrieve.py b/Lib/retrieve.py index 8ca7899..99c9c4e 100644 --- a/Lib/retrieve.py +++ b/Lib/retrieve.py @@ -687,6 +687,46 @@ class VariablesMatcher(object): VariableConditioner. """ def __init__(self,variableConditioner1=None,variableConditioner2=None,externalVariableConditioner=None,weightedGridMaker=None,cdmsArguments=[],cdmsKeywords={}): + """ + :param variableConditioner1: a VariableConditioner object or a file name or a transient variable + (from which a VariableConditioner will be constructed). It may also be a tuple comprising a transient + variable plus a fraction associated with each cell (which will be used in constructing "weights"). + If variableConditioner1 is a file name, then the user must also define the name of the variable + (e.g., VM.variableConditioner1.var='tas'). + :type :py:class:`VariableConditioner` or str or transient variable + + :param variableConditioner2: as variableConditioner1, except if variable 2 is not on the same grid as variable 1 + after all processing is completed, then variable 2 will be mapped to variable 1's grid. + :type variableConditioner2: :py:class:`VariableConditioner` + + :param externalVariableConditioner: optional argument used to mask both variable 1 and variable 2 with its own + mask. Variable 1 and variable 2 are mapped to the external variable grid before applying the mask. + The external variable weights are applied (except where the weights associated with the variables are + zero) The externalVariableConditioner is generally not needed unless an external time-varying mask is + to be applied. + :type externalVariableConditioner: :py:class:`VariableConditioner` + + :param weightedGridMaker: an optional :py:class:`WeightedGridMaker` object that defines the target grid to which + variable 1 and variable 2 should be mapped as a last step. + + .. note:: + If a WeightsMaker is associated with the WeightedGridMaker object, + then the mask will be applied to the data after regridding. + :type weightedGridMaker: :py:class:`WeightedGridMaker` + + :param cdmsArguments: a tuple of optional arguments used when retrieving a variable with cdms. (For example, + cdmsArguments=(cdutil.region.NH) specifies that data should be retrieved from the Northern Hemisphere + only). See the cdms documentation for more information. The cdmsArguments set here will replace all + arguments that might be set for individual VariableConditioner objects (i.e., "1", "2" and "external"). + :type cdmsArguments: tuple + + :param cdmsKeywords: a dictionary defining "keyword:value" pairs used when retrieving a variable with cdms. + For example, cdmsKeywords= {'latitude:(-90.0, 0.0)} specifies that data should be retrieved from the + Southern Hemisphere only. See the cdms documentation for more information. + The cdmsKeywords set here will be appended to or take the place of those that might be set for + individual VariableConditioner objects (i.e., "1", "2" and "external"). + :type cdmsKeywords: dict + """ # First VariableConditioner if isinstance(variableConditioner1,VariableConditioner): self.variableConditioner1=variableConditioner1 From 2d701c4cac958d7b77dafcb8fb47bef242d991b3 Mon Sep 17 00:00:00 2001 From: embrown Date: Thu, 5 Jan 2017 12:02:04 -0800 Subject: [PATCH 5/6] This contains a lot of documentation edits to make docstrings sphinx-compatible. Not as much has been done with cdutil as was done in genutil, but much of the documentation has been converted to RST format, there are :Example: sections in a lot of places, and there is a sphinx configuration that makes it possible to build pdf/html output for the documentation. As with genutil, cdutil needs an experienced eye to go over the documentation and fill in parameter/return descriptions/datatypes. It also needs working :Examples: that will pass doctests. --- .idea/cdutil.iml | 11 + .idea/misc.xml | 14 + .idea/modules.xml | 8 + .idea/vcs.xml | 6 + .idea/workspace.xml | 755 ++ .../CDUtil/Modules/ValidationFunctions.rst | 5 + .../CDUtil/Modules/continent_fill.rst | 5 + .../CDUtil/Modules/create_landsea_mask.rst | 5 + .../CDUtil/Modules/netcdfwriter.rst | 5 + Doc/sphinx_docs/CDUtil/Modules/region.rst | 5 + Doc/sphinx_docs/CDUtil/Modules/retrieve.rst | 5 + Doc/sphinx_docs/CDUtil/Modules/sftbyrgn.rst | 5 + Doc/sphinx_docs/CDUtil/Modules/times.rst | 5 + Doc/sphinx_docs/CDUtil/Modules/vertical.rst | 5 + Doc/sphinx_docs/CDUtil/cdutil.rst | 17 + Doc/sphinx_docs/Makefile | 225 + .../Modules/ValidationFunctions.doctree | Bin 0 -> 19130 bytes .../CDUtil/Modules/continent_fill.doctree | Bin 0 -> 2896 bytes .../Modules/create_landsea_mask.doctree | Bin 0 -> 11167 bytes .../CDUtil/Modules/netcdfwriter.doctree | Bin 0 -> 8239 bytes .../doctrees/CDUtil/Modules/region.doctree | Bin 0 -> 15350 bytes .../doctrees/CDUtil/Modules/retrieve.doctree | Bin 0 -> 2836 bytes .../doctrees/CDUtil/Modules/sftbyrgn.doctree | Bin 0 -> 13927 bytes .../doctrees/CDUtil/Modules/times.doctree | Bin 0 -> 126354 bytes .../doctrees/CDUtil/Modules/vertical.doctree | Bin 0 -> 34654 bytes .../_build/doctrees/CDUtil/cdutil.doctree | Bin 0 -> 3899 bytes .../_build/doctrees/cdutil.doctree | Bin 0 -> 3159 bytes .../_build/doctrees/environment.pickle | Bin 0 -> 124483 bytes Doc/sphinx_docs/_build/doctrees/index.doctree | Bin 0 -> 5455 bytes Doc/sphinx_docs/_build/html/.buildinfo | 4 + .../CDUtil/Modules/ValidationFunctions.html | 157 + .../html/CDUtil/Modules/continent_fill.html | 103 + .../CDUtil/Modules/create_landsea_mask.html | 127 + .../html/CDUtil/Modules/netcdfwriter.html | 123 + .../_build/html/CDUtil/Modules/region.html | 140 + .../_build/html/CDUtil/Modules/retrieve.html | 103 + .../_build/html/CDUtil/Modules/sftbyrgn.html | 123 + .../_build/html/CDUtil/Modules/times.html | 655 + .../_build/html/CDUtil/Modules/vertical.html | 269 + .../_build/html/CDUtil/cdutil.html | 115 + .../_modules/cdutil/ValidationFunctions.html | 280 + .../_modules/cdutil/create_landsea_mask.html | 290 + .../html/_modules/cdutil/netcdfwriter.html | 124 + .../_build/html/_modules/cdutil/region.html | 324 + .../_build/html/_modules/cdutil/sftbyrgn.html | 280 + .../_build/html/_modules/cdutil/times.html | 1603 +++ .../_build/html/_modules/cdutil/vertical.html | 376 + .../_build/html/_modules/index.html | 92 + .../Modules/ValidationFunctions.rst.txt | 5 + .../CDUtil/Modules/ValidationFunctions.txt | 5 + .../CDUtil/Modules/continent_fill.rst.txt | 5 + .../CDUtil/Modules/continent_fill.txt | 5 + .../Modules/create_landsea_mask.rst.txt | 5 + .../CDUtil/Modules/create_landsea_mask.txt | 5 + .../CDUtil/Modules/netcdfwriter.rst.txt | 5 + .../_sources/CDUtil/Modules/netcdfwriter.txt | 5 + .../_sources/CDUtil/Modules/region.rst.txt | 5 + .../html/_sources/CDUtil/Modules/region.txt | 5 + .../_sources/CDUtil/Modules/retrieve.rst.txt | 5 + .../html/_sources/CDUtil/Modules/retrieve.txt | 5 + .../_sources/CDUtil/Modules/sftbyrgn.rst.txt | 5 + .../html/_sources/CDUtil/Modules/sftbyrgn.txt | 5 + .../_sources/CDUtil/Modules/times.rst.txt | 5 + .../html/_sources/CDUtil/Modules/times.txt | 5 + .../_sources/CDUtil/Modules/vertical.rst.txt | 5 + .../html/_sources/CDUtil/Modules/vertical.txt | 5 + .../html/_sources/CDUtil/cdutil.rst.txt | 17 + .../_build/html/_sources/CDUtil/cdutil.txt | 17 + .../_build/html/_sources/cdutil.txt | 5 + .../_build/html/_sources/index.rst.txt | 24 + .../_build/html/_sources/index.txt | 24 + .../_build/html/_static/ajax-loader.gif | Bin 0 -> 673 bytes .../_build/html/_static/alabaster.css | 693 ++ Doc/sphinx_docs/_build/html/_static/basic.css | 632 + .../_build/html/_static/comment-bright.png | Bin 0 -> 756 bytes .../_build/html/_static/comment-close.png | Bin 0 -> 829 bytes .../_build/html/_static/comment.png | Bin 0 -> 641 bytes .../_build/html/_static/custom.css | 1 + .../_build/html/_static/doctools.js | 287 + .../_build/html/_static/down-pressed.png | Bin 0 -> 222 bytes Doc/sphinx_docs/_build/html/_static/down.png | Bin 0 -> 202 bytes Doc/sphinx_docs/_build/html/_static/file.png | Bin 0 -> 286 bytes .../_build/html/_static/jquery-1.11.1.js | 10308 ++++++++++++++++ .../_build/html/_static/jquery-3.1.0.js | 10074 +++++++++++++++ Doc/sphinx_docs/_build/html/_static/jquery.js | 4 + Doc/sphinx_docs/_build/html/_static/minus.png | Bin 0 -> 90 bytes Doc/sphinx_docs/_build/html/_static/plus.png | Bin 0 -> 90 bytes .../_build/html/_static/pygments.css | 65 + .../_build/html/_static/searchtools.js | 758 ++ .../_build/html/_static/underscore-1.3.1.js | 999 ++ .../_build/html/_static/underscore.js | 31 + .../_build/html/_static/up-pressed.png | Bin 0 -> 214 bytes Doc/sphinx_docs/_build/html/_static/up.png | Bin 0 -> 203 bytes .../_build/html/_static/websupport.js | 808 ++ Doc/sphinx_docs/_build/html/cdutil.html | 100 + Doc/sphinx_docs/_build/html/genindex.html | 294 + Doc/sphinx_docs/_build/html/index.html | 130 + Doc/sphinx_docs/_build/html/objects.inv | Bin 0 -> 919 bytes Doc/sphinx_docs/_build/html/py-modindex.html | 150 + Doc/sphinx_docs/_build/html/search.html | 104 + Doc/sphinx_docs/_build/html/searchindex.js | 1 + Doc/sphinx_docs/conf.py | 348 + Doc/sphinx_docs/index.rst | 24 + Lib/ValidationFunctions.py | 50 +- Lib/continent_fill.py | 3 + Lib/create_landsea_mask.py | 8 +- Lib/netcdfwriter.py | 9 +- Lib/region.py | 12 +- Lib/retrieve.py | 6 +- Lib/sftbyrgn.py | 45 +- Lib/times.py | 38 +- Lib/vertical.py | 18 +- build/lib/cdutil/ValidationFunctions.py | 193 + build/lib/cdutil/__init__.py | 12 + build/lib/cdutil/cdutil_version.py | 1 + build/lib/cdutil/continent_fill.py | 182 + build/lib/cdutil/create_landsea_mask.py | 218 + build/lib/cdutil/netcdfwriter.py | 37 + build/lib/cdutil/region.py | 239 + build/lib/cdutil/retrieve.py | 1039 ++ build/lib/cdutil/sftbyrgn.py | 194 + build/lib/cdutil/times.py | 1516 +++ build/lib/cdutil/vertical.py | 289 + build/lib/cdutil/worldmap.py | 2330 ++++ 124 files changed, 38740 insertions(+), 56 deletions(-) create mode 100644 .idea/cdutil.iml create mode 100644 .idea/misc.xml create mode 100644 .idea/modules.xml create mode 100644 .idea/vcs.xml create mode 100644 .idea/workspace.xml create mode 100644 Doc/sphinx_docs/CDUtil/Modules/ValidationFunctions.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/continent_fill.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/create_landsea_mask.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/netcdfwriter.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/region.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/retrieve.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/sftbyrgn.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/times.rst create mode 100644 Doc/sphinx_docs/CDUtil/Modules/vertical.rst create mode 100644 Doc/sphinx_docs/CDUtil/cdutil.rst create mode 100644 Doc/sphinx_docs/Makefile create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/ValidationFunctions.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/continent_fill.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/create_landsea_mask.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/netcdfwriter.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/region.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/retrieve.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/sftbyrgn.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/times.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/vertical.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/CDUtil/cdutil.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/cdutil.doctree create mode 100644 Doc/sphinx_docs/_build/doctrees/environment.pickle create mode 100644 Doc/sphinx_docs/_build/doctrees/index.doctree create mode 100644 Doc/sphinx_docs/_build/html/.buildinfo create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/ValidationFunctions.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/continent_fill.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/create_landsea_mask.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/netcdfwriter.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/region.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/retrieve.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/sftbyrgn.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/times.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/Modules/vertical.html create mode 100644 Doc/sphinx_docs/_build/html/CDUtil/cdutil.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/ValidationFunctions.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/create_landsea_mask.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/netcdfwriter.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/region.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/sftbyrgn.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/times.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/cdutil/vertical.html create mode 100644 Doc/sphinx_docs/_build/html/_modules/index.html create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/cdutil.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/index.rst.txt create mode 100644 Doc/sphinx_docs/_build/html/_sources/index.txt create mode 100644 Doc/sphinx_docs/_build/html/_static/ajax-loader.gif create mode 100644 Doc/sphinx_docs/_build/html/_static/alabaster.css create mode 100644 Doc/sphinx_docs/_build/html/_static/basic.css create mode 100644 Doc/sphinx_docs/_build/html/_static/comment-bright.png create mode 100644 Doc/sphinx_docs/_build/html/_static/comment-close.png create mode 100644 Doc/sphinx_docs/_build/html/_static/comment.png create mode 100644 Doc/sphinx_docs/_build/html/_static/custom.css create mode 100644 Doc/sphinx_docs/_build/html/_static/doctools.js create mode 100644 Doc/sphinx_docs/_build/html/_static/down-pressed.png create mode 100644 Doc/sphinx_docs/_build/html/_static/down.png create mode 100644 Doc/sphinx_docs/_build/html/_static/file.png create mode 100644 Doc/sphinx_docs/_build/html/_static/jquery-1.11.1.js create mode 100644 Doc/sphinx_docs/_build/html/_static/jquery-3.1.0.js create mode 100644 Doc/sphinx_docs/_build/html/_static/jquery.js create mode 100644 Doc/sphinx_docs/_build/html/_static/minus.png create mode 100644 Doc/sphinx_docs/_build/html/_static/plus.png create mode 100644 Doc/sphinx_docs/_build/html/_static/pygments.css create mode 100644 Doc/sphinx_docs/_build/html/_static/searchtools.js create mode 100644 Doc/sphinx_docs/_build/html/_static/underscore-1.3.1.js create mode 100644 Doc/sphinx_docs/_build/html/_static/underscore.js create mode 100644 Doc/sphinx_docs/_build/html/_static/up-pressed.png create mode 100644 Doc/sphinx_docs/_build/html/_static/up.png create mode 100644 Doc/sphinx_docs/_build/html/_static/websupport.js create mode 100644 Doc/sphinx_docs/_build/html/cdutil.html create mode 100644 Doc/sphinx_docs/_build/html/genindex.html create mode 100644 Doc/sphinx_docs/_build/html/index.html create mode 100644 Doc/sphinx_docs/_build/html/objects.inv create mode 100644 Doc/sphinx_docs/_build/html/py-modindex.html create mode 100644 Doc/sphinx_docs/_build/html/search.html create mode 100644 Doc/sphinx_docs/_build/html/searchindex.js create mode 100644 Doc/sphinx_docs/conf.py create mode 100644 Doc/sphinx_docs/index.rst create mode 100644 build/lib/cdutil/ValidationFunctions.py create mode 100644 build/lib/cdutil/__init__.py create mode 100644 build/lib/cdutil/cdutil_version.py create mode 100644 build/lib/cdutil/continent_fill.py create mode 100644 build/lib/cdutil/create_landsea_mask.py create mode 100644 build/lib/cdutil/netcdfwriter.py create mode 100644 build/lib/cdutil/region.py create mode 100644 build/lib/cdutil/retrieve.py create mode 100644 build/lib/cdutil/sftbyrgn.py create mode 100644 build/lib/cdutil/times.py create mode 100644 build/lib/cdutil/vertical.py create mode 100644 build/lib/cdutil/worldmap.py diff --git a/.idea/cdutil.iml b/.idea/cdutil.iml new file mode 100644 index 0000000..6711606 --- /dev/null +++ b/.idea/cdutil.iml @@ -0,0 +1,11 @@ + + + + + + + + + + \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..d93c344 --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,14 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml new file mode 100644 index 0000000..2f5e117 --- /dev/null +++ b/.idea/modules.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..94a25f7 --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/.idea/workspace.xml b/.idea/workspace.xml new file mode 100644 index 0000000..53fe3bc --- /dev/null +++ b/.idea/workspace.xml @@ -0,0 +1,755 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1475678637912 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/CDUtil/Modules/ValidationFunctions.rst b/Doc/sphinx_docs/CDUtil/Modules/ValidationFunctions.rst new file mode 100644 index 0000000..2fe9560 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/ValidationFunctions.rst @@ -0,0 +1,5 @@ +ValidationFunctions +------------------- + +.. automodule:: cdutil.ValidationFunctions + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/continent_fill.rst b/Doc/sphinx_docs/CDUtil/Modules/continent_fill.rst new file mode 100644 index 0000000..c767ed5 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/continent_fill.rst @@ -0,0 +1,5 @@ +continent_fill +-------------- + +.. automodule:: cdutil.continent_fill + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/create_landsea_mask.rst b/Doc/sphinx_docs/CDUtil/Modules/create_landsea_mask.rst new file mode 100644 index 0000000..3db4f76 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/create_landsea_mask.rst @@ -0,0 +1,5 @@ +create_landsea_mask +------------------- + +.. automodule:: cdutil.create_landsea_mask + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/netcdfwriter.rst b/Doc/sphinx_docs/CDUtil/Modules/netcdfwriter.rst new file mode 100644 index 0000000..54aab64 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/netcdfwriter.rst @@ -0,0 +1,5 @@ +netcdfwriter +------------ + +.. automodule:: cdutil.netcdfwriter + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/region.rst b/Doc/sphinx_docs/CDUtil/Modules/region.rst new file mode 100644 index 0000000..980dee1 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/region.rst @@ -0,0 +1,5 @@ +region +------ + +.. automodule:: cdutil.region + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/retrieve.rst b/Doc/sphinx_docs/CDUtil/Modules/retrieve.rst new file mode 100644 index 0000000..7ee9390 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/retrieve.rst @@ -0,0 +1,5 @@ +retrieve +-------- + +.. automodule:: cdutil.retrieve + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/sftbyrgn.rst b/Doc/sphinx_docs/CDUtil/Modules/sftbyrgn.rst new file mode 100644 index 0000000..706c5a0 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/sftbyrgn.rst @@ -0,0 +1,5 @@ +sftbyrgn +-------- + +.. automodule:: cdutil.sftbyrgn + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/times.rst b/Doc/sphinx_docs/CDUtil/Modules/times.rst new file mode 100644 index 0000000..3369265 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/times.rst @@ -0,0 +1,5 @@ +times +----- + +.. automodule:: cdutil.times + :members: diff --git a/Doc/sphinx_docs/CDUtil/Modules/vertical.rst b/Doc/sphinx_docs/CDUtil/Modules/vertical.rst new file mode 100644 index 0000000..e0f8d3d --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/Modules/vertical.rst @@ -0,0 +1,5 @@ +vertical +-------- + +.. automodule:: cdutil.vertical + :members: diff --git a/Doc/sphinx_docs/CDUtil/cdutil.rst b/Doc/sphinx_docs/CDUtil/cdutil.rst new file mode 100644 index 0000000..9baa545 --- /dev/null +++ b/Doc/sphinx_docs/CDUtil/cdutil.rst @@ -0,0 +1,17 @@ +CDUtil +------ + +.. automodule:: cdutil + :members: + +.. toctree:: + + Modules/continent_fill + Modules/create_landsea_mask + Modules/netcdfwriter + Modules/region + Modules/retrieve + Modules/sftbyrgn + Modules/times + Modules/ValidationFunctions + Modules/vertical diff --git a/Doc/sphinx_docs/Makefile b/Doc/sphinx_docs/Makefile new file mode 100644 index 0000000..0c12156 --- /dev/null +++ b/Doc/sphinx_docs/Makefile @@ -0,0 +1,225 @@ +# Makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +PAPER = +BUILDDIR = _build + +# Internal variables. +PAPEROPT_a4 = -D latex_paper_size=a4 +PAPEROPT_letter = -D latex_paper_size=letter +ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . +# the i18n builder cannot share the environment and doctrees with the others +I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . + +.PHONY: help +help: + @echo "Please use \`make ' where is one of" + @echo " html to make standalone HTML files" + @echo " dirhtml to make HTML files named index.html in directories" + @echo " singlehtml to make a single large HTML file" + @echo " pickle to make pickle files" + @echo " json to make JSON files" + @echo " htmlhelp to make HTML files and a HTML help project" + @echo " qthelp to make HTML files and a qthelp project" + @echo " applehelp to make an Apple Help Book" + @echo " devhelp to make HTML files and a Devhelp project" + @echo " epub to make an epub" + @echo " epub3 to make an epub3" + @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" + @echo " latexpdf to make LaTeX files and run them through pdflatex" + @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" + @echo " text to make text files" + @echo " man to make manual pages" + @echo " texinfo to make Texinfo files" + @echo " info to make Texinfo files and run them through makeinfo" + @echo " gettext to make PO message catalogs" + @echo " changes to make an overview of all changed/added/deprecated items" + @echo " xml to make Docutils-native XML files" + @echo " pseudoxml to make pseudoxml-XML files for display purposes" + @echo " linkcheck to check all external links for integrity" + @echo " doctest to run all doctests embedded in the documentation (if enabled)" + @echo " coverage to run coverage check of the documentation (if enabled)" + @echo " dummy to check syntax errors of document sources" + +.PHONY: clean +clean: + rm -rf $(BUILDDIR)/* + +.PHONY: html +html: + $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." + +.PHONY: dirhtml +dirhtml: + $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." + +.PHONY: singlehtml +singlehtml: + $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml + @echo + @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." + +.PHONY: pickle +pickle: + $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle + @echo + @echo "Build finished; now you can process the pickle files." + +.PHONY: json +json: + $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json + @echo + @echo "Build finished; now you can process the JSON files." + +.PHONY: htmlhelp +htmlhelp: + $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp + @echo + @echo "Build finished; now you can run HTML Help Workshop with the" \ + ".hhp project file in $(BUILDDIR)/htmlhelp." + +.PHONY: qthelp +qthelp: + $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp + @echo + @echo "Build finished; now you can run "qcollectiongenerator" with the" \ + ".qhcp project file in $(BUILDDIR)/qthelp, like this:" + @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/CDUtil.qhcp" + @echo "To view the help file:" + @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/CDUtil.qhc" + +.PHONY: applehelp +applehelp: + $(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp + @echo + @echo "Build finished. The help book is in $(BUILDDIR)/applehelp." + @echo "N.B. You won't be able to view it unless you put it in" \ + "~/Library/Documentation/Help or install it in your application" \ + "bundle." + +.PHONY: devhelp +devhelp: + $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp + @echo + @echo "Build finished." + @echo "To view the help file:" + @echo "# mkdir -p $$HOME/.local/share/devhelp/CDUtil" + @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/CDUtil" + @echo "# devhelp" + +.PHONY: epub +epub: + $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub + @echo + @echo "Build finished. The epub file is in $(BUILDDIR)/epub." + +.PHONY: epub3 +epub3: + $(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3 + @echo + @echo "Build finished. The epub3 file is in $(BUILDDIR)/epub3." + +.PHONY: latex +latex: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo + @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." + @echo "Run \`make' in that directory to run these through (pdf)latex" \ + "(use \`make latexpdf' here to do that automatically)." + +.PHONY: latexpdf +latexpdf: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through pdflatex..." + $(MAKE) -C $(BUILDDIR)/latex all-pdf + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +.PHONY: latexpdfja +latexpdfja: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through platex and dvipdfmx..." + $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +.PHONY: text +text: + $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text + @echo + @echo "Build finished. The text files are in $(BUILDDIR)/text." + +.PHONY: man +man: + $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man + @echo + @echo "Build finished. The manual pages are in $(BUILDDIR)/man." + +.PHONY: texinfo +texinfo: + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo + @echo + @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." + @echo "Run \`make' in that directory to run these through makeinfo" \ + "(use \`make info' here to do that automatically)." + +.PHONY: info +info: + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo + @echo "Running Texinfo files through makeinfo..." + make -C $(BUILDDIR)/texinfo info + @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." + +.PHONY: gettext +gettext: + $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale + @echo + @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." + +.PHONY: changes +changes: + $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes + @echo + @echo "The overview file is in $(BUILDDIR)/changes." + +.PHONY: linkcheck +linkcheck: + $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck + @echo + @echo "Link check complete; look for any errors in the above output " \ + "or in $(BUILDDIR)/linkcheck/output.txt." + +.PHONY: doctest +doctest: + $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest + @echo "Testing of doctests in the sources finished, look at the " \ + "results in $(BUILDDIR)/doctest/output.txt." + +.PHONY: coverage +coverage: + $(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage + @echo "Testing of coverage in the sources finished, look at the " \ + "results in $(BUILDDIR)/coverage/python.txt." + +.PHONY: xml +xml: + $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml + @echo + @echo "Build finished. The XML files are in $(BUILDDIR)/xml." + +.PHONY: pseudoxml +pseudoxml: + $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml + @echo + @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." + +.PHONY: dummy +dummy: + $(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy + @echo + @echo "Build finished. Dummy builder generates no files." diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/ValidationFunctions.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/ValidationFunctions.doctree new file mode 100644 index 0000000000000000000000000000000000000000..037af73318766162047148054fbdb14f93684387 GIT binary patch literal 19130 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 literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/continent_fill.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/continent_fill.doctree new file mode 100644 index 0000000000000000000000000000000000000000..8dee19b68e332e6e0338352c0a3e680ed18e6a04 GIT binary patch literal 2896 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 Sfw%(sC0-)BAOFKb=6?bEc!x~@ literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/netcdfwriter.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/netcdfwriter.doctree new file mode 100644 index 0000000000000000000000000000000000000000..2fc7baddc96505bf540ff81b791c1df61aba6923 GIT binary patch literal 8239 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 literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/region.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/region.doctree new file mode 100644 index 0000000000000000000000000000000000000000..015caa8b3332588a13dc12614063c0e4612783dc GIT binary patch literal 15350 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 B5I6t; literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/retrieve.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/retrieve.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b66aeee89e3d7ce59cb4c09373959c9e6b93d662 GIT binary patch literal 2836 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 CiL6Kf literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/times.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/times.doctree new file mode 100644 index 0000000000000000000000000000000000000000..65b0209163eb2b5e51c38cb0e4c67b0851f61fc0 GIT binary patch literal 126354 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 literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/vertical.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/Modules/vertical.doctree new file mode 100644 index 0000000000000000000000000000000000000000..9d3d5eafc592c6be48795c7432b671fa742cc48b GIT binary patch literal 34654 zcmdsg2Y?&J^|x`iaO1$#!-#$c`wp9C3^ur6Fa~pHED+^#=uUgLTI;0Sw~`BC113Q1 z5CS0u(g>-fLMkbwKzayCNFjxEl8}TXq>zvvzTfZ7?rJ5i&Ia=b^WkG>XXdqe@6GJY zJk9QvV+Zo(foi2t^g2uByyc~s9kxo9l)KxUE$&#~9oLbWQpycmmCYlT=Z^Q?2_4xZ z#*7&=kSAK_21_c1fn2e(SROjNP_lBes#LLLq+HBZ3gwbJaclO_BF!<$$(Bx^o?({}2d7Hh8H5|gE+!@f-OyAuD zx{};RuUwS@%Wcby$)s|XiWK^*6%g9fclYYZOwLzFs87$G)ti}6v^H49)#Ebb3VF}n zyEikrKR2*mD9b**nTdu_b_?3qmGLa`y85NOv2^S)3%hcq92%I%mL-DJ!J^X!|MG*HZW z9wgrnlAAW{-^5eMs>4gqo0ksmD&=$`@+T{eY=;NsrK_bv#Y^YB^r|_XsTI~>u3D@F zIEyZxe+>Vdn?7m5@k|!tisVF7c!Eh-hQi}CdCrx)X#Rpl=?+z0*RgZbnUb|>#2Tnr zd9*$cC2C*lJl4p}RzdUyCO6;Yw9TfGbJM1X;0A1Nn$^8FJTTp1&+4`J>$UgkwfF9| z_wTLRO$I6!yh zks=x*#H+YVGLtH~A@+3l)XbznF!wb2!O}WKy30DUdqbpQr82K!IB}O}CWmz06&9S% zJ>8y?tD2$1UAcNJM#bQ{@OAG~dFw85vlknwz%i{?m95F z$!B%7KUeK<@(Xs`O({165zqJC3qlh@s$FC>&r&xkrF$WDb5RF}0}KjgbilYi2`()K z%j}i;Cbj(S26iR6$Qsa|tjy*{wfzj-hYifclR8aMGaeJP0oS3q)^}tkmCD9`#ci31`SNhC zP;!T}VtN~Jbobog@x1t{Kc3S&`{0|K_V5U;dW+YTOV-?UZd1WqeB@vimIq`5cI0o~2^#9U^gacuXp#^Fk=5y7-*0Mq!C z`@-xDG^%kNz8r&>@4GMRk9TzU3X+{Xh=;b0^jB&xPWEPZOJ;&j0^O@Hxt%ar;8Wto z+u~kxbqlZIBNGpjlzR<)=33u<34LZ}vyh!IN(F;Abum?S5n#Gosfld~V|dt)-Iv-u zi6q_Y(D0Y}?)71Zx;A;#R(3|pmqW@MeD_9R*jr*EO^IOKS5TgtMw922kcW@O7Rr1T zq0_#;#S{%)2^?HTLP~(Jv?fHdmFXz=Fzn97WmOFY-RVYaOAi7?%P90zEvGL zXd9bg>9J!*!Auwa`82ueFy2@4M*bc z$;D=8q1XK+EcYqj{d8!FyI?t3Vxr;ae#T^{#x?5Rqt>-BedBuPUf=y}h>eG7Y}^i( zMegTl(9e(N-(TpkxfAe3-~AFuWd#zRT^?dHFu99u0AN|fEdUVaaw45e>pC$#h>e}J zZWG0}4Mu_uqoAlWb$+f`wY+q{RV;5zV=HMeH(;f)MUfuPdF!owr~74S|K43`I`9=( zVhYCz-7RtNqaMGSpvP!N?cNXjK1bU78a(OizWWUr(55E8s9s`o0sVmQelv6tD41P6 zWmfonn7Q9#yS|;!uIRb`9h(dJ2YvUuh791p*9_loKR_Sp#Bx-w^9Dt)7MI#KyY+1N@V|i~&c=+Y*q{Rr@V0Pwz8wOo{f%WH%s#4eTLf zaqG)CLrwS0WV~jYw%u$RMkb(=wvma7ILRPp7en4|wkI0LVq@L9bGy?WxSFcg-7{b(6qUEifAc^_FrdE@@0- zYV6g0%@&!CtS>VZk6VWA4oR!R?0Q4VOjH1455;JUVUV;MZ6TEKblWd`8uEK7`B{d1 zc4sJ}Ek?4M4>&Qy@2!mXF^r7i_ti`b!|#VmHT?dHcz{97-j6m1o8KLDusL;3(6}v* zC`;0=c=w#SX+$()yW)J(ElT~Luf0=Ao6gdntOtiGqYoXZ_4LEpxbx*8&9`MIM!KLg zrnNND8L2`NI+$rs3{MV037qUuB)%MmYcMQ0

*HZk(h$N^ibj>WsEbV{?O?yA#VisdqZ2l99x$6` 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 literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/CDUtil/cdutil.doctree b/Doc/sphinx_docs/_build/doctrees/CDUtil/cdutil.doctree new file mode 100644 index 0000000000000000000000000000000000000000..6a64df0b71cfce2069a8a59b5595a741ec996426 GIT binary patch literal 3899 zcmcgv_j?>y6_sUcrCnRaj!WEJx<##*6_KPNY|XE9TwZ=W;*F5iH;M^ z9i?5VX?%7I8#Pe`zM_eoCPj_ast~3W8}mdE`nZ;M+O%t9N{V~t?gm|fjCSX=2N_9s zz6xM38)7v?ikN7h7-qHV?^ky2LYi%+xK!<~Oy=Voj-PC&GC7ayRGUY|-`WGbityWI zNbS>!*H);KX)-vd38h9Pb>2QmU z`B`f06kTPrQ7?3r!tYnxY^>{g7oqzXw8b^HIBI7C{zT;kaIB}^Ilche9bbF%L+-msCvv(0 z4u$b@eb#leu2*6^m{-8ws}0K+9zgC zw!@&?P8YRE;uAABwN;?`bP9A0Z3i`VoFERgvrt&8nPiv(<5C2;FbzN;IIKe zu-NTOHx&(f6ri{{r$?JgorQxt3PMz|Hj%w{gIG1AKzTe2-IyntYRUvH9COv|C9)a0 zagb&qc#SmYTp76CkgFMb%>NtMTL5f*H8r}`fP33!%o+egr^WIAang?k56|TEIKx8& zz|AEOH{kCjQJQ42-=N0>{~8Xx60hgencXgH7th(~|S)c@!|^k}P*! z+w2^)%@Z$Ue|54!PlDGc=k%0;*Rxemj#d`*RO9phl}*|l}nUwV9pLsJ;Pe< z0D7iPcFXD<1~V%!B|*_`pe8to1PEABdxt1i$zOXOOe zgO?k}Tzh_RUZSrhb(hGqI(sg+lDuzLkiSIS>g?O>d(*yioO(;t-_%0&bazqqV-iag zSe@OM-=PCD$xcc!?6uYE}Kx6}F?Q zC?JG4vPrhY-Qph66~5>RA{Fjna^o~O{vAGn}p85QqiJK&tf~*ZT8~yvu%0~+r7cu zDZa{WdM>MbfiCb+^gNsHHBG>F3?xLc!7f5EtVVcAY&_ql7nrcpM4F<%&|+hOU#W@v zpeDxG#-eD+rWdjCfwMAz<(yX76h?X=vGN@Vkv`XoUTo7#*qGwlOh!d7U9&8E671y| z0H|XIF-0#+=;b-RqQ!O%pm5CAM&K6|y%J$ufvXegLp7y1$72usfnH^?9kS=a6!IyP zA-$R%5?ZI~RJ*N{1X?ZNx;K-^ep~1$Y}0F49T0fj+)b}thVtU6$pI}Md${m*7Mm~& zD|Ik`jJi|wdK404VNE!1U?XNhEz%p=INGY8Vf(?}=kz8vjJfb;RtGgX1X+~QTTF-r zxK4>{WxIM?)^6?PblEY0+PyYs!+ zzCgp%bU#8uZ7~j=1;cQ9A8In`XHn{`a!S$rffYu55ciVG>;o{Hn0IAt0>)k3jp&0G z+hcGyO=qg+XdWS6&FMpI3|~xNcl<`5KFoIV1?ULCs54bz^ATWE!{qA)efnrsD==;@ zfD%b0eGE5yVd7qJc;p751KlGbs!`aFFSEnQBwFpXOI3Fi6bz?Ntgx++IrK@Z$}3eo z^N~js(x(i33uywD1>miW-B8h|(N6{wi27ovR~dh1g>5gDv18avpGBC4qib09Ik?yW zJbj*xWV$zflD@zi)p0}UFXD6%uPqUMiPa0sX$26z%qAT_P)2fqf(0&Lu~;1)oWfzS zKwrgRs%y9F%m+T^*Vkt8+*r>e`Z^n7=gz?OH`wUlwed}{pG~5RHKeBL1wf?fTg$B8 z=P}0<1Ymy~p%nzU1j%hrla zOjVn{Z^j~Y*McL0z6kN7=?9SEN!+I&vP0|P*w6((68EzSGqIdY5d4@82R{7-(Ly;G zeO^`Srz`AW*=IcDMY97WEu6vA;b&lT1!}=nML)OM-h#D|gl4DU6~|+Py-&YbX4|pD zS3m#KjLrg{)dBb`E9RlMe#KGO-{dUi6a{oYdKRJ^gAe*-{GO1j@1VvThZTb`Uk5S=HZp~&z%01b!YwqjnAJ& literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/cdutil.doctree b/Doc/sphinx_docs/_build/doctrees/cdutil.doctree new file mode 100644 index 0000000000000000000000000000000000000000..eee4a677e3d2b016fc2e7599e4ff30f258ff6df2 GIT binary patch literal 3159 zcmcgu>3_{9CmZa*I-p(S1Y!(?BPI|;mH@6Gj$!DX>D``qW_oJ6 zM+Yzv0|ANqzVG|K;qT-1%&aVn@QoiI?4NeGyZY6uSFh^%*&x(GVWZgeQyogvaUTN=61Qc8BjqMkh-?g^Y5s)c`n6Gt>f7 zVB&k!EVY{N@7;I?X%5K9+zdv!-bx?2e07lJ`ZC~GV`dU358C$5vL{wvfy>ZH0?ol$3Lt~$zV3h4Vi zb-$+`@Ko1R4|?jNS17!vnpZ%_otnELx1qPo2P41ogL ztJG6?;OR;b4c0EQw<1bSH;GIj<5;9p7p9wQ^lmCmcdYYnBGM=;Vh9>(Zi+k-qga|g zzw!S~?3+Mrdp|XPvm^J37gN@h7{0D9|BsV?3v~Eo$!~Q!bObzJ=}_W-Cp9`|bCDXb zmdKpnHl(F}->UlasgmDL3;45c!S#~gL91pb8R^)co;3Wl$3r@PhwD|h-|6u)bn?(~ zzxwH29>1H~L1Zi2G5j8nZ#Z?(;?!QNCMUS*KEm5Z{H(|Cb+9s>Tj1Up(n1tAPWwJM z?b1OkhTre;2WV;fSPkHVC400A)kit((1%G+q&55@k9}G&(mL@N{_p`m8RyWROvBEz zA}%m!SZE%V9Q5eKlnUP&8-U+590JDO2(9xF6D7kvnFeSfmP1<1#{rIFv=n*FV>+j- z&CIpIz-o;-7D+qq>wGd$Hi-v3p*AQ8q>IgJ7gI@QE(Zz64-haK(z5I6%nx+pCZFNw zP)MuY8&fzpY0mZV4#%{FrkNBl2%HZkCp3$(lTterux=}ojJ1PUk?Y5DQ^uUZYZs9Q zhGbfgITXC3L~NS_`T86!H6R+FH$$~Hq;oRQb?yVH4#B8je^eq3V-(KPs)J~7Md861 zS#m*hp&S(x-W<{@hLm)L-9ZB@DJ^g9(RuWGR@na*a~lQ)HUi5#fP~tnMdEKeh4V*H zla;VYGJjuFhCd3f;6_n8*3Gex;n?z)$WsRxv7|`29MUPr`#6fLs`*wXz-uLcoEGrI z+C!Hg4fzvvTyDc^L8C29!_D*HrUl;`M-#r))C!8*j9}I}=T9PX5NmPMmx+jCAEP11 z!hynmYM0Ij(Xo1K@SS>j4=|lZ52);Oc;XQ8{CS!y?0D@ee}Ov9btmXA;&zlC zED?W++SSQ50}{SWD}ERm=gN>^#miTQ)J6wqcre=LufmwxR*d|uD71>dwvJWoP95>r zX^w6@iKo9o^V3c2o9Ya$po=Z0vFim;WcgdW)Sk#xVm$-d-v+cw0Jkam4#aK}>}Wn0 z*w+kycaIibsrMW7d(@pa=+@R2rl^~?RfC3dbAY2}z~6Vah|#p|t7xKP{ImQ6Y$`gP z@DJ(Sopc=Pf*+|JT6T`*-=^TlG#iEd6QI@D{jkC`mHO!(-BWE|YQvSO<38kH?9wspk?5rQ^DmusR`l!};ID?oh)x~0@Or2H z_4-V`z5S---}cmn!$ZCH)DHg+6aDuk|KY%LqukEXst@oV-CX=rH5ai5{#jiRSU#|k z80-|gZV9W`uj!C1Mru`^EFk2ATYEjA{!;Q^)maP@MEqM5(FJREV(fW!IBHKV+wk8# T{s*<3^00{hv*dpjqyE1E<93G5 literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/environment.pickle b/Doc/sphinx_docs/_build/doctrees/environment.pickle new file mode 100644 index 0000000000000000000000000000000000000000..c8445159da7f1324419a412bc891d3de7988407c GIT binary patch literal 124483 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 M0lR?gbuVH)52Yo`7XA-b*jw0rdR(JA>M` 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 Cbl_wF literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/doctrees/index.doctree b/Doc/sphinx_docs/_build/doctrees/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..7fb178dfb95b33cfe0265a27eede680b9d38cc2d GIT binary patch literal 5455 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 b9EWI0o`PSd&%n4&k_YjU$V2#z%VYlqj@WL- literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/html/.buildinfo b/Doc/sphinx_docs/_build/html/.buildinfo new file mode 100644 index 0000000..b604e5a --- /dev/null +++ b/Doc/sphinx_docs/_build/html/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: 01a22e19526280a53e69efa09399d682 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/ValidationFunctions.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/ValidationFunctions.html new file mode 100644 index 0000000..149d772 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/ValidationFunctions.html @@ -0,0 +1,157 @@ + + + + + + + + ValidationFunctions — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +

+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/continent_fill.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/continent_fill.html new file mode 100644 index 0000000..1b22b22 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/continent_fill.html @@ -0,0 +1,103 @@ + + + + + + + + continent_fill — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

continent_fill

+
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/create_landsea_mask.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/create_landsea_mask.html new file mode 100644 index 0000000..7f71e38 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/create_landsea_mask.html @@ -0,0 +1,127 @@ + + + + + + + + create_landsea_mask — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

create_landsea_mask

+
+
+cdutil.create_landsea_mask.generateLandSeaMask(target, source=None, threshold_1=0.2, threshold_2=0.3, regridTool='regrid2')[source]
+

Generates a best guess mask on any rectilinear grid, using the method described in PCMDI’s report #58 +see: http://www-pcmdi.llnl.gov/publications/ab58.html +Input:

+
+

target: either a MV2 object with a grid, or a cdms2 grid (rectilinear grid only) +source: A fractional (0 to 1.) land sea mask, where 1 means all land +threshold_1 (optional): criteria 1 for detecting cells with possible increment see report for detail

+
+
difference threshold
+
+
threshold_2 (optional): criteria 2 for detecting cells with possible increment see report for detail
+
water/land content threshold
+
+

regridTool: which cdms2 regridder tool to use, default is regrid2

+
+
+
Output:
+
landsea maks on target grid
+
+
+ +
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/netcdfwriter.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/netcdfwriter.html new file mode 100644 index 0000000..9cca4d5 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/netcdfwriter.html @@ -0,0 +1,123 @@ + + + + + + + + netcdfwriter — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

netcdfwriter

+

writenetcdf +see also dataset write method

+
+
+cdutil.netcdfwriter.writenetcdf(slab, filename, mode='a')[source]
+

writenetcdf(slab, filename, mode=”a”) writes slab to the file. +:param mode: One of ‘a’ append, or ‘w’ replace +:type mode: str

+ +++ + + + + + +
Parameters:slab – Anything cdms2.asVariable() will accept
Type:see cdms2.asVariable()
+
+ +
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/region.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/region.html new file mode 100644 index 0000000..4138976 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/region.html @@ -0,0 +1,140 @@ + + + + + + + + region — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

region

+
+
+class cdutil.region.DomainComponent(*args, **kargs)[source]
+

gets a domain, and by default adjusts the bounds to the domain +or if exact is set to 0 or None gets all the domain that has +parts of the domain requested, also post processing allows you to apply a mask +dimension names can be passed as keywords, +but if no name is passed arguments are taken in order and applied to the corresponding axis +Overwritting an axis (2 keywords or keyword + argument) is not allowed +Example of use: +NH=cdms.selectors.Selector(domain(latitude=(0.,90.)))

+
+
+post(fetched, slab, axes, specifications, confined_by, aux, axismap)[source]
+

Post processing retouches the bounds and later will deal with the mask

+
+ +
+
+same(data, value)[source]
+

Check if data is basically the same than value

+
+ +
+
+specify(slab, axes, specification, confined_by, aux)[source]
+

First part: confine the slab within a Domain wide enough to do the exact in post

+
+ +
+ +
+
+cdutil.region.domain(*args, **kargs)[source]
+

construct the selector

+
+ +
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/retrieve.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/retrieve.html new file mode 100644 index 0000000..7300839 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/retrieve.html @@ -0,0 +1,103 @@ + + + + + + + + retrieve — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

retrieve

+
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/sftbyrgn.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/sftbyrgn.html new file mode 100644 index 0000000..4ba25fc --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/sftbyrgn.html @@ -0,0 +1,123 @@ + + + + + + + + sftbyrgn — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

sftbyrgn

+

This module contains functions to map an array of “regions” onto a mask

+
+
+cdutil.sftbyrgn.generateSurfaceTypeByRegionMask(mask, sftbyrgn=None, sftbyrgnmask=215, regions=[201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222], maximum_regions_per_cell=4, extend_up_to=3, verbose=True)[source]
+

Maps a “regions” dataset onto a user provided land/sea mask or grid

+

mapped,found = generateSurfaceTypeByRegionMask(mask,sftbyrgn=None,sftbyrgnmask=None,regions=None,maximum_regions_per_cell=4,extend_up_to=3,verbose=True)

+

mask User provided land/sea mask (100/0) or grid (the land/sea mask will be generated automagically) which will be mapped using the “sftbyrgn” internal dataset (will generate a land/sea mask for you) +sftbyrgn Mask you wish to map onto your grid (if None uses internal “sftbyrgn” dataset (old ezget type)) +sftbyrgnmask Land/sea mask for sftbyrgn (or a number specifying value limits for sftbyrgn which indicates land/sea threshold (greater values are land) - see URL below for integer region map) +regions Numbers from sftbyrgn array that you want to map onto mask (integers from 201-222) +maximum_regions_per_cell Maximum number of regions considered for a single cell +extend_up_to How many grid cells around a cell can we extend to identify a guess +verbose Prints to the screen what’s going on (default is True)

+

mapped Mapped input grid/mask using provided (or default) regions - sftbyrgn -> user provided grid/mask +found Matrix containing number of regions matched for each output cell

+ +
+ +
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/times.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/times.html new file mode 100644 index 0000000..88ddae5 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/times.html @@ -0,0 +1,655 @@ + + + + + + + + times — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

times

+
+
+class cdutil.times.TimeSlicer(slicerfunction=None, criteriafunction=None)[source]
+

Author : Charles Doutriaux: doutriaux1@llnl.gov +Date: April 2001

+

Returns masked average of specific time slices +“slicer” determine which slices of the Transient Variable (TV) are processed +“criteria” gets TV (with time dimension) and returns a “timeless” mask, used to mask the averaged slices

+
+
“slicer”
+
+
Input:
+
    +
  • Time Axis
    • +
  • User argument (can be anything) (in a list if more than one argument)
    • +
+
+
Output:
+
+
indices
+ : the indices for each season:
[[i1,i2,...,il], +[j1,j2,...,jm], +..., +[k1,k2,...kn]]
+
bounds
+ : the bounds covered by each slice for each season:
[[[i1b1,i1b2],[i2b1,i2b2],...,[ilb1,ilb2]], +[[[j1b1,j1b2],[j2b1,j2b2],...,[jmb1,jmb2]], +..., +[[k1b1,k1b2],[k2b1,k2b2],...,[knb1,knb2]]]
+
norm
+ : the actual length of each “season”, and its start
[[Li,Si], +[Lj,Sj], +..., +[Lk,Sk]]
+
+
+
+
+
“criteria”
+
+
Input:
+
    +

  • slab : a slab

    +
    • +
  • +
    mask: the actual percentage of data in each subset used to produce the slab
    +

    the bounds of its first (time) dimension must be correct +they will be used by centroid

    +
    +
    +
    • +

  • spread: the begining and end time of the slice processed

    +
    • +

  • User argument (can be anything)

    +
    • +
+
+
Output:
+
    +
  • the slab, masked
    • +
+
+
+
+
+

Once constructed the object, beside “slicer” and “criteria” has 3 functions:

+
+
“get”
+ : which returns the slices wanted, appropriately masked
+
Input:
+
slab : the slab on which to operate +sliceruserargument : anything your slicer function needs, default is None +criteriauserargument: anything your criteria function needs, default is None
+
Output:
+
out : averaged and masked slices of slab
+
+
+
“departures”
+ : which returns the departures of slab from the result of get
+
Input:
+
slab : slab from which the we want to get the departure +sliceruserargument : anything your slicer function needs, default is None +criteriauserargument: anything your criteria function needs, default is None +(ref): optional : result from get or equivalent precomputed
+
Output:
+
out : departure of slab from ref
+
+
+
“average”
+ : which return the average of the result of get
+
Input:
+
slab : the slab on which to operate +slices : the slices for each part +bounds : the length of each slice +norm : the actual length of each “season” +criteriaarg : arguments for criteria thing
+
Output:
+
out : the average of slab, masked by criteria
+
+
+
+

Example of construction: +TS=TimeSlicer(slicerfunc,criteriafunc) +myres=TS(myslab,[[slicerarg,[criteriaarg]]) +myresdeparture=TS(myslab,[[slicerarg,[criteriaarg,ref]]]

+
+
+average(slab, slices, bounds, norm, criteriaarg=None, statusbar=None, weights=False, sum=False)[source]
+

Return the average of the result of slicer

+ +++ + + + + + +
Parameters:
    +
  • slab – the slab on which to operate
    • +
  • slices – the slices for each part
    • +
  • bounds – the length of each slice
    • +
  • norm – the actual length of each “season”
    • +
  • criteriaarg – arguments for criteria thing
    • +
+
Returns:

the average of slab, masked by criteria

+
+
+ +
+
+departures(slab, slicerarg=None, criteriaarg=None, ref=None, statusbar=None, sum=False)[source]
+
+++ + + + + + +
Parameters:
    +
  • slab – slab from which the we want to get the departure
    • +
  • slicerarg – anything your slicer function needs, default is None
    • +
  • criteriaarg – anything your criteria function needs, default is None
    • +
  • ref – result from get or equivalent precomputed
    • +
  • statusbar – see statusbar() for details
    • +
+
Returns:

The departures of slab from the result of get

+
+
+ +
+
+get(slab, slicerarg=None, criteriaarg=None, statusbar=None, weights=False, sum=False)[source]
+
+++ + + + + + +
Parameters:
    +
  • slab – the slab on which to operate
    • +
  • slicerarg – anything your slicer function needs, default is None
    • +
  • criteriaarg – anything your criteria function needs, default is None
    • +
  • statusbar – see statusbar() for details
    • +
+
Returns:

averaged and masked slices of slab

+
+
+ +
+ +
+
+cdutil.times.centroid(msk, bounds, coords=None)[source]
+

Computes the centroid of a bunch of points. +Authors: Charles Doutriaux/Karl Taylor +Date: April 2001 +:param msk: A slab (cdms2 TransientVariable) +:type msk: cdms2.tvariable.TransientVariable

+ +++ + + + +
Parameters:bounds – The bounds of the overall thing.
+

:param coords : The coordinates spanned by each subset

+ +++ + + + +
Returns:A slab representing the centroid. Values are between 0 (data evenly distributed evenly across the center) +and +/-1 (data not evenly distributed). Centroid is 1D less than msk
+
+ +
+
+cdutil.times.cyclicalcentroid(s, bounds, coords=None)[source]
+

Returns the centroid, but this assumes cyclical axis.

+ +++ + + + + + + + + + +
Example:
>>> import cdms2
+>>> import vcs
+>>> vcs.download_sample_data_files()
+>>> f=cdms2.open(vcs.sampledata + '/clt.nc')
+>>> s=f('clt')
+>>> cyclecentroid=cyclicalcentroid(s,bounds)
+
+
+
Parameters:
    +
  • s (cdms2.tvariable.TransientVariable) – A slab (cdms2 TransientVariable)
    • +
  • bounds – The bounds of the overall thing
    • +
  • coords – The coordinates spanned by each subset
    • +
+
Returns:

A slab representing the cyclecentroid, which is the same shape as s but without the 1st dimension

+
Return type:

cdms2.tvariable.TransientVariable

+
+
+ +
+
+cdutil.times.dayBasedSlicer(tim, arg=None)[source]
+

slicer function for the TimeSlicer class +select days +Author : Charles Doutriaux, doutriaux1@llnl.gov +Original Date: June, 2003

+ +++ + + + +
Parameters:
    +
  • tim – time axis
    • +
  • arg (str) – string representing the desired day/days or day number(s) (jan 1st, is day 0, feb 29th is day 59.5...) +day are represented as “Jan-01” “January-01” “jan-1”, “1-january”, case does not matter +days can be represented by 2 numbers but then month is assumed to be first ! e.g “01-25” = “jan-25” +you can mix definitions
    • +
+
+
+
Output:
+
    +
  • +
+
+
+
+ +
+
+cdutil.times.generalCriteria(slab, mask, spread, arg)[source]
+
+
Default Conditions:
+
50% of the data +AND +Centroid < x (in absolute value), centroid is always between 0 (perfect) and 1, (not perfect) +by default centroid is not used
+
+

Author: Charles Doutriaux, doutriaux1@llnl.gov

+
+
Usage:
+
generalCriteria(slab,sliced,slices,arg)
+
+ +++ + + + +
Parameters:
    +
  • slab – the original slab
    • +
  • mask – the actual percentage of data in each subset used to produce the slab +the bounds of its first (time) dimension must be correct +they will be used by centroid
    • +
  • spread – the begining and end time of the slice processed
    • +
  • arg – A list of arguments +First represent the % of value present to retain a slice +Second represent the value of the centroid (between 0: perfect and 1: bad +If you do not want to use one these criteria pass None +if you would rather use a cyclicalcnetroid pass: “cyclical” as an extra argument
    • +
+
+
+ +
+
+cdutil.times.getMonthIndex(my_str)[source]
+

Given a string representing a month or a season (common abrev) +Returns the ordered indices of the month. +Author: Krishna Achutarao +Date: April 2001

+ +++ + + + + + + + +
Parameters:my_str (str) – string reperesenting month or season
Returns:The ordered indices of the month
Return type:list
+
+ +
+
+cdutil.times.getMonthString(my_list)[source]
+

Given a list of months creates the string representing the sequence

+
+ +
+
+cdutil.times.insert_monthly_seasons(data, seasons)[source]
+

Takes data assumed to be in monthly increments (1,2,3,etc...) +And tries to add seasons into it is actually missing +For this takes each time step, and see if a number of “season” could be inserted between these two

+
+ +
+
+cdutil.times.isMonthly(s)[source]
+

This function test if the data are monthly data from the time axis.

+ +++ + + + + + + + +
Parameters:s (cdms2.tvariable.TransientVariable) – A cdms2 TransientVariable
Returns:An integer flag indicating whether s has monthly data (1), or does not (0).
Return type:int
+
+ +
+
+cdutil.times.mergeTime(ds, statusbar=1, fill_value=1e+20)[source]
+

Merge chronologically a bunch of slabs +Version 1.0 +Author: Charles Doutriaux, doutriaux1@llnl.gov

+ +++ + + + + + + + + + +
Example:
>>> import cdms2
+>>> import vcs
+>>> vcs.download_sample_data_files()
+>>> f=cdms2.open(vcs.sampledata + '/clt.nc')
+>>> clt=f('clt')
+>>> u=f('u')
+>>> v=f('v')
+>>> ds=[clt,u,v]
+>>> mymerged=mergeTime(ds)
+
+
+
Parameters:
    +
  • ds (list) – A list or an array of slabs to merge. Each slab MUST be in chronological order.
    • +
  • statusbar (int) – Integer flag indicating whether to show status bar or not.
    • +
  • fill_value (float) – Float used to set the fill value of the generated slab.
    • +
+
Returns:

A slab merging all the slabs of ds. Order is the order of the first slab

+
Return type:

cdms2.tvariable.TransientVariable

+
+
+ +
+
+cdutil.times.monthBasedSlicer(tim, arg=None)[source]
+

slicer function for the TimeSlicer class +select months +Author : Charles Doutriaux, doutriaux1@llnl.gov +Original Date: April 2001 +Last Modified: October, 2001 +Input: +:param tim: time axis +:param arg: character string representing the desired month/season or integer(s)

+
+
also you can pass a list of the months you want (string or integer) +you can mix integer and strings
+
+
Output:
+
    +
  • +
+
+
+
+ +
+
+cdutil.times.setAxisTimeBoundsDaily(axis, frequency=1)[source]
+

Sets the bounds correctly for the time axis (beginning to end of day) +Usage: +tim=s.getTime() +cdutil.times.setAxisTimeBoundsMonthly(tim,frequency=1) +e.g. for twice-daily data use frequency=2

+
+
for 6 hourly data use frequency=4 +for hourly data use frequency=24
+

Origin of day is always midnight

+
+ +
+
+cdutil.times.setAxisTimeBoundsMonthly(axis, stored=0)[source]
+

Sets the bounds correctly for the time axis (beginning to end of month) +Set stored to 1 to indicate that your data are stored at the end of the month +Usage: +tim=s.getTime() +cdutil.times.setAxisTimeBoundsMonthly(tim,stored=0)

+
+ +
+
+cdutil.times.setAxisTimeBoundsYearly(axis)[source]
+

Sets the bounds correctly for the time axis (beginning to end of year) +Usage: +tim=s.getTime() +cdutil.times.setAxisTimeBoundsYearly(tim)

+
+ +
+
+cdutil.times.setSlabTimeBoundsDaily(slab, frequency=1)[source]
+

Sets the bounds correctly for the time axis (beginning to end of day) +for ‘frequency’-daily data +Usage: +cdutil.times.setSlabTimeBoundsDaily(slab,frequency=1) +e.g. for twice-daily data use frequency=2

+
+
for 6 hourly data use frequency=4 +for hourly data use frequency=24
+

Origin of day is always midnight

+
+ +
+
+cdutil.times.setSlabTimeBoundsMonthly(slab, stored=0)[source]
+

Sets the bounds correctly for the time axis for monthly data stored +without bounds. +Set stored to 1 to indicate that your data are stored at the end of the month +Usage: +cdutil.times.setSlabTimeBoundsMonthly(slab,stored=0)

+
+ +
+
+cdutil.times.setSlabTimeBoundsYearly(slab)[source]
+

Sets the bounds correctly for the time axis for yearly data +Usage: +cdutil.times.setSlabTimeBoundsYearly(slab)

+
+ +
+
+cdutil.times.setTimeBoundsDaily(obj, frequency=1)[source]
+

Sets the bounds correctly for the time axis (beginning to end of day) +for ‘frequency’-daily data +Usage: +cdutil.times.setSlabTimeBoundsDaily(slab,frequency=1) +or +cdutil.times.setSlabTimeBoundsDaily(time_axis,frequency=1) +e.g. for twice-daily data use frequency=2

+
+
for 6 hourly data use frequency=4 +for hourly data use frequency=24
+

Origin of day is always midnight

+
+ +
+
+cdutil.times.setTimeBoundsMonthly(obj, stored=0)[source]
+

Sets the bounds correctly for the time axis (beginning to end of month) +Set stored to 1 to indicate that your data are stored at the end of the month +Usage: +tim=s.getTime() +cdutil.times.setAxisTimeBoundsMonthly(s,stored=0) +or +cdutil.times.setAxisTimeBoundsMonthly(tim,stored=0)

+
+ +
+
+cdutil.times.setTimeBoundsYearly(obj)[source]
+

Sets the bounds correctly for the time axis for yearly data +Usage: +cdutil.times.setSlabTimeBoundsYearly(slab) +or +cdutil.times.setSlabTimeBoundsYearly(time_axis)

+
+ +
+
+cdutil.times.switchCalendars(t1, u1, c1, u2, c2=None)[source]
+

Converts a relative time from one calendar to another, assuming that they are in different calendars

+ +++ + + + + + +
Example:
>>> switchCalendars(t1,c1,u2,c2)
+
+
+
Parameters:
    +
  • t1 – A cdtime reltime object or a value. If it is a value, then u1 is needed.
    • +
  • c1 – cdtime calendar
    • +
  • c2 – cdtime calendar
    • +
  • u1 – units in the calendar to be converted
    • +
  • u2 – units in the final calendar
    • +
+
+
+ +
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/Modules/vertical.html b/Doc/sphinx_docs/_build/html/CDUtil/Modules/vertical.html new file mode 100644 index 0000000..a2315e1 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/Modules/vertical.html @@ -0,0 +1,269 @@ + + + + + + + + vertical — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

vertical

+
+
+cdutil.vertical.linearInterpolation(A, I, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z')[source]
+

Linear interpolation to interpolate a field from some levels to another set of levels +Values below “surface” are masked.

+ +++ + + + +
Parameters:
    +
  • A – array to interpolate
    • +
  • I – interpolation field (usually Pressure or depth) from TOP (level 0) to BOTTOM (last level) +i.e P value going up with each level.
    • +
  • levels –

    levels to interpolate to (same units as I). +Default levels:[100000, 92500, 85000, 70000, 60000, 50000, 40000,

    +
    +
    30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000]
    +
    • +
  • axis (str or int) – Axis over which to do the linear interpolation. +Can provide either an int representing axis index, or the axis name. +Default: ‘z’.
    • +
+
+
+

Note

+

I and levels must have same units

+
+ +++ + + + + + +
Returns:

array on new levels (levels)

+
Examples:
>>> A=interpolate(A,I) # interpolates A over default levels
+
+
+
+
+ +
+
+cdutil.vertical.logLinearInterpolation(A, P, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z')[source]
+

Log-linear interpolation to convert a field from sigma levels to pressure levels. +Values below surface are masked.

+ +++ + + + +
Parameters:
    +
  • A – array on sigma levels
    • +
  • P – pressure field from TOP (level 0) to BOTTOM (last level)
    • +
  • levels (list) – pressure levels to interplate to (same units as P), default levels are: +[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, +3000, 2000, 1000]
    • +
  • axis (str) – axis over which to do the linear interpolation
    • +
+
+
+

Note

+

P and levels must have same units

+
+ +++ + + + + + +
Returns:

array on pressure levels (levels)

+
Example:
>>> A=logLinearInterpolation(A,P) # interpolate A using pressure field P over the default levels
+
+
+
+
+ +
+
+cdutil.vertical.reconstructPressureFromHybrid(ps, A, B, Po)[source]
+

Reconstruct the Pressure field on sigma levels, from the surface pressure

+ +++ + + + +
Parameters:
    +
  • Ps – Surface pressure
    • +
  • A – Hybrid Conversion Coefficient, such as: p=B.ps+A.Po.
    • +
  • B – Hybrid Conversion Coefficient, such as: p=B.ps+A.Po.
    • +
  • Po – Hybrid Conversion Coefficient, such as: p=B.ps+A.Po
    • +
  • Ps – surface pressure
    • +
+
+
+

Note

+

A and B are 1d sigma levels. +Po and Ps must have same units.

+
+ +++ + + + + + +
Returns:

Pressure field, such as P=B*Ps+A*Po.

+
Example:
>>> P=reconstructPressureFromHybrid(ps,A,B,Po)
+
+
+
+
+ +
+
+cdutil.vertical.sigma2Pressure(A, P, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z')
+

Log-linear interpolation to convert a field from sigma levels to pressure levels. +Values below surface are masked.

+ +++ + + + +
Parameters:
    +
  • A – array on sigma levels
    • +
  • P – pressure field from TOP (level 0) to BOTTOM (last level)
    • +
  • levels (list) – pressure levels to interplate to (same units as P), default levels are: +[100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000, +3000, 2000, 1000]
    • +
  • axis (str) – axis over which to do the linear interpolation
    • +
+
+
+

Note

+

P and levels must have same units

+
+ +++ + + + + + +
Returns:

array on pressure levels (levels)

+
Example:
>>> A=logLinearInterpolation(A,P) # interpolate A using pressure field P over the default levels
+
+
+
+
+ +
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/CDUtil/cdutil.html b/Doc/sphinx_docs/_build/html/CDUtil/cdutil.html new file mode 100644 index 0000000..7ff5fbb --- /dev/null +++ b/Doc/sphinx_docs/_build/html/CDUtil/cdutil.html @@ -0,0 +1,115 @@ + + + + + + + + CDUtil — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

CDUtil

+

Module cdutil contains miscellaneous routines for manipulating variables.

+
+ +
+
+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + + | + Page source +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/ValidationFunctions.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/ValidationFunctions.html new file mode 100644 index 0000000..8aeb975 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/ValidationFunctions.html @@ -0,0 +1,280 @@ + + + + + + + + cdutil.ValidationFunctions — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.ValidationFunctions

+# Adapted for numpy/ma/cdms2 by convertcdms.py
+import string
+import types
+import numpy
+import numpy.ma
+import cdms2
+import os
+import cdutil
+
+
[docs]def checkStringOrNone(self,name,value):
+    """
+    Checks to see if value is a string or None
+    :param name: The name of the value
+    :type name: str
+
+    :param value: The value to check the type of
+    :type value: any
+
+    :returns: If value is None or a string, value will be returned. If not, an error will be raised.
+    """
+    if not type(value) in [types.StringType,types.NoneType]:
+        raise ValueError,name+' must be a string or None'
+    return value

+
+
+
[docs]def checkListNumbers(self,name,value):
+    """
+    Checks to make sure a list or tuple contains values that are only numbers
+    :param name: string name of the value being checked
+    :type name: str
+    :param value: A list or tuple, which will be checked to determine if the contents are all numbers.
+    :type value: list or tuple
+    :returns: If value contains only numbers, value will be returned. Else, an exception is raised.
+    """
+    if not type(value) in [types.ListType,types.TupleType,types.NoneType]:
+        raise ValueError, name + ' must be a list/tuple/None'
+    if not value is None:
+        for v in value:
+            if not type(v) in [types.IntType,types.LongType,types.FloatType]:
+                raise ValueError, name + ' list/tuple elements must be numbers'
+    return value

+    
+
[docs]def setSlab(self,name,value):
+    """
+    If value is a numpy ndarray or numpy MA, this function sets the object's data field to the value.
+    :param name: string name of the value being checked
+    :type name: str
+    :param value:
+    :returns: If value is a numpy ndarray or numpy MA, returns ('data',value).
+            If value is a string, and the string is a filename in the system's path, returns ('file',value).
+            If value is None, returns name,value.
+    """
+    if isinstance (value,numpy.ndarray ) or numpy.ma.isMA(value):
+        self.data=value
+        return ('data',value)
+    elif type(value) == types.StringType:
+        if os.path.exists(value):
+            return('file',value)
+        else:
+            raise ValueError, value+" : file does not exist...."
+    elif type(value) == types.NoneType:
+        return name,value
+    else:
+        raise ValueError, name+" must be a slab, a file name or None"

+
+def checkAxisType(self,name,value):
+    return checkInStringsListInt(self,name,value,[
+                          ['uniform','rect','linear'],
+                          'gaussian',
+                          ['equal','equal area','equalarea','equal-area'],]
+                          )
+    
+def checkAction(self,name,value):
+    return checkInStringsListInt(self,name,value,['select','mask'])
+    
+def  setDataSetGrid(self,name,value):
+    if isinstance(value,cdutil.WeightedGridMaker):
+        return value
+    else:
+        self.grid.grid=value
+    
+def setGrid(self,name,value):
+    if isinstance(value,cdms2.grid.AbstractGrid):
+        return value
+    elif value is None:
+        self.var=None
+        self.file=None
+        self.longitude.__init__()
+        self.latitude.__init__()
+        self.weightsMaker=None
+        return None
+    else:
+        raise ValueError, name+" must be a grid object or None"
+        
+def setSlabOnly(self,name,value):
+    if isinstance (value,numpy.ndarray ) or numpy.ma.isMA(value):
+        return value
+    elif type(value) == types.NoneType:
+        return value
+    else:
+        raise ValueError, name+" must be a slab or None"
+    
+def getSlab(self,name):
+    value=getattr(self,'_'+name)
+    try:
+        times=self.times
+        times_type=self.times_type
+    except:
+        times=None
+        times_type=''
+    if times_type == 'indices':
+        times=slice(times[0],times[1])
+        
+    if isinstance (value,numpy.ndarray ) or numpy.ma.isMA(value):
+        return value
+    elif type(value)==types.StringType:
+        f=cdms2.open(value)
+        if not times is None:
+            v=f(self.var,time=times)
+        else:
+            v=f(self.var)
+        f.close()
+        return v
+    else:
+        return None
+
+def checkNumberOrNone(self,name,value):
+    if not type(value) in [types.IntType,types.FloatType,types.LongType,types.NoneType]:
+        raise ValueError,name+' must be an integer, a float, or None'
+    return value
+
+def checkIntOrNone(self,name,value):
+    if not type(value) in [types.IntType,types.LongType,types.NoneType]:
+        raise ValueError,name+' must be an integer or None'
+    return value
+
+    
+
[docs]def checkInStringsList(self,name,value,values):
+    """ check if value is in values"""
+    if not type(value)==types.StringType:
+        raise ValueError, name + 'must be a string'
+    elif not string.lower(value) in values:
+        err=name+" must be in ('"+values[0]
+        for v in values[1:-1]:
+            err=err+", '"+v+"'"
+        err=err+" or '"+values[-1]+"')"
+        raise ValueError, err
+    self._basic_set(name,string.lower(value))

+
+
[docs]def checkInStringsListInt(self,name,value,values):
+    """ checks the line type"""
+    val=[]
+    str1=name + ' can either be ('
+    str2=' or ('
+    i=0
+    for v in values:
+        if not v=='': # skips the invalid/non-contiguous values
+            str2=str2+str(i)+', '
+            if type(v) in [types.ListType,types.TupleType]:
+                str1=str1+"'"+v[0]+"', "
+                for v2 in v:
+                    val.append(v2)
+            else:
+                val.append(v)
+                str1=str1+"'"+v+"', "
+            i=i+1
+    err=str1[:-2]+')'+str2[:-2]+')'
+    if type(value)==types.StringType:
+        value=string.lower(value)
+        if not value in val:
+            raise ValueError, err
+        i=0
+        for v in values:
+            if type(v) in [types.ListType,types.TupleType]:
+                if value in v:
+                    return i
+            elif value==v:
+                return i
+            i=i+1
+    elif type(value)==types.IntType or (type(value)==types.FloatType and int(value)==value):
+        if not value in range(len(values)):
+            raise ValueError, err
+        else:
+            return int(value)
+    else:
+        raise ValueError, err

+
+ 
+def checkNumber(self,name,value):
+    if not type(value) in [types.IntType,types.FloatType,types.LongType]:
+        raise ValueError,name+' must be an integer or a float'
+    return value
+
+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/create_landsea_mask.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/create_landsea_mask.html new file mode 100644 index 0000000..60ee9c5 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/create_landsea_mask.html @@ -0,0 +1,290 @@ + + + + + + + + cdutil.create_landsea_mask — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.create_landsea_mask

+import cdms2,MV2,sys,os
+import cdat_info
+
+def create_surrounds(data):
+    sh=list(data.shape)
+    L=data.getAxis(1)
+    bL=L.getBounds()
+    if L.isCircular() and bL[-1][1]-bL[0][0] % L.modulo == 0:
+        sh[0]=sh[0]-2
+    else:
+        sh[0]=sh[0]-2
+        sh[1]=sh[1]-2
+        
+    UL=MV2.ones(sh)
+    UC=MV2.ones(sh)
+    UR=MV2.ones(sh)
+    ML=MV2.ones(sh)
+    MC=MV2.ones(sh)
+    MR=MV2.ones(sh)
+    LL=MV2.ones(sh)
+    LC=MV2.ones(sh)
+    LR=MV2.ones(sh)
+
+    if L.isCircular() and bL[-1][1]-bL[0][0] % L.modulo == 0:
+        UC[:,:]=data[2:]
+    
+        LC[:,:]=data[:-2]
+        
+        ML[:,1:]=data[1:-1,:-1]
+        ML[:,0]=data[1:-1,-1]
+        
+        MR[:,:-1]=data[1:-1,1:]
+        MR[:,-1]=data[1:-1,0]
+        
+        
+        UL[:,1:]=data[2:,:-1]
+        UL[:,0]=data[2:,-1]
+        
+        UR[:,:-1]=data[2:,1:]
+        UR[:,-1]=data[2:,0]
+        
+        LL[:,1:]=data[:-2,:-1]
+        LL[:,0]=data[:-2,-1]
+        
+        LR[:,:-1]=data[:-2,1:]
+        LR[:,-1]=data[:-2,0]
+    else:
+        UC[:,:]=data[2:,1:-1]
+    
+        LC[:,:]=data[:-2,1:-1]
+        ML[:,:]=data[1:-1,:-2]
+        
+        MR[:,:]=data[1:-1,2:]
+        
+        
+        UL[:,:]=data[2:,:-2]
+        
+        UR[:,:]=data[2:,2:]
+        
+        LL[:,:]=data[:-2,:-2]
+        
+        LR[:,:]=data[:-2,2:]
+        
+    return UL,UC,UR,ML,MR,LL,LC,LR
+
+
+def map2four(data,target,regridTool='regrid2'):
+    lons=target.getLongitude()
+    lats=target.getLatitude()
+    lonso=cdms2.createAxis(lons[::2])
+    lonse=cdms2.createAxis(lons[1::2])
+    latso=cdms2.createAxis(lats[::2])
+    latse=cdms2.createAxis(lats[1::2])
+    
+    oo=cdms2.createRectGrid(latso,lonso)
+    oe=cdms2.createRectGrid(latso,lonse)
+    eo=cdms2.createRectGrid(latse,lonso)
+    ee=cdms2.createRectGrid(latse,lonse)
+    
+    doo = data.regrid(oo,regridTool=regridTool)
+    doe = data.regrid(oe,regridTool=regridTool)
+    deo = data.regrid(eo,regridTool=regridTool)
+    dee = data.regrid(ee,regridTool=regridTool)
+
+    out=MV2.zeros(data.shape,dtype='f')
+
+    out[::2,::2]=doo
+    out[::2,1::2]=doe
+    out[1::2,::2]=deo
+    out[1::2,1::2]=dee
+
+    out.id=data.id
+    out.setAxisList((lats,lons))
+
+    return out
+
+def improve(mask,navy_frac_t,threshold_1,threshold_2,UL,UC,UR,ML,MR,LL,LC,LR,regridTool='regrid2'):
+    mask_approx = map2four(mask,mask.getGrid(),regridTool=regridTool)
+    diff =  navy_frac_t - mask_approx
+    ## Land point conversion
+    c1 = MV2.greater(diff,threshold_1)
+    c2 = MV2.greater(navy_frac_t,threshold_2)
+    c= MV2.logical_and(c1,c2)
+##     x.plot(c.astype("i"))
+##     raw_input()
+##     x.clear()
+    ## Now figures out local maxima
+    cUL,cUC,cUR,cML,cMR,cLL,cLC,cLR = create_surrounds(c)
+    L=c.getAxis(1)
+    bL=L.getBounds()
+    if L.isCircular() and bL[-1][1]-bL[0][0] % L.modulo == 0:
+        c=c[1:-1] # elimnitates north and south poles
+        tmp = navy_frac_t[1:-1]
+    else:
+        c=c[1:-1,1:-1] # elimnitates north and south poles
+        tmp = navy_frac_t[1:-1,1:-1]
+    m = MV2.logical_and(c,MV2.greater(tmp,MV2.where(cUL,UL,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cUC,UC,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cUR,UR,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cML,ML,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cMR,MR,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cLL,LL,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cLC,LC,0.)))
+    m = MV2.logical_and(m,MV2.greater(tmp,MV2.where(cLR,LR,0.)))
+    # Ok now update the mask by setting these points to land
+    mask2 = mask*1.
+    if L.isCircular() and bL[-1][1]-bL[0][0] % L.modulo == 0:
+        mask2[1:-1] = MV2.where(m,1,mask[1:-1])
+    else:
+        mask2[1:-1,1:-1] = MV2.where(m,1,mask[1:-1,1:-1])
+
+    ## ocean point conversion
+    c1 = MV2.less(diff,-threshold_1)
+    c2 = MV2.less(navy_frac_t,1.-threshold_2)
+    c= MV2.logical_and(c1,c2)
+    cUL,cUC,cUR,cML,cMR,cLL,cLC,cLR = create_surrounds(c)
+    L=c.getAxis(1)
+    bL=L.getBounds()
+    if L.isCircular() and bL[-1][1]-bL[0][0] % L.modulo == 0:
+        c=c[1:-1] # elimnitates north and south poles
+        tmp = navy_frac_t[1:-1]
+    else:
+        c=c[1:-1,1:-1] # elimnitates north and south poles
+        tmp = navy_frac_t[1:-1,1:-1]
+    ## Now figures out local maxima
+    m = MV2.logical_and(c,MV2.less(tmp,MV2.where(cUL,UL,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cUC,UC,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cUR,UR,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cML,ML,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cMR,MR,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cLL,LL,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cLC,LC,1.)))
+    m = MV2.logical_and(m,MV2.less(tmp,MV2.where(cLR,LR,1.)))
+    # Ok now update the mask by setting these points to ocean
+    if L.isCircular() and bL[-1][1]-bL[0][0] % L.modulo == 0:
+        mask2[1:-1] = MV2.where(m,0,mask2[1:-1])
+    else:
+        mask2[1:-1,1:-1] = MV2.where(m,0,mask2[1:-1,1:-1])
+    mask2.setAxisList(mask.getAxisList())
+    return mask2
+
+
[docs]def generateLandSeaMask(target,source=None,threshold_1 = .2, threshold_2 = .3,regridTool='regrid2'):
+    """ Generates a best guess mask on any rectilinear grid, using the method described in PCMDI's report #58
+    see: http://www-pcmdi.llnl.gov/publications/ab58.html
+    Input:
+       target: either a MV2 object with a grid, or a cdms2 grid (rectilinear grid only)
+       source: A fractional (0 to 1.) land sea mask, where 1 means all land
+       threshold_1 (optional): criteria 1 for detecting cells with possible increment see report for detail
+                               difference threshold
+       threshold_2 (optional): criteria 2 for detecting cells with possible increment see report for detail
+                               water/land content threshold
+       regridTool: which cdms2 regridder tool to use, default is regrid2
+    Output:
+       landsea maks on target grid
+    """
+    cdat_info.pingPCMDIdb("cdat","cdutil.generateLandSeaMask")
+    if cdms2.isVariable(target):
+        target = target.getGrid()
+        if target is None:
+            raise Exception,"Error target data passed do not have  a grid"
+    if not isinstance(target,cdms2.grid.TransientRectGrid):
+        raise Exception, "Error: target grid must be rectilinear"
+
+    if source is None:
+        source = cdms2.open(os.path.join(cdat_info.get_prefix(),'share','cdutil','navy_land.nc'))('sftlf')
+        
+    try:
+        navy_frac_t = source.regrid(target,regridTool='regrid2')
+    except Exception,err:
+        raise "error, cannot regrid source data to target, got error message: %s" % err
+    
+    mask = MV2.greater(navy_frac_t,.5).astype('i') # First guess, anything greater than 50% is land
+    UL,UC,UR,ML,MR,LL,LC,LR = create_surrounds(navy_frac_t)
+    cont = True
+    i=0
+    while cont:
+        mask2 = improve(mask,navy_frac_t,threshold_1,threshold_2,UL,UC,UR,ML,MR,LL,LC,LR,regridTool=regridTool)
+        if MV2.allequal(mask2,mask) or i>25: # shouldn't be more than 10 at max, 25 is way safe
+            cont=False
+        mask=mask2
+        i+=1
+    mask.id='sftlf'
+    return mask

+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/netcdfwriter.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/netcdfwriter.html new file mode 100644 index 0000000..6ca0473 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/netcdfwriter.html @@ -0,0 +1,124 @@ + + + + + + + + cdutil.netcdfwriter — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.netcdfwriter

+# Adapted for numpy/ma/cdms2 by convertcdms.py
+"""writenetcdf
+   see also dataset write method
+"""
+import cdms2
+
+
[docs]def writenetcdf (slab, filename, mode="a"):
+    """
+    writenetcdf(slab, filename, mode="a") writes slab to the file.
+    :param mode: One of 'a' append, or 'w'  replace
+    :type mode: str
+
+    :param slab: Anything :py:func:`cdms2.asVariable` will accept
+    :type: see :py:func:`cdms2.asVariable`
+    """
+    if mode == 'r': mode = 'w'
+    slab = cdms2.asVariable(slab, 0)
+    f = cdms2.openDataset(filename, mode)
+    f.write(slab)
+    f.close()

+
+if __name__ == '__main__':
+    from numpy.ma import allclose
+    import pcmdi
+    g = cdms2.openDataset('clt.nc','r')
+    c = g.variables['clt']
+    t = cdms2.asVariable([1.,2.,3.])
+    t.id = 't'
+    writenetcdf(c, 'test.nc', 'w')
+    writenetcdf(t, 'test.nc', 'a')
+    f = cdms2.open('test.nc')
+    d = f.variables['clt']
+    assert allclose(c,d)
+    for name in ['clt', 't']:
+        pcmdi.slabinfo(f.variables[name])
+
+
+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/region.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/region.html new file mode 100644 index 0000000..1ce106c --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/region.html @@ -0,0 +1,324 @@ + + + + + + + + cdutil.region — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.region

+# Adapted for numpy/ma/cdms2 by convertcdms.py
+from cdms2.selectors import SelectorComponent
+import cdat_info
+
[docs]class DomainComponent(SelectorComponent):
+    '''gets a domain, and by default adjusts the bounds to the domain
+    or if exact is set to 0 or None gets all the domain that has
+    parts of the domain requested, also post processing allows you to apply a mask
+    dimension names can be passed as keywords,
+    but if no name is passed arguments are taken in order and applied to the corresponding axis
+    Overwritting an axis (2 keywords or keyword + argument) is not allowed
+    Example of use:
+    NH=cdms.selectors.Selector(domain(latitude=(0.,90.)))
+    '''
+    
+    def __init__(self,*args,**kargs):
+        ''' initialise some value such as tolerances for equality'''
+        self.args=args
+        self.kargs=kargs
+        self.atol=kargs.get('atol',1.E-8)
+        self.rtol=kargs.get('rtol',1.E-5)
+        self.exact=kargs.get('exact',1)
+        if not (self.exact is None or type(self.exact)==type(0)):
+            raise 'Error keyword: ''exact'' value: '+str(exact)+' not legal'
+
+    def __str__(self):
+        s='Exact Region Selector\n'
+        if len(self.args)>0:
+            s+='Arguments: ('
+            for a in len(self.args):
+                s+=str(a)+', '
+            s+=')\n'
+        if self.kargs!={}:
+            s+='Keywords:\n'
+            for k in self.kargs.keys():
+                s+='\t'+str(k)+':'+str(self.kargs[k])+'\n'
+        return s
+    
+
[docs]    def specify(self,slab,axes,specification,confined_by,aux):
+        ''' First part: confine the slab within a Domain wide enough to do the exact in post'''
+        import string,copy
+        from numpy.ma import minimum,maximum
+        # myconfined is for later, we can't confine a dimension twice with an argument plus a keyword or 2 keywords
+        myconfined=[None]*len(axes)
+        self.aux=copy.copy(specification)
+        # First look at the arguments (i.e not keywords) and confine the dimensions
+        # in the order of the arguments
+        for i in range(len(self.args)):
+            if confined_by[i] is None :  # Check it hasn't been confined by somebody else
+                myconfined[i]=1  # dim confined by argument list
+                confined_by[i]=self # for cdms I want to confine this dimension
+                self.aux[i]=specs=list(self.args[i]) # How do we want to confine this dim ?
+                if type(specs)==type(slice(0)):
+                    specification[i]=specs  # If it's a slicing nothing to do
+                else: # But if it's not...
+                    if specs[0] is None:
+                        tmp=axes[i].getBounds()
+                        if tmp is None:
+                            raise ValueError, 'Region error, axis:'+axes[i].id+' has no bounds'
+                        specs[0]=minimum(minimum(tmp[0],tmp[-1]))
+                    if specs[1] is None:
+                        tmp=axes[i].getBounds()
+                        if tmp is None:
+                            raise ValueError, 'Region error, axis:'+axes[i].id+' has no bounds'
+                        specs[1]=maximum(maximum(tmp[0],tmp[-1]))
+                    if axes[i].isTime(): # Time is as always "Special"
+                        import cdtime
+                        tc=type(cdtime.comptime(0))  # component time type
+                        tr=type(cdtime.reltime(0,'months since 0'))  # relative time type
+                        t=type(specs[0]) # my first spec type
+                        if t==type(''): #if my first spec is passed as a string
+                            specs[0]=cdtime.s2r(specs[0],axes[i].units)
+                        elif t==tc or t==tr: #if my first spec is passed as a cdtime object
+                            specs[0]=cdtime.torel(specs[0],axes[i].units)
+                        else: # If not it has to be that the users knows the time values in the axis
+                            pass
+                        t=type(specs[1]) # my second spec type
+                        if t==type(''): #if my second spec is passed as a string
+                            specs[1]=cdtime.s2r(specs[1],axes[i].units)
+                        elif t==tc or t==tr: #if my second spec is passed as a cdtime object
+                            specs[1]=cdtime.torel(specs[1],axes[i].units)
+                    sp=[specs[0],specs[1],'oob']  # Now retrieve the values wide enough for the exact                    specification[i]=sp  # sets the specifications
+            else:
+                return 1
+        for kw in self.kargs.keys():
+            axis=None
+            for i in range(len(axes)):
+                if axes[i].id==kw : axis=i
+            if axis is None:
+                if kw=='time' :
+                    for i in range(len(axes)):
+                        if axes[i].isTime() : axis=i
+                elif kw=='level' :
+                    for i in range(len(axes)):
+                        if axes[i].isLevel() : axis=i
+                elif kw=='longitude' :
+                    for i in range(len(axes)):
+                        if axes[i].isLongitude() : axis=i
+                elif kw=='latitude' :
+                    for i in range(len(axes)):
+                        if axes[i].isLatitude() : axis=i
+                elif not kw in ['exact','atol','rtol']: # keyword not a recognised keyword or dimension name
+                    raise 'Error, keyword: '+kw+' not recognized'
+            # At this point, if axis is None:
+            # we are dealing with a keyword for the selector
+            # so we'll skip it
+            if not axis is None : 
+                if confined_by[axis] is None:
+                    confined_by[axis]=self
+                    myconfined[axis]=1
+                    self.aux[axis]=specs=list(self.kargs[kw])
+                    if type(specs)!=type(slice(0)):
+                        if specs[0] is None:
+                            tmp=axes[axis].getBounds()
+                            if tmp is None:
+                                raise ValueError, 'Region error, axis:'+axes[axis].id+' has no bounds'
+                            specs[0]=minimum(minimum(tmp[0],tmp[-1]))
+                        if specs[1] is None:
+                            tmp=axes[axis].getBounds()
+                            if tmp is None:
+                                raise ValueError, 'Region error, axis:'+axes[axis].id+' has no bounds'
+                            specs[1]=maximum(maximum(tmp[0],tmp[-1]))
+                        if axes[axis].isTime():
+                            import cdtime
+                            tc=type(cdtime.comptime(0))
+                            tr=type(cdtime.reltime(0,'months since 0'))
+                            t=type(specs[0])
+                            if t==type(''):
+                                specs[0]=cdtime.s2r(specs[0],axes[i].units)
+                            elif t==tc or t==tr:
+                                specs[0]=cdtime.torel(specs[0],axes[i].units)
+                            t=type(specs[1])
+                            if t==type(''):
+                                specs[1]=cdtime.s2r(specs[1],axes[i].units)
+                            elif t==tc or t==tr:
+                                specs[1]=cdtime.torel(specs[1],axes[i].units)
+                        sp=[specs[0],specs[1],'oob']
+                        specification[axis]=sp
+                    else:
+                        specification[axis]=specs
+
+                else:
+                    if myconfined[axis]==1:
+                        raise 'Error you are attempting to set the axis: '+str(axes[axis].id)+' more than once'
+                    else:
+                        return 1
+        return 0

+    
+
[docs]    def same(self,data,value):
+        ''' Check if data is basically the same than value'''
+        return abs(data-value)<self.atol+self.rtol*abs(value)

+    
+
[docs]    def post(self,fetched,slab,axes,specifications,confined_by,aux,axismap):
+        ''' Post processing retouches the bounds and later will deal with the mask'''
+        import cdms2 as cdms
+        fetched=cdms.createVariable(fetched,copy=1)
+        faxes=fetched.getAxisList()
+        if self.exact:
+            for i in range(len(faxes)):
+                if confined_by[i] is self and type(self.aux[i])!=type(slice(0)):
+                    # ok we touched that axis, and didn't just sliced it let's adjust the bounds
+                    ax=faxes[axismap[i]].clone()  # retrieve the axis and clones it
+                    bounds=ax.getBounds()
+                    if bounds is None:
+                        raise ValueError, 'Region error, axis:'+ax.id+' has no bounds'
+                    ax0=ax[0]
+                    ax1=ax[-1]
+                    '''sets xb with the bounds
+                    smaller value of axis first
+                    switches ax0 and ax1 if necessary'''
+                    if ax[0]<ax[-1]:
+                        xb=[bounds[0],bounds[-1]] # Extreme bounds 
+                    else:
+                        xb=[bounds[-1],bounds[0]] # Extreme bounds
+                        tmp=ax0*1.  # *1. is just to make sure I'm copying
+                        ax0=ax1*1.
+                        ax1=tmp
+                    specs=self.aux[i]  # the specifications
+                    fbound=specs[0]  # specs for the first bound
+                    lbound=specs[1]  # specs for the last bound
+                    if fbound>lbound : # if the first bound is smaller then flip it
+                        tmp=fbound*1.
+                        fbound=lbound*1.
+                        lbound=tmp
+                    b0=xb[0] # bounds of lower   value of the axis
+                    b1=xb[1] # bounds of greater value of the axis
+                    ''' The folowing reset the values of the axis
+                    sets it to the middle of the new cell
+                    also reset the bounds accordingly'''
+                    if not(b0[0]>fbound and b0[0]<lbound):
+                        if not self.same(b0[0],fbound):  # make sure they are actually different not just very close
+                            b0[0]=fbound
+                            ax0=(b0[1]+b0[0])/2.
+                    if not(b0[1]>fbound and b0[1]<lbound):
+                        if not self.same(b0[1],fbound):
+                            b0[1]=fbound
+                            ax0=(b0[1]+b0[0])/2.
+                    if not(b1[0]>fbound and b1[0]<lbound):
+                        if not self.same(b1[0],lbound):
+                            b1[0]=lbound
+                            ax1=(b1[1]+b1[0])/2.
+                    if not(b1[1]>fbound and b1[1]<lbound):
+                        if not self.same(b1[1],lbound):
+                            b1[1]=lbound
+                            ax1=(b1[1]+b1[0])/2.
+                    xb[0]=b0
+                    xb[1]=b1
+                    if ax[-1]>ax[0]:
+                        bounds[0],bounds[-1]=xb # Extreme bounds
+                        ax[-1]=ax1
+                        ax[0]=ax0
+                    else:
+                        bounds[-1],bounds[0]=xb # Extreme bounds
+                        ax[-1]=ax0
+                        ax[0]=ax1
+                    ax.setBounds(bounds)
+                    if faxes[axismap[i]].isLatitude():
+                        ax.designateLatitude()
+                    faxes[axismap[i]]=ax
+
+        a=cdms.createVariable(fetched.filled(),mask=fetched.mask,axes=faxes)
+        return a                        

+                        
+
[docs]def domain(*args, **kargs):
+    '''construct the selector'''
+    import cdms2 as cdms
+    cdat_info.pingPCMDIdb("cdat","cdutil.region.domain")
+    a=cdms.selectors.Selector(DomainComponent(*args,**kargs))
+    return a

+
+NH=NorthernHemisphere=domain(latitude=(0.,None))
+SH=SouthernHemisphere=domain(latitude=(None,0.))
+Tropics=domain(latitude=(-23.4,23.4))
+NPZ=AZ=ArcticZone=domain(latitude=(66.6,None))
+SPZ=AAZ=AntarcticZone=domain(latitude=(None,-66.6))
+
+
+
+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/sftbyrgn.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/sftbyrgn.html new file mode 100644 index 0000000..aae587a --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/sftbyrgn.html @@ -0,0 +1,280 @@ + + + + + + + + cdutil.sftbyrgn — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.sftbyrgn

+# Adapted for numpy/ma/cdms2 by convertcdms.py
+"""
+This module contains functions to map an array of "regions" onto a mask
+"""
+
+import regrid2,cdutil,MV2,genutil,cdms2,os
+import cdat_info
+
+
+def sumregions(potential_reg,potential):
+    out = potential_reg[0]*1.
+    wts = potential[0]*1.
+    for i in range(1,potential.shape[0]):
+        c   = MV2.greater(potential[i]-wts,0)
+        out = MV2.where(c,potential_reg[i],out)
+        wts = MV2.where(c,potential[i],wts)
+    return out
+
+
+def loop(potential,potential_reg,c2,w3,region):
+    nmax        = potential.shape[0]
+    c3          = MV2.not_equal(w3,0.)
+    c           = MV2.logical_and(c2,c3)
+    thisturn    = MV2.ones(c.shape)
+    for i in range(nmax):
+        c1                  = MV2.logical_or(MV2.equal(potential_reg[i],region),MV2.equal(potential[i],-999))
+        c2                  = MV2.logical_and(c,c1)
+        c2                  = MV2.logical_and(c2,thisturn)
+        potential_reg[i]    = MV2.where(c2,region,potential_reg[i])
+        thisturn            = MV2.where(c2,0,thisturn)
+        c1                  = MV2.logical_and(c2,MV2.equal(potential[i],-999))
+        c2                  = MV2.logical_and(c2,MV2.not_equal(potential[i],-999))
+        potential[i]        = MV2.where(c1,w3,potential[i])
+        potential[i]        = MV2.where(c2,potential[i]+w3,potential[i])
+    ## Ultimate test to see if more would be needed !
+    if not MV2.allequal(MV2.logical_and(c,thisturn),0):
+        raise 'OOOPS WE COULD USE MORE REGIONS BUDDY !'
+    return
+
+
+
[docs]def generateSurfaceTypeByRegionMask(mask,sftbyrgn=None,sftbyrgnmask=215,regions=range(201,223),maximum_regions_per_cell=4,extend_up_to=3,verbose=True):
+    """
+    Maps a "regions" dataset onto a user provided land/sea mask or grid
+    
+    Usage:
+    -----
+    mapped,found = generateSurfaceTypeByRegionMask(mask,sftbyrgn=None,sftbyrgnmask=None,regions=None,maximum_regions_per_cell=4,extend_up_to=3,verbose=True)
+
+    Input:
+    -----
+    mask                        User provided land/sea mask (100/0) or grid (the land/sea mask will be generated automagically) which will be mapped using the "sftbyrgn" internal dataset (will generate a land/sea mask for you)
+    sftbyrgn                    Mask you wish to map onto your grid (if None uses internal "sftbyrgn" dataset (old ezget type))
+    sftbyrgnmask                Land/sea mask for sftbyrgn (or a number specifying value limits for sftbyrgn which indicates land/sea threshold (greater values are land) - see URL below for integer region map)
+    regions                     Numbers from sftbyrgn array that you want to map onto mask (integers from 201-222)
+    maximum_regions_per_cell    Maximum number of regions considered for a single cell
+    extend_up_to                How many grid cells around a cell can we extend to identify a guess
+    verbose                     Prints to the screen what's going on (default is True)
+
+    Output:
+    -----
+    mapped                      Mapped input grid/mask using provided (or default) regions - sftbyrgn -> user provided grid/mask
+    found                       Matrix containing number of regions matched for each output cell
+    
+    Notes:
+    -----
+    - More detailed information, including a region map and tabulated region numbers are available from http://www-pcmdi.llnl.gov/publications/pdf/34.pdf
+    """
+    
+    cdat_info.pingPCMDIdb("cdat","cdutil.generateSurfaceTypeByRegionMask")
+    ## OK first determine which regions are available
+    ## Must be integer values
+    if isinstance(mask,cdms2.grid.TransientRectGrid):
+        mask = cdutil.generateLandSeaMask(mask)*100.
+
+    if sftbyrgn is None:
+        sftbyrgn = cdms2.open(os.path.join(cdat_info.get_prefix(),'share','cdutil','sftbyrgn.nc'))('sftbyrgn')
+        
+    if regions is None:
+        if verbose: print 'Preparing regions'
+        #regions = range(201,223)
+
+        regions = []
+        for i in range(0,10000):
+            genutil.statusbar(i,9999)
+            c = float(MV2.sum(MV2.ravel(MV2.equal(sftbyrgn,i)),0))
+            if c != 0: regions.append(i)
+
+    if verbose: print 'Regions:',regions
+    ## If no mask passed fr sftbyrgn, assumes everything greater 5000 is land)
+    if isinstance(sftbyrgnmask,int):
+        split           = sftbyrgnmask
+        n               = MV2.maximum(mask)
+        sftbyrgnmask    = MV2.greater_equal(sftbyrgn,sftbyrgnmask)*n
+    else:
+        split           = MV2.maximum(sftbyrgnmask)/2.
+    ## Now guess the type for each regions
+    keys = {}
+    ## ## Nice way to do it
+    ##     for r in regions:
+    ##         c=MV2.not_equal(sftbyrgn,r)
+    ##         c=MV2.masked_where(c,sftbyrgnmask)
+    ##         n=MV2.count(c)
+    ##         c=float(MV2.sum(MV2.ravel(c),0)/n)
+    ##         print r,c,n
+    ##         keys[r]=c
+    ## Fast but not so "general" way to do it
+    for r in regions:
+        if r< split:
+            keys[r] = 0.
+        else:
+            keys[r] = 100.
+    sh              = list(mask.shape)
+    sh.insert(0,maximum_regions_per_cell)
+    potential       = MV2.ones(sh,dtype='d')*-999
+    potential_reg   = MV2.ones(sh,dtype='d')*-999
+
+    g1  = sftbyrgn.getGrid()
+    g2  = mask.getGrid()
+    r1  = regrid2.Horizontal(g1,g2)
+    w   = cdutil.area_weights(sftbyrgn)
+
+    if verbose: print 'First pass'
+    itmp = 0.
+    for ireg in keys.keys():
+        genutil.statusbar(itmp,len(keys.keys())-1)
+        itmp += 1.
+        c       = MV2.equal(sftbyrgn,ireg)
+        w2      = 1.-c*w
+        s2,w3   = r1(sftbyrgn,mask=w2.filled(),returnTuple=1)
+        c2      = MV2.equal(mask,keys[ireg])
+        loop(potential,potential_reg,c2,w3,ireg)
+
+    found = MV2.zeros(sh[1:],typecode='f')
+    for i in range(maximum_regions_per_cell):
+        found = found+MV2.not_equal(potential[i],-999)
+    sh2 = list(sh)
+    for k in range(extend_up_to):
+        sh2[1] = sh[1]+2*(k+1)
+        sh2[2] = sh[2]+2*(k+1)
+        ## Form the possible i/j couples !
+        s = MV2.sum(MV2.ravel(MV2.equal(potential[0],-999)),0)
+        if verbose: print 'Expanding up to',k+1,'cells while trying to fix',s,'cells'
+            #if dump:
+                #f=cdms2.open('tmp_'+str(k)+'.nc','w')
+                #f.write(sumregions(potential_reg,potential).astype('f'),id='sftbyrgn',axes=mask.getAxisList())
+                #f.close()
+                #g=sumregions(potential_reg,potential).astype('d')
+                #g=MV2.masked_equal(g,-999)
+                #g=MV2.greater(g,4999)*100.
+                #g=MV2.absolute(mask-g)
+                #g=MV2.masked_equal(g,0.)
+                #print 'Number of differences:',MV2.count(g)
+
+        if float(s) != 0:
+            c0 = MV2.equal(potential[0],-999)
+            couples = []
+            sft2 = MV2.zeros(sh2[1:],dtype='d')-888.
+            sft2[k+1:-k-1,k+1:-k-1] = mask
+            for i in range(-k-1,k+2):
+                for j in range(-k-1,k+2):
+                    if abs(i)>k or abs(j)>k: couples.append([i,j])
+            ntot = len(keys.keys())*len(couples)-1
+            itmp = 0
+            for ireg in keys.keys():
+                c = MV2.equal(sftbyrgn,ireg)
+                w2 = 1.-c*w
+                s2,w3 = r1(sftbyrgn,mask=w2.filled(),returnTuple=1)
+                w4 = MV2.zeros(sh2[1:],typecode='d')
+                w4[k+1:-k-1,k+1:-k-1] = w3
+                for i,j in couples:
+                    if verbose: genutil.statusbar(itmp,ntot)
+                    itmp += 1.
+                    c2 = MV2.equal(sft2[j+k+1:j+k+1+sh[1],i+k+1:i+k+1+sh[2]],keys[ireg])
+                    c3 = MV2.equal(sft2[j+k+1:j+k+1+sh[1],i+k+1:i+k+1+sh[2]],mask)
+                    c2 = MV2.logical_and(c2,c3)
+                    c2 = MV2.logical_and(c2,c0)
+                    loop(potential,potential_reg,c2,w4[j+k+1:j+k+1+sh[1],i+k+1:i+k+1+sh[2]],ireg)
+           
+        found = MV2.where(MV2.equal(potential[0],-999),found-1,found)
+
+    out = sumregions(potential_reg,potential)
+    out.setAxisList(mask.getAxisList())
+    out.id = 'sftbyrgn'
+    out = out.astype('i')
+    out.missing_value = -999
+    found.setAxisList(mask.getAxisList())
+    found.id = 'found'
+    found = found.astype('i')
+    found.missing_value = -999
+
+    del(out.name)
+    del(found.name)
+    return out,found

+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/times.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/times.html new file mode 100644 index 0000000..a5943f4 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/times.html @@ -0,0 +1,1603 @@ + + + + + + + + cdutil.times — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.times

+# Adapted for numpy/ma/cdms2 by convertcdms.py
+import numpy
+import MV2
+import cdms2,cdtime,string,types,numpy.ma,sys
+import cdat_info
+
+
[docs]def centroid(msk,bounds,coords=None):
+    """
+    Computes the centroid of a bunch of points.
+    Authors: Charles Doutriaux/Karl Taylor
+    Date: April 2001
+    :param msk: A slab (cdms2 TransientVariable)
+    :type msk: cdms2.tvariable.TransientVariable
+
+    :param bounds: The bounds of the overall thing.
+    :param coords : The coordinates spanned by each subset
+
+    :returns: A slab representing the centroid.  Values are between 0 (data evenly distributed evenly across the center)
+                and +/-1 (data not evenly distributed). Centroid is 1D less than msk
+    """
+    # determine the length,spread, shape and mean
+    sh=msk.shape
+    mean=float(bounds[1]+bounds[0])/2.
+    if coords is None:
+        coords=msk.getAxis(0).getBounds() # if MV2 then gets the bounds from there
+    n=len(coords)
+    mask=numpy.ma.getmask(msk)
+    if mask is None:
+        msk=numpy.zeros(msk.shape,numpy.float)
+    else:
+        msk=mask.astype(numpy.float)
+    sw=0.
+    for i in range(n):
+        w=float(coords[i][1]-coords[i][0]) # width
+        if isinstance(msk,numpy.ndarray):
+            sw=sw+w*(1.-msk[i])
+        else:
+            sw=sw+w*(1.-msk)
+        c=float(coords[i][0]+coords[i][1])/2.-mean # location
+        w=w*c/float(bounds[1]-bounds[0]) # factor to multiply by plus normalization
+        if isinstance(msk,numpy.ndarray):
+            msk[i]=(1.-msk[i])*w
+        else:
+            msk = (1.-msk)*w
+    msk=numpy.ma.sum(msk, axis=0) # sums it
+    sw=sw/2.
+    msk=msk/sw
+    return msk

+
+
[docs]def cyclicalcentroid(s,bounds,coords=None):
+    """
+    Returns the centroid, but this assumes cyclical axis.
+
+    :Example:
+
+        .. doctest:: times_cyclicalcentroid
+
+            >>> import cdms2
+            >>> import vcs
+            >>> vcs.download_sample_data_files()
+            >>> f=cdms2.open(vcs.sampledata + '/clt.nc')
+            >>> s=f('clt')
+            >>> cyclecentroid=cyclicalcentroid(s,bounds)
+
+    :param s: A slab (cdms2 TransientVariable)
+    :type s: cdms2.tvariable.TransientVariable
+    :param bounds: The bounds of the overall thing
+    :param coords: The coordinates spanned by each subset
+
+    :returns: A slab representing the cyclecentroid, which is the same shape as s but without the 1st dimension
+    :rtype: cdms2.tvariable.TransientVariable
+    """
+    if coords is None:
+        coords=s.getAxis(0).getBounds() # if MV2 then gets the bounds from there
+    n=len(coords)
+    length=float(bounds[1]-bounds[0])
+    nax=numpy.zeros((n,2),numpy.float)
+    for i in range(n):
+        nax[i][0]=coords[i][0]/length*2.*numpy.pi
+        nax[i][1]=coords[i][1]/length*2.*numpy.pi
+    # Places the point evenly around the axis
+    # Compute the centroid on x and y
+    xc=centroid(s,[0,2.*numpy.pi],numpy.cos(nax))
+    yc=centroid(s,[0,2.*numpy.pi],numpy.sin(nax))
+    # compute the new centroid
+    return numpy.sqrt(xc*xc+yc*yc)/numpy.sqrt(2.)

+
+
[docs]def getMonthString(my_list):
+    """Given a list of months creates the string representing the sequence"""
+    if not type(my_list) in [types.ListType,types.TupleType]:
+        my_list=[my_list]
+    dic = {
+        1:'JANUARY',2:'FEBRUARY',3:'MARCH',
+        4:'APRIL',5:'MAY',6:'JUNE',
+        7:'JULY',8:'AUGUST',9:'SEPTEMBER',
+        10:'OCTOBER',11:'NOVEMBER',12:'DECEMBER'}
+    out=[]
+    for i in my_list:
+        out.append(dic[i][0])
+    if len(out)==1: out=[dic[my_list[0]]]
+    return string.join(out,'')

+    
+
[docs]def getMonthIndex(my_str):
+   """
+   Given a string representing a month or a season (common abrev)
+   Returns the ordered indices of the month.
+   Author: Krishna Achutarao
+   Date: April 2001
+
+   :param my_str: string reperesenting month or season
+   :type my_str: str
+
+   :returns: The ordered indices of the month
+   :rtype: list
+   """
+   my_str = string.upper(my_str)
+   mon_list = ['JANUARY', 'FEBRUARY', 'MARCH', 'APRIL', 'MAY', 'JUNE', 'JULY',
+               'AUGUST', 'SEPTEMBER', 'OCTOBER', 'NOVEMBER', 'DECEMBER']
+   if my_str in mon_list:
+       return [mon_list.index(my_str)+1]
+   # end of if string.upper(my_str) in yr_arr:
+   #
+
+   # Determine if my_str is an abbreviated month, if my_str has
+   # at least 3 characters.
+   # * If my_str has one character, the same result will be found by using
+   #   the 'yrs' string below (ambiguous result because we choose the
+   #   first matching char...)
+   # * If my_str has 2 characters, we assume that we are looking for 2
+   #   consecutive months that will be found with 'yrs'
+   #   i.e. 'JA' -> July AND August  (NOT January!)
+   if len(my_str) >= 3:
+       for mon in mon_list:
+           if string.find(mon,  my_str) != -1:
+               return [mon_list.index(mon)+1]
+           # end of if string.find(mon,  my_str) != -1:
+       # end of for mon in mon_list:
+           
+   yr = 'JFMAMJJASOND'
+   yrs = yr+yr
+   #
+   result = string.find(yrs, my_str)
+   if result == -1: return []
+   month =  result + 1
+   lis = range(month, month+len(my_str))
+   for i in range(len(lis)):
+       if lis[i] > 12: lis[i] -= 12
+   return lis

+
+
+
[docs]def isMonthly(s):
+    """
+    This function test if the data are monthly data from the time axis.
+
+    :param s: A cdms2 TransientVariable
+    :type s: cdms2.tvariable.TransientVariable
+
+    :returns: An integer flag indicating whether s has monthly data (1), or does not (0).
+    :rtype: int
+    """
+    tim=s.getTime()
+    units=tim.units
+    monthly=1
+    for i in range(len(tim)-1):
+      month1=cdtime.reltime(tim[i],units).torel('months since 2000').value
+      month2=cdtime.reltime(tim[i+1],units).torel('months since 2000').value
+      if month2-month1!=1 : monthly=0
+    return monthly

+
+
+
[docs]def mergeTime(ds,statusbar=1,fill_value=1.e20):
+    """
+    Merge chronologically a bunch of slabs
+    Version 1.0
+    Author: Charles Doutriaux, doutriaux1@llnl.gov
+
+    :Example:
+
+        .. doctest:: times_mergeTime
+
+            >>> import cdms2
+            >>> import vcs
+            >>> vcs.download_sample_data_files()
+            >>> f=cdms2.open(vcs.sampledata + '/clt.nc')
+            >>> clt=f('clt')
+            >>> u=f('u')
+            >>> v=f('v')
+            >>> ds=[clt,u,v]
+            >>> mymerged=mergeTime(ds)
+
+    :param ds: A list or an array of slabs to merge. Each slab MUST be in chronological order.
+    :type ds: list
+    :param statusbar: Integer flag indicating whether to show status bar or not.
+    :type statusbar: int
+    :param fill_value: Float used to set the fill value of the generated slab.
+    :type fill_value: float
+
+    :returns: A slab merging all the slabs of ds. Order is the order of the first slab
+    :rtype: cdms2.tvariable.TransientVariable
+    """
+    allNone = True
+    for s in ds:
+        if s is not None:
+            allNone = False
+            break
+    if allNone:
+        return None
+    # first determine the number of slabs
+    nslab=len(ds)
+    order0=None
+    initialgrid = ds[0].getGrid()
+    times=[[]]*nslab
+    vals=[]
+    ax=ds[0].getAxisList()
+    # Now makes sure time is first
+    timesleft=[]
+    for i in range(nslab):
+        order=ds[i].getOrder(ids=1)
+        if order0 is None : order0=order
+        if order[0]!='t' :
+            ds[i]=ds[i](order='t...')
+            ax=ds[i].getAxisList()
+        times[i]=ds[i].getTime()
+        units=times[i].units
+        cal=times[i].getCalendar()
+        tmpdic={}
+        for ii in range(len(times[i])):  # creates the dictionary of times not matched yet
+            t=times[i][ii]
+            tmpval=cdtime.reltime(times[i][ii],units).torel('seconds since 2000',cal)
+            tmpdic[ii]=tmpval
+            vals.append(tmpval.value)
+        timesleft.append(tmpdic)
+    vals.sort()
+    nt=len(vals)
+    # sys.exit()
+    # Quick error check (no duplicate)
+    if len(numpy.unique(vals))!=nt:
+      for i in range(nt-1):
+        if vals[i]==vals[i+1] :
+            errtime=cdtime.reltime(vals[i],'seconds since 2000').tocomp()
+            err='Error in merging process : duplicate time point\n'
+            err=err+str(errtime)+' is duplicated, cannot merge'+str(vals[i-2:i+3])
+            raise Exception,err
+
+    # Now create the big array that will be the merged
+    sh=list(ds[0].shape)
+    sh[0]=nt
+    out=numpy.ma.zeros(tuple(sh),MV2.float)
+    # bounds array
+    bnds=numpy.zeros((nt,2),MV2.float)
+    fvals=numpy.zeros((nt),MV2.float)
+    if not statusbar is None:
+        import genutil
+        prev=0
+    for v in range(nt):
+        if not statusbar is None and nt!=1:
+            if not type(statusbar) in [type([]),type(())]:
+                statusbar=float(v)/(nt-1.)
+            elif v==0:
+                statusbar.insert(0,float(v)/(nt-1.))
+            else:
+                statusbar[0]=float(v)/(nt-1.)
+                
+            prev=genutil.statusbar(statusbar,prev=prev,title='Merging')
+        try:  # In order to speeed up, raise an execption to exit the inner loops
+            for i in range(nslab):
+                tim=times[i]
+                for it in numpy.sort(timesleft[i].keys()):
+                    t=tim[it]
+                    val=timesleft[i][it]
+                    if val.value==vals[v]:
+                        out[v]=ds[i][it]
+                        fvals[v]=val.torel(times[0].units,times[0].getCalendar()).value
+                        bnds[v]=tim.getBounds()[it]
+                        bnds[v][0]=switchCalendars(bnds[v][0],tim.units,tim.getCalendar(),times[0].units,times[0].getCalendar()).value
+                        bnds[v][1]=switchCalendars(bnds[v][1],tim.units,tim.getCalendar(),times[0].units,times[0].getCalendar()).value
+                        del(timesleft[i][it])
+                        raise Exception  # to exit the it and i loops
+                    elif val.value>vals[v]:
+                        break
+        except:
+            pass
+    if not statusbar is None and nt!=1:
+        if type(prev[0])!=type(0) : prev[0].destroy()
+
+    t=cdms2.createAxis(fvals,bounds=bnds)
+    t.designateTime()
+    t.id='time'
+    t.units=times[0].units
+    t.setCalendar(times[0].getCalendar())
+    ax[0]=t
+    out=cdms2.createVariable(out,id=ds[0].id,copy=0,fill_value=fill_value)
+    out.setAxisList(ax)
+    out.set_fill_value(fill_value)
+    if initialgrid is not None:
+        out.setGrid(initialgrid)
+    if out.getOrder(ids=1)!=order0:
+        return out(order=order0)
+    else:
+        return out

+
+
+
[docs]def switchCalendars(t1,u1,c1,u2,c2=None):
+    """
+    Converts a relative time from one calendar to another, assuming that they are in different calendars
+
+    :Example:
+
+        .. doctest:: times_switchCalendars
+
+            >>> switchCalendars(t1,c1,u2,c2)
+
+    :param t1: A cdtime reltime object or a value. If it is a value, then u1 is needed.
+    :param c1: cdtime calendar
+    :param c2: cdtime calendar
+    :param u1: units in the calendar to be converted
+    :param u2: units in the final calendar
+    """
+    if not (type(t1)==types.IntType or type(t1)==types.FloatType):
+      c2=u2
+      u2=c1
+      c1=u1
+      u1=t1.units
+      t1=t1.value
+    # makes t1 a cdtime object
+    t1=cdtime.reltime(t1,u1)
+    # Converts t1 to comptime
+    t1=t1.tocomp(c1)
+    return t1.torel(u2,c2)

+
+
+
+
[docs]class TimeSlicer:
+    """
+    Author : Charles Doutriaux: doutriaux1@llnl.gov
+    Date: April 2001
+
+    Returns masked average of specific time slices
+    "slicer" determine which slices of the Transient Variable (TV) are processed
+    "criteria" gets TV (with time dimension) and returns a "timeless" mask, used to mask the averaged slices
+    
+    "slicer"
+      Input:
+            - Time Axis
+            - User argument (can be anything) (in a list if more than one argument)
+      Output:
+          indices             : the indices for each season:
+                                                     [[i1,i2,...,il],
+                                                     [j1,j2,...,jm],
+                                                     ...,
+                                                     [k1,k2,...kn]]
+          bounds              : the bounds covered by each slice for each season:
+                                                     [[[i1b1,i1b2],[i2b1,i2b2],...,[ilb1,ilb2]],
+                                                     [[[j1b1,j1b2],[j2b1,j2b2],...,[jmb1,jmb2]],
+                                                     ...,
+                                                     [[k1b1,k1b2],[k2b1,k2b2],...,[knb1,knb2]]]
+          norm                : the actual length of each "season", and its start
+                                                     [[Li,Si],
+                                                     [Lj,Sj],
+                                                     ...,
+                                                     [Lk,Sk]]
+    "criteria"
+      Input:
+            - slab : a slab
+            - mask:  the actual percentage of data in each subset used to produce the slab
+                     the bounds of its first (time) dimension must be correct
+                     they will be used by centroid
+            - spread: the begining and end time of the slice processed 
+            - User argument (can be anything)
+      Output:
+            - the slab, masked
+            
+    Once constructed the object, beside "slicer" and "criteria" has 3 functions:
+    
+    "get" : which returns the slices wanted, appropriately masked
+       Input:
+          slab : the slab on which to operate
+          sliceruserargument  : anything your slicer function needs, default is None
+          criteriauserargument: anything your criteria function needs, default is None
+       Output:
+          out  : averaged and masked slices of slab
+          
+    "departures" : which returns the departures of slab from the result of get
+       Input:
+          slab                : slab from which the we want to get the departure
+          sliceruserargument  : anything your slicer function needs, default is None
+          criteriauserargument: anything your criteria function needs, default is None
+          (ref): optional     : result from get or equivalent precomputed
+          
+       Output:
+          out : departure of slab from ref
+          
+    "average" : which return the average of the result of get
+       Input:
+          slab                : the slab on which to operate
+          slices              : the slices for each part
+          bounds              : the length of each slice
+          norm                : the actual length of each "season"
+          criteriaarg         : arguments for criteria thing
+       Output:
+          out : the average of slab, masked by criteria
+
+    Example of construction:
+    TS=TimeSlicer(slicerfunc,criteriafunc)
+    myres=TS(myslab,[[slicerarg,[criteriaarg]])
+    myresdeparture=TS(myslab,[[slicerarg,[criteriaarg,ref]]]
+    """
+    def __init__(self,slicerfunction=None,criteriafunction=None):
+        self.slicer=slicerfunction
+        self.criteria=criteriafunction
+        self.__call__=self.get
+        self.prev=0
+        self.title=''
+        
+
[docs]    def get(self,slab,slicerarg=None,criteriaarg=None,statusbar=None,weights=False,sum=False):
+        """
+        :param slab: the slab on which to operate
+        :param slicerarg: anything your slicer function needs, default is None
+        :param criteriaarg: anything your criteria function needs, default is None
+        :param statusbar: see :py:func:`statusbar` for details
+
+        :returns: averaged and masked slices of slab
+        """
+        
+        
+        # Makes sure time is first
+        initialorder=slab.getOrder(ids=1)
+        initialgrid = slab.getGrid()
+        if initialorder[0]!='t' : slab=slab(order='t...')
+
+        # retrieve the time axis
+        tim=slab.getTime()
+        # Let slicer figure out wich slices we want
+        slices,bounds,norm=self.slicer(tim,slicerarg)
+##         print 'Slices:',slices,len(slices)
+##         print 'Bounds:',bounds
+##         print 'Norm:',norm
+##         print 'Slices:',slices[-3:]
+##         print 'Bounds:',bounds[-3:]
+##         print 'Norm:',norm[-3:]
+        
+        # Check we have something
+        if slices==[] :
+            return None
+##             raise Exception,'Error Slicer return nothing for: '+str(slicerarg)
+        # How many slices ?
+        out=self.average(slab,slices,bounds,norm,criteriaarg,statusbar,weights=weights,sum=sum)
+        if weights:
+            out,w = out
+        # Put the dimensions
+        out=cdms2.createVariable(out,id=slab.id,copy=0)
+        for i in range(1,len(slab.shape)):
+            out.setAxis(i,slab.getAxis(i))
+        # Time axis
+        n=len(slices)
+        vals=numpy.zeros((n),MV2.float)  # time values
+        bnds=numpy.zeros((n,2),MV2.float) # time bounds
+        # Retrieve the bounds
+        sh=out.shape
+        for i in range(sh[0]):
+            b0=norm[i][1]
+            b1=norm[i][0]+b0
+            bnds[i]=b0,b1
+            v=cdtime.reltime(b0,tim.units).value
+            v=v+cdtime.reltime(b1,tim.units).value
+            v=v/2.
+            vals[i]=v
+        t=cdms2.createAxis(vals,bounds=bnds)
+        t.designateTime()
+        t.id=tim.id
+        t.units=tim.units
+        t.setCalendar(tim.getCalendar())
+        out.setAxis(0,t)
+        if weights:
+##             print out.shape,w.shape
+            w=MV2.array(w,id='weights')
+            w.setAxisList(out.getAxisList())
+        if out.getOrder(ids=1)!=initialorder:
+            out = out(order=initialorder)
+            if weights:
+                w = w(order=initialorder)
+        if initialgrid is not None:
+            out.setGrid(initialgrid)
+            if weights:
+                w.setGrid(initialgrid)
+                
+        if weights:
+            return out,w
+        else:
+            return out

+            
+
+
[docs]    def departures(self,slab,slicerarg=None,criteriaarg=None,ref=None,statusbar=None,sum=False):
+        """
+        :param slab: slab from which the we want to get the departure
+        :param slicerarg: anything your slicer function needs, default is None
+        :param criteriaarg: anything your criteria function needs, default is None
+        :param ref: result from get or equivalent precomputed
+        :param statusbar: see :py:func:`statusbar` for details
+
+        :returns: The departures of slab from the result of get
+        """
+        sliced=TimeSlicer.get(self,slab,slicerarg,criteriaarg,statusbar=statusbar,sum=sum)
+
+        if sliced is None:
+            return None
+        order=sliced.getOrder(ids=1)
+        initialgrid=sliced.getGrid()
+        
+        if order[0]!='t' : sliced=sliced(order='t...')
+        order2=sliced.getOrder(ids=1)
+        if ref is None:
+            if sum is False:
+                ref=numpy.ma.average(sliced,0)
+            else:
+                ref = numpy.ma.sum(sliced,0)
+        elif len(order2[1:])>0:
+            ref=ref(order=order2[1:])
+        if cdms2.isVariable(ref):
+            out=cdms2.asVariable(sliced(raw=1)-ref(raw=1))
+        else:
+            out=cdms2.asVariable(sliced(raw=1)-ref)
+        # put the axes back
+        out.id=slab.id
+        for i in range(len(sliced.shape)):
+            out.setAxis(i,sliced.getAxis(i))
+
+        if initialgrid is not None:
+            out.setGrid(initialgrid)
+
+        if out.getOrder(ids=1)!=order:
+            return out(order=order)
+        else:
+            return out

+
+
[docs]    def average(self,slab,slices,bounds,norm,criteriaarg=None,statusbar=None,weights=False,sum=False):
+        """
+        Return the average of the result of slicer
+
+        :param slab: the slab on which to operate
+        :param slices: the slices for each part
+        :param bounds: the length of each slice
+        :param norm: the actual length of each "season"
+        :param criteriaarg: arguments for criteria thing
+
+        :returns: the average of slab, masked by criteria
+          """
+        n=len(slices)
+        sh=list(slab.shape)
+        sh[0]=n
+        out  = numpy.ma.zeros(sh,dtype=numpy.float)
+        wout = numpy.ma.ones(sh,dtype=numpy.float)
+        for i in range(n):
+            self.statusbar1(i,n,statusbar)
+            sub=slices[i]
+            sh[0]=len(sub)
+            msk=numpy.ma.ones(sh,dtype=numpy.float)
+            subb=bounds[i]
+            nrm=norm[i][0]
+##             print sub,subb,nrm,'are subb, nrm',len(sub),sum
+##             if len(sub)==1:
+##                 out[i]=slab[sub[0]]
+##                 w=float(subb[0][1]-subb[0][0])/nrm
+##                 msk=msk*w
+##             else:
+            for j in range(len(sub)):
+                w=float(subb[j][1]-subb[j][0])/nrm
+##                 print j,w
+                m=numpy.ma.getmask(slab[sub[j]])
+                if m is not None:
+                    msk[j]=msk[j]*(1.-m.astype(MV2.float))*w
+                else:
+                    msk[j]=msk[j]*w
+            if len(sub)>1:
+                out[i]=numpy.ma.sum(msk*slab[sub[0]:sub[-1]+1].asma(),axis=0)
+                wout[i]=numpy.ma.sum(msk,axis=0)
+                if sum is False : out[i]=out[i]/wout[i]
+##                 print 'case long:',wout[i,0,0]
+            else:
+##                 print 'case 1:',out.shape,msk.shape,slab[sub[0]].asma().shape
+                out[i] = MV2.array(slab[sub[0]]).asma()
+##                 if sum is False:
+##                     out[i] = out[i]/msk
+
+            if criteriaarg is not None:
+                msk=cdms2.asVariable(msk)
+                ax=msk.getAxis(0)
+                b=numpy.array(bounds[i])
+                ax.setBounds(b)
+                msk.setAxis(0,ax)
+                out[i]=self.criteria(out[i],msk,[norm[i][1],norm[i][1]+norm[i][0],],criteriaarg)
+        self.statusbar2(statusbar)
+        if weights:
+            return out,wout
+        else:
+            return out

+    
+    def statusbar1(self,i,n,statusbar):
+        if not statusbar is None and n!=1:
+            import genutil
+            if not type(statusbar) in [type([]),type(())]:
+                if type(statusbar)!=type(''):
+                    status=float(i)/(n-1.)
+                else:
+                    status=float(i+eval(statusbar)[0]*n)/(eval(statusbar)[1]*n)
+            else:
+                status=statusbar[1:]
+                tot=eval(statusbar[0])
+                if type(tot)==type(''):
+                    status.insert(0,float(i+eval(statusbar)[0]*n)/(eval(statusbar)[1]*n))
+                else:
+                    status.insert(0,float(i)/(n-1.))
+            self.prev=genutil.statusbar(status,prev=self.prev,title=self.title)
+
+    def statusbar2(self,statusbar):
+        if not statusbar is None:
+            if not type(statusbar) in [type([]),type(())]:
+                if type(statusbar)!=type(''):
+                    if type(self.prev) in [type([]),type(())] :
+                        if type(self.prev[0])!=type(0):self.prev[0].destroy()
+                    self.prev=0
+                elif eval(statusbar)[0]==eval(statusbar)[1]-1:
+                    if type(self.prev) in [type([]),type(())] :
+                        if type(self.prev[0])!=type(0):self.prev[0].destroy()
+                    self.prev=0
+            else:
+                status=statusbar[1:]
+                tot=eval(statusbar[0])
+                if type(tot)==type(''):
+                    if eval(statusbar)[0]==eval(statusbar)[1]-1:
+                        if type(self.prev) in [type([]),type(())]  :
+                            if type(self.prev[0])!=type(0):self.prev[0].destroy()
+                        self.prev=0                        
+                else:
+                    if type(self.prev) in [type([]),type(())]  :
+                        if type(self.prev[0])!=type(0):self.prev[0].destroy()
+                    self.prev=0
+            if type(statusbar) in [type([]),type(())]: statusbar.pop(0)

+
+
+
[docs]def monthBasedSlicer(tim,arg=None):
+    """
+    slicer function for the TimeSlicer class
+    select months
+    Author : Charles Doutriaux, doutriaux1@llnl.gov
+    Original Date: April 2001
+    Last Modified: October, 2001
+    Input:
+    :param tim: time axis
+    :param arg: character string representing the desired month/season or integer(s)
+             also you can pass a list of the months you want (string or integer)
+             you can mix integer and strings
+    Output:
+      - 
+    """
+    # First convert the input
+    if not type(arg) in [types.ListType , types.TupleType]:
+        arg=[arg]
+    # Now convert the strings and add to the valid months
+    months=[]
+    for i in range(len(arg)):
+        if type(arg[i])==types.StringType:
+            vals=getMonthIndex(arg[i])
+            for j in vals: months.append(j)
+        else:
+            months.append(arg[i])
+    slices=[]
+    bounds=[]
+    seaslength=[]
+    sub=[]
+    subb=[]
+    subs=[]
+    bnds=tim.getBounds()
+    cal=tim.getCalendar()
+    units=tim.units
+    nt=len(tim)
+    for i in range(nt):
+        b0=cdtime.reltime(bnds[i][0],units)
+        b1=cdtime.reltime(bnds[i][1],units)
+        iout=0
+        # Now figures out what the length of
+        # the requested season
+        b=b0.tocomp(cal)
+        yr=b.year
+        if months[-1]==12:
+            bb=cdtime.comptime(b.year+1)
+        else:
+            bb=cdtime.comptime(b.year,months[-1]+1)
+##         if b.cmp(bb)>0:
+##             yr=yr+1
+        # do we span 2 years ?
+        if months[0]>months[-1] : # yes
+            ## Are we in the part before the year's end
+            if b.month<months[0]: ## no
+                t0=cdtime.comptime(yr-1,months[0])
+                t1=cdtime.comptime(yr,months[-1]+1)
+            else: ## yes
+##                 print 'in here ?',b
+                t0=cdtime.comptime(yr,months[0])
+                t1=cdtime.comptime(yr+1,months[-1]+1)              
+        else:
+            t0=cdtime.comptime(yr,months[0])
+            if months[-1]!=12:
+                t1=cdtime.comptime(yr,months[-1]+1)
+            else:
+                t1=cdtime.comptime(yr+1)
+        if t0.cmp(b1.tocomp(cal))>0:
+            t1=t1.add(-1,cdtime.Year)
+            t0=t0.add(-1,cdtime.Year)
+        if t1.cmp(b0.tocomp(cal))<0:
+            t1=t1.add(1,cdtime.Year)
+            t0=t0.add(1,cdtime.Year)
+        t1=t1.torel(units,cal)
+##         if i<5:print 't1 after:',t1.tocomp(cal)
+        t0=t0.torel(units,cal)
+        lenseas=float(t1.value-t0.value)
+        # Now checks if we overlap the season
+##         if i<5: print '---',i,b0.tocomp(cal),b1.tocomp(cal),t0.tocomp(cal),t1.tocomp(cal)
+##         if i<5: print '---',i,t0.cmp(b0),b1.cmp(t1),t1.cmp(b0)
+        if t0.cmp(b0)>-1:        # cell starts after season started
+            if b1.cmp(t1)>=0 :    # and ends before the season ends
+                sub.append(i)
+                subb.append([t0.value,t1.value])
+                subs.append([lenseas,t0.value])
+            elif t0.cmp(b1)>-1:        # all before the season
+                iout=1
+            else:                      # ends during the season
+                sub.append(i)
+                subb.append([t0.value,b1.value])
+                subs.append([lenseas,t0.value])
+            # Now check if if this is exactly one season long !
+            if (b1.value-b0.value==lenseas) and t0.cmp(b0)==0:
+                iout=1
+
+        elif t1.cmp(b0)==1:      # end season after beginning of cell ?
+##             print 'index,t1>b0 time',i,tim[i],t1.tocomp(),b0.tocomp(),b
+            if b1.cmp(t1)>0:             # and ends after the end
+                sub.append(i)
+                subb.append([b0.value,t1.value])
+                subs.append([lenseas,t0.value])
+##                 print 'haha',len(months),t0.value
+##                 if len(months)==12 or lenseas==(b1.value-b1.value):
+                if len(months)==12:
+##                     print "i:",i,tim[i]
+##                     print "sub :",sub
+##                     print "subb:",subb
+##                     print "subs:",subs
+                    slices.append(sub)
+                    bounds.append(subb)
+                    seaslength.append([lenseas,t0.value])
+                    sub=[i]
+                    subb=[[t1.value,b1.value]]
+                    subs=[[lenseas,t1.value]]
+            else:                       # but ends during
+                sub.append(i)
+                subb.append([b0.value,b1.value])
+                subs.append([lenseas,t0.value])
+                if len(months)==12 and b1.cmp(t1)==0:
+                    slices.append(sub)
+                    bounds.append(subb)
+                    seaslength.append([lenseas,t0.value])
+                    sub=[]
+                    subb=[]
+                    subs=[]
+        else:
+            iout=1
+##         if i<5: print "ok we got iuot: ",iout,sub
+        if iout:
+            if sub!=[]:
+                slices.append(sub)
+                bounds.append(subb)
+                seaslength.append(subs[-1])
+                sub=[]
+                subb=[]
+                subs=[]
+        ## ??? Add something here for 12 omnths span....
+        ## like remenbering which season we're at, etc....
+    if sub!=[]:
+        slices.append(sub)
+        bounds.append(subb)
+##         print 'using:',subs
+        seaslength.append(subs[-1])
+    # Now looks for the cyclical thing
+    # ??? do something here as well......
+    return slices,bounds,seaslength

+
+
+
[docs]def dayBasedSlicer(tim,arg=None):
+    """
+    slicer function for the TimeSlicer class
+    select days
+    Author : Charles Doutriaux, doutriaux1@llnl.gov
+    Original Date: June, 2003
+
+    :param tim: time axis
+    :param arg: string representing the desired day/days or day number(s) (jan 1st, is day 0, feb 29th is day 59.5...)
+             day are represented as "Jan-01" "January-01" "jan-1", "1-january", case does not matter
+             days can be represented by 2 numbers but then month is assumed to be first ! e.g "01-25" = "jan-25"
+             you can mix definitions
+    :type arg: str
+    Output:
+      - 
+    """
+    # First convert the input
+    if not type(arg) in [types.ListType , types.TupleType]:
+        arg=[arg]
+    # Now convert the strings and add to the valid month/day tupples
+    tupples=[]
+    for i in range(len(arg)):
+        subarg=arg[i]
+        if type(subarg)!=types.StringType:
+            raise Exception,"Error, arguments to dayBasedSlicer must be strings"
+        sp=string.split(subarg,"-")
+        if sp[0]==subarg:
+            sp=string.split(subarg,'/')
+            if sp[0]==subarg:
+                try:
+                    index=string.atof(subarg)
+                    if index==59.5:
+                        subarg='feb-29'
+                    else:
+                        t=cdtime.reltime(index,'month since 1997')
+                        t=t.tocomp()
+                        subarg=str(t.month)+'-'+str(t.day)
+                except:
+                    raise Exception,"Error, dayBasedSlicer args must have '-' or '/' as month/day separator"
+        try:
+            day=string.atoi(sp[1])
+            try:
+                month=getMonthIndex(sp[0])
+            except:
+                month=string.atoi(sp[0])
+        except:
+            try:
+                day=string.atoi(sp[0])
+                try:
+                    month=getMonthIndex(sp[1])
+                except:
+                    month=string.atoi(sp[1])
+            except:
+                raise Exception,"Error dayBasedSlicer couldn't understand argument: "+subarg
+        tupples.append([day,month])
+    slices=[]
+    bounds=[]
+    seaslength=[]
+    sub=[]
+    subb=[]
+    subs=[]
+    bnds=tim.getBounds()
+    cal=tim.getCalendar()
+    units=tim.units
+    nt=len(tim)
+    for i in range(nt):
+        b0=cdtime.reltime(bnds[i][0],units)
+        b1=cdtime.reltime(bnds[i][1],units)
+        iout=0
+        # Now figures out what the length of
+        # the requested season
+        b=b0.tocomp(cal)
+        yr=b.year
+        if months[-1]==12:
+            bb=cdtime.comptime(b.year+1)
+        else:
+            bb=cdtime.comptime(b.year,months[-1]+1)
+        if b.cmp(bb)>0:
+            yr=yr+1
+        # do we span 2 years ?
+        if months[0]>months[-1] : # yes
+            t0=cdtime.comptime(yr-1,months[0])
+            if months[-1]!=12:
+                t1=cdtime.comptime(yr,months[-1]+1)
+            else:
+                t1=cdtime.comptime(yr+1)                
+        else:
+            t0=cdtime.comptime(yr,months[0])
+            if months[-1]!=12:
+                t1=cdtime.comptime(yr,months[-1]+1)
+            else:
+                t1=cdtime.comptime(yr+1)
+        t1=t1.torel(units,cal)
+        t0=t0.torel(units,cal)
+        lenseas=float(t1.value-t0.value)
+##         print 't0,b0,t1,b1',t0,b0,t1,b1
+        # Now checks if we overlap the season
+        if t0.cmp(b0)>-1:        # cell starts before season
+            if b1.cmp(t1)>0 :            # and ends after the season
+                sub.append(i)
+                subb.append([t0.value,t1.value])
+                subs.append([lenseas,t0.value])
+            elif t0.cmp(b1)>-1:        # all before the season
+                iout=1
+            else:                      # ends during the season
+                sub.append(i)
+                subb.append([t0.value,b1.value])
+                subs.append([lenseas,t0.value])
+            # Now check if if this is exactly one season long !
+            if (b1.value-b0.value==lenseas) and t0.cmp(b0)==0:
+                iout=1
+
+        elif t1.cmp(b0)==1:      # end season after beginning of cell ?
+##             print 'index,time',i,tim[i]
+            if b1.cmp(t1)>0:             # and ends after the end
+                sub.append(i)
+                subb.append([b0.value,t1.value])
+                subs.append([lenseas,t0.value])
+##                 print 'haha',len(months),t0.value
+##                 if len(months)==12 or lenseas==(b1.value-b1.value):
+                if len(months)==12:
+##                     print "i:",i,tim[i]
+##                     print "sub :",sub
+##                     print "subb:",subb
+##                     print "subs:",subs
+                    slices.append(sub)
+                    bounds.append(subb)
+                    seaslength.append([lenseas,t0.value])
+                    sub=[i]
+                    subb=[[t1.value,b1.value]]
+                    subs=[[lenseas,t1.value]]
+            else:                       # but ends during
+                sub.append(i)
+                subb.append([b0.value,b1.value])
+                subs.append([lenseas,t0.value])
+                if len(months)==12 and b1.cmp(t1)==0:
+                    slices.append(sub)
+                    bounds.append(subb)
+                    seaslength.append([lenseas,t0.value])
+                    sub=[]
+                    subb=[]
+                    subs=[]
+        else:
+            iout=1
+        if iout:
+            if sub!=[]:
+                slices.append(sub)
+                bounds.append(subb)
+                seaslength.append(subs[-1])
+                sub=[]
+                subb=[]
+                subs=[]
+        ## ??? Add something here for 12 omnths span....
+        ## like remenbering which season we're at, etc....
+    if sub!=[]:
+        slices.append(sub)
+        bounds.append(subb)
+##         print 'using:',subs
+        seaslength.append(subs[-1])
+    # Now looks for the cyclical thing
+    # ??? do something here as well......
+    return slices,bounds,seaslength

+
+def weekday(a,calendar=None):
+    if calendar is None:
+        b=a.torel('days since 0')
+    else:
+        b=a.torel('days since 0',calendar)        
+    d=(b.value - 3) % 7
+    if d==1:
+        return 'monday'
+    elif d==2:
+        return 'tuesday'
+    elif d==3:
+        return 'wednesday'
+    elif d==4:
+        return 'thursday'
+    elif d==5:
+        return 'friday'
+    elif d==6:
+        return 'saturday'
+    else:
+        return 'sunday'
+
+
+
+
[docs]def generalCriteria(slab,mask,spread,arg):
+    """
+    Default Conditions:
+        50% of the data
+        AND
+        Centroid < x (in absolute value), centroid is always between 0 (perfect) and 1, (not perfect)
+        by default centroid is not used
+
+    Author: Charles Doutriaux, doutriaux1@llnl.gov
+
+    Usage:
+        generalCriteria(slab,sliced,slices,arg)
+    :param slab: the original slab
+    :param mask: the actual percentage of data in each subset used to produce the slab
+            the bounds of its first (time) dimension must be correct
+            they will be used by centroid
+    :param spread: the begining and end time of the slice processed
+    :param arg: A list of arguments
+            First represent the % of value present to retain a slice
+            Second represent the value of the centroid (between 0: perfect and 1: bad
+            If you do not want to use one these criteria pass None
+            if you would rather use a cyclicalcnetroid pass: "cyclical" as an extra argument
+    """
+    # Reads the arguments
+    slab=MV2.asVariable(slab)
+    sh=slab.shape
+##     print slab,mask,spread,arg
+    if not arg is None:
+        min=arg[0]
+        centro=arg[1]
+    # prepare the mask
+##     print 'Mask shape',mask.shape
+    if not min is None:
+        fmask=MV2.sum(mask, axis=0).filled()
+        fmask=numpy.less(fmask,min)
+##         print 'fmask,slab',fmask.shape,slab.shape
+##         import sys,vcs
+##         x=vcs.init()
+##         x.plot(mask)
+##         sys.stdin.readline()
+##         x.clear()
+##         x.plot(fmask)
+        slab=numpy.ma.masked_where(fmask,slab)
+    if not centro is None:
+        a=numpy.ma.equal(mask,0.)
+        a=MV2.masked_where(a,a)
+        a.setAxis(0,mask.getAxis(0))
+        mask=a
+        if 'cyclical' in arg:
+            c=cyclicalcentroid(mask,spread)
+        else:
+            c=centroid(mask,spread)
+            c=numpy.ma.absolute(c)
+        slab=numpy.ma.masked_where(numpy.ma.greater_equal(c,centro),slab)
+    return slab

+
+
+
[docs]def setAxisTimeBoundsDaily(axis,frequency=1):
+    """
+    Sets the bounds correctly for the time axis (beginning to end of day)
+    Usage:
+    tim=s.getTime()
+    cdutil.times.setAxisTimeBoundsMonthly(tim,frequency=1)
+    e.g. for twice-daily data use frequency=2
+         for 6 hourly data use frequency=4
+         for   hourly data use frequency=24
+    Origin of day is always midnight
+    """
+    tim=axis
+    if not tim.isTime():
+        raise ValueError,'Time Axis only please !'
+    if tim is None:
+        return
+    units=tim.units
+    timc=tim.asComponentTime()
+    n=len(tim)
+    bnds=numpy.zeros((n,2),numpy.float)
+    frequency=int(frequency)
+    for i in range(n):
+        t=timc[i]
+        d=t.day
+        m=t.month
+        y=t.year
+        h=t.hour
+        for f in range(frequency):
+            if f*(24/frequency)<=h<(f+1)*(24/frequency):
+                t1=cdtime.comptime(y,m,d,f*(24/frequency))
+                t2=t1.add(24/frequency,cdtime.Hours,tim.getCalendar())
+                t1=t1.torel(units,tim.getCalendar())
+                t2=t2.torel(units,tim.getCalendar())
+        bnds[i,0]=t1.value
+        bnds[i,1]=t2.value
+    tim.setBounds(bnds)
+    return

+
+
+
[docs]def setSlabTimeBoundsDaily(slab,frequency=1):
+    """
+    Sets the bounds correctly for the time axis (beginning to end of day)
+    for 'frequency'-daily data
+    Usage:
+    cdutil.times.setSlabTimeBoundsDaily(slab,frequency=1)
+    e.g. for twice-daily data use frequency=2
+         for 6 hourly data use frequency=4
+         for   hourly data use frequency=24
+    Origin of day is always midnight
+    """
+    tim=slab.getTime()
+    setAxisTimeBoundsDaily(tim,frequency=frequency)
+    return

+
+
+
[docs]def setTimeBoundsDaily(obj,frequency=1):
+    """
+    Sets the bounds correctly for the time axis (beginning to end of day)
+    for 'frequency'-daily data
+    Usage:
+    cdutil.times.setSlabTimeBoundsDaily(slab,frequency=1)
+    or
+    cdutil.times.setSlabTimeBoundsDaily(time_axis,frequency=1)
+    e.g. for twice-daily data use frequency=2
+         for 6 hourly data use frequency=4
+         for   hourly data use frequency=24
+    Origin of day is always midnight
+    """
+    if isinstance(obj,cdms2.AbstractAxis):
+        setAxisTimeBoundsDaily(obj,frequency=frequency)
+    elif isinstance(obj,cdms2.MV2.AbstractVariable):
+        setSlabTimeBoundsDaily(obj,frequency=frequency)
+    return

+
+
+
[docs]def setAxisTimeBoundsMonthly(axis,stored=0):
+    """
+    Sets the bounds correctly for the time axis (beginning to end of month)
+    Set stored to 1 to indicate that your data are stored at the end of the month
+    Usage:
+    tim=s.getTime()
+    cdutil.times.setAxisTimeBoundsMonthly(tim,stored=0)
+    """
+    tim=axis
+    if not tim.isTime():
+        raise ValueError,'Time Axis only please !'
+    if tim is None:
+        return
+    units=tim.units
+    timc=tim.asComponentTime()
+    n=len(tim)
+    bnds=numpy.zeros((n,2),numpy.float)
+    for i in range(n):
+        t=timc[i]
+        d=t.day
+        m=t.month
+        y=t.year
+        if stored == 1 and d<2: #data stored at the end of the month
+            if m==1 : y=y-1
+            m=m-1
+            if m==0 : m=12
+        t1=cdtime.comptime(y,m)
+        t2=t1.add(1,cdtime.Month,tim.getCalendar())
+        t1=t1.torel(units,tim.getCalendar())
+        t2=t2.torel(units,tim.getCalendar())
+        bnds[i,0]=t1.value
+        bnds[i,1]=t2.value
+    tim.setBounds(bnds)
+    return

+
+
+
[docs]def setSlabTimeBoundsMonthly(slab,stored=0):
+    """ Sets the bounds correctly for the time axis for monthly data stored
+    without bounds.
+    Set stored to 1 to indicate that your data are stored at the end of the month
+    Usage:
+    cdutil.times.setSlabTimeBoundsMonthly(slab,stored=0)
+    """
+    tim=slab.getTime()
+    setAxisTimeBoundsMonthly(tim,stored=stored)
+    return

+
+
+
[docs]def setTimeBoundsMonthly(obj,stored=0):
+    """ Sets the bounds correctly for the time axis (beginning to end of month)
+    Set stored to 1 to indicate that your data are stored at the end of the month
+    Usage:
+    tim=s.getTime()
+    cdutil.times.setAxisTimeBoundsMonthly(s,stored=0)
+    or
+    cdutil.times.setAxisTimeBoundsMonthly(tim,stored=0)
+    """
+    if isinstance(obj,cdms2.AbstractAxis):
+        setAxisTimeBoundsMonthly(obj,stored=stored)
+    elif isinstance(obj,cdms2.MV2.AbstractVariable):
+        setSlabTimeBoundsMonthly(obj,stored=stored)
+    return

+
+
+
[docs]def setAxisTimeBoundsYearly(axis):
+    """ Sets the bounds correctly for the time axis (beginning to end of year)
+    Usage:
+    tim=s.getTime()
+    cdutil.times.setAxisTimeBoundsYearly(tim)
+    """
+    tim=axis
+    if tim is None:
+        return
+    units=tim.units
+    timc=tim.asComponentTime()
+    n=len(tim)
+    bnds=numpy.zeros((n,2),numpy.float)
+    for i in range(n):
+        t=timc[i]
+        y=t.year
+        t1=cdtime.comptime(y)
+        t2=t1.add(1,cdtime.Year,tim.getCalendar())
+        t1=t1.torel(units,tim.getCalendar())
+        t2=t2.torel(units,tim.getCalendar())
+        bnds[i,0]=t1.value
+        bnds[i,1]=t2.value
+    tim.setBounds(bnds)
+    return

+
+
+
[docs]def setSlabTimeBoundsYearly(slab):
+    """ Sets the bounds correctly for the time axis for yearly data
+    Usage:
+    cdutil.times.setSlabTimeBoundsYearly(slab)
+"""
+    tim=slab.getTime()
+    setAxisTimeBoundsYearly(tim)
+    return

+
+
+
[docs]def setTimeBoundsYearly(obj):
+    """ Sets the bounds correctly for the time axis for yearly data
+    Usage:
+    cdutil.times.setSlabTimeBoundsYearly(slab)
+    or
+    cdutil.times.setSlabTimeBoundsYearly(time_axis)
+"""
+    if isinstance(obj,cdms2.AbstractAxis):
+        setAxisTimeBoundsYearly(obj)
+    elif isinstance(obj,cdms2.MV2.AbstractVariable):
+        setSlabTimeBoundsYearly(obj)
+    return

+
+
+
[docs]def insert_monthly_seasons(data,seasons):
+    """ Takes data assumed to be in monthly increments (1,2,3,etc...)
+    And tries to add seasons into it is actually missing
+    For this takes each time step, and see if a number of "season" could be inserted between these two
+    """
+    t = data.getTime()
+    axes=data.getAxisList()
+    cal = t.getCalendar()
+    tc = t.asComponentTime()
+    tbnd = t.getBounds()
+    sh = list(data.shape)
+    sh[0]=1
+    adds = []
+    for season in seasons:
+##         print 'Dealing with season:',season
+        axv = []
+        bnds =[]
+        idx = getMonthIndex(season)
+        for i in range(data.shape[0]-1):
+            tscan=cdtime.reltime(tbnd[i][1]  ,t.units).tocomp(t.getCalendar()) # end of current time step
+            tnext=cdtime.reltime(tbnd[i+1][0],t.units).tocomp(t.getCalendar()) # beginnig of next time step
+
+            # Begining of the season
+            tb = cdtime.comptime(tscan.year,idx[0])
+            if tb.cmp(tscan) == -1:
+                tb.add(1,cdtime.Year)
+            # end of season
+            te=tb.add(len(idx),cdtime.Month)
+##             print season,tb,te,tscan,tnext,tb.cmp(tscan)>-1, te.cmp(tnext)<1,tb.cmp(tscan)>-1 and te.cmp(tnext)<1
+            # ok now we're going to create the "n" seasons
+            while  te.cmp(tnext)<1:
+                if tb.cmp(tscan)>-1:
+                    t0 = tb.torel(t.units,cal).value
+                    t1 = te.torel(t.units,cal).value
+                    bnds.append([t0,t1])
+                    # ok that was the bounds, now computes the mid value
+                    tm = cdtime.reltime((t0+t1)/2.,t.units)
+                    # ok sometimes we need to round up these things (months since especially)
+                    tm = tm.torel(tm.units,t.getCalendar()).value
+                    axv.append(tm)
+##                     print 'adding:',i,season,tb,te
+                tb=tb.add(1,cdtime.Year)
+                te=te.add(1,cdtime.Year)
+        n=len(axv)
+##         print 'N is:',n,'for season',season
+        if n!=0:
+            sh[0]=n
+            tmp = MV2.array(numpy.ma.masked_all(sh,dtype=data.dtype))
+            ax = cdms2.createAxis(axv,bounds=numpy.array(bnds))
+            ax.id = t.id
+            ax.designateTime()
+            ax.units=t.units
+            ax.setCalendar(cal)
+            axes[0]=ax
+            tmp.setAxisList(axes)
+            adds.append(tmp)
+    if adds!=[]:
+        adds.insert(0,data)
+        return mergeTime(adds,statusbar=None,fill_value=getattr(data,'fill_value',1.e20))
+    return data

+    
+class ASeason(TimeSlicer):
+    def __init__(self):
+        self.prev=0
+        self.title=''
+        self.slicer=monthBasedSlicer
+        self.criteria=generalCriteria
+
+class Seasons(ASeason):
+    def __init__(self,*seasons):
+        self.__call__=self.get
+        if len(seasons)==1:
+            seasons=seasons[0]
+        if type(seasons)==types.StringType:
+            seasons=[seasons]
+        for i in range(len(seasons)):
+            if type(seasons[i]) in [types.ListType,types.TupleType,types.IntType]:
+                seasons[i]=getMonthString(seasons[i])
+        self.seasons=seasons
+        self.slicer=monthBasedSlicer
+        self.criteria=generalCriteria
+        self.prev=0
+        self.title=''
+
+    def month_fix(self,slab):
+        t=slab.getTime()
+        u = t.units
+        if u.split()[0][:5].lower()=="month":
+            tc=cdtime.reltime(t[0],u).tocomp(t.getCalendar())
+            tc2=cdtime.reltime(t[-1],u).tocomp(t.getCalendar())
+            relyear = int(u.split()[2].split("-")[0])
+            #if tc.cmp(cdtime.comptime(relyear))<1 and tc2.cmp(cdtime.comptime(relyear))>-1:
+                #slab.__saved_time__=t.units
+                #t.toRelativeTime("months since %i" % (relyear - len(t)/10))
+                #t.toRelativeTime("months since 1")# % (relyear - len(t)/10))
+            slab.__saved_time__ = t.units
+            t.toRelativeTime("months since "+str(tc))
+        return u
+
+    def month_restore(self,merged,slab):
+           t = getattr(slab,"__saved_time__",None)
+           if t is not None:
+               T=slab.getTime()
+               T.toRelativeTime(t,T.getCalendar())
+               T=merged.getTime()
+               T.toRelativeTime(t,T.getCalendar())
+               del(slab.__saved_time__)
+
+    def get(self,slab,slicerarg=None,criteriaarg=None,statusbar=None,sum=False):
+        """Get the seasons asked for and return them in chronological order
+        i.e. if you asked for DJF and JJA and the first season of your dataset is JJA you will have a JJA first !!!!
+        Check your time axis coordinate !!!
+        slicerarg will be ignored
+        it is recomended to use Season(slab,criteria=mycriteriaarguments) syntax
+        rather than Season(slab,None,None,mycriteriaarguments)
+        Now for the original doc of the get function see get2__doc__:
+        """
+        cdat_info.pingPCMDIdb("cdat","cdutil.times.Seasons.get -%s-" % self.seasons)
+        u=self.month_fix(slab)
+        s=[]
+        i=-1
+        missing_seasons = []
+        for season in self.seasons:
+            i=i+1
+            self.statusbar1(i,len(self.seasons),statusbar)
+            s.append(TimeSlicer.get(self,slab,season,criteriaarg,statusbar=statusbar,sum=sum))
+            if s[-1] is None: # ok no data for that season
+                s.pop(-1)
+                missing_seasons.append(season)
+        self.statusbar2(statusbar)
+        m = mergeTime(s,statusbar=statusbar,fill_value=getattr(slab,'fill_value',1.e20))
+        self.month_restore(m,slab)
+        return m
+
+    def departures(self,slab,slicerarg=None,criteriaarg=None,ref=None,statusbar=None,sum=False):
+        """ Return the departures for the list of season you specified, returned in chronological order
+        i.e. if you asked for DJF and JJA and the first season of your dataset is JJA you will have a JJA first !!!!
+        Check your time axis coordinate !!!
+        To pass a specific array from which to compute departures, please pass 1 per season (or None if we should compute it)
+        for info one default departures see: departures2.__doc__
+        """
+        cdat_info.pingPCMDIdb("cdat","cdutil.times.Seasons.departures -%s-" % self.seasons)
+        u=self.month_fix(slab)
+        if not cdms2.isVariable(ref) and ref is not None:
+            raise RuntimeError,"reference must be a variable (MV2)"
+        s=[]
+        # Loop through the seasons
+        self.departures_seasons=[]
+        for ss in self.seasons:
+            self.departures_seasons.append(ss)
+        n = len(self.departures_seasons)
+        for i in range(n):
+            self.seasons=[self.departures_seasons[i],]
+            # Do we want a statusbar ?
+            if not statusbar is None:
+                if not type(statusbar) in [type([]),type(())]:
+                    statusbar=str([float(i),len(self.departures_seasons)])
+                elif i==0:
+                    statusbar.insert(0,str([float(i),len(self.departures_seasons)]))
+                else:
+                    statusbar[0]=str([float(i),len(self.departures_seasons)])
+            # Did we pass a reference to copmute the departures from ?
+            if not ref is None :
+                if not ref.getAxis(0).isTime():
+                    ref = ref(order='t...')
+                if ref.shape[0]!=len(self.departures_seasons):
+                    self.seasons=self.departures_seasons
+                    raise ValueError,"The reference time (or first) dimension does not match the number of dimensions"
+                newref=ref[i]
+            else:
+                newref=None
+            # now computes the departures
+            out=TimeSlicer.departures(self,slab,slicerarg=self.departures_seasons[i],criteriaarg=criteriaarg,statusbar=statusbar,ref=newref,sum=sum)
+            # Adds it to the list
+            if out is not None:
+                s.append(out)
+        self.seasons=self.departures_seasons
+        if not statusbar is None and len(self.seasons)!=1 :
+            if type(statusbar) in [type([]),type(())]: statusbar.pop(0)
+        # Now merges the stuff
+        m = mergeTime(s,statusbar=statusbar,fill_value=getattr(slab,'fill_value',1.e20))
+        self.month_restore(m,slab)
+        return m
+                                    
+    def climatology(self,slab,criteriaarg=None,criteriaargclim=None,statusbar=None,sum=False):
+        """ Compute the climatology from a slab
+
+        :param slab: A cdms2 transient variable
+        :type slab: cdms2.tvariable.TransientVariable
+
+        :param criteriaarg: the argument for criteria function when slicing the season (and clim)
+        :param criteriaargclim: the argument for criteria function when averaging the seasons together
+                            if different from criteriarg
+
+        :returns: The Average of the seasons in the order passed when constructing it
+            i.e if DJF and JJA are asked, the output will have the average DJF first, then the average JJA
+            2 criteria can be passed one for the slicing part and one for the climatology part
+        """
+        cdat_info.pingPCMDIdb("cdat","cdutil.times.Seasons.climatology -%s-" % self.seasons)
+        u=self.month_fix(slab)
+        #if criteriaargclim is None: criteriaargclim=criteriaarg
+        order=slab.getOrder(ids=1)
+        initialgrid = slab.getGrid()
+
+        if order[0]!='t' : slab=slab(order='t...')
+        timeaxis=slab.getAxis(0)
+        timecalendar=timeaxis.getCalendar()
+        sh=list(slab.shape)
+        nseason=len(self.seasons)
+        sh[0]=nseason
+        s=numpy.ma.zeros(sh,MV2.float)
+        vals=numpy.zeros(nseason,MV2.float)
+        bnds=numpy.zeros((nseason,2),MV2.float)
+        tim=slab.getTime()
+        for i in range(nseason):
+            if not statusbar is None:
+                if not type(statusbar) in [type([]),type(())]:
+                    statusbar=str([float(i),len(self.seasons)])
+                elif i==0:
+                    statusbar.insert(0,str([float(i),len(self.seasons)]))
+                else:
+                    statusbar[0]=str([float(i),len(self.seasons)])
+            months=getMonthIndex(self.seasons[i])
+            if len(months)==1 : months=months*2
+            if months[0]>months[1] : months[0]=months[0]-12
+            v1=cdtime.reltime(months[0]-1,'months since 0').torel('days since 0',timecalendar)
+            v2=cdtime.reltime(months[-1],'months since 0').torel('days since 0',timecalendar)
+            vals[i]=float(v1.value+v2.value)/2.
+            bnds[i]=[v1.value,v2.value]
+            tmp = TimeSlicer.get(self,slab,self.seasons[i],criteriaarg,statusbar=statusbar,weights=True,sum=sum)
+            if tmp is None:
+                return None
+            tmp,w=tmp
+            tmp2=numpy.ma.getmask(tmp)
+            if tmp2 is None:
+                tmp2=numpy.ones(tmp.shape,dtype=numpy.float)*w
+            else:
+                tmp2=tmp2.astype(MV2.float)
+                tmp2=(1.-tmp2)*w
+            tim=tmp.getTime()
+            bnd=tim.getBounds()
+            tot=0
+            if not cdms2.isVariable(tmp2):
+                tmp2=cdms2.asVariable(tmp2)
+            tmp2.setAxis(0,tim)
+            if  criteriaargclim is not None:
+                tmp=self.criteria(tmp,tmp2,bnds[i],criteriaargclim)
+            else:
+                if sum is False:
+                    tmp=numpy.ma.average(tmp,weights=tmp2,axis=0)
+                else:
+                    tmp = numpy.ma.sum(tmp*tmp2,axis=0)
+            s[i]=tmp
+        if not statusbar is None and len(self.seasons)!=1 :
+            if type(statusbar) in [type([]),type(())]: statusbar.pop(0)
+        t=cdms2.createAxis(vals,bounds=bnds)
+        t.id='time'
+        t.units='days since 0'
+        t.designateTime()
+        t.setCalendar(tim.getCalendar())
+        ax=slab.getAxisList()
+        ax[0]=t
+        s=cdms2.createVariable(s,id=slab.id,copy=0,fill_value=getattr(slab,'fill_value',1.e20))
+        s.setAxisList(ax)
+        if initialgrid is not None:
+            s.setGrid(initialgrid)
+        self.month_restore(s,slab)
+
+        if s.getOrder(ids=1)!=order:
+            return s(order=order)
+        else:
+            return s
+    
+## Seasons.get.__doc__=Seasons.get.__doc__+Seasons._get.__doc__
+## Seasons.departures.__doc__=Seasons.departures.__doc__+Seasons._departures.__doc__
+
+ANNUALCYCLE=Seasons([1,2,3,4,5,6,7,8,9,10,11,12])
+SEASONALCYCLE=Seasons(['DJF','MAM','JJA','SON'])
+
+DJF=Seasons('DJF')
+MAM=Seasons('MAM')
+JJA=Seasons('JJA')
+SON=Seasons('SON')
+JAN=Seasons('JAN')
+FEB=Seasons('FEB')
+MAR=Seasons('MAR')
+APR=Seasons('APR')
+MAY=Seasons('MAY')
+JUN=Seasons('JUN')
+JUL=Seasons('JUL')
+AUG=Seasons('AUG')
+SEP=Seasons('SEP')
+OCT=Seasons('OCT')
+NOV=Seasons('NOV')
+DEC=Seasons('DEC')
+
+YEAR=Seasons('JFMAMJJASOND')
+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/cdutil/vertical.html b/Doc/sphinx_docs/_build/html/_modules/cdutil/vertical.html new file mode 100644 index 0000000..b491a43 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/cdutil/vertical.html @@ -0,0 +1,376 @@ + + + + + + + + cdutil.vertical — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for cdutil.vertical

+# Adapted for numpy/ma/cdms2 by convertcdms.py
+import MV2
+import genutil
+import cdms2
+import numpy
+import cdat_info
+
+
+
[docs]def reconstructPressureFromHybrid(ps, A, B, Po):
+    """
+    Reconstruct the Pressure field on sigma levels, from the surface pressure
+
+
+    :param Ps: Surface pressure
+    :param A: Hybrid Conversion Coefficient, such as: p=B.ps+A.Po.
+    :param B: Hybrid Conversion Coefficient, such as: p=B.ps+A.Po.
+    :param Po: Hybrid Conversion Coefficient, such as: p=B.ps+A.Po
+    :param Ps: surface pressure
+
+    .. note::
+
+        A and B are 1d sigma levels.
+        Po and Ps must have same units.
+
+
+    :returns: Pressure field, such as P=B*Ps+A*Po.
+
+    :Example:
+
+        .. doctest:: vertical_reconstructPressureFromHybrid
+
+            >>> P=reconstructPressureFromHybrid(ps,A,B,Po)
+    """
+    # Compute the pressure for the sigma levels
+    cdat_info.pingPCMDIdb(
+        "cdat",
+        "cdutil.vertical.reconstructPressureFromHybrid")
+    ps, B = genutil.grower(ps, B)
+    ps, A = genutil.grower(ps, A)
+    p = ps * B
+    p = p + A * Po
+    p.setAxisList(ps.getAxisList())
+    p.id = 'P'
+    try:
+        p.units = ps.units
+    except:
+        pass
+    t = p.getTime()
+    if not t is None:
+        p = p(order='tz...')
+    else:
+        p = p(order='z...')
+    return p

+
+
+
[docs]def linearInterpolation(
+    A, I, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000,
+                  30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z'):
+    """
+    Linear interpolation to interpolate a field from some levels to another set of levels
+    Values below "surface" are masked.
+
+
+    :param A: array to interpolate
+    :type A:
+    :param I: interpolation field (usually Pressure or depth) from TOP (level 0) to BOTTOM (last level)
+            i.e P value going up with each level.
+    :type I:
+    :param levels: levels to interpolate to (same units as I).
+                    Default levels:[100000, 92500, 85000, 70000, 60000, 50000, 40000,
+                        30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000]
+    :type levels:
+    :param axis: Axis over which to do the linear interpolation.
+                Can provide either an int representing axis index, or the axis name.
+                Default: 'z'.
+    :type axis: str or int
+
+    .. note::
+
+        I and levels must have same units
+
+    :returns: array on new levels (levels)
+
+    :Examples:
+
+        .. doctest:: vertical_linearInterpolation
+
+            >>> A=interpolate(A,I) # interpolates A over default levels
+    """
+
+    cdat_info.pingPCMDIdb("cdat", "cdutil.vertical.linearInterpolation")
+    try:
+        nlev = len(levels)  # Number of pressure levels
+    except:
+        nlev = 1  # if only one level len(levels) would breaks
+        levels = [levels, ]
+    order = A.getOrder()
+    A = A(order='%s...' % axis)
+    I = I(order='%s...' % axis)
+    sh = list(I.shape)
+    nsigma = sh[0]  # number of sigma levels
+    sh[0] = nlev
+    t = MV2.zeros(sh, typecode=MV2.float32)
+    sh2 = I[0].shape
+    prev = -1
+    for ilev in range(nlev):  # loop through pressure levels
+        if status is not None:
+            prev = genutil.statusbar(ilev, nlev - 1., prev)
+        lev = levels[ilev]  # get value for the level
+        Iabv = MV2.ones(sh2, MV2.float)
+        Aabv = -1 * Iabv  # Array on sigma level Above
+        Abel = -1 * Iabv  # Array on sigma level Below
+        Ibel = -1 * Iabv  # Pressure on sigma level Below
+        Iabv = -1 * Iabv  # Pressure on sigma level Above
+        Ieq = MV2.masked_equal(Iabv, -1)  # Area where Pressure == levels
+        for i in range(1, nsigma):  # loop from second sigma level to last one
+            a = MV2.greater_equal(
+                I[i],
+                lev)  # Where is the pressure greater than lev
+            b = MV2.less_equal(
+                I[i - 1],
+                lev)  # Where is the pressure less than lev
+            # Now looks if the pressure level is in between the 2 sigma levels
+            # If yes, sets Iabv, Ibel and Aabv, Abel
+            a = MV2.logical_and(a, b)
+            Iabv = MV2.where(a, I[i], Iabv)  # Pressure on sigma level Above
+            Aabv = MV2.where(a, A[i], Aabv)  # Array on sigma level Above
+            Ibel = MV2.where(
+                a,
+                I[i - 1],
+                Ibel)  # Pressure on sigma level Below
+            Abel = MV2.where(a, A[i - 1], Abel)  # Array on sigma level Below
+            Ieq = MV2.where(MV2.equal(I[i], lev), A[i], Ieq)
+
+        val = MV2.masked_where(
+            MV2.equal(Ibel, -1.), numpy.ones(Ibel.shape) * lev)
+                               # set to missing value if no data below lev if
+                               # there is
+
+        tl = (val - Ibel) / (Iabv - Ibel) * \
+            (Aabv - Abel) + Abel  # Interpolation
+        if ((Ieq.mask is None) or (Ieq.mask is MV2.nomask)):
+            tl = Ieq
+        else:
+            tl = MV2.where(1 - Ieq.mask, Ieq, tl)
+        t[ilev] = tl.astype(MV2.float32)
+
+    ax = A.getAxisList()
+    autobnds = cdms2.getAutoBounds()
+    cdms2.setAutoBounds('off')
+    lvl = cdms2.createAxis(MV2.array(levels).filled())
+    cdms2.setAutoBounds(autobnds)
+    try:
+        lvl.units = I.units
+    except:
+        pass
+    lvl.id = 'plev'
+
+    try:
+        t.units = I.units
+    except:
+        pass
+
+    ax[0] = lvl
+    t.setAxisList(ax)
+    t.id = A.id
+    for att in A.listattributes():
+        setattr(t, att, getattr(A, att))
+    return t(order=order)

+
+
+
[docs]def logLinearInterpolation(
+    A, P, levels=[100000, 92500, 85000, 70000, 60000, 50000, 40000,
+                  30000, 25000, 20000, 15000, 10000, 7000, 5000, 3000, 2000, 1000], status=None, axis='z'):
+    """
+    Log-linear interpolation to convert a field from sigma levels to pressure levels.
+    Values below surface are masked.
+
+    :param A: array on sigma levels
+    :type A:
+
+    :param P: pressure field from TOP (level 0) to BOTTOM (last level)
+    :type P:
+
+    :param levels: pressure levels to interplate to (same units as P), default levels are:
+            [100000, 92500, 85000, 70000, 60000, 50000, 40000, 30000, 25000, 20000, 15000, 10000, 7000, 5000,
+            3000, 2000, 1000]
+    :type levels: list
+
+    :param axis: axis over which to do the linear interpolation
+    :type axis: str
+
+    .. note::
+
+        P and levels must have same units
+
+    :returns: array on pressure levels (levels)
+
+    :Example:
+
+        .. doctest:: vertical_logLinearInterpolation
+
+            >>> A=logLinearInterpolation(A,P) # interpolate A using pressure field P over the default levels
+    """
+
+    cdat_info.pingPCMDIdb("cdat", "cdutil.vertical.logLinearInterpolation")
+    try:
+        nlev = len(levels)  # Number of pressure levels
+    except:
+        nlev = 1  # if only one level len(levels) would breaks
+        levels = [levels, ]
+    order = A.getOrder()
+    A = A(order='%s...' % axis)
+    P = P(order='%s...' % axis)
+    sh = list(P.shape)
+    nsigma = sh[0]  # number of sigma levels
+    sh[0] = nlev
+    t = MV2.zeros(sh, typecode=MV2.float32)
+    sh2 = P[0].shape
+    prev = -1
+    for ilev in range(nlev):  # loop through pressure levels
+        if status is not None:
+            prev = genutil.statusbar(ilev, nlev - 1., prev)
+        lev = levels[ilev]  # get value for the level
+        Pabv = MV2.ones(sh2, MV2.float)
+        Aabv = -1 * Pabv  # Array on sigma level Above
+        Abel = -1 * Pabv  # Array on sigma level Below
+        Pbel = -1 * Pabv  # Pressure on sigma level Below
+        Pabv = -1 * Pabv  # Pressure on sigma level Above
+        Peq = MV2.masked_equal(Pabv, -1)  # Area where Pressure == levels
+        for i in range(1, nsigma):  # loop from second sigma level to last one
+            a = MV2.greater_equal(
+                P[i],
+                lev)  # Where is the pressure greater than lev
+            b = MV2.less_equal(
+                P[i - 1],
+                lev)  # Where is the pressure less than lev
+            # Now looks if the pressure level is in between the 2 sigma levels
+            # If yes, sets Pabv, Pbel and Aabv, Abel
+            a = MV2.logical_and(a, b)
+            Pabv = MV2.where(a, P[i], Pabv)  # Pressure on sigma level Above
+            Aabv = MV2.where(a, A[i], Aabv)  # Array on sigma level Above
+            Pbel = MV2.where(
+                a,
+                P[i - 1],
+                Pbel)  # Pressure on sigma level Below
+            Abel = MV2.where(a, A[i - 1], Abel)  # Array on sigma level Below
+            Peq = MV2.where(MV2.equal(P[i], lev), A[i], Peq)
+
+        val = MV2.masked_where(
+            MV2.equal(Pbel, -1), numpy.ones(Pbel.shape) * lev)
+                               # set to missing value if no data below lev if
+                               # there is
+
+        tl = MV2.log(
+            val / Pbel) / MV2.log(
+                Pabv / Pbel) * (
+            Aabv - Abel) + Abel  # Interpolation
+        if ((Peq.mask is None) or (Peq.mask is MV2.nomask)):
+            tl = Peq
+        else:
+            tl = MV2.where(1 - Peq.mask, Peq, tl)
+        t[ilev] = tl.astype(MV2.float32)
+
+    ax = A.getAxisList()
+    autobnds = cdms2.getAutoBounds()
+    cdms2.setAutoBounds('off')
+    lvl = cdms2.createAxis(MV2.array(levels).filled())
+    cdms2.setAutoBounds(autobnds)
+    try:
+        lvl.units = P.units
+    except:
+        pass
+    lvl.id = 'plev'
+
+    try:
+        t.units = P.units
+    except:
+        pass
+
+    ax[0] = lvl
+    t.setAxisList(ax)
+    t.id = A.id
+    for att in A.listattributes():
+        setattr(t, att, getattr(A, att))
+    return t(order=order)

+
+sigma2Pressure = logLinearInterpolation
+
+
+ +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_modules/index.html b/Doc/sphinx_docs/_build/html/_modules/index.html new file mode 100644 index 0000000..c625e2c --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_modules/index.html @@ -0,0 +1,92 @@ + + + + + + + + Overview: module code — CDUtil 2.8 documentation + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

All modules for which code is available

+ + +
+
+
+ +
+
+
+ ©2016, Charles Doutriaux. + + | + Powered by Sphinx 1.5.1 + & Alabaster 0.7.9 + +
+ + + + + + \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.rst.txt new file mode 100644 index 0000000..2fe9560 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.rst.txt @@ -0,0 +1,5 @@ +ValidationFunctions +------------------- + +.. automodule:: cdutil.ValidationFunctions + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.txt new file mode 100644 index 0000000..2fe9560 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/ValidationFunctions.txt @@ -0,0 +1,5 @@ +ValidationFunctions +------------------- + +.. automodule:: cdutil.ValidationFunctions + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.rst.txt new file mode 100644 index 0000000..c767ed5 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.rst.txt @@ -0,0 +1,5 @@ +continent_fill +-------------- + +.. automodule:: cdutil.continent_fill + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.txt new file mode 100644 index 0000000..c767ed5 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/continent_fill.txt @@ -0,0 +1,5 @@ +continent_fill +-------------- + +.. automodule:: cdutil.continent_fill + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.rst.txt new file mode 100644 index 0000000..3db4f76 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.rst.txt @@ -0,0 +1,5 @@ +create_landsea_mask +------------------- + +.. automodule:: cdutil.create_landsea_mask + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.txt new file mode 100644 index 0000000..3db4f76 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/create_landsea_mask.txt @@ -0,0 +1,5 @@ +create_landsea_mask +------------------- + +.. automodule:: cdutil.create_landsea_mask + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.rst.txt new file mode 100644 index 0000000..54aab64 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.rst.txt @@ -0,0 +1,5 @@ +netcdfwriter +------------ + +.. automodule:: cdutil.netcdfwriter + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.txt new file mode 100644 index 0000000..54aab64 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/netcdfwriter.txt @@ -0,0 +1,5 @@ +netcdfwriter +------------ + +.. automodule:: cdutil.netcdfwriter + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.rst.txt new file mode 100644 index 0000000..980dee1 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.rst.txt @@ -0,0 +1,5 @@ +region +------ + +.. automodule:: cdutil.region + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.txt new file mode 100644 index 0000000..980dee1 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/region.txt @@ -0,0 +1,5 @@ +region +------ + +.. automodule:: cdutil.region + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.rst.txt new file mode 100644 index 0000000..7ee9390 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.rst.txt @@ -0,0 +1,5 @@ +retrieve +-------- + +.. automodule:: cdutil.retrieve + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.txt new file mode 100644 index 0000000..7ee9390 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/retrieve.txt @@ -0,0 +1,5 @@ +retrieve +-------- + +.. automodule:: cdutil.retrieve + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.rst.txt new file mode 100644 index 0000000..706c5a0 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.rst.txt @@ -0,0 +1,5 @@ +sftbyrgn +-------- + +.. automodule:: cdutil.sftbyrgn + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.txt new file mode 100644 index 0000000..706c5a0 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/sftbyrgn.txt @@ -0,0 +1,5 @@ +sftbyrgn +-------- + +.. automodule:: cdutil.sftbyrgn + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.rst.txt new file mode 100644 index 0000000..3369265 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.rst.txt @@ -0,0 +1,5 @@ +times +----- + +.. automodule:: cdutil.times + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.txt new file mode 100644 index 0000000..3369265 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/times.txt @@ -0,0 +1,5 @@ +times +----- + +.. automodule:: cdutil.times + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.rst.txt new file mode 100644 index 0000000..e0f8d3d --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.rst.txt @@ -0,0 +1,5 @@ +vertical +-------- + +.. automodule:: cdutil.vertical + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.txt new file mode 100644 index 0000000..e0f8d3d --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/Modules/vertical.txt @@ -0,0 +1,5 @@ +vertical +-------- + +.. automodule:: cdutil.vertical + :members: diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.rst.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.rst.txt new file mode 100644 index 0000000..9baa545 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.rst.txt @@ -0,0 +1,17 @@ +CDUtil +------ + +.. automodule:: cdutil + :members: + +.. toctree:: + + Modules/continent_fill + Modules/create_landsea_mask + Modules/netcdfwriter + Modules/region + Modules/retrieve + Modules/sftbyrgn + Modules/times + Modules/ValidationFunctions + Modules/vertical diff --git a/Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.txt b/Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.txt new file mode 100644 index 0000000..9baa545 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/CDUtil/cdutil.txt @@ -0,0 +1,17 @@ +CDUtil +------ + +.. automodule:: cdutil + :members: + +.. toctree:: + + Modules/continent_fill + Modules/create_landsea_mask + Modules/netcdfwriter + Modules/region + Modules/retrieve + Modules/sftbyrgn + Modules/times + Modules/ValidationFunctions + Modules/vertical diff --git a/Doc/sphinx_docs/_build/html/_sources/cdutil.txt b/Doc/sphinx_docs/_build/html/_sources/cdutil.txt new file mode 100644 index 0000000..55be424 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/cdutil.txt @@ -0,0 +1,5 @@ +CDUtil +------ + +.. automodule:: cdutil + :members: \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_sources/index.rst.txt b/Doc/sphinx_docs/_build/html/_sources/index.rst.txt new file mode 100644 index 0000000..72dc368 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/index.rst.txt @@ -0,0 +1,24 @@ +.. CDUtil documentation master file, created by + sphinx-quickstart on Tue Nov 29 06:00:33 2016. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to CDUtil's documentation! +================================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + CDUtil/cdutil + + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + diff --git a/Doc/sphinx_docs/_build/html/_sources/index.txt b/Doc/sphinx_docs/_build/html/_sources/index.txt new file mode 100644 index 0000000..72dc368 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_sources/index.txt @@ -0,0 +1,24 @@ +.. CDUtil documentation master file, created by + sphinx-quickstart on Tue Nov 29 06:00:33 2016. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to CDUtil's documentation! +================================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + CDUtil/cdutil + + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + diff --git a/Doc/sphinx_docs/_build/html/_static/ajax-loader.gif b/Doc/sphinx_docs/_build/html/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 GIT binary patch literal 673 zcmZ?wbhEHb6krfw_{6~Q|Nno%(3)e{?)x>&1u}A`t?OF7Z|1gRivOgXi&7IyQd1Pl zGfOfQ60;I3a`F>X^fL3(@);C=vM_KlFfb_o=k{|A33hf2a5d61U}gjg=>Rd%XaNQW zW@Cw{|b%Y*pl8F?4B9 zlo4Fz*0kZGJabY|>}Okf0}CCg{u4`zEPY^pV?j2@h+|igy0+Kz6p;@SpM4s6)XEMg z#3Y4GX>Hjlml5ftdH$4x0JGdn8~MX(U~_^d!Hi)=HU{V%g+mi8#UGbE-*ao8f#h+S z2a0-5+vc7MU$e-NhmBjLIC1v|)9+Im8x1yacJ7{^tLX(ZhYi^rpmXm0`@ku9b53aN zEXH@Y3JaztblgpxbJt{AtE1ad1Ca>{v$rwwvK(>{m~Gf_=-Ro7Fk{#;i~+{{>QtvI yb2P8Zac~?~=sRA>$6{!(^3;ZP0TPFR(G_-UDU(8Jl0?(IXu$~#4A!880|o%~Al1tN literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/html/_static/alabaster.css b/Doc/sphinx_docs/_build/html/_static/alabaster.css new file mode 100644 index 0000000..a88ce29 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_static/alabaster.css @@ -0,0 +1,693 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +@import url("basic.css"); + +/* -- page layout ----------------------------------------------------------- */ + +body { + font-family: 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; + font-size: 17px; + background-color: #fff; + color: #000; + margin: 0; + padding: 0; +} + + +div.document { + width: 940px; + margin: 30px auto 0 auto; +} + +div.documentwrapper { + float: left; + width: 100%; +} + +div.bodywrapper { + margin: 0 0 0 220px; +} + +div.sphinxsidebar { + width: 220px; + font-size: 14px; + line-height: 1.5; +} + +hr { + border: 1px solid #B1B4B6; +} + +div.body { + background-color: #fff; + color: #3E4349; + padding: 0 30px 0 30px; +} + +div.body > .section { + text-align: left; +} + +div.footer { + width: 940px; + margin: 20px auto 30px auto; + font-size: 14px; + color: #888; + text-align: right; +} + +div.footer a { + color: #888; +} + +p.caption { + font-family: inherit; + font-size: inherit; +} + + +div.relations { + display: none; +} + + +div.sphinxsidebar a { + color: #444; + text-decoration: none; + border-bottom: 1px dotted #999; +} + +div.sphinxsidebar a:hover { + border-bottom: 1px solid #999; +} + +div.sphinxsidebarwrapper { + padding: 18px 10px; +} + +div.sphinxsidebarwrapper p.logo { + padding: 0; + margin: -10px 0 0 0px; + text-align: center; +} + +div.sphinxsidebarwrapper h1.logo { + margin-top: -10px; + text-align: center; + margin-bottom: 5px; + text-align: left; +} + +div.sphinxsidebarwrapper h1.logo-name { + margin-top: 0px; +} + +div.sphinxsidebarwrapper p.blurb { + margin-top: 0; + font-style: normal; +} + +div.sphinxsidebar h3, +div.sphinxsidebar h4 { + font-family: 'Garamond', 'Georgia', serif; + color: #444; + font-size: 24px; + font-weight: normal; + margin: 0 0 5px 0; + padding: 0; +} + +div.sphinxsidebar h4 { + font-size: 20px; +} + +div.sphinxsidebar h3 a { + color: #444; +} + +div.sphinxsidebar p.logo a, +div.sphinxsidebar h3 a, +div.sphinxsidebar p.logo a:hover, +div.sphinxsidebar h3 a:hover { + border: none; +} + +div.sphinxsidebar p { + color: #555; + margin: 10px 0; +} + +div.sphinxsidebar ul { + margin: 10px 0; + padding: 0; + color: #000; +} + +div.sphinxsidebar ul li.toctree-l1 > a { + font-size: 120%; +} + +div.sphinxsidebar ul li.toctree-l2 > a { + font-size: 110%; +} + +div.sphinxsidebar input { + border: 1px solid #CCC; + font-family: 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; + font-size: 1em; +} + +div.sphinxsidebar hr { + border: none; + height: 1px; + color: #AAA; + background: #AAA; + + text-align: left; + margin-left: 0; + width: 50%; +} + +/* -- body styles ----------------------------------------------------------- */ + +a { + color: #004B6B; + text-decoration: underline; +} + +a:hover { + color: #6D4100; + text-decoration: underline; +} + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: 'Garamond', 'Georgia', serif; + font-weight: normal; + margin: 30px 0px 10px 0px; + padding: 0; +} + +div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; } +div.body h2 { font-size: 180%; } +div.body h3 { font-size: 150%; } +div.body h4 { font-size: 130%; } +div.body h5 { font-size: 100%; } +div.body h6 { font-size: 100%; } + +a.headerlink { + color: #DDD; + padding: 0 4px; + text-decoration: none; +} + +a.headerlink:hover { + color: #444; + background: #EAEAEA; +} + +div.body p, div.body dd, div.body li { + line-height: 1.4em; +} + +div.admonition { + margin: 20px 0px; + padding: 10px 30px; + background-color: #EEE; + border: 1px solid #CCC; +} + +div.admonition tt.xref, div.admonition code.xref, div.admonition a tt { + background-color: ; + border-bottom: 1px solid #fafafa; +} + +dd div.admonition { + margin-left: -60px; + padding-left: 60px; +} + +div.admonition p.admonition-title { + font-family: 'Garamond', 'Georgia', serif; + font-weight: normal; + font-size: 24px; + margin: 0 0 10px 0; + padding: 0; + line-height: 1; +} + +div.admonition p.last { + margin-bottom: 0; +} + +div.highlight { + background-color: #fff; +} + +dt:target, .highlight { + background: #FAF3E8; +} + +div.warning { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.danger { + background-color: #FCC; + border: 1px solid #FAA; + -moz-box-shadow: 2px 2px 4px #D52C2C; + -webkit-box-shadow: 2px 2px 4px #D52C2C; + box-shadow: 2px 2px 4px #D52C2C; +} + +div.error { + background-color: #FCC; + border: 1px solid #FAA; + -moz-box-shadow: 2px 2px 4px #D52C2C; + -webkit-box-shadow: 2px 2px 4px #D52C2C; + box-shadow: 2px 2px 4px #D52C2C; +} + +div.caution { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.attention { + background-color: #FCC; + border: 1px solid #FAA; +} + +div.important { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.note { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.tip { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.hint { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.seealso { + background-color: #EEE; + border: 1px solid #CCC; +} + +div.topic { + background-color: #EEE; +} + +p.admonition-title { + display: inline; +} + +p.admonition-title:after { + content: ":"; +} + +pre, tt, code { + font-family: 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace; + font-size: 0.9em; +} + +.hll { + background-color: #FFC; + margin: 0 -12px; + padding: 0 12px; + display: block; +} + +img.screenshot { +} + +tt.descname, tt.descclassname, code.descname, code.descclassname { + font-size: 0.95em; +} + +tt.descname, code.descname { + padding-right: 0.08em; +} + +img.screenshot { + -moz-box-shadow: 2px 2px 4px #EEE; + -webkit-box-shadow: 2px 2px 4px #EEE; + box-shadow: 2px 2px 4px #EEE; +} + +table.docutils { + border: 1px solid #888; + -moz-box-shadow: 2px 2px 4px #EEE; + -webkit-box-shadow: 2px 2px 4px #EEE; + box-shadow: 2px 2px 4px #EEE; +} + +table.docutils td, table.docutils th { + border: 1px solid #888; + padding: 0.25em 0.7em; +} + +table.field-list, table.footnote { + border: none; + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} + +table.footnote { + margin: 15px 0; + width: 100%; + border: 1px solid #EEE; + background: #FDFDFD; + font-size: 0.9em; +} + +table.footnote + table.footnote { + margin-top: -15px; + border-top: none; +} + +table.field-list th { + padding: 0 0.8em 0 0; +} + +table.field-list td { + padding: 0; +} + +table.field-list p { + margin-bottom: 0.8em; +} + +table.footnote td.label { + width: .1px; + padding: 0.3em 0 0.3em 0.5em; +} + +table.footnote td { + padding: 0.3em 0.5em; +} + +dl { + margin: 0; + padding: 0; +} + +dl dd { + margin-left: 30px; +} + +blockquote { + margin: 0 0 0 30px; + padding: 0; +} + +ul, ol { + /* Matches the 30px from the narrow-screen "li > ul" selector below */ + margin: 10px 0 10px 30px; + padding: 0; +} + +pre { + background: #EEE; + padding: 7px 30px; + margin: 15px 0px; + line-height: 1.3em; +} + +div.viewcode-block:target { + background: #ffd; +} + +dl pre, blockquote pre, li pre { + margin-left: 0; + padding-left: 30px; +} + +dl dl pre { + margin-left: -90px; + padding-left: 90px; +} + +tt, code { + background-color: #ecf0f3; + color: #222; + /* padding: 1px 2px; */ +} + +tt.xref, code.xref, a tt { + background-color: #FBFBFB; + border-bottom: 1px solid #fff; +} + +a.reference { + text-decoration: none; + border-bottom: 1px dotted #004B6B; +} + +/* Don't put an underline on images */ +a.image-reference, a.image-reference:hover { + border-bottom: none; +} + +a.reference:hover { + border-bottom: 1px solid #6D4100; +} + +a.footnote-reference { + text-decoration: none; + font-size: 0.7em; + vertical-align: top; + border-bottom: 1px dotted #004B6B; +} + +a.footnote-reference:hover { + border-bottom: 1px solid #6D4100; +} + +a:hover tt, a:hover code { + background: #EEE; +} + + +@media screen and (max-width: 870px) { + + div.sphinxsidebar { + display: none; + } + + div.document { + width: 100%; + + } + + div.documentwrapper { + margin-left: 0; + margin-top: 0; + margin-right: 0; + margin-bottom: 0; + } + + div.bodywrapper { + margin-top: 0; + margin-right: 0; + margin-bottom: 0; + margin-left: 0; + } + + ul { + margin-left: 0; + } + + li > ul { + /* Matches the 30px from the "ul, ol" selector above */ + margin-left: 30px; + } + + .document { + width: auto; + } + + .footer { + width: auto; + } + + .bodywrapper { + margin: 0; + } + + .footer { + width: auto; + } + + .github { + display: none; + } + + + +} + + + +@media screen and (max-width: 875px) { + + body { + margin: 0; + padding: 20px 30px; + } + + div.documentwrapper { + float: none; + background: #fff; + } + + div.sphinxsidebar { + display: block; + float: none; + width: 102.5%; + margin: 50px -30px -20px -30px; + padding: 10px 20px; + background: #333; + color: #FFF; + } + + div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p, + div.sphinxsidebar h3 a { + color: #fff; + } + + div.sphinxsidebar a { + color: #AAA; + } + + div.sphinxsidebar p.logo { + display: none; + } + + div.document { + width: 100%; + margin: 0; + } + + div.footer { + display: none; + } + + div.bodywrapper { + margin: 0; + } + + div.body { + min-height: 0; + padding: 0; + } + + .rtd_doc_footer { + display: none; + } + + .document { + width: auto; + } + + .footer { + width: auto; + } + + .footer { + width: auto; + } + + .github { + display: none; + } +} + + +/* misc. */ + +.revsys-inline { + display: none!important; +} + +/* Make nested-list/multi-paragraph items look better in Releases changelog + * pages. Without this, docutils' magical list fuckery causes inconsistent + * formatting between different release sub-lists. + */ +div#changelog > div.section > ul > li > p:only-child { + margin-bottom: 0; +} + +/* Hide fugly table cell borders in ..bibliography:: directive output */ +table.docutils.citation, table.docutils.citation td, table.docutils.citation th { + border: none; + /* Below needed in some edge cases; if not applied, bottom shadows appear */ + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_static/basic.css b/Doc/sphinx_docs/_build/html/_static/basic.css new file mode 100644 index 0000000..7ed0e58 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_static/basic.css @@ -0,0 +1,632 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox input[type="text"] { + width: 170px; +} + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, .highlighted { + background-color: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +div.code-block-caption { + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +div.code-block-caption + div > div.highlight > pre { + margin-top: 0; +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + padding: 1em 1em 0; +} + +div.literal-block-wrapper div.highlight { + margin: 0; +} + +code.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +code.descclassname { + background-color: transparent; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: relative; + left: 0px; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_static/comment-bright.png b/Doc/sphinx_docs/_build/html/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..15e27edb12ac25701ac0ac21b97b52bb4e45415e GIT binary patch literal 756 zcmVgfIX78 z$8Pzv({A~p%??+>KickCb#0FM1rYN=mBmQ&Nwp<#JXUhU;{|)}%&s>suq6lXw*~s{ zvHx}3C%<;wE5CH!BR{p5@ml9ws}y)=QN-kL2?#`S5d*6j zk`h<}j1>tD$b?4D^N9w}-k)bxXxFg>+#kme^xx#qg6FI-%iv2U{0h(Y)cs%5a|m%Pn_K3X_bDJ>EH#(Fb73Z zfUt2Q3B>N+ot3qb*DqbTZpFIn4a!#_R-}{?-~Hs=xSS6p&$sZ-k1zDdtqU`Y@`#qL z&zv-~)Q#JCU(dI)Hf;$CEnK=6CK50}q7~wdbI->?E07bJ0R;!GSQTs5Am`#;*WHjvHRvY?&$Lm-vq1a_BzocI^ULXV!lbMd%|^B#fY;XX)n<&R^L z=84u1e_3ziq;Hz-*k5~zwY3*oDKt0;bM@M@@89;@m*4RFgvvM_4;5LB!@OB@^WbVT zjl{t;a8_>od-~P4 m{5|DvB&z#xT;*OnJqG}gk~_7HcNkCr0000W zanA~u9RIXo;n7c96&U)YLgs-FGlx~*_c{Jgvesu1E5(8YEf&5wF=YFPcRe@1=MJmi zag(L*xc2r0(slpcN!vC5CUju;vHJkHc*&70_n2OZsK%O~A=!+YIw z7zLLl7~Z+~RgWOQ=MI6$#0pvpu$Q43 zP@36QAmu6!_9NPM?o<1_!+stoVRRZbW9#SPe!n;#A_6m8f}|xN1;H{`0RoXQ2LM47 zt(g;iZ6|pCb@h2xk&(}S3=EVBUO0e90m2Lp5CB<(SPIaB;n4))3JB87Or#XPOPcum z?<^(g+m9}VNn4Y&B`g8h{t_$+RB1%HKRY6fjtd-<7&EsU;vs0GM(Lmbhi%Gwcfs0FTF}T zL{_M6Go&E0Eg8FuB*(Yn+Z*RVTBE@10eIOb3El^MhO`GabDll(V0&FlJi2k^;q8af zkENdk2}x2)_KVp`5OAwXZM;dG0?M-S)xE1IKDi6BY@5%Or?#aZ9$gcX)dPZ&wA1a< z$rFXHPn|TBf`e?>Are8sKtKrKcjF$i^lp!zkL?C|y^vlHr1HXeVJd;1I~g&Ob-q)& z(fn7s-KI}G{wnKzg_U5G(V%bX6uk zIa+<@>rdmZYd!9Y=C0cuchrbIjuRB_Wq{-RXlic?flu1*_ux}x%(HDH&nT`k^xCeC ziHi1!ChH*sQ6|UqJpTTzX$aw8e(UfcS^f;6yBWd+(1-70zU(rtxtqR%j z-lsH|CKQJXqD{+F7V0OTv8@{~(wp(`oIP^ZykMWgR>&|RsklFMCnOo&Bd{le} zV5F6424Qzl;o2G%oVvmHgRDP9!=rK8fy^!yV8y*4p=??uIRrrr0?>O!(z*g5AvL2!4z0{sq%vhG*Po}`a<6%kTK5TNhtC8}rXNu&h^QH4A&Sk~Autm*s~45(H7+0bi^MraaRVzr05hQ3iK?j` zR#U@^i0WhkIHTg29u~|ypU?sXCQEQgXfObPW;+0YAF;|5XyaMAEM0sQ@4-xCZe=0e z7r$ofiAxn@O5#RodD8rh5D@nKQ;?lcf@tg4o+Wp44aMl~c47azN_(im0N)7OqdPBC zGw;353_o$DqGRDhuhU$Eaj!@m000000NkvXXu0mjfjZ7Z_ literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/html/_static/custom.css b/Doc/sphinx_docs/_build/html/_static/custom.css new file mode 100644 index 0000000..2a924f1 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_static/custom.css @@ -0,0 +1 @@ +/* This file intentionally left blank. */ diff --git a/Doc/sphinx_docs/_build/html/_static/doctools.js b/Doc/sphinx_docs/_build/html/_static/doctools.js new file mode 100644 index 0000000..8163495 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_static/doctools.js @@ -0,0 +1,287 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s == 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node) { + if (node.nodeType == 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { + var span = document.createElement("span"); + span.className = className; + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this); + }); + } + } + return this.each(function() { + highlight(this); + }); +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated == 'undefined') + return string; + return (typeof translated == 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated == 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + if (!body.length) { + body = $('body'); + } + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('

' + _('Hide Search Matches') + '

') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) == 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this == '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + }, + + initOnKeyListeners: function() { + $(document).keyup(function(event) { + var activeElementType = document.activeElement.tagName; + // don't navigate when in search box or textarea + if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') { + switch (event.keyCode) { + case 37: // left + var prevHref = $('link[rel="prev"]').prop('href'); + if (prevHref) { + window.location.href = prevHref; + return false; + } + case 39: // right + var nextHref = $('link[rel="next"]').prop('href'); + if (nextHref) { + window.location.href = nextHref; + return false; + } + } + } + }); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); \ No newline at end of file diff --git a/Doc/sphinx_docs/_build/html/_static/down-pressed.png b/Doc/sphinx_docs/_build/html/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..5756c8cad8854722893dc70b9eb4bb0400343a39 GIT binary patch literal 222 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`OFdm2Ln;`PZ^+1>KjR?B@S0W7 z%OS_REiHONoJ6{+Ks@6k3590|7k9F+ddB6!zw3#&!aw#S`x}3V3&=A(a#84O-&F7T z^k3tZB;&iR9siw0|F|E|DAL<8r-F4!1H-;1{e*~yAKZN5f0|Ei6yUmR#Is)EM(Po_ zi`qJR6|P<~+)N+kSDgL7AjdIC_!O7Q?eGb+L+qOjm{~LLinM4NHn7U%HcK%uoMYO5 VJ~8zD2B3o(JYD@<);T3K0RV0%P>BEl literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/html/_static/down.png b/Doc/sphinx_docs/_build/html/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..1b3bdad2ceffae91cee61b32f3295f9bbe646e48 GIT binary patch literal 202 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!60wlNoGJgf6CVIL!hEy=F?b*7pIY7kW{q%Rg zx!yQ<9v8bmJwa`TQk7YSw}WVQ()mRdQ;TC;* literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/html/_static/file.png b/Doc/sphinx_docs/_build/html/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 GIT binary patch literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( literal 0 HcmV?d00001 diff --git a/Doc/sphinx_docs/_build/html/_static/jquery-1.11.1.js b/Doc/sphinx_docs/_build/html/_static/jquery-1.11.1.js new file mode 100644 index 0000000..d4b67f7 --- /dev/null +++ b/Doc/sphinx_docs/_build/html/_static/jquery-1.11.1.js @@ -0,0 +1,10308 @@ +/*! + * jQuery JavaScript Library v1.11.1 + * http://jquery.com/ + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * + * Copyright 2005, 2014 jQuery Foundation, Inc. and other contributors + * Released under the MIT license + * http://jquery.org/license + * + * Date: 2014-05-01T17:42Z + */ + +(function( global, factory ) { + + if ( typeof module === "object" && typeof module.exports === "object" ) { + // For CommonJS and CommonJS-like environments where a proper window is present, + // execute the factory and get jQuery + // For environments that do not inherently posses a window with a document + // (such as Node.js), expose a jQuery-making factory as module.exports + // This accentuates the need for the creation of a real window + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +}(typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Can't do this because several apps including ASP.NET trace +// the stack via arguments.caller.callee and Firefox dies if +// you try to trace through "use strict" call chains. (#13335) +// Support: Firefox 18+ +// + +var deletedIds = []; + +var slice = deletedIds.slice; + +var concat = deletedIds.concat; + +var push = deletedIds.push; + +var indexOf = deletedIds.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var support = {}; + + + +var + version = "1.11.1", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }, + + // Support: Android<4.1, IE<9 + // Make sure we trim BOM and NBSP + rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, + + // Matches dashed string for camelizing + rmsPrefix = /^-ms-/, + rdashAlpha = /-([\da-z])/gi, + + // Used by jQuery.camelCase as callback to replace() + fcamelCase = function( all, letter ) { + return letter.toUpperCase(); + }; + +jQuery.fn = jQuery.prototype = { + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // Start with an empty selector + selector: "", + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + return num != null ? + + // Return just the one element from the set + ( num < 0 ? this[ num + this.length ] : this[ num ] ) : + + // Return all the elements in a clean array + slice.call( this ); + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + ret.context = this.context; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + // (You can seed the arguments with an array of args, but this is + // only used internally.) + each: function( callback, args ) { + return jQuery.each( this, callback, args ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map(this, function( elem, i ) { + return callback.call( elem, i, elem ); + })); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[j] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(null); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: deletedIds.sort, + splice: deletedIds.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var src, copyIsArray, copy, name, options, clone, + target = arguments[0] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction(target) ) { + target = {}; + } + + // extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + // Only deal with non-null/undefined values + if ( (options = arguments[ i ]) != null ) { + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { + if ( copyIsArray ) { + copyIsArray = false; + clone = src && jQuery.isArray(src) ? src : []; + + } else { + clone = src && jQuery.isPlainObject(src) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend({ + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + // See test/unit/core.js for details concerning isFunction. + // Since version 1.3, DOM methods and functions like alert + // aren't supported. They return false on IE (#2968). + isFunction: function( obj ) { + return jQuery.type(obj) === "function"; + }, + + isArray: Array.isArray || function( obj ) { + return jQuery.type(obj) === "array"; + }, + + isWindow: function( obj ) { + /* jshint eqeqeq: false */ + return obj != null && obj == obj.window; + }, + + isNumeric: function( obj ) { + // parseFloat NaNs numeric-cast false positives (null|true|false|"") + // ...but misinterprets leading-number strings, particularly hex literals ("0x...") + // subtraction forces infinities to NaN + return !jQuery.isArray( obj ) && obj - parseFloat( obj ) >= 0; + }, + + isEmptyObject: function( obj ) { + var name; + for ( name in obj ) { + return false; + } + return true; + }, + + isPlainObject: function( obj ) { + var key; + + // Must be an Object. + // Because of IE, we also have to check the presence of the constructor property. + // Make sure that DOM nodes and window objects don't pass through, as well + if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { + return false; + } + + try { + // Not own constructor property must be Object + if ( obj.constructor && + !hasOwn.call(obj, "constructor") && + !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { + return false; + } + } catch ( e ) { + // IE8,9 Will throw exceptions on certain host objects #9897 + return false; + } + + // Support: IE<9 + // Handle iteration over inherited properties before own properties. + if ( support.ownLast ) { + for ( key in obj ) { + return hasOwn.call( obj, key ); + } + } + + // Own properties are enumerated firstly, so to speed up, + // if last one is own, then all properties are own. + for ( key in obj ) {} + + return key === undefined || hasOwn.call( obj, key ); + }, + + type: function( obj ) { + if ( obj == null ) { + return obj + ""; + } + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call(obj) ] || "object" : + typeof obj; + }, + + // Evaluates a script in a global context + // Workarounds based on findings by Jim Driscoll + // http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context + globalEval: function( data ) { + if ( data && jQuery.trim( data ) ) { + // We use execScript on Internet Explorer + // We use an anonymous function so that context is window + // rather than jQuery in Firefox + ( window.execScript || function( data ) { + window[ "eval" ].call( window, data ); + } )( data ); + } + }, + + // Convert dashed to camelCase; used by the css and data modules + // Microsoft forgot to hump their vendor prefix (#9572) + camelCase: function( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); + }, + + nodeName: function( elem, name ) { + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + }, + + // args is for internal usage only + each: function( obj, callback, args ) { + var value, + i = 0, + length = obj.length, + isArray = isArraylike( obj ); + + if ( args ) { + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback.apply( obj[ i ], args ); + + if ( value === false ) { + break; + } + } + } else { + for ( i in obj ) { + value = callback.apply( obj[ i ], args ); + + if ( value === false ) { + break; + } + } + } + + // A special, fast, case for the most common use of each + } else { + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback.call( obj[ i ], i, obj[ i ] ); + + if ( value === false ) { + break; + } + } + } else { + for ( i in obj ) { + value = callback.call( obj[ i ], i, obj[ i ] ); + + if ( value === false ) { + break; + } + } + } + } + + return obj; + }, + + // Support: Android<4.1, IE<9 + trim: function( text ) { + return text == null ? + "" : + ( text + "" ).replace( rtrim, "" ); + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArraylike( Object(arr) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + var len; + + if ( arr ) { + if ( indexOf ) { + return indexOf.call( arr, elem, i ); + } + + len = arr.length; + i = i ? i < 0 ? Math.max( 0, len + i ) : i : 0; + + for ( ; i < len; i++ ) { + // Skip accessing in sparse arrays + if ( i in arr && arr[ i ] === elem ) { + return i; + } + } + } + + return -1; + }, + + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + while ( j < len ) { + first[ i++ ] = second[ j++ ]; + } + + // Support: IE<9 + // Workaround casting of .length to NaN on otherwise arraylike objects (e.g., NodeLists) + if ( len !== len ) { + while ( second[j] !== undefined ) { + first[ i++ ] = second[ j++ ]; + } + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var value, + i = 0, + length = elems.length, + isArray = isArraylike( elems ), + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // Bind a function to a context, optionally partially applying any + // arguments. + proxy: function( fn, context ) { + var args, proxy, tmp; + + if ( typeof context === "string" ) { + tmp = fn[ context ]; + context = fn; + fn = tmp; + } + + // Quick check to determine if target is callable, in the spec + // this throws a TypeError, but we will just return undefined. + if ( !jQuery.isFunction( fn ) ) { + return undefined; + } + + // Simulated bind + args = slice.call( arguments, 2 ); + proxy = function() { + return fn.apply( context || this, args.concat( slice.call( arguments ) ) ); + }; + + // Set the guid of unique handler to the same of original handler, so it can be removed + proxy.guid = fn.guid = fn.guid || jQuery.guid++; + + return proxy; + }, + + now: function() { + return +( new Date() ); + }, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +}); + +// Populate the class2type map +jQuery.each("Boolean Number String Function Array Date RegExp Object Error".split(" "), function(i, name) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +}); + +function isArraylike( obj ) { + var length = obj.length, + type = jQuery.type( obj ); + + if ( type === "function" || jQuery.isWindow( obj ) ) { + return false; + } + + if ( obj.nodeType === 1 && length ) { + return true; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v1.10.19 + * http://sizzlejs.com/ + * + * Copyright 2013 jQuery Foundation, Inc. and other contributors + * Released under the MIT license + * http://jquery.org/license + * + * Date: 2014-04-18 + */ +(function( window ) { + +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + -(new Date()), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // General-purpose constants + strundefined = typeof undefined, + MAX_NEGATIVE = 1 << 31, + + // Instance methods + hasOwn = ({}).hasOwnProperty, + arr = [], + pop = arr.pop, + push_native = arr.push, + push = arr.push, + slice = arr.slice, + // Use a stripped-down indexOf if we can't use a native one + indexOf = arr.indexOf || function( elem ) { + var i = 0, + len = this.length; + for ( ; i < len; i++ ) { + if ( this[i] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // Whitespace characters http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + // http://www.w3.org/TR/css3-syntax/#characters + characterEncoding = "(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+", + + // Loosely modeled on CSS identifier characters + // An unquoted value should be a CSS identifier http://www.w3.org/TR/css3-selectors/#attribute-selectors + // Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier + identifier = characterEncoding.replace( "w", "w#" ), + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + characterEncoding + ")(?:" + whitespace + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + // "Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace + + "*\\]", + + pseudos = ":(" + characterEncoding + ")(?:\\((" + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ), + + rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*?)" + whitespace + "*\\]", "g" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + characterEncoding + ")" ), + "CLASS": new RegExp( "^\\.(" + characterEncoding + ")" ), + "TAG": new RegExp( "^(" + characterEncoding.replace( "w", "w*" ) + ")" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace + + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + + whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + rescape = /'|\\/g, + + // CSS escapes http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ), + funescape = function( _, escaped, escapedWhitespace ) { + var high = "0x" + escaped - 0x10000; + // NaN means non-codepoint + // Support: Firefox<24 + // Workaround erroneous numeric interpretation of +"0x" + return high !== high || escapedWhitespace ? + escaped : + high < 0 ? + // BMP codepoint + String.fromCharCode( high + 0x10000 ) : + // Supplemental Plane codepoint (surrogate pair) + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }; + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + (arr = slice.call( preferredDoc.childNodes )), + preferredDoc.childNodes + ); + // Support: Android<4.0 + // Detect silently failing push.apply + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + push_native.apply( target, slice.call(els) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + // Can't trust NodeList.length + while ( (target[j++] = els[i++]) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var match, elem, m, nodeType, + // QSA vars + i, groups, old, nid, newContext, newSelector; + + if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) { + setDocument( context ); + } + + context = context || document; + results = results || []; + + if ( !selector || typeof selector !== "string" ) { + return results; + } + + if ( (nodeType = context.nodeType) !== 1 && nodeType !== 9 ) { + return []; + } + + if ( documentIsHTML && !seed ) { + + // Shortcuts + if ( (match = rquickExpr.exec( selector )) ) { + // Speed-up: Sizzle("#ID") + if ( (m = match[1]) ) { + if ( nodeType === 9 ) { + elem = context.getElementById( m ); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document (jQuery #6963) + if ( elem && elem.parentNode ) { + // Handle the case where IE, Opera, and Webkit return items + // by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + } else { + // Context is not a document + if ( context.ownerDocument && (elem = context.ownerDocument.getElementById( m )) && + contains( context, elem ) && elem.id === m ) { + results.push( elem ); + return results; + } + } + + // Speed-up: Sizzle("TAG") + } else if ( match[2] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Speed-up: Sizzle(".CLASS") + } else if ( (m = match[3]) && support.getElementsByClassName && context.getElementsByClassName ) { + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // QSA path + if ( support.qsa && (!rbuggyQSA || !rbuggyQSA.test( selector )) ) { + nid = old = expando; + newContext = context; + newSelector = nodeType === 9 && selector; + + // qSA works strangely on Element-rooted queries + // We can work around this by specifying an extra ID on the root + // and working up from there (Thanks to Andrew Dupont for the technique) + // IE 8 doesn't work on object elements + if ( nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { + groups = tokenize( selector ); + + if ( (old = context.getAttribute("id")) ) { + nid = old.replace( rescape, "\\$&" ); + } else { + context.setAttribute( "id", nid ); + } + nid = "[id='" + nid + "'] "; + + i = groups.length; + while ( i-- ) { + groups[i] = nid + toSelector( groups[i] ); + } + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || context; + newSelector = groups.join(","); + } + + if ( newSelector ) { + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch(qsaError) { + } finally { + if ( !old ) { + context.removeAttribute("id"); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {Function(string, Object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return (cache[ key + " " ] = value); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created div and expects a boolean result + */ +function assert( fn ) { + var div = document.createElement("div"); + + try { + return !!fn( div ); + } catch (e) { + return false; + } finally { + // Remove from its parent by default + if ( div.parentNode ) { + div.parentNode.removeChild( div ); + } + // release memory in IE + div = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split("|"), + i = attrs.length; + + while ( i-- ) { + Expr.attrHandle[ arr[i] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + ( ~b.sourceIndex || MAX_NEGATIVE ) - + ( ~a.sourceIndex || MAX_NEGATIVE ); + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( (cur = cur.nextSibling) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction(function( argument ) { + argument = +argument; + return markFunction(function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ (j = matchIndexes[i]) ] ) { + seed[j] = !(matches[j] = seed[j]); + } + } + }); + }); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== strundefined && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = elem && (elem.ownerDocument || elem).documentElement; + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, + doc = node ? node.ownerDocument || node : preferredDoc, + parent = doc.defaultView; + + // If no document and documentElement is available, return + if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Set our document + document = doc; + docElem = doc.documentElement; + + // Support tests + documentIsHTML = !isXML( doc ); + + // Support: IE>8 + // If iframe document is assigned to "document" variable and if iframe has been reloaded, + // IE will throw "permission denied" error when accessing "document" variable, see jQuery #13936 + // IE6-8 do not support the defaultView property so parent will be undefined + if ( parent && parent !== parent.top ) { + // IE11 does not have attachEvent, so all must suffer + if ( parent.addEventListener ) { + parent.addEventListener( "unload", function() { + setDocument(); + }, false ); + } else if ( parent.attachEvent ) { + parent.attachEvent( "onunload", function() { + setDocument(); + }); + } + } + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties (excepting IE8 booleans) + support.attributes = assert(function( div ) { + div.className = "i"; + return !div.getAttribute("className"); + }); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert(function( div ) { + div.appendChild( doc.createComment("") ); + return !div.getElementsByTagName("*").length; + }); + + // Check if getElementsByClassName can be trusted + support.getElementsByClassName = rnative.test( doc.getElementsByClassName ) && assert(function( div ) { + div.innerHTML = "
"; + + // Support: Safari<4 + // Catch class over-caching + div.firstChild.className = "i"; + // Support: Opera<10 + // Catch gEBCN failure to find non-leading classes + return div.getElementsByClassName("i").length === 2; + }); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert(function( div ) { + docElem.appendChild( div ).id = expando; + return !doc.getElementsByName || !doc.getElementsByName( expando ).length; + }); + + // ID find and filter + if ( support.getById ) { + Expr.find["ID"] = function( id, context ) { + if ( typeof context.getElementById !== strundefined && documentIsHTML ) { + var m = context.getElementById( id ); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + return m && m.parentNode ? [ m ] : []; + } + }; + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute("id") === attrId; + }; + }; + } else { + // Support: IE6/7 + // getElementById is not reliable as a find shortcut + delete Expr.find["ID"]; + + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode("id"); + return node && node.value === attrId; + }; + }; + } + + // Tag + Expr.find["TAG"] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== strundefined ) { + return context.getElementsByTagName( tag ); + } + } : + function( tag, context ) { + var elem, + tmp = [], + i = 0, + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( (elem = results[i++]) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== strundefined && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See http://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( (support.qsa = rnative.test( doc.querySelectorAll )) ) { + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert(function( div ) { + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // http://bugs.jquery.com/ticket/12359 + div.innerHTML = ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // http://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( div.querySelectorAll("[msallowclip^='']").length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !div.querySelectorAll("[selected]").length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !div.querySelectorAll(":checked").length ) { + rbuggyQSA.push(":checked"); + } + }); + + assert(function( div ) { + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = doc.createElement("input"); + input.setAttribute( "type", "hidden" ); + div.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( div.querySelectorAll("[name=d]").length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( !div.querySelectorAll(":enabled").length ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Opera 10-11 does not throw on post-comma invalid pseudos + div.querySelectorAll("*,:x"); + rbuggyQSA.push(",.*:"); + }); + } + + if ( (support.matchesSelector = rnative.test( (matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector) )) ) { + + assert(function( div ) { + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( div, "div" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( div, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + }); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully does not implement inclusive descendent + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + )); + } : + function( a, b ) { + if ( b ) { + while ( (b = b.parentNode) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + compare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + (!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) { + + // Choose the first element that is related to our preferred document + if ( a === doc || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) { + return -1; + } + if ( b === doc || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + return a === doc ? -1 : + b === doc ? 1 : + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( (cur = cur.parentNode) ) { + ap.unshift( cur ); + } + cur = b; + while ( (cur = cur.parentNode) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[i] === bp[i] ) { + i++; + } + + return i ? + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[i], bp[i] ) : + + // Otherwise nodes in our document sort first + ap[i] === preferredDoc ? -1 : + bp[i] === preferredDoc ? 1 : + 0; + }; + + return doc; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + // Make sure that attribute selectors are quoted + expr = expr.replace( rattributeQuotes, "='$1']" ); + + if ( support.matchesSelector && documentIsHTML && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch(e) {} + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + // Set document vars if needed + if ( ( context.ownerDocument || context ) !== document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + (val = elem.getAttributeNode(name)) && val.specified ? + val.value : + null; +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( (elem = results[i++]) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + // If no nodeType, this is expected to be an array + while ( (node = elem[i++]) ) { + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[1] = match[1].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[3] = ( match[3] || match[4] || match[5] || "" ).replace( runescape, funescape ); + + if ( match[2] === "~=" ) { + match[3] = " " + match[3] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[1] = match[1].toLowerCase(); + + if ( match[1].slice( 0, 3 ) === "nth" ) { + // nth-* requires argument + if ( !match[3] ) { + Sizzle.error( match[0] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) ); + match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" ); + + // other types prohibit arguments + } else if ( match[3] ) { + Sizzle.error( match[0] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[6] && match[2]; + + if ( matchExpr["CHILD"].test( match[0] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[3] ) { + match[2] = match[4] || match[5] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + // Get excess from tokenize (recursively) + (excess = tokenize( unquoted, true )) && + // advance to the next closing parenthesis + (excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) { + + // excess is a negative index + match[0] = match[0].slice( 0, excess ); + match[2] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { return true; } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + (pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) && + classCache( className, function( elem ) { + return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== strundefined && elem.getAttribute("class") || "" ); + }); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + }; + }, + + "CHILD": function( type, what, argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, context, xml ) { + var cache, outerCache, node, diff, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( (node = node[ dir ]) ) { + if ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) { + return false; + } + } + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + // Seek `elem` from a previously-cached index + outerCache = parent[ expando ] || (parent[ expando ] = {}); + cache = outerCache[ type ] || []; + nodeIndex = cache[0] === dirruns && cache[1]; + diff = cache[0] === dirruns && cache[2]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( (node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + (diff = nodeIndex = 0) || start.pop()) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + outerCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + // Use previously-cached element index if available + } else if ( useCache && (cache = (elem[ expando ] || (elem[ expando ] = {}))[ type ]) && cache[0] === dirruns ) { + diff = cache[1]; + + // xml :nth-child(...) or :nth-last-child(...) or :nth(-last)?-of-type(...) + } else { + // Use the same loop as above to seek `elem` from the start + while ( (node = ++nodeIndex && node && node[ dir ] || + (diff = nodeIndex = 0) || start.pop()) ) { + + if ( ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) && ++diff ) { + // Cache the index of each encountered element + if ( useCache ) { + (node[ expando ] || (node[ expando ] = {}))[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction(function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf.call( seed, matched[i] ); + seed[ idx ] = !( matches[ idx ] = matched[i] ); + } + }) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + // Potentially complex pseudos + "not": markFunction(function( selector ) { + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction(function( seed, matches, context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( (elem = unmatched[i]) ) { + seed[i] = !(matches[i] = elem); + } + } + }) : + function( elem, context, xml ) { + input[0] = elem; + matcher( input, null, xml, results ); + return !results.pop(); + }; + }), + + "has": markFunction(function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + }), + + "contains": markFunction(function( text ) { + return function( elem ) { + return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1; + }; + }), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + // lang value must be a valid identifier + if ( !ridentifier.test(lang || "") ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( (elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( (elem = elem.parentNode) && elem.nodeType === 1 ); + return false; + }; + }), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex); + }, + + // Boolean properties + "enabled": function( elem ) { + return elem.disabled === false; + }, + + "disabled": function( elem ) { + return elem.disabled === true; + }, + + "checked": function( elem ) { + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected); + }, + + "selected": function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos["empty"]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo(function() { + return [ 0 ]; + }), + + "last": createPositionalPseudo(function( matchIndexes, length ) { + return [ length - 1 ]; + }), + + "eq": createPositionalPseudo(function( matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + }), + + "even": createPositionalPseudo(function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "odd": createPositionalPseudo(function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "lt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "gt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }) + } +}; + +Expr.pseudos["nth"] = Expr.pseudos["eq"]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || (match = rcomma.exec( soFar )) ) { + if ( match ) { + // Don't consume trailing commas as valid + soFar = soFar.slice( match[0].length ) || soFar; + } + groups.push( (tokens = []) ); + } + + matched = false; + + // Combinators + if ( (match = rcombinators.exec( soFar )) ) { + matched = match.shift(); + tokens.push({ + value: matched, + // Cast descendant combinators to space + type: match[0].replace( rtrim, " " ) + }); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] || + (match = preFilters[ type ]( match ))) ) { + matched = match.shift(); + tokens.push({ + value: matched, + type: type, + matches: match + }); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[i].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + checkNonElements = base && dir === "parentNode", + doneName = done++; + + return combinator.first ? + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from dir caching + if ( xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || (elem[ expando ] = {}); + if ( (oldCache = outerCache[ dir ]) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return (newCache[ 2 ] = oldCache[ 2 ]); + } else { + // Reuse newcache so results back-propagate to previous elements + outerCache[ dir ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( (newCache[ 2 ] = matcher( elem, context, xml )) ) { + return true; + } + } + } + } + } + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[i]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[0]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[i], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( (elem = unmatched[i]) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction(function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( (elem = temp[i]) ) { + matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) ) { + // Restore matcherIn since elem is not yet a final match + temp.push( (matcherIn[i] = elem) ); + } + } + postFinder( null, (matcherOut = []), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) && + (temp = postFinder ? indexOf.call( seed, elem ) : preMap[i]) > -1 ) { + + seed[temp] = !(results[temp] = elem); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + }); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[0].type ], + implicitRelative = leadingRelative || Expr.relative[" "], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf.call( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + return ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + (checkContext = context).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + } ]; + + for ( ; i < len; i++ ) { + if ( (matcher = Expr.relative[ tokens[i].type ]) ) { + matchers = [ addCombinator(elementMatcher( matchers ), matcher) ]; + } else { + matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[j].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" }) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( (tokens = tokens.slice( j )) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find["TAG"]( "*", outermost ), + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1), + len = elems.length; + + if ( outermost ) { + outermostContext = context !== document && context; + } + + // Add elements passing elementMatchers directly to results + // Keep `i` a string if there are no elements so `matchedCount` will be "00" below + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && (elem = elems[i]) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + while ( (matcher = elementMatchers[j++]) ) { + if ( matcher( elem, context, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + // They will have gone through all possible matchers + if ( (elem = !matcher && elem) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // Apply set filters to unmatched elements + matchedCount += i; + if ( bySet && i !== matchedCount ) { + j = 0; + while ( (matcher = setMatchers[j++]) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !(unmatched[i] || setMatched[i]) ) { + setMatched[i] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[i] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( (selector = compiled.selector || selector) ); + + results = results || []; + + // Try to minimize operations if there is no seed and only one group + if ( match.length === 1 ) { + + // Take a shortcut and set the context if the root selector is an ID + tokens = match[0] = match[0].slice( 0 ); + if ( tokens.length > 2 && (token = tokens[0]).type === "ID" && + support.getById && context.nodeType === 9 && documentIsHTML && + Expr.relative[ tokens[1].type ] ) { + + context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[i]; + + // Abort if we hit a combinator + if ( Expr.relative[ (type = token.type) ] ) { + break; + } + if ( (find = Expr.find[ type ]) ) { + // Search, expanding context for leading sibling combinators + if ( (seed = find( + token.matches[0].replace( runescape, funescape ), + rsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context + )) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split("").sort( sortOrder ).join("") === expando; + +// Support: Chrome<14 +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert(function( div1 ) { + // Should return 1, but returns 4 (following) + return div1.compareDocumentPosition( document.createElement("div") ) & 1; +}); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// http://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert(function( div ) { + div.innerHTML = ""; + return div.firstChild.getAttribute("href") === "#" ; +}) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + }); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert(function( div ) { + div.innerHTML = ""; + div.firstChild.setAttribute( "value", "" ); + return div.firstChild.getAttribute( "value" ) === ""; +}) ) { + addHandle( "value", function( elem, name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + }); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert(function( div ) { + return div.getAttribute("disabled") == null; +}) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + (val = elem.getAttributeNode( name )) && val.specified ? + val.value : + null; + } + }); +} + +return Sizzle; + +})( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; +jQuery.expr[":"] = jQuery.expr.pseudos; +jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; + + + +var rneedsContext = jQuery.expr.match.needsContext; + +var rsingleTag = (/^<(\w+)\s*\/?>(?:<\/\1>|)$/); + + + +var risSimple = /^.[^:#\[\.,]*$/; + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + /* jshint -W018 */ + return !!qualifier.call( elem, i, elem ) !== not; + }); + + } + + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + }); + + } + + if ( typeof qualifier === "string" ) { + if ( risSimple.test( qualifier ) ) { + return jQuery.filter( qualifier, elements, not ); + } + + qualifier = jQuery.filter( qualifier, elements ); + } + + return jQuery.grep( elements, function( elem ) { + return ( jQuery.inArray( elem, qualifier ) >= 0 ) !== not; + }); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + return elems.length === 1 && elem.nodeType === 1 ? + jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [] : + jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + })); +}; + +jQuery.fn.extend({ + find: function( selector ) { + var i, + ret = [], + self = this, + len = self.length; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter(function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + }) ); + } + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + // Needed because $( selector, context ) becomes $( context ).find( selector ) + ret = this.pushStack( len > 1 ? jQuery.unique( ret ) : ret ); + ret.selector = this.selector ? this.selector + " " + selector : selector; + return ret; + }, + filter: function( selector ) { + return this.pushStack( winnow(this, selector || [], false) ); + }, + not: function( selector ) { + return this.pushStack( winnow(this, selector || [], true) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +}); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // Use the correct document accordingly with window argument (sandbox) + document = window.document, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/, + + init = jQuery.fn.init = function( selector, context ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && (match[1] || !context) ) { + + // HANDLE: $(html) -> $(array) + if ( match[1] ) { + context = context instanceof jQuery ? context[0] : context; + + // scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[1], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + // Properties of context are called as methods if possible + if ( jQuery.isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[2] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id !== match[2] ) { + return rootjQuery.find( selector ); + } + + // Otherwise, we inject the element directly into the jQuery object + this.length = 1; + this[0] = elem; + } + + this.context = document; + this.selector = selector; + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || rootjQuery ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this.context = this[0] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return typeof rootjQuery.ready !== "undefined" ? + rootjQuery.ready( selector ) : + // Execute immediately if ready is not present + selector( jQuery ); + } + + if ( selector.selector !== undefined ) { + this.selector = selector.selector; + this.context = selector.context; + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + // methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.extend({ + dir: function( elem, dir, until ) { + var matched = [], + cur = elem[ dir ]; + + while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { + if ( cur.nodeType === 1 ) { + matched.push( cur ); + } + cur = cur[dir]; + } + return matched; + }, + + sibling: function( n, elem ) { + var r = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + r.push( n ); + } + } + + return r; + } +}); + +jQuery.fn.extend({ + has: function( target ) { + var i, + targets = jQuery( target, this ), + len = targets.length; + + return this.filter(function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( this, targets[i] ) ) { + return true; + } + } + }); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + pos = rneedsContext.test( selectors ) || typeof selectors !== "string" ? + jQuery( selectors, context || this.context ) : + 0; + + for ( ; i < l; i++ ) { + for ( cur = this[i]; cur && cur !== context; cur = cur.parentNode ) { + // Always skip document fragments + if ( cur.nodeType < 11 && (pos ? + pos.index(cur) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector(cur, selectors)) ) { + + matched.push( cur ); + break; + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.unique( matched ) : matched ); + }, + + // Determine the position of an element within + // the matched set of elements + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[0] && this[0].parentNode ) ? this.first().prevAll().length : -1; + } + + // index in selector + if ( typeof elem === "string" ) { + return jQuery.inArray( this[0], jQuery( elem ) ); + } + + // Locate the position of the desired element + return jQuery.inArray( + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[0] : elem, this ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.unique( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter(selector) + ); + } +}); + +function sibling( cur, dir ) { + do { + cur = cur[ dir ]; + } while ( cur && cur.nodeType !== 1 ); + + return cur; +} + +jQuery.each({ + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return jQuery.dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return jQuery.dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return jQuery.dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return jQuery.dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return jQuery.dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return jQuery.dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return jQuery.sibling( elem.firstChild ); + }, + contents: function( elem ) { + return jQuery.nodeName( elem, "iframe" ) ? + elem.contentDocument || elem.contentWindow.document : + jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var ret = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + ret = jQuery.filter( selector, ret ); + } + + if ( this.length > 1 ) { + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + ret = jQuery.unique( ret ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + ret = ret.reverse(); + } + } + + return this.pushStack( ret ); + }; +}); +var rnotwhite = (/\S+/g); + + + +// String to Object options format cache +var optionsCache = {}; + +// Convert String-formatted options into Object-formatted ones and store in cache +function createOptions( options ) { + var object = optionsCache[ options ] = {}; + jQuery.each( options.match( rnotwhite ) || [], function( _, flag ) { + object[ flag ] = true; + }); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + ( optionsCache[ options ] || createOptions( options ) ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + // Last fire value (for non-forgettable lists) + memory, + // Flag to know if list was already fired + fired, + // End of the loop when firing + firingLength, + // Index of currently firing callback (modified by remove if needed) + firingIndex, + // First callback to fire (used internally by add and fireWith) + firingStart, + // Actual callback list + list = [], + // Stack of fire calls for repeatable lists + stack = !options.once && [], + // Fire callbacks + fire = function( data ) { + memory = options.memory && data; + fired = true; + firingIndex = firingStart || 0; + firingStart = 0; + firingLength = list.length; + firing = true; + for ( ; list && firingIndex < firingLength; firingIndex++ ) { + if ( list[ firingIndex ].apply( data[ 0 ], data[ 1 ] ) === false && options.stopOnFalse ) { + memory = false; // To prevent further calls using add + break; + } + } + firing = false; + if ( list ) { + if ( stack ) { + if ( stack.length ) { + fire( stack.shift() ); + } + } else if ( memory ) { + list = []; + } else { + self.disable(); + } + } + }, + // Actual Callbacks object + self = { + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + // First, we save the current length + var start = list.length; + (function add( args ) { + jQuery.each( args, function( _, arg ) { + var type = jQuery.type( arg ); + if ( type === "function" ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && type !== "string" ) { + // Inspect recursively + add( arg ); + } + }); + })( arguments ); + // Do we need to add the callbacks to the + // current firing batch? + if ( firing ) { + firingLength = list.length; + // With memory, if we're not firing then + // we should call right away + } else if ( memory ) { + firingStart = start; + fire( memory ); + } + } + return this; + }, + // Remove a callback from the list + remove: function() { + if ( list ) { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + // Handle firing indexes + if ( firing ) { + if ( index <= firingLength ) { + firingLength--; + } + if ( index <= firingIndex ) { + firingIndex--; + } + } + } + }); + } + return this; + }, + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? jQuery.inArray( fn, list ) > -1 : !!( list && list.length ); + }, + // Remove all callbacks from the list + empty: function() { + list = []; + firingLength = 0; + return this; + }, + // Have the list do nothing anymore + disable: function() { + list = stack = memory = undefined; + return this; + }, + // Is it disabled? + disabled: function() { + return !list; + }, + // Lock the list in its current state + lock: function() { + stack = undefined; + if ( !memory ) { + self.disable(); + } + return this; + }, + // Is it locked? + locked: function() { + return !stack; + }, + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( list && ( !fired || stack ) ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + if ( firing ) { + stack.push( args ); + } else { + fire( args ); + } + } + return this; + }, + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +jQuery.extend({ + + Deferred: function( func ) { + var tuples = [ + // action, add listener, listener list, final state + [ "resolve", "done", jQuery.Callbacks("once memory"), "resolved" ], + [ "reject", "fail", jQuery.Callbacks("once memory"), "rejected" ], + [ "notify", "progress", jQuery.Callbacks("memory") ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + then: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + return jQuery.Deferred(function( newDefer ) { + jQuery.each( tuples, function( i, tuple ) { + var fn = jQuery.isFunction( fns[ i ] ) && fns[ i ]; + // deferred[ done | fail | progress ] for forwarding actions to newDefer + deferred[ tuple[1] ](function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && jQuery.isFunction( returned.promise ) ) { + returned.promise() + .done( newDefer.resolve ) + .fail( newDefer.reject ) + .progress( newDefer.notify ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( this === promise ? newDefer.promise() : this, fn ? [ returned ] : arguments ); + } + }); + }); + fns = null; + }).promise(); + }, + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Keep pipe for back-compat + promise.pipe = promise.then; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 3 ]; + + // promise[ done | fail | progress ] = list.add + promise[ tuple[1] ] = list.add; + + // Handle state + if ( stateString ) { + list.add(function() { + // state = [ resolved | rejected ] + state = stateString; + + // [ reject_list | resolve_list ].disable; progress_list.lock + }, tuples[ i ^ 1 ][ 2 ].disable, tuples[ 2 ][ 2 ].lock ); + } + + // deferred[ resolve | reject | notify ] + deferred[ tuple[0] ] = function() { + deferred[ tuple[0] + "With" ]( this === deferred ? promise : this, arguments ); + return this; + }; + deferred[ tuple[0] + "With" ] = list.fireWith; + }); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( subordinate /* , ..., subordinateN */ ) { + var i = 0, + resolveValues = slice.call( arguments ), + length = resolveValues.length, + + // the count of uncompleted subordinates + remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0, + + // the master Deferred. If resolveValues consist of only a single Deferred, just use that. + deferred = remaining === 1 ? subordinate : jQuery.Deferred(), + + // Update function for both resolve and progress values + updateFunc = function( i, contexts, values ) { + return function( value ) { + contexts[ i ] = this; + values[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( values === progressValues ) { + deferred.notifyWith( contexts, values ); + + } else if ( !(--remaining) ) { + deferred.resolveWith( contexts, values ); + } + }; + }, + + progressValues, progressContexts, resolveContexts; + + // add listeners to Deferred subordinates; treat others as resolved + if ( length > 1 ) { + progressValues = new Array( length ); + progressContexts = new Array( length ); + resolveContexts = new Array( length ); + for ( ; i < length; i++ ) { + if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) { + resolveValues[ i ].promise() + .done( updateFunc( i, resolveContexts, resolveValues ) ) + .fail( deferred.reject ) + .progress( updateFunc( i, progressContexts, progressValues ) ); + } else { + --remaining; + } + } + } + + // if we're not waiting on anything, resolve the master + if ( !remaining ) { + deferred.resolveWith( resolveContexts, resolveValues ); + } + + return deferred.promise(); + } +}); + + +// The deferred used on DOM ready +var readyList; + +jQuery.fn.ready = function( fn ) { + // Add the callback + jQuery.ready.promise().done( fn ); + + return this; +}; + +jQuery.extend({ + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Hold (or release) the ready event + holdReady: function( hold ) { + if ( hold ) { + jQuery.readyWait++; + } else { + jQuery.ready( true ); + } + }, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( !document.body ) { + return setTimeout( jQuery.ready ); + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + + // Trigger any bound ready events + if ( jQuery.fn.triggerHandler ) { + jQuery( document ).triggerHandler( "ready" ); + jQuery( document ).off( "ready" ); + } + } +}); + +/** + * Clean-up method for dom ready events + */ +function detach() { + if ( document.addEventListener ) { + document.removeEventListener( "DOMContentLoaded", completed, false ); + window.removeEventListener( "load", completed, false ); + + } else { + document.detachEvent( "onreadystatechange", completed ); + window.detachEvent( "onload", completed ); + } +} + +/** + * The ready event handler and self cleanup method + */ +function completed() { + // readyState === "complete" is good enough for us to call the dom ready in oldIE + if ( document.addEventListener || event.type === "load" || document.readyState === "complete" ) { + detach(); + jQuery.ready(); + } +} + +jQuery.ready.promise = function( obj ) { + if ( !readyList ) { + + readyList = jQuery.Deferred(); + + // Catch cases where $(document).ready() is called after the browser event has already occurred. + // we once tried to use readyState "interactive" here, but it caused issues like the one + // discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15 + if ( document.readyState === "complete" ) { + // Handle it asynchronously to allow scripts the opportunity to delay ready + setTimeout( jQuery.ready ); + + // Standards-based browsers support DOMContentLoaded + } else if ( document.addEventListener ) { + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed, false ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed, false ); + + // If IE event model is used + } else { + // Ensure firing before onload, maybe late but safe also for iframes + document.attachEvent( "onreadystatechange", completed ); + + // A fallback to window.onload, that will always work + window.attachEvent( "onload", completed ); + + // If IE and not a frame + // continually check to see if the document is ready + var top = false; + + try { + top = window.frameElement == null && document.documentElement; + } catch(e) {} + + if ( top && top.doScroll ) { + (function doScrollCheck() { + if ( !jQuery.isReady ) { + + try { + // Use the trick by Diego Perini + // http://javascript.nwbox.com/IEContentLoaded/ + top.doScroll("left"); + } catch(e) { + return setTimeout( doScrollCheck, 50 ); + } + + // detach all dom ready events + detach(); + + // and execute any waiting functions + jQuery.ready(); + } + })(); + } + } + } + return readyList.promise( obj ); +}; + + +var strundefined = typeof undefined; + + + +// Support: IE<9 +// Iteration over object's inherited properties before its own +var i; +for ( i in jQuery( support ) ) { + break; +} +support.ownLast = i !== "0"; + +// Note: most support tests are defined in their respective modules. +// false until the test is run +support.inlineBlockNeedsLayout = false; + +// Execute ASAP in case we need to set body.style.zoom +jQuery(function() { + // Minified: var a,b,c,d + var val, div, body, container; + + body = document.getElementsByTagName( "body" )[ 0 ]; + if ( !body || !body.style ) { + // Return for frameset docs that don't have a body + return; + } + + // Setup + div = document.createElement( "div" ); + container = document.createElement( "div" ); + container.style.cssText = "position:absolute;border:0;width:0;height:0;top:0;left:-9999px"; + body.appendChild( container ).appendChild( div ); + + if ( typeof div.style.zoom !== strundefined ) { + // Support: IE<8 + // Check if natively block-level elements act like inline-block + // elements when setting their display to 'inline' and giving + // them layout + div.style.cssText = "display:inline;margin:0;border:0;padding:1px;width:1px;zoom:1"; + + support.inlineBlockNeedsLayout = val = div.offsetWidth === 3; + if ( val ) { + // Prevent IE 6 from affecting layout for positioned elements #11048 + // Prevent IE from shrinking the body in IE 7 mode #12869 + // Support: IE<8 + body.style.zoom = 1; + } + } + + body.removeChild( container ); +}); + + + + +(function() { + var div = document.createElement( "div" ); + + // Execute the test only if not already executed in another module. + if (support.deleteExpando == null) { + // Support: IE<9 + support.deleteExpando = true; + try { + delete div.test; + } catch( e ) { + support.deleteExpando = false; + } + } + + // Null elements to avoid leaks in IE. + div = null; +})(); + + +/** + * Determines whether an object can have data + */ +jQuery.acceptData = function( elem ) { + var noData = jQuery.noData[ (elem.nodeName + " ").toLowerCase() ], + nodeType = +elem.nodeType || 1; + + // Do not set data on non-element DOM nodes because it will not be cleared (#8335). + return nodeType !== 1 && nodeType !== 9 ? + false : + + // Nodes accept data unless otherwise specified; rejection can be conditional + !noData || noData !== true && elem.getAttribute("classid") === noData; +}; + + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /([A-Z])/g; + +function dataAttr( elem, key, data ) { + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + + var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); + + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = data === "true" ? true : + data === "false" ? false : + data === "null" ? null : + // Only convert to a number if it doesn't change the string + +data + "" === data ? +data : + rbrace.test( data ) ? jQuery.parseJSON( data ) : + data; + } catch( e ) {} + + // Make sure we set the data so it isn't changed later + jQuery.data( elem, key, data ); + + } else { + data = undefined; + } + } + + return data; +} + +// checks a cache object for emptiness +function isEmptyDataObject( obj ) { + var name; + for ( name in obj ) { + + // if the public data object is empty, the private is still empty + if ( name === "data" && jQuery.isEmptyObject( obj[name] ) ) { + continue; + } + if ( name !== "toJSON" ) { + return false; + } + } + + return true; +} + +function internalData( elem, name, data, pvt /* Internal Use Only */ ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var ret, thisCache, + internalKey = jQuery.expando, + + // We have to handle DOM nodes and JS objects differently because IE6-7 + // can't GC object references properly across the DOM-JS boundary + isNode = elem.nodeType, + + // Only DOM nodes need the global jQuery cache; JS object data is + // attached directly to the object so GC can occur automatically + cache = isNode ? jQuery.cache : elem, + + // Only defining an ID for JS objects if its cache already exists allows + // the code to shortcut on the same path as a DOM node with no cache + id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey; + + // Avoid doing any more work than we need to when trying to get data on an + // object that has no data at all + if ( (!id || !cache[id] || (!pvt && !cache[id].data)) && data === undefined && typeof name === "string" ) { + return; + } + + if ( !id ) { + // Only DOM nodes need a new unique ID for each element since their data + // ends up in the global cache + if ( isNode ) { + id = elem[ internalKey ] = deletedIds.pop() || jQuery.guid++; + } else { + id = internalKey; + } + } + + if ( !cache[ id ] ) { + // Avoid exposing jQuery metadata on plain JS objects when the object + // is serialized using JSON.stringify + cache[ id ] = isNode ? {} : { toJSON: jQuery.noop }; + } + + // An object can be passed to jQuery.data instead of a key/value pair; this gets + // shallow copied over onto the existing cache + if ( typeof name === "object" || typeof name === "function" ) { + if ( pvt ) { + cache[ id ] = jQuery.extend( cache[ id ], name ); + } else { + cache[ id ].data = jQuery.extend( cache[ id ].data, name ); + } + } + + thisCache = cache[ id ]; + + // jQuery data() is stored in a separate object inside the object's internal data + // cache in order to avoid key collisions between internal data and user-defined + // data. + if ( !pvt ) { + if ( !thisCache.data ) { + thisCache.data = {}; + } + + thisCache = thisCache.data; + } + + if ( data !== undefined ) { + thisCache[ jQuery.camelCase( name ) ] = data; + } + + // Check for both converted-to-camel and non-converted data property names + // If a data property was specified + if ( typeof name === "string" ) { + + // First Try to find as-is property data + ret = thisCache[ name ]; + + // Test for null|undefined property data + if ( ret == null ) { + + // Try to find the camelCased property + ret = thisCache[ jQuery.camelCase( name ) ]; + } + } else { + ret = thisCache; + } + + return ret; +} + +function internalRemoveData( elem, name, pvt ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var thisCache, i, + isNode = elem.nodeType, + + // See jQuery.data for more information + cache = isNode ? jQuery.cache : elem, + id = isNode ? elem[ jQuery.expando ] : jQuery.expando; + + // If there is already no cache entry for this object, there is no + // purpose in continuing + if ( !cache[ id ] ) { + return; + } + + if ( name ) { + + thisCache = pvt ? cache[ id ] : cache[ id ].data; + + if ( thisCache ) { + + // Support array or space separated string names for data keys + if ( !jQuery.isArray( name ) ) { + + // try the string as a key before any manipulation + if ( name in thisCache ) { + name = [ name ]; + } else { + + // split the camel cased version by spaces unless a key with the spaces exists + name = jQuery.camelCase( name ); + if ( name in thisCache ) { + name = [ name ]; + } else { + name = name.split(" "); + } + } + } else { + // If "name" is an array of keys... + // When data is initially created, via ("key", "val") signature, + // keys will be converted to camelCase. + // Since there is no way to tell _how_ a key was added, remove + // both plain key and camelCase key. #12786 + // This will only penalize the array argument path. + name = name.concat( jQuery.map( name, jQuery.camelCase ) ); + } + + i = name.length; + while ( i-- ) { + delete thisCache[ name[i] ]; + } + + // If there is no data left in the cache, we want to continue + // and let the cache object itself get destroyed + if ( pvt ? !isEmptyDataObject(thisCache) : !jQuery.isEmptyObject(thisCache) ) { + return; + } + } + } + + // See jQuery.data for more information + if ( !pvt ) { + delete cache[ id ].data; + + // Don't destroy the parent cache unless the internal data object + // had been the only thing left in it + if ( !isEmptyDataObject( cache[ id ] ) ) { + return; + } + } + + // Destroy the cache + if ( isNode ) { + jQuery.cleanData( [ elem ], true ); + + // Use delete when supported for expandos or `cache` is not a window per isWindow (#10080) + /* jshint eqeqeq: false */ + } else if ( support.deleteExpando || cache != cache.window ) { + /* jshint eqeqeq: true */ + delete cache[ id ]; + + // When all else fails, null + } else { + cache[ id ] = null; + } +} + +jQuery.extend({ + cache: {}, + + // The following elements (space-suffixed to avoid Object.prototype collisions) + // throw uncatchable exceptions if you attempt to set expando properties + noData: { + "applet ": true, + "embed ": true, + // ...but Flash objects (which have this classid) *can* handle expandos + "object ": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" + }, + + hasData: function( elem ) { + elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; + return !!elem && !isEmptyDataObject( elem ); + }, + + data: function( elem, name, data ) { + return internalData( elem, name, data ); + }, + + removeData: function( elem, name ) { + return internalRemoveData( elem, name ); + }, + + // For internal use only. + _data: function( elem, name, data ) { + return internalData( elem, name, data, true ); + }, + + _removeData: function( elem, name ) { + return internalRemoveData( elem, name, true ); + } +}); + +jQuery.fn.extend({ + data: function( key, value ) { + var i, name, data, + elem = this[0], + attrs = elem && elem.attributes; + + // Special expections of .data basically thwart jQuery.access, + // so implement the relevant behavior ourselves + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = jQuery.data( elem ); + + if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE11+ + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = jQuery.camelCase( name.slice(5) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + jQuery._data( elem, "parsedAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each(function() { + jQuery.data( this, key ); + }); + } + + return arguments.length > 1 ? + + // Sets one value + this.each(function() { + jQuery.data( this, key, value ); + }) : + + // Gets one value + // Try to fetch any internally stored data first + elem ? dataAttr( elem, key, jQuery.data( elem, key ) ) : undefined; + }, + + removeData: function( key ) { + return this.each(function() { + jQuery.removeData( this, key ); + }); + } +}); + + +jQuery.extend({ + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = jQuery._data( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || jQuery.isArray(data) ) { + queue = jQuery._data( elem, type, jQuery.makeArray(data) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // not intended for public consumption - generates a queueHooks object, or returns the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return jQuery._data( elem, key ) || jQuery._data( elem, key, { + empty: jQuery.Callbacks("once memory").add(function() { + jQuery._removeData( elem, type + "queue" ); + jQuery._removeData( elem, key ); + }) + }); + } +}); + +jQuery.fn.extend({ + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[0], type ); + } + + return data === undefined ? + this : + this.each(function() { + var queue = jQuery.queue( this, type, data ); + + // ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[0] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + }); + }, + dequeue: function( type ) { + return this.each(function() { + jQuery.dequeue( this, type ); + }); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = jQuery._data( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +}); +var pnum = (/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/).source; + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var isHidden = function( elem, el ) { + // isHidden might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + return jQuery.css( elem, "display" ) === "none" || !jQuery.contains( elem.ownerDocument, elem ); + }; + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = jQuery.access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + length = elems.length, + bulk = key == null; + + // Sets many values + if ( jQuery.type( key ) === "object" ) { + chainable = true; + for ( i in key ) { + jQuery.access( elems, fn, i, key[i], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !jQuery.isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < length; i++ ) { + fn( elems[i], key, raw ? value : value.call( elems[i], i, fn( elems[i], key ) ) ); + } + } + } + + return chainable ? + elems : + + // Gets + bulk ? + fn.call( elems ) : + length ? fn( elems[0], key ) : emptyGet; +}; +var rcheckableType = (/^(?:checkbox|radio)$/i); + + + +(function() { + // Minified: var a,b,c + var input = document.createElement( "input" ), + div = document.createElement( "div" ), + fragment = document.createDocumentFragment(); + + // Setup + div.innerHTML = "
a"; + + // IE strips leading whitespace when .innerHTML is used + support.leadingWhitespace = div.firstChild.nodeType === 3; + + // Make sure that tbody elements aren't automatically inserted + // IE will insert them into empty tables + support.tbody = !div.getElementsByTagName( "tbody" ).length; + + // Make sure that link elements get serialized correctly by innerHTML + // This requires a wrapper element in IE + support.htmlSerialize = !!div.getElementsByTagName( "link" ).length; + + // Makes sure cloning an html5 element does not cause problems + // Where outerHTML is undefined, this still works + support.html5Clone = + document.createElement( "nav" ).cloneNode( true ).outerHTML !== "<:nav>"; + + // Check if a disconnected checkbox will retain its checked + // value of true after appended to the DOM (IE6/7) + input.type = "checkbox"; + input.checked = true; + fragment.appendChild( input ); + support.appendChecked = input.checked; + + // Make sure textarea (and checkbox) defaultValue is properly cloned + // Support: IE6-IE11+ + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // #11217 - WebKit loses check when the name is after the checked attribute + fragment.appendChild( div ); + div.innerHTML = ""; + + // Support: Safari 5.1, iOS 5.1, Android 4.x, Android 2.3 + // old WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE<9 + // Opera does not clone events (and typeof div.attachEvent === undefined). + // IE9-10 clones events bound via attachEvent, but they don't trigger with .click() + support.noCloneEvent = true; + if ( div.attachEvent ) { + div.attachEvent( "onclick", function() { + support.noCloneEvent = false; + }); + + div.cloneNode( true ).click(); + } + + // Execute the test only if not already executed in another module. + if (support.deleteExpando == null) { + // Support: IE<9 + support.deleteExpando = true; + try { + delete div.test; + } catch( e ) { + support.deleteExpando = false; + } + } +})(); + + +(function() { + var i, eventName, + div = document.createElement( "div" ); + + // Support: IE<9 (lack submit/change bubble), Firefox 23+ (lack focusin event) + for ( i in { submit: true, change: true, focusin: true }) { + eventName = "on" + i; + + if ( !(support[ i + "Bubbles" ] = eventName in window) ) { + // Beware of CSP restrictions (https://developer.mozilla.org/en/Security/CSP) + div.setAttribute( eventName, "t" ); + support[ i + "Bubbles" ] = div.attributes[ eventName ].expando === false; + } + } + + // Null elements to avoid leaks in IE. + div = null; +})(); + + +var rformElems = /^(?:input|select|textarea)$/i, + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|pointer|contextmenu)|click/, + rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + rtypenamespace = /^([^.]*)(?:\.(.+)|)$/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + var tmp, events, t, handleObjIn, + special, eventHandle, handleObj, + handlers, type, namespaces, origType, + elemData = jQuery._data( elem ); + + // Don't attach events to noData or text/comment nodes (but allow plain objects) + if ( !elemData ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !(events = elemData.events) ) { + events = elemData.events = {}; + } + if ( !(eventHandle = elemData.handle) ) { + eventHandle = elemData.handle = function( e ) { + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== strundefined && (!e || jQuery.event.triggered !== e.type) ? + jQuery.event.dispatch.apply( eventHandle.elem, arguments ) : + undefined; + }; + // Add elem as a property of the handle fn to prevent a memory leak with IE non-native events + eventHandle.elem = elem; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnotwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[t] ) || []; + type = origType = tmp[1]; + namespaces = ( tmp[2] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend({ + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join(".") + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !(handlers = events[ type ]) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener/attachEvent if the special events handler returns false + if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + // Bind the global event handler to the element + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle, false ); + + } else if ( elem.attachEvent ) { + elem.attachEvent( "on" + type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + // Nullify elem to prevent memory leaks in IE + elem = null; + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + var j, handleObj, tmp, + origCount, t, events, + special, handlers, type, + namespaces, origType, + elemData = jQuery.hasData( elem ) && jQuery._data( elem ); + + if ( !elemData || !(events = elemData.events) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnotwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[t] ) || []; + type = origType = tmp[1]; + namespaces = ( tmp[2] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[2] && new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + delete elemData.handle; + + // removeData also checks for emptiness and clears the expando if empty + // so use it instead of delete + jQuery._removeData( elem, "events" ); + } + }, + + trigger: function( event, data, elem, onlyHandlers ) { + var handle, ontype, cur, + bubbleType, special, tmp, i, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split(".") : []; + + cur = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf(".") >= 0 ) { + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split("."); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf(":") < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join("."); + event.namespace_re = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === (elem.ownerDocument || document) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( (cur = eventPath[i++]) && !event.isPropagationStopped() ) { + + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( jQuery._data( cur, "events" ) || {} )[ event.type ] && jQuery._data( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && jQuery.acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( (!special._default || special._default.apply( eventPath.pop(), data ) === false) && + jQuery.acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name name as the event. + // Can't use an .isFunction() check here because IE6/7 fails that test. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && elem[ type ] && !jQuery.isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + try { + elem[ type ](); + } catch ( e ) { + // IE<9 dies on focus/blur to hidden element (#1486,#12518) + // only reproducible on winXP IE8 native, not IE9 in IE8 mode + } + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + dispatch: function( event ) { + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( event ); + + var i, ret, handleObj, matched, j, + handlerQueue = [], + args = slice.call( arguments ), + handlers = ( jQuery._data( this, "events" ) || {} )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[0] = event; + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( (matched = handlerQueue[ i++ ]) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( (handleObj = matched.handlers[ j++ ]) && !event.isImmediatePropagationStopped() ) { + + // Triggered event must either 1) have no namespace, or + // 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace). + if ( !event.namespace_re || event.namespace_re.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler ) + .apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( (event.result = ret) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var sel, handleObj, matches, i, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + // Black-hole SVG instance trees (#13180) + // Avoid non-left-click bubbling in Firefox (#3861) + if ( delegateCount && cur.nodeType && (!event.button || event.type !== "click") ) { + + /* jshint eqeqeq: false */ + for ( ; cur != this; cur = cur.parentNode || this ) { + /* jshint eqeqeq: true */ + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && (cur.disabled !== true || event.type !== "click") ) { + matches = []; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matches[ sel ] === undefined ) { + matches[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) >= 0 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matches[ sel ] ) { + matches.push( handleObj ); + } + } + if ( matches.length ) { + handlerQueue.push({ elem: cur, handlers: matches }); + } + } + } + } + + // Add the remaining (directly-bound) handlers + if ( delegateCount < handlers.length ) { + handlerQueue.push({ elem: this, handlers: handlers.slice( delegateCount ) }); + } + + return handlerQueue; + }, + + fix: function( event ) { + if ( event[ jQuery.expando ] ) { + return event; + } + + // Create a writable copy of the event object and normalize some properties + var i, prop, copy, + type = event.type, + originalEvent = event, + fixHook = this.fixHooks[ type ]; + + if ( !fixHook ) { + this.fixHooks[ type ] = fixHook = + rmouseEvent.test( type ) ? this.mouseHooks : + rkeyEvent.test( type ) ? this.keyHooks : + {}; + } + copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props; + + event = new jQuery.Event( originalEvent ); + + i = copy.length; + while ( i-- ) { + prop = copy[ i ]; + event[ prop ] = originalEvent[ prop ]; + } + + // Support: IE<9 + // Fix target property (#1925) + if ( !event.target ) { + event.target = originalEvent.srcElement || document; + } + + // Support: Chrome 23+, Safari? + // Target should not be a text node (#504, #13143) + if ( event.target.nodeType === 3 ) { + event.target = event.target.parentNode; + } + + // Support: IE<9 + // For mouse/key events, metaKey==false if it's undefined (#3368, #11328) + event.metaKey = !!event.metaKey; + + return fixHook.filter ? fixHook.filter( event, originalEvent ) : event; + }, + + // Includes some event props shared by KeyEvent and MouseEvent + props: "altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "), + + fixHooks: {}, + + keyHooks: { + props: "char charCode key keyCode".split(" "), + filter: function( event, original ) { + + // Add which for key events + if ( event.which == null ) { + event.which = original.charCode != null ? original.charCode : original.keyCode; + } + + return event; + } + }, + + mouseHooks: { + props: "button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "), + filter: function( event, original ) { + var body, eventDoc, doc, + button = original.button, + fromElement = original.fromElement; + + // Calculate pageX/Y if missing and clientX/Y available + if ( event.pageX == null && original.clientX != null ) { + eventDoc = event.target.ownerDocument || document; + doc = eventDoc.documentElement; + body = eventDoc.body; + + event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 ); + event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 ); + } + + // Add relatedTarget, if necessary + if ( !event.relatedTarget && fromElement ) { + event.relatedTarget = fromElement === event.target ? original.toElement : fromElement; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + // Note: button is not normalized, so don't use it + if ( !event.which && button !== undefined ) { + event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) ); + } + + return event; + } + }, + + special: { + load: { + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + focus: { + // Fire native event if possible so blur/focus sequence is correct + trigger: function() { + if ( this !== safeActiveElement() && this.focus ) { + try { + this.focus(); + return false; + } catch ( e ) { + // Support: IE<9 + // If we error on focus to hidden element (#1486, #12518), + // let .trigger() run the handlers + } + } + }, + delegateType: "focusin" + }, + blur: { + trigger: function() { + if ( this === safeActiveElement() && this.blur ) { + this.blur(); + return false; + } + }, + delegateType: "focusout" + }, + click: { + // For checkbox, fire native event so checked state will be right + trigger: function() { + if ( jQuery.nodeName( this, "input" ) && this.type === "checkbox" && this.click ) { + this.click(); + return false; + } + }, + + // For cross-browser consistency, don't fire native .click() on links + _default: function( event ) { + return jQuery.nodeName( event.target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + }, + + simulate: function( type, elem, event, bubble ) { + // Piggyback on a donor event to simulate a different one. + // Fake originalEvent to avoid donor's stopPropagation, but if the + // simulated event prevents default then we do the same on the donor. + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true, + originalEvent: {} + } + ); + if ( bubble ) { + jQuery.event.trigger( e, null, elem ); + } else { + jQuery.event.dispatch.call( elem, e ); + } + if ( e.isDefaultPrevented() ) { + event.preventDefault(); + } + } +}; + +jQuery.removeEvent = document.removeEventListener ? + function( elem, type, handle ) { + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle, false ); + } + } : + function( elem, type, handle ) { + var name = "on" + type; + + if ( elem.detachEvent ) { + + // #8545, #7054, preventing memory leaks for custom events in IE6-8 + // detachEvent needed property on element, by name of that event, to properly expose it to GC + if ( typeof elem[ name ] === strundefined ) { + elem[ name ] = null; + } + + elem.detachEvent( name, handle ); + } + }; + +jQuery.Event = function( src, props ) { + // Allow instantiation without the 'new' keyword + if ( !(this instanceof jQuery.Event) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + // Support: IE < 9, Android < 4.0 + src.returnValue === false ? + returnTrue : + returnFalse; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + if ( !e ) { + return; + } + + // If preventDefault exists, run it on the original event + if ( e.preventDefault ) { + e.preventDefault(); + + // Support: IE + // Otherwise set the returnValue property of the original event to false + } else { + e.returnValue = false; + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + if ( !e ) { + return; + } + // If stopPropagation exists, run it on the original event + if ( e.stopPropagation ) { + e.stopPropagation(); + } + + // Support: IE + // Set the cancelBubble property of the original event to true + e.cancelBubble = true; + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && e.stopImmediatePropagation ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Create mouseenter/leave events using mouseover/out and event-time checks +jQuery.each({ + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mousenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || (related !== target && !jQuery.contains( target, related )) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +}); + +// IE submit delegation +if ( !support.submitBubbles ) { + + jQuery.event.special.submit = { + setup: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Lazy-add a submit handler when a descendant form may potentially be submitted + jQuery.event.add( this, "click._submit keypress._submit", function( e ) { + // Node name check avoids a VML-related crash in IE (#9807) + var elem = e.target, + form = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.form : undefined; + if ( form && !jQuery._data( form, "submitBubbles" ) ) { + jQuery.event.add( form, "submit._submit", function( event ) { + event._submit_bubble = true; + }); + jQuery._data( form, "submitBubbles", true ); + } + }); + // return undefined since we don't need an event listener + }, + + postDispatch: function( event ) { + // If form was submitted by the user, bubble the event up the tree + if ( event._submit_bubble ) { + delete event._submit_bubble; + if ( this.parentNode && !event.isTrigger ) { + jQuery.event.simulate( "submit", this.parentNode, event, true ); + } + } + }, + + teardown: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Remove delegated handlers; cleanData eventually reaps submit handlers attached above + jQuery.event.remove( this, "._submit" ); + } + }; +} + +// IE change delegation and checkbox/radio fix +if ( !support.changeBubbles ) { + + jQuery.event.special.change = { + + setup: function() { + + if ( rformElems.test( this.nodeName ) ) { + // IE doesn't fire change on a check/radio until blur; trigger it on click + // after a propertychange. Eat the blur-change in special.change.handle. + // This still fires onchange a second time for check/radio after blur. + if ( this.type === "checkbox" || this.type === "radio" ) { + jQuery.event.add( this, "propertychange._change", function( event ) { + if ( event.originalEvent.propertyName === "checked" ) { + this._just_changed = true; + } + }); + jQuery.event.add( this, "click._change", function( event ) { + if ( this._just_changed && !event.isTrigger ) { + this._just_changed = false; + } + // Allow triggered, simulated change events (#11500) + jQuery.event.simulate( "change", this, event, true ); + }); + } + return false; + } + // Delegated event; lazy-add a change handler on descendant inputs + jQuery.event.add( this, "beforeactivate._change", function( e ) { + var elem = e.target; + + if ( rformElems.test( elem.nodeName ) && !jQuery._data( elem, "changeBubbles" ) ) { + jQuery.event.add( elem, "change._change", function( event ) { + if ( this.parentNode && !event.isSimulated && !event.isTrigger ) { + jQuery.event.simulate( "change", this.parentNode, event, true ); + } + }); + jQuery._data( elem, "changeBubbles", true ); + } + }); + }, + + handle: function( event ) { + var elem = event.target; + + // Swallow native change events from checkbox/radio, we already triggered them above + if ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox") ) { + return event.handleObj.handler.apply( this, arguments ); + } + }, + + teardown: function() { + jQuery.event.remove( this, "._change" ); + + return !rformElems.test( this.nodeName ); + } + }; +} + +// Create "bubbling" focus and blur events +if ( !support.focusinBubbles ) { + jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + var doc = this.ownerDocument || this, + attaches = jQuery._data( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + jQuery._data( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this, + attaches = jQuery._data( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + jQuery._removeData( doc, fix ); + } else { + jQuery._data( doc, fix, attaches ); + } + } + }; + }); +} + +jQuery.fn.extend({ + + on: function( types, selector, data, fn, /*INTERNAL*/ one ) { + var type, origFn; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + this.on( type, selector, data, types[ type ], one ); + } + return this; + } + + if ( data == null && fn == null ) { + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return this; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return this.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + }); + }, + one: function( types, selector, data, fn ) { + return this.on( types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each(function() { + jQuery.event.remove( this, types, fn, selector ); + }); + }, + + trigger: function( type, data ) { + return this.each(function() { + jQuery.event.trigger( type, data, this ); + }); + }, + triggerHandler: function( type, data ) { + var elem = this[0]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +}); + + +function createSafeFragment( document ) { + var list = nodeNames.split( "|" ), + safeFrag = document.createDocumentFragment(); + + if ( safeFrag.createElement ) { + while ( list.length ) { + safeFrag.createElement( + list.pop() + ); + } + } + return safeFrag; +} + +var nodeNames = "abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|" + + "header|hgroup|mark|meter|nav|output|progress|section|summary|time|video", + rinlinejQuery = / jQuery\d+="(?:null|\d+)"/g, + rnoshimcache = new RegExp("<(?:" + nodeNames + ")[\\s/>]", "i"), + rleadingWhitespace = /^\s+/, + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi, + rtagName = /<([\w:]+)/, + rtbody = /\s*$/g, + + // We have to close these tags to support XHTML (#13200) + wrapMap = { + option: [ 1, "" ], + legend: [ 1, "
", "
" ], + area: [ 1, "", "" ], + param: [ 1, "", "" ], + thead: [ 1, "", "
" ], + tr: [ 2, "", "
" ], + col: [ 2, "", "
" ], + td: [ 3, "", "
" ], + + // IE6-8 can't serialize link, script, style, or any html5 (NoScope) tags, + // unless wrapped in a div with non-breaking characters in front of it. + _default: support.htmlSerialize ? [ 0, "", "" ] : [ 1, "X
", "
" ] + }, + safeFragment = createSafeFragment( document ), + fragmentDiv = safeFragment.appendChild( document.createElement("div") ); + +wrapMap.optgroup = wrapMap.option; +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +function getAll( context, tag ) { + var elems, elem, + i = 0, + found = typeof context.getElementsByTagName !== strundefined ? context.getElementsByTagName( tag || "*" ) : + typeof context.querySelectorAll !== strundefined ? context.querySelectorAll( tag || "*" ) : + undefined; + + if ( !found ) { + for ( found = [], elems = context.childNodes || context; (elem = elems[i]) != null; i++ ) { + if ( !tag || jQuery.nodeName( elem, tag ) ) { + found.push( elem ); + } else { + jQuery.merge( found, getAll( elem, tag ) ); + } + } + } + + return tag === undefined || tag && jQuery.nodeName( context, tag ) ? + jQuery.merge( [ context ], found ) : + found; +} + +// Used in buildFragment, fixes the defaultChecked property +function fixDefaultChecked( elem ) { + if ( rcheckableType.test( elem.type ) ) { + elem.defaultChecked = elem.checked; + } +} + +// Support: IE<8 +// Manipulating tables requires a tbody +function manipulationTarget( elem, content ) { + return jQuery.nodeName( elem, "table" ) && + jQuery.nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ? + + elem.getElementsByTagName("tbody")[0] || + elem.appendChild( elem.ownerDocument.createElement("tbody") ) : + elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = (jQuery.find.attr( elem, "type" ) !== null) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + var match = rscriptTypeMasked.exec( elem.type ); + if ( match ) { + elem.type = match[1]; + } else { + elem.removeAttribute("type"); + } + return elem; +} + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var elem, + i = 0; + for ( ; (elem = elems[i]) != null; i++ ) { + jQuery._data( elem, "globalEval", !refElements || jQuery._data( refElements[i], "globalEval" ) ); + } +} + +function cloneCopyEvent( src, dest ) { + + if ( dest.nodeType !== 1 || !jQuery.hasData( src ) ) { + return; + } + + var type, i, l, + oldData = jQuery._data( src ), + curData = jQuery._data( dest, oldData ), + events = oldData.events; + + if ( events ) { + delete curData.handle; + curData.events = {}; + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + + // make the cloned public data object a copy from the original + if ( curData.data ) { + curData.data = jQuery.extend( {}, curData.data ); + } +} + +function fixCloneNodeIssues( src, dest ) { + var nodeName, e, data; + + // We do not need to do anything for non-Elements + if ( dest.nodeType !== 1 ) { + return; + } + + nodeName = dest.nodeName.toLowerCase(); + + // IE6-8 copies events bound via attachEvent when using cloneNode. + if ( !support.noCloneEvent && dest[ jQuery.expando ] ) { + data = jQuery._data( dest ); + + for ( e in data.events ) { + jQuery.removeEvent( dest, e, data.handle ); + } + + // Event data gets referenced instead of copied if the expando gets copied too + dest.removeAttribute( jQuery.expando ); + } + + // IE blanks contents when cloning scripts, and tries to evaluate newly-set text + if ( nodeName === "script" && dest.text !== src.text ) { + disableScript( dest ).text = src.text; + restoreScript( dest ); + + // IE6-10 improperly clones children of object elements using classid. + // IE10 throws NoModificationAllowedError if parent is null, #12132. + } else if ( nodeName === "object" ) { + if ( dest.parentNode ) { + dest.outerHTML = src.outerHTML; + } + + // This path appears unavoidable for IE9. When cloning an object + // element in IE9, the outerHTML strategy above is not sufficient. + // If the src has innerHTML and the destination does not, + // copy the src.innerHTML into the dest.innerHTML. #10324 + if ( support.html5Clone && ( src.innerHTML && !jQuery.trim(dest.innerHTML) ) ) { + dest.innerHTML = src.innerHTML; + } + + } else if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + // IE6-8 fails to persist the checked state of a cloned checkbox + // or radio button. Worse, IE6-7 fail to give the cloned element + // a checked appearance if the defaultChecked value isn't also set + + dest.defaultChecked = dest.checked = src.checked; + + // IE6-7 get confused and end up setting the value of a cloned + // checkbox/radio button to an empty string instead of "on" + if ( dest.value !== src.value ) { + dest.value = src.value; + } + + // IE6-8 fails to return the selected option to the default selected + // state when cloning options + } else if ( nodeName === "option" ) { + dest.defaultSelected = dest.selected = src.defaultSelected; + + // IE6-8 fails to set the defaultValue to the correct value when + // cloning other types of input fields + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +jQuery.extend({ + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var destElements, node, clone, i, srcElements, + inPage = jQuery.contains( elem.ownerDocument, elem ); + + if ( support.html5Clone || jQuery.isXMLDoc(elem) || !rnoshimcache.test( "<" + elem.nodeName + ">" ) ) { + clone = elem.cloneNode( true ); + + // IE<=8 does not properly clone detached, unknown element nodes + } else { + fragmentDiv.innerHTML = elem.outerHTML; + fragmentDiv.removeChild( clone = fragmentDiv.firstChild ); + } + + if ( (!support.noCloneEvent || !support.noCloneChecked) && + (elem.nodeType === 1 || elem.nodeType === 11) && !jQuery.isXMLDoc(elem) ) { + + // We eschew Sizzle here for performance reasons: http://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + // Fix all IE cloning issues + for ( i = 0; (node = srcElements[i]) != null; ++i ) { + // Ensure that the destination node is not null; Fixes #9587 + if ( destElements[i] ) { + fixCloneNodeIssues( node, destElements[i] ); + } + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0; (node = srcElements[i]) != null; i++ ) { + cloneCopyEvent( node, destElements[i] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + destElements = srcElements = node = null; + + // Return the cloned set + return clone; + }, + + buildFragment: function( elems, context, scripts, selection ) { + var j, elem, contains, + tmp, tag, tbody, wrap, + l = elems.length, + + // Ensure a safe fragment + safe = createSafeFragment( context ), + + nodes = [], + i = 0; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( jQuery.type( elem ) === "object" ) { + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || safe.appendChild( context.createElement("div") ); + + // Deserialize a standard representation + tag = (rtagName.exec( elem ) || [ "", "" ])[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + + tmp.innerHTML = wrap[1] + elem.replace( rxhtmlTag, "<$1>" ) + wrap[2]; + + // Descend through wrappers to the right content + j = wrap[0]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Manually add leading whitespace removed by IE + if ( !support.leadingWhitespace && rleadingWhitespace.test( elem ) ) { + nodes.push( context.createTextNode( rleadingWhitespace.exec( elem )[0] ) ); + } + + // Remove IE's autoinserted from table fragments + if ( !support.tbody ) { + + // String was a , *may* have spurious + elem = tag === "table" && !rtbody.test( elem ) ? + tmp.firstChild : + + // String was a bare or + wrap[1] === "
" && !rtbody.test( elem ) ? + tmp : + 0; + + j = elem && elem.childNodes.length; + while ( j-- ) { + if ( jQuery.nodeName( (tbody = elem.childNodes[j]), "tbody" ) && !tbody.childNodes.length ) { + elem.removeChild( tbody ); + } + } + } + + jQuery.merge( nodes, tmp.childNodes ); + + // Fix #12392 for WebKit and IE > 9 + tmp.textContent = ""; + + // Fix #12392 for oldIE + while ( tmp.firstChild ) { + tmp.removeChild( tmp.firstChild ); + } + + // Remember the top-level container for proper cleanup + tmp = safe.lastChild; + } + } + } + + // Fix #11356: Clear elements from fragment + if ( tmp ) { + safe.removeChild( tmp ); + } + + // Reset defaultChecked for any radios and checkboxes + // about to be appended to the DOM in IE 6/7 (#8060) + if ( !support.appendChecked ) { + jQuery.grep( getAll( nodes, "input" ), fixDefaultChecked ); + } + + i = 0; + while ( (elem = nodes[ i++ ]) ) { + + // #4087 - If origin and destination elements are the same, and this is + // that element, do not do anything + if ( selection && jQuery.inArray( elem, selection ) !== -1 ) { + continue; + } + + contains = jQuery.contains( elem.ownerDocument, elem ); + + // Append to fragment + tmp = getAll( safe.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( contains ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( (elem = tmp[ j++ ]) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + tmp = null; + + return safe; + }, + + cleanData: function( elems, /* internal */ acceptData ) { + var elem, type, id, data, + i = 0, + internalKey = jQuery.expando, + cache = jQuery.cache, + deleteExpando = support.deleteExpando, + special = jQuery.event.special; + + for ( ; (elem = elems[i]) != null; i++ ) { + if ( acceptData || jQuery.acceptData( elem ) ) { + + id = elem[ internalKey ]; + data = id && cache[ id ]; + + if ( data ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Remove cache only if it was not already removed by jQuery.event.remove + if ( cache[ id ] ) { + + delete cache[ id ]; + + // IE does not allow us to delete expando properties from nodes, + // nor does it have a removeAttribute function on Document nodes; + // we must handle all of these cases + if ( deleteExpando ) { + delete elem[ internalKey ]; + + } else if ( typeof elem.removeAttribute !== strundefined ) { + elem.removeAttribute( internalKey ); + + } else { + elem[ internalKey ] = null; + } + + deletedIds.push( id ); + } + } + } + } + } +}); + +jQuery.fn.extend({ + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) ); + }, null, value, arguments.length ); + }, + + append: function() { + return this.domManip( arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + }); + }, + + prepend: function() { + return this.domManip( arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + }); + }, + + before: function() { + return this.domManip( arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + }); + }, + + after: function() { + return this.domManip( arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + }); + }, + + remove: function( selector, keepData /* Internal Use Only */ ) { + var elem, + elems = selector ? jQuery.filter( selector, this ) : this, + i = 0; + + for ( ; (elem = elems[i]) != null; i++ ) { + + if ( !keepData && elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem ) ); + } + + if ( elem.parentNode ) { + if ( keepData && jQuery.contains( elem.ownerDocument, elem ) ) { + setGlobalEval( getAll( elem, "script" ) ); + } + elem.parentNode.removeChild( elem ); + } + } + + return this; + }, + + empty: function() { + var elem, + i = 0; + + for ( ; (elem = this[i]) != null; i++ ) { + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + } + + // Remove any remaining nodes + while ( elem.firstChild ) { + elem.removeChild( elem.firstChild ); + } + + // If this is a select, ensure that it displays empty (#12336) + // Support: IE<9 + if ( elem.options && jQuery.nodeName( elem, "select" ) ) { + elem.options.length = 0; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map(function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + }); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined ) { + return elem.nodeType === 1 ? + elem.innerHTML.replace( rinlinejQuery, "" ) : + undefined; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + ( support.htmlSerialize || !rnoshimcache.test( value ) ) && + ( support.leadingWhitespace || !rleadingWhitespace.test( value ) ) && + !wrapMap[ (rtagName.exec( value ) || [ "", "" ])[ 1 ].toLowerCase() ] ) { + + value = value.replace( rxhtmlTag, "<$1>" ); + + try { + for (; i < l; i++ ) { + // Remove element nodes and prevent memory leaks + elem = this[i] || {}; + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch(e) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var arg = arguments[ 0 ]; + + // Make the changes, replacing each context element with the new content + this.domManip( arguments, function( elem ) { + arg = this.parentNode; + + jQuery.cleanData( getAll( this ) ); + + if ( arg ) { + arg.replaceChild( elem, this ); + } + }); + + // Force removal if there was no new content (e.g., from empty arguments) + return arg && (arg.length || arg.nodeType) ? this : this.remove(); + }, + + detach: function( selector ) { + return this.remove( selector, true ); + }, + + domManip: function( args, callback ) { + + // Flatten any nested arrays + args = concat.apply( [], args ); + + var first, node, hasScripts, + scripts, doc, fragment, + i = 0, + l = this.length, + set = this, + iNoClone = l - 1, + value = args[0], + isFunction = jQuery.isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( isFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return this.each(function( index ) { + var self = set.eq( index ); + if ( isFunction ) { + args[0] = value.call( this, index, self.html() ); + } + self.domManip( args, callback ); + }); + } + + if ( l ) { + fragment = jQuery.buildFragment( args, this[ 0 ].ownerDocument, false, this ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + if ( first ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( this[i], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !jQuery._data( node, "globalEval" ) && jQuery.contains( doc, node ) ) { + + if ( node.src ) { + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl ) { + jQuery._evalUrl( node.src ); + } + } else { + jQuery.globalEval( ( node.text || node.textContent || node.innerHTML || "" ).replace( rcleanScript, "" ) ); + } + } + } + } + + // Fix #11809: Avoid leaking memory + fragment = first = null; + } + } + + return this; + } +}); + +jQuery.each({ + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + i = 0, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone(true); + jQuery( insert[i] )[ original ]( elems ); + + // Modern browsers can apply jQuery collections as arrays, but oldIE needs a .get() + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +}); + + +var iframe, + elemdisplay = {}; + +/** + * Retrieve the actual display of a element + * @param {String} name nodeName of the element + * @param {Object} doc Document object + */ +// Called only from within defaultDisplay +function actualDisplay( name, doc ) { + var style, + elem = jQuery( doc.createElement( name ) ).appendTo( doc.body ), + + // getDefaultComputedStyle might be reliably used only on attached element + display = window.getDefaultComputedStyle && ( style = window.getDefaultComputedStyle( elem[ 0 ] ) ) ? + + // Use of this method is a temporary fix (more like optmization) until something better comes along, + // since it was removed from specification and supported only in FF + style.display : jQuery.css( elem[ 0 ], "display" ); + + // We don't have any data stored on the element, + // so use "detach" method as fast way to get rid of the element + elem.detach(); + + return display; +} + +/** + * Try to determine the default display value of an element + * @param {String} nodeName + */ +function defaultDisplay( nodeName ) { + var doc = document, + display = elemdisplay[ nodeName ]; + + if ( !display ) { + display = actualDisplay( nodeName, doc ); + + // If the simple way fails, read from inside an iframe + if ( display === "none" || !display ) { + + // Use the already-created iframe if possible + iframe = (iframe || jQuery( "
+
+
+
+ +
+

ValidationFunctions

+
+
+cdutil.ValidationFunctions.checkInStringsList(self, name, value, values)[source]
+

check if value is in values

+
+ +
+
+cdutil.ValidationFunctions.checkInStringsListInt(self, name, value, values)[source]
+

checks the line type

+
+ +
+
+cdutil.ValidationFunctions.checkListNumbers(self, name, value)[source]
+

Checks to make sure a list or tuple contains values that are only numbers +:param name: string name of the value being checked +:type name: str +:param value: A list or tuple, which will be checked to determine if the contents are all numbers. +:type value: list or tuple +:returns: If value contains only numbers, value will be returned. Else, an exception is raised.

+
+ +
+
+cdutil.ValidationFunctions.checkStringOrNone(self, name, value)[source]
+

Checks to see if value is a string or None +:param name: The name of the value +:type name: str

+ +++ + + + + + +
Parameters:value (any) – The value to check the type of
Returns:If value is None or a string, value will be returned. If not, an error will be raised.
+
+ +
+
+cdutil.ValidationFunctions.setSlab(self, name, value)[source]
+

If value is a numpy ndarray or numpy MA, this function sets the object’s data field to the value. +:param name: string name of the value being checked +:type name: str +:param value: +:returns: If value is a numpy ndarray or numpy MA, returns (‘data’,value).

+
+
If value is a string, and the string is a filename in the system’s path, returns (‘file’,value). +If value is None, returns name,value.
+
+ +
+ + +
+
+
+ +
+