code: def register_method(func, name=None, deprecated=False):
      
      # warn about deprecated functions
      if deprecated:
          func = deprecated_function(
              func,
              "the {0!r} PSD methods is deprecated, and will be removed "
              "in a future release, please consider using {1!r} instead".format(
                  name, name.split('-', 1)[1],
              ),
          )
  
      if name is None:
          name = func.__name__
      name = _format_name(name)
      METHODS[name] = func
      return name
docs: Register a method of calculating an average spectrogram.
  
      Parameters
      ----------
      func : `callable`
          function to execute
  
      name : `str`, optional
          name of the method, defaults to ``func.__name__``
  
      deprecated : `bool`, optional
          whether this method is deprecated (`True`) or not (`False`)
  
      Returns
      -------
      name : `str`
          the registered name of the function, which may differ
          pedantically from what was given by the user.