mdl_bpm_plot_data (ul_model)

	status.i4.v = mdl_bpm_plot_data(plot_options.s.r [,horz_pos.r4a.r]
					[,vert_pos.r4a.r] [,horz_status.i1a.r]
					[,vert_status.i1a.r] [,timestamp.u4.r]
					[,loss_data.r4a.r] [,loss_status.i1a.r] 
					[,horz_int.r4a.r] [,vert_int.r4a.r]

  	This function is called to plot BPM data.  Plotting options provide
	the choice of three types of plots; BPM position (1 to 10 frames),
	BPM position with data (single frame), or BPM position with either
	loss or intensity (single frame/two planes).  All plotting options
	are specified in the plot options structure (see below).

	plot_options	structure defining BPM plot options
			(structure of type BPM_PLT_OPT)
	[horz_pos]	horizontal position BPM data to be plotted
	[vert_pos]	vertical position BPM data to be plotted
	[horz_status]	horizontal BPM data status
	[vert_status]	vertical BPM data status
	[timestamp]	time of BPM data retrieval
	[loss_data]	BLM (loss) data to be plotted
	[loss_status]	BLM (loss) data status
	[horz_int]	horizontal intensity data to be plotted
	[vert_int]	vertical intensity data to be plotted
	[time_in_cycle]	time-in-cycle of BPM frame(s)
	[bpm_title]	null terminated window title for plot (39 chars max)
	[horz_int_stat]	horizontal intensity data status
	[vert_int_stat]	vertical intensity data status
	[horz_orbit]	horizontal model orbit data to be plotted
	[vert_orbit]	vertical model orbit data to be plotted

	BPM plot options structure breakdown:

	  int bpm_frm ....... frame type
			      (BPM_PROFILE -> profile frame,
			       BPM_SNAPSHOT -> snapshot frame,
			       BPM_DISPLAY_FRAME -> display frame,
			       BPM_FLASH -> flash frame)
	  int bpm_typ ....... plot type
			      (BPM_PLT_TYP_HV -> normal (HOR/VER 1-10 frames),
			       BPM_PLT_TYP_1P -> 1-plot (HOR/VER w/text data),
			       BPM_PLT_TYP_3P -> 3-plot (HOR + VER + LOSS/INT))
	  int bpm_pln ....... plot plane
			      (BPM_PLT_PLN_HZ -> horizontal,
			       BPM_PLT_PLN_VT -> vertical)
	  int bpm_nof ....... number of frames (from 1 - 10)
	  int bpm_aux ....... intensity/loss plot flag
			      (BPM_PLT_AUX_LS -> loss,
			       BPM_PLT_AUX_IN -> intensity)
	  int bpm_plt ....... plot view
			      (BPM_PLT_PLT_RG -> plot full ring,
			       BPM_PLT_PLT_B0 -> plot B0 close-up (Tevatron),
			       BPM_PLT_PLT_D0 -> plot D0 close-up (Tevatron),
			       BPM_PLT_PLT_LINE -> plot entire line (8 GeV),
			       BPM_PLT_PLT_UPSTM -> plot upstream (8 GeV))
	  int bpm_scr ....... plot screen
			      (BPM_PLT_SCR_G1 -> GxP1,
			       BPM_PLT_SCR_G2 -> GxP2)
	  int bpm_dsp ....... plot display type
			      (BPM_PLT_DSP_NM -> normal,
			       BPM_PLT_DSP_CN -> connected points,
			       BPM_PLT_DSP_FL -> filled vectors,
			       BPM_PLT_DSP_NMC -> normal (continuous),
			       BPM_PLT_DSP_CNC -> connected points (continuous),
			       BPM_PLT_DSP_FLC -> filled vectors (continuous))
	  int bpm_opt ....... limits/labels display
			      (TRUE -> yes,
			       FALSE -> no)
	  int bpm_par ....... particle type
			      (BPM_MODE_PROTON -> proton data,
			       BPM_MODE_PBAR -> antiproton data)
	  int bpm_sam ....... sample mode
			      (BPM_MODE_BUNCH -> bunch mode,
			       BPM_MODE_BATCH -> batch mode)
	  float bpm_h_scl ... horizontal BPM plot range
	  float bpm_v_scl ... vertical BPM plot range
	  int bpm_l_scl ..... loss monitor plot maximum
	  int bpm_i1_scl .... intensity plot minimum (exponent)
	  int bpm_i2_scl .... intensity plot maximum (exponent)
	  char **frm_title .. pointers to individual frame titles or NULL for
			      default title text (FR xxx)

	This function returns ACNET status values as follows:

	CBS_OK			success
	CBS_INVARG		invalid/missing argument
	CBS_MEMFAIL		failed to allocate dynamic memory
	CBS_INVID		window does not exist
	CBS_RANGE		invalid coordinates for scaling
	CBS_NOTYET		plotting is not supported for the currently
				selected machine

	This function requires the following include files:

	ul_model_h:model_bpmuti_h, ul_cbsaux_h:bpmuti_h, acnet_errors_h

	Related functions:

	bpm_get_data_c, blm_get_data_c, bpm_get_intensity_c, bpm_machine_c,
	bpm_data_source_c, model_db_set_machine, model_db_set_machine_cpp,
	model_db_query, mi_mode_text, model_mi_lattice_menu, tev_mode_text,

	C/C++ usage:

	char	horz_status[NUM_HORZ_POS];
	char	vert_status[NUM_VERT_POS];
	char	loss_status[NUM_LOSSES];
	char	*bpm_title = (char *) NULL;
	char	*horz_int_stat = (char *) NULL;
	char	*vert_int_stat = (char *) NULL;
	int	status;
	unsigned int	*timestamp = (unsigned int *) NULL;
	float	horz_pos[NUM_HORZ_POS];
	float	vert_pos[NUM_VERT_POS];
	float	loss_data[NUM_LOSSES];
	float	horz_int = (float *) NULL;
	float	vert_int = (float *) NULL;
	float	time_in_cycle = (float *) NULL;
	BPM_PLT_OPT	plot_options;

	status = mdl_bpm_plot_data(&plot_options,horz_pos,vert_pos,horz_status,