docs: def climate_stats(self, startclim, endclim, type, **kwargs):
          r""" Returns a dictionary of aggregated yearly climate statistics (count, standard deviation,
          average, median, maximum, minimum, min time, and max time depending on user specified type) of a time series
          for a specified range of time at user specified location.  Users must specify at least one geographic search
          parameter ('stid', 'state', 'country', 'county', 'radius', 'bbox', 'cwa', 'nwsfirezone', 'gacc', or 'subgacc')
          to obtain observation data. Other parameters may also be included. See below mandatory and optional parameters.
          Also see the metadata() function for station IDs.
  
          Arguments:
          ----------
          type: string, mandatory
              Describes what statistical values will be returned. Can be one of the following values:
              "avg"/"average"/"mean", "max"/"maximum", "min"/"minimum", "stdev"/"standarddeviation"/"std", "median"/"med",
              "count", or "all". "All" will return all of the statistics.
          startclim: string, mandatory
              Start date in form of MMDDhhmm. MUST BE USED WITH THE ENDCLIM PARAMETER. Default time is UTC
              e.g. startclim=06011800 Do not specify a year.
          endclim: string, mandatory
              End date in form of MMDDhhmm. MUST BE USED WITH THE STARTCLIM PARAMETER. Default time is UTC
              e.g. endclim=06011800 Do not specify a year.
          obtimezone: string, optional
              Set to either UTC or local. Sets timezone of obs. Default is UTC. e.g. obtimezone='local'.
          showemptystations: string, optional
              Set to '1' to show stations even if no obs exist that match the time period. Stations without obs are
              omitted by default.
          stid: string, optional
              Single or comma separated list of MesoWest station IDs. e.g. stid='kden,kslc,wbb'
          county: string, optional
              County/parish/borough (US/Canada only), full name e.g. county='Larimer'
          state: string, optional
              US state, 2-letter ID e.g. state='CO'
          country: string, optional
              Single or comma separated list of abbreviated 2 or 3 character countries e.g. country='us,ca,mx'
          radius: string, optional
              Distance from a lat/lon pt or stid as [lat,lon,radius (mi)] or [stid, radius (mi)]. e.g. radius="-120,40,20"
          bbox: string, optional
              Stations within a [lon/lat] box in the order [lonmin,latmin,lonmax,latmax] e.g. bbox="-120,40,-119,41"
          cwa: string, optional
              NWS county warning area. See http://www.nws.noaa.gov/organization.php for CWA list. e.g. cwa='LOX'
          nwsfirezone: string, optional
              NWS fire zones. See http://www.nws.noaa.gov/geodata/catalog/wsom/html/firezone.htm for a shapefile
              containing the full list of zones. e.g. nwsfirezone='LOX241'
          gacc: string, optional
              Name of Geographic Area Coordination Center e.g. gacc='EBCC' See http://gacc.nifc.gov/ for a list of GACCs.
          subgacc: string, optional
              Name of Sub GACC e.g. subgacc='EB07'
          vars: string, optional
              Single or comma separated list of sensor variables. Will return all stations that match one of provided
              variables. Useful for filtering all stations that sense only certain vars. Do not request vars twice in
              the query. e.g. vars='wind_speed,pressure' Use the variables function to see a list of sensor vars.
          units: string, optional
              String or set of strings and pipes separated by commas. Default is metric units. Set units='ENGLISH' for
              FREEDOM UNITS ;) Valid  other combinations are as follows: temp|C, temp|F, temp|K; speed|mps, speed|mph,
              speed|kph, speed|kts; pres|pa, pres|mb; height|m, height|ft; precip|mm, precip|cm, precip|in; alti|pa,
              alti|inhg. e.g. units='temp|F,speed|kph,metric'
          groupby: string, optional
              Results can be grouped by key words: state, county, country, cwa, nwszone, mwsfirezone, gacc, subgacc
              e.g. groupby='state'
          timeformat: string, optional
              A python format string for returning customized date-time groups for observation times. Can include
              characters. e.g. timeformat='%m/%d/%Y at %H:%M'
  
          Returns:
          --------
              Dictionary of aggregated climatology statistics.
  
          Raises:
          -------
              None.
  
          """
  
          self._check_geo_param(kwargs)
          kwargs['type'] = type
          kwargs['startclim'] = startclim
          kwargs['endclim'] = endclim
          kwargs['token'] = self.token
  
          return self._get_response('stations/climatology', kwargs)