IMF_read_flat

Syntax

[ID_arr] = IMF_read_flat
IMF_read_flat(startpoint)
IMF_read_flat(startpoint,endpoint)
IMF_read_flat(startpoint,endpoint,filename)
IMF_read_flat(startpoint,endpoint,filename,pathname)

Description

[ID_arr] = IMF_read_flat reads the full Flatfile. [ID_arr] is a cell array of File-IDs (for Command Line Users and Batch Jobs).

IMF_read_flat(startpoint) reads the Flatfile from the user defined startpoint to the end.

IMF_read_flat(startpoint,endpoint) reads the Flatfile from the user defined startpoint to the user defined endpoint.

IMF_read_flat(startpoint,endpoint,filename) reads the Flatfile 'filename' in the actual path from the user defined startpoint to the user defined endpoint.

IMF_read_flat(startpoint,endpoint,filename,pathname) also changes the path.

Remarks

IMF_read_flat reads the Flatfile with respect to the global variable g_max_bytes. The default value of this variable is: g_max_bytes = 3000000. That means, if a Flatfile is bigger than 3Mb it will be split. You can change the default value of this variable by editing the file IMF_ini.

Examples

Example with an UCLA - Flatfile:

» IMF_info_flat
DATA  = B98047_SGDC5.ffd                                                
CDATE =  98 279 OCT  6  10:53:40                                        
RECL  =   104                                                           
NCOLS =    25                                                           
NROWS =      86281                                                      
OPSYS = SUN/UNIX                                                        
  # NAME      UNITS     SOURCE                    TYPE  LOC             
001 TIME      SEC       SMALL                     T       0             
002 B CHAN1   nT        SMALL                     R       8             
003 B CHAN2   nT        SMALL                     R      12             
004 B CHAN3   nT        SMALL                     R      16             
005 B TOTAL   nT        SMALL                     R      20             
006 MAGSEQ #  V         SMALL                     R      24             
007 MAG CHN1  V         SMALL                     R      28             
008 MAG CHN2  V         SMALL                     R      32             
009 MAG CHN3  V         SMALL                     R      36             
010 SENSORON            SMALL                     R      40             
011 SENSORTP  V         SMALL                     R      44             
012 A/D ON              SMALL                     R      48             
013 A/D TEMP  V         SMALL                     R      52             
014 FB ON               SMALL                     R      56             
015 FB TEMP   V         SMALL                     R      60             
016 TDOP                SMALL                     R      64             
017 ExpTimeE            SMALL                     R      68             
018 OutOfSeq            SMALL                     R      72             
019 FigMerit            SMALL                     R      76             
020 #VisSat             SMALL                     R      80             
021 UTCValid            SMALL                     R      84             
022 NavMode             SMALL                     R      88             
023 SensorTmp C         SMALL                     R      92             
024 A/D Tmp   C         SMALL                     R      96             
025 FB  Tmp   C         SMALL                     R     100             
ABSTRACT                                                                
FIRST TIME         =  98 047 FEB 16  00:00:00.267                       
LAST TIME          =  98 047 FEB 16  23:59:59.205

If you are interested just in the time range from 14pm - 15pm type:

IMF_read_flat('1998 FEB 16 14 00 00 000','1998 FEB 16 15 00 00 000')

You do not need to write Minutes, Seconds and Miliseconds if they are zero. Just type:

IMF_read_flat('1998 FEB 16 14','1998 FEB 16 15')

Note: It must be one character space between every item of the date-time string.

IMF_read_flat('','','filename','pathname')

Reads the full file filename in the path path.

See Also