Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/6.1.0/doc/dsstruct/node3.html
Дата изменения: Tue Nov 23 00:24:40 2004
Дата индексирования: Sat Dec 22 09:26:07 2007
Кодировка:
Поисковые слова: п р п р п р п р п р п р п п р п п р п п р п п р п п р п п р п

XMM-Newton Science Analysis System


dsstruct (daltools-1.7.3) [xmmsas_20041122_1834-6.1.0]

Meta Index / Home Page

Description

Get the structure of a list of datasets

This task outputs a high level (syntax orientated) description of the given dataset. The syntax of the output is essentially the same as that expected by dsvalidate and dsverify.

The output has the form:

dataset < <dataset items> >

where,

<dataset items> is a list of one or more of

<name> <attribute> <block>

where <block> has the form

block < <block items> >

<block items > is a list of one or more of

<attribute> <array> <table>

where <array> has the form

array < <array items> >

where array is a list of one or more or

<attrribute>

For example, if a dataset is created with the following code

#include <Dal.h>

int
main()
{
	DataSet*	set = dataSetServer -> open( "test.dat", Dal::Create );
	Attribute*	att = set -> addAttribute( "att1", "an attribute", "mm" );
	*att = 123;

	Table*		tab = set -> addTable( "table1", 10, "a table" );
	Column*		col = tab -> addColumn( "col1", Column::Int32, "a column" );
	att = col -> addAttribute( "TLMAX", "std attribute", "Nm" );
	*att = 1000;

	dataSetServer -> close( set );

}

i.e. creates a dataset with name "test.dat" containing a dataset attribute called att1, ...

then the command dsstruct -set=test.dat produces the following output:

dataset
<
	name	"test.dat"
	attribute
	<
		name	"ATT1"
		type	Int
		value	"123"
	>
	table
	<
		name	"table1"
		rows	10
		column
		<
			name	"col1"
			type	Int32
			attribute
			<
				name	"TLMAX"
				type	Int
				value	"1000"
			>
		>
	>
>

If the output is redirected to the file check.ds (easily achieved e.g. use the command dsstruct -set=test.dat > check.ds )

then the command dsverify -file=check.ds or dsvalidate -sets=test.dat -template=check.sc

can be used to check the validity of the dataset test.dat.