### Navigation

- index
- modules |
- next |
- previous |
- home|
- examples|
- tutorials|
- pyplot|
- docs »
- The Matplotlib API »
- `Axes` class »

# matplotlib.axes.Axes.axis

`Axes.``axis`(*v, **kwargs)

  Set axis properties.

  Valid signatures:

      xmin, xmax, ymin, ymax = axis()
      xmin, xmax, ymin, ymax = axis(list_arg)
      xmin, xmax, ymin, ymax = axis(string_arg)
      xmin, xmax, ymin, ymax = axis(**kwargs)

  > > Parameters: | v : list of float or {‘on’, ‘off’, ‘equal’, ‘tight’, ‘scaled’, ‘normal’, ‘auto’, ‘image’, ‘square’} Optional positional argument Axis data limits set from a list; or a command relating to axes:
  > > Value | Description
  > > --- | ---
  > > ‘on’ | Toggle axis lines and labels on
  > > ‘off’ | Toggle axis lines and labels off
  > > ‘equal’ | Equal scaling by changing limits
  > > ‘scaled’ | Equal scaling by changing box dimensions
  > > ‘tight’ | Limits set such that all data is shown
  > > ‘auto’ | Automatic scaling, fill rectangle with data
  > > ‘normal’ | Same as ‘auto’; deprecated
  > > ‘image’ | ‘scaled’ with axis limits equal to data limits
  > > ‘square’ | Square plot; similar to ‘scaled’, but initially forcing xmax-xmin = ymax-ymin
  emit : bool, optional Passed to set_{x,y}lim functions, if observers are notified of axis limit change xmin, ymin, xmax, ymax : float, optional The axis limits to be set
  Returns: | xmin, xmax, ymin, ymax : float The axis limits