NAME:
bovy_plot
PURPOSE:
wrapper around matplotlib’s plot function
INPUT:
see http://matplotlib.sourceforge.net/api/pyplot_api.html#matplotlib.pyplot.plot
xlabel - (raw string!) x-axis label, LaTeX math mode, no $s needed
ylabel - (raw string!) y-axis label, LaTeX math mode, no $s needed
xrange
yrange
scatter= if True, use pyplot.scatter and its options etc.
colorbar= if True, and scatter==True, add colorbar
crange - range for colorbar of scatter==True
clabel= label for colorbar
overplot=True does not start a new figure and does not change the ranges and labels
gcf=True does not start a new figure (does change the ranges and labels)
onedhists - if True, make one-d histograms on the sides
onedhistcolor, onedhistfc, onedhistec
onedhistxnormed, onedhistynormed - normed keyword for one-d histograms
onedhistxweights, onedhistyweights - weights keyword for one-d histograms
bins= number of bins for onedhists
semilogx=, semilogy=, loglog= if True, plot logs
OUTPUT:
plot to output device, returns what pyplot.plot returns, or 3 Axes instances if onedhists=True
HISTORY:
2009-12-28 - Written - Bovy (NYU)