# spacepy.pybats.add_planet

`spacepy.pybats.``add_planet`(ax, rad=1.0, ang=0.0, add_night=True, zorder=1000, **extra_kwargs)

  Creates a circle of `radius=self.para['rbody']` and returns the MatPlotLib Ellipse patch object for plotting. If an axis is specified using the ax keyword, the patch is added to the plot.

  Unlike the add_body method, the circle is colored half white (dayside) and half black (nightside) to coincide with the direction of the sun. Additionally, because the size of the planet is not intrinsically known to the MHD file, the kwarg “rad”, defaulting to 1.0, sets the size of the planet. add_night can turn off this behavior.

  Extra keywords are handed to the Ellipse generator function.

  Parameters: | ax : Matplotlib Axes object Set the axes on which to place planet.
  Other Parameters:
  | rad : float Set radius of planet. Defaults to 1. ang : float Set the rotation of the day-night terminator from the y-axis, in degrees. Defaults to zero (terminator is aligned with Y-axis.) add_night : boolean Add night hemisphere. Defaults to True zorder : int Set the matplotlib zorder of the patch to set how other plot elements order with the inner boundary patch. Defaults to 1000, nightside patch is given zorder of zorder+5.