load vanilla

Contents: Description, Arguments, Usage, Examples Supported Under Version: >1.69 Current Davinci Version: 2.27 64-bit Safe: No Description Loads vanilla text output from a file Arguments and Return Values Arguments: A string Return Value: A structure Usage Syntax: load_vanilla(file = STRING [, delim = STRING]) The load_vanilla() function loads a text output file generated by a run of vanilla. Fields with same names are combined into arrays and the data types are guessed from the data itself. The output is stored in a structure of parallel arrays of fields detected in the file. Field names are picked from the first line of the input file. Optional 'delim' character-string parameter may be specified to enumerate field/column delimiters in the input file. Default delimiters are spaces and tabs. NOTE: load_vanilla() will work on text files with fixed number of columns per line. Thus, while selecting variable data fields, qualify them with indices, e.g. instead of saying "cal_rad[]" use some range of values, like, "cal_rad[3-144]". Additional Notes: The vanilla output is TSV (tab separated values). There's a one line TSV header containing the names of the columns. Vanilla is capable of outputting variable length arrays, but the load_vanilla() function (and davinci in general) can't handle that output. Instead, make sure to specify a range on arrays, such as 'array[1-143]'. Examples The following command will load the vanilla output generated from an earlier vanilla run into a variable named 'a'. The data (stored in variable a) will be a structure of two fields, named, "sclk_time" and "temps". Each of these fields will be an array of 'n'-records. Where, 'n' is the number of lines minus 1 (#lines - 1) in the input file. (#lines - 1: because the first line contains the header info) dv> system("vanilla ./data -fields 'sclk_time ick temps[1-4]' > /tmp/foo") dv> a = load_vanilla("/tmp/foo") struct, 3 elements sclk_time: 1x2x1 array of int, bsq format [8 bytes] ick: 1x2x1 array of int, bsq format [8 bytes] temps: 4x2x1 array of int, bsq format [32 bytes]

DavinciWiki Mini-Nav Bar Contents Functions Function Categories Common Procedures Glossary Download Davinci Change Log News Mailing List Contact Developers davinci-dev [AT] mars.asu.edu All other topics See navigation on the left Recent Core Changes Change Log Modified On: 03-27-2006