The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....


Home MathPack Matrix Classes TIntMatrix, TMatrix and TMat3D Methods ImportASC
See also: ExportAsASC, Format of ASC data file 

ImportASC


Unit:SDL_matrix
Class: TMatrix, TIntMatrix
Declaration: [1] function ImportASC (FName: string; var Comment: string): integer;
[2] function ImportASC (FName: string; var Comment: string; var CustData: TStr2DArray): integer;

The method ImportASC reads the data from a specially formatted ASCII text into the data matrix. The size of the matrix is adjusted automatically to fit the data on the ASCII file. If ImportASC is called as a member of TIntMatrix, the values on the file are rounded when reading them. In addition to reading the matrix data version [2] also reads the custom data which have been stored using version [2] of ExportAsASC. The parameter CustData returns the custom data as a two-dimensional string array containing the names of the custom data in the first column and the corresponding values in the second column.

The function returns an error code with the following meaning:
0 no error
-1 error in specification of number of features
-2 error in specification of number of objects
-3 error in ClInf/NamFeat/NamObj flags
-4 file probably in UNIX format
-5 invalid class information
-6 invalid numeric data
-8 file not found

Last Update: 2019-Feb-26