# 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()