galpy.df.StreamTrack.plot

StreamTrack.plot(d1='x', d2='y', spread=0, **kwargs)[source]

Plot the smooth track in the (d1, d2) plane.

Parameters:
  • d1 (str) – Coordinate names. Any of: x, y, z, vx, vy, vz, R, vR, vT, phi, ra, dec, dist, ll, bb, pmra, pmdec, pmll, pmbb, vlos, plus phi1, phi2, pmphi1, pmphi2 if custom_sky_transform is set.

  • d2 (str) – Coordinate names. Any of: x, y, z, vx, vy, vz, R, vR, vT, phi, ra, dec, dist, ll, bb, pmra, pmdec, pmll, pmbb, vlos, plus phi1, phi2, pmphi1, pmphi2 if custom_sky_transform is set.

  • spread (float, optional) – If > 0, draw a ±spread·sigma band around the track along d2 using the projected covariance. Works for any d2 that has a basis in _COORD_BASIS. Silently skipped for axes outside the dispatch (e.g. ll, bb).

  • ro (float or Quantity, optional) – Distance scale to use for the conversion (overrides self._ro).

  • vo (float or Quantity, optional) – Velocity scale to use for the conversion (overrides self._vo).

  • use_physical (bool, optional) – Override the object-wide default (set by _roSet/_voSet) for using physical units in the plot.

  • **kwargs – Passed to matplotlib.pyplot.plot.

Notes

Uses the same physical-unit logic as Orbit.plot: physical output is on iff _roSet and _voSet are True (or the user passes use_physical=True/explicit ro= / vo=); axis labels are picked accordingly.