class_docstr: Frames matches inside a set of frames.
  
  You can instantiate it passing a list of FramesMatch objects or
  using the class methods ``load`` and ``from_clip``.
  
  Parameters
  ----------
  
  lst : list
    Iterable of FramesMatch objects.
class_docstr_tok: ["Frames","matches","inside","a","set","of","frames",".","You","can","instantiate","it","passing","a","list","of","FramesMatch","objects","or","using","the","class","methods","``","load","``","and","``","from_clip","``",".","Parameters","--","--","--","--","--","lst",":","list","Iterable","of","FramesMatch","objects","."]
docstr: Returns a new instance of FramesMatches object or a FramesMatch
  from the current class instance given different conditions.
  
  By default returns the first FramesMatch that the current instance
  stores.
  
  Parameters
  ----------
  
  n : int, optional
    Number of matches to retrieve from the current FramesMatches object.
    Only has effect when ``percent=None``.
  
  percent : float, optional
    Percent of the current match to retrieve.
  
  Returns
  -------
  
  FramesMatch or FramesMatches : If the number of matches to retrieve is
    greater than 1 returns a FramesMatches object, otherwise a
    FramesMatch.
docstr_tok: ["Returns","a","new","instance","of","FramesMatches","object","or","a","FramesMatch","from","the","current","class","instance","given","different","conditions",".","By","default","returns","the","first","FramesMatch","that","the","current","instance","stores",".","Parameters","--","--","--","--","--","n",":","int",",","optional","Number","of","matches","to","retrieve","from","the","current","FramesMatches","object",".","Only","has","effect","when","``","percent=None","``",".","percent",":","float",",","optional","Percent","of","the","current","match","to","retrieve",".","Returns","--","--","--","-","FramesMatch","or","FramesMatches",":","If","the","number","of","matches","to","retrieve","is","greater","than","1","returns","a","FramesMatches","object",",","otherwise","a","FramesMatch","."]
code: def best(self, n=1, percent=None):
      """Returns a new instance of FramesMatches object or a FramesMatch
      from the current class instance given different conditions.
  
      By default returns the first FramesMatch that the current instance
      stores.
  
      Parameters
      ----------
  
      n : int, optional
        Number of matches to retrieve from the current FramesMatches object.
        Only has effect when ``percent=None``.
  
      percent : float, optional
        Percent of the current match to retrieve.
  
      Returns
      -------
  
      FramesMatch or FramesMatches : If the number of matches to retrieve is
        greater than 1 returns a FramesMatches object, otherwise a
        FramesMatch.
  
      """
      if percent is not None:
          n = len(self) * percent / 100
      return self[0] if n == 1 else FramesMatches(self[: int(n)])
  
imports: from collections import defaultdict
  import numpy
  from moviepy.decorators import convert_parameter_to_seconds, use_clip_fps_by_default
label_desc: Use image node_id 2 for calling the FramesMatches obj's underlying member method code with example usage: obj.best(n, percent) and returns: unknown