|
|
load_ascii( [id], filename; [ncols=2, colkeys=NULL, sep=" ",
comment='#', dstype=Data1D] );
The load_ascii command loads ASCII data from a column-based
text file.
-
id - the id of the dataset to use; if not given, uses the default dataset id (id=1 by default, see "ahelp get_default_id")
-
filename - the name of the file (with path) which contains
the data
-
ncols - number of columns to read; default=2
-
colkeys - list of column names;
default=NULL
-
sep - the column-separating character; default is a space (" ")
-
comment - character which indicates a comment line; default=#
-
dstype - dataset type: Data1D, Data1DInt, Data2D, Data2DInt;
default=Data1D
For more information on working with ASCII files in CIAO,
refer to "ahelp dmascii".
The columns to load are specified by a Data Model filter
on the filename or the colkeys option of the load_ascii
command, as shown in the examples. Vector columns are
separated to form two dstype columns when the file is loaded.
If no columns are specified, the first two columns in the file
are read by default. If column names are not included in the
file, Sherpa calls them "col1", "col2", etc.
The columns must be listed in the order required by the
dataset type:
-
Data1D: x, y,
staterror=NULL,
syserror=NULL
-
Data1DInt: xlo, xhi, y,
staterror=NULL,
syserror=NULL
-
Data2D: x0, x1, y,
shape=NULL,
staterror=NULL,
syserror=NULL
-
Data2DInt: x0lo, x1lo, x0hi, x1hi, y,
shape=NULL,
staterror=NULL,
syserror=NULL
While possible, it is not recommended that load_ascii be
used with images (2D dstypes), PHA files, or ARF and RMF
response files. For these cases, use the load command
specific to the filetype instead (e.g. load_image).
sherpa> load_ascii("src", "data.txt"; ncols=3);
Load the first three columns of data.txt, using the
dataset id "src".
sherpa> load_ascii("tabbed.txt"; sep="\t");
Load ASCII data from tabbed.txt, which uses a tab as the
separator character.
sherpa> load_ascii("radpro.txt[cols RMID, SUR_BRI, SUR_BRI_ERR]";
dstype=Data1D);
sherpa> load_ascii("radpro.txt"; colkeys=["RMID", "SUR_BRI",
"SUR_BRI_ERR"], dstype=Data1D);
The two commands are equivalent. The columns RMID,
SUR_BRI, and SUR_BRI_ERR correspond to the x, y, and
staterror columns in the Data1D dataset radpro.txt:
sherpa> !cat radpro.txt
#SUR_BRI SUR_BRI_ERR RMID
3.4 0.4 1
3.5 0.4 2
3.6 0.4 3
...
The default comment character and column separator are
used.
sherpa> load_ascii("binned.txt[cols LO, HI, Y, ERR]"; dstype=Data1DInt);
sherpa> load_ascii("binned.txt"; colkeys=["LO", "HI", "Y", "ERR"],
dstype=Data1DInt);
The two commands are equivalent ways of loading an ASCII
dataset in which the independent grid is binned.
sherpa> !cat binned.txt
#LO HI Y ERR
0.1 0.2 3.5 0.4
0.2 0.3 3.6 0.4
0.3 0.4 3.7 0.4
...
- py.sherpa
-
get_staterror,
get_syserror
- sl.sherpa
-
add_user_pars,
calc_data_sum,
calc_data_sum2d,
calc_ftest,
calc_kcorr,
calc_mlr,
calc_model_sum2d,
calc_source_sum2d,
clean,
contour,
contour_data,
contour_ratio,
copy_data,
dataspace1d,
dataspace2d,
delete_data,
get_axes,
get_bkg_plot,
get_counts,
get_data,
get_data_plot,
get_default_id,
get_dep,
get_dims,
get_error,
get_filter,
get_rate,
get_ratio,
get_resid,
get_specresp,
get_staterror,
get_syserror,
group,
histogram1d,
histogram2d,
image_data,
list_bkg_ids,
list_data_ids,
list_response_ids,
load_arf,
load_arrays,
load_bkg,
load_bkg_arf,
load_bkg_rmf,
load_data,
load_image,
load_multi_arfs,
load_multi_rmfs,
load_pha,
load_rmf,
load_table,
load_table_model,
load_user_model,
pack_image,
pack_pha,
pack_table,
plot_data,
rebin,
save_data,
save_image,
save_pha,
save_table,
set_data,
ungroup,
unpack_arf,
unpack_arrays,
unpack_ascii,
unpack_bkg,
unpack_data,
unpack_image,
unpack_pha,
unpack_rmf,
unpack_table
|
![[Sherpa Logo]](../imgs/sherpa_logo_navbar.gif){kind=logo}