class_docstr: The location of a subplot in a `GridSpec`.
  
  .. note::
  
      Likely, you will never instantiate a `SubplotSpec` yourself. Instead,
      you will typically obtain one from a `GridSpec` using item-access.
  
  Parameters
  ----------
  gridspec : `~matplotlib.gridspec.GridSpec`
      The GridSpec, which the subplot is referencing.
  num1, num2 : int
      The subplot will occupy the *num1*-th cell of the given
      *gridspec*.  If *num2* is provided, the subplot will span between
      *num1*-th cell and *num2*-th cell **inclusive**.
  
      The index starts from 0.
class_docstr_tok: ["The","location","of","a","subplot","in","a","`","GridSpec","`",".","..","note",":",":","Likely",",","you","will","never","instantiate","a","`","SubplotSpec","`","yourself",".","Instead",",","you","will","typically","obtain","one","from","a","`","GridSpec","`","using","item-access",".","Parameters","--","--","--","--","--","gridspec",":","`","~matplotlib.gridspec.GridSpec","`","The","GridSpec",",","which","the","subplot","is","referencing",".","num1",",","num2",":","int","The","subplot","will","occupy","the","*","num1","*","-th","cell","of","the","given","*","gridspec","*",".","If","*","num2","*","is","provided",",","the","subplot","will","span","between","*","num1","*","-th","cell","and","*","num2","*","-th","cell","*","*","inclusive","*","*",".","The","index","starts","from","0","."]
docstr: Create a GridSpec within this subplot.
  
  The created `.GridSpecFromSubplotSpec` will have this `SubplotSpec` as
  a parent.
  
  Parameters
  ----------
  nrows : int
      Number of rows in grid.
  
  ncols : int
      Number of columns in grid.
  
  Returns
  -------
  `.GridSpecFromSubplotSpec`
  
  Other Parameters
  ----------------
  **kwargs
      All other parameters are passed to `.GridSpecFromSubplotSpec`.
  
  See Also
  --------
  matplotlib.pyplot.subplots
  
  Examples
  --------
  Adding three subplots in the space occupied by a single subplot::
  
      fig = plt.figure()
      gs0 = fig.add_gridspec(3, 1)
      ax1 = fig.add_subplot(gs0[0])
      ax2 = fig.add_subplot(gs0[1])
      gssub = gs0[2].subgridspec(1, 3)
      for i in range(3):
          fig.add_subplot(gssub[0, i])
code: def subgridspec(self, nrows, ncols, **kwargs):
      """
      Create a GridSpec within this subplot.
  
      The created `.GridSpecFromSubplotSpec` will have this `SubplotSpec` as
      a parent.
  
      Parameters
      ----------
      nrows : int
          Number of rows in grid.
  
      ncols : int
          Number of columns in grid.
  
      Returns
      -------
      `.GridSpecFromSubplotSpec`
  
      Other Parameters
      ----------------
      **kwargs
          All other parameters are passed to `.GridSpecFromSubplotSpec`.
  
      See Also
      --------
      matplotlib.pyplot.subplots
  
      Examples
      --------
      Adding three subplots in the space occupied by a single subplot::
  
          fig = plt.figure()
          gs0 = fig.add_gridspec(3, 1)
          ax1 = fig.add_subplot(gs0[0])
          ax2 = fig.add_subplot(gs0[1])
          gssub = gs0[2].subgridspec(1, 3)
          for i in range(3):
              fig.add_subplot(gssub[0, i])
      """
      return GridSpecFromSubplotSpec(nrows, ncols, self, **kwargs)
  
imports: import copy
  import logging
  from numbers import Integral
  import numpy
  import matplotlib
  from matplotlib import _api, _pylab_helpers, _tight_layout
  from matplotlib.transforms import Bbox
label_desc: Use image node_id 18 for calling the SubplotSpec obj's underlying member method code with example usage: obj.subgridspec(nrows, ncols) and returns: GridSpecFromSubplotSpec