# spacepy.plot.dual_half_circle

`spacepy.plot.``dual_half_circle`(center=(0, 0), radius=1.0, sun_direction='right', ax=None, colors=('w', 'k'), **kwargs)

  Plot two half circles to a plot with the specified face colors and rotation. This is normal to use to denote the sun direction in magnetospheric science plots.

  Returns
    out tuple

      Tuple of the two wedge objects

  Other Parameters
    center array-like, 2 elements

      Center in data coordinates of the circles, default (0,0)

    radius float

      Radius of the circles, defualt 1.0

    sun_direction string or float

      The rotation direction of the first (white) circle. Options are [‘down’, ‘down right’, ‘right’, ‘up left’, ‘up right’, ‘up’, ‘down left’, ‘left’] or an angle in degrees counter-clockwise from up. Default right.

    ax matplotlib.axes

      Axis to plot the circles on.

    colors array-like, 2 elements

      The two colors for the circle fill. The First number is the light and second is the dark.

    **kwargs other keywords

      Other keywords to pass to matplotlib.patches.Wedge

  Examples

      >>> import spacepy.plot
      >>> spacepy.plot.dual_half_circle()