µGRAPH User's Manual
Contents
1. Purpose LTERM capture file format Syntax 1 Description Specify that imported data are in LTERM terminal emulator for serial connections capture file format YYMMDDHHNNSS Chan_1 Chan_2 Chan_3 Chan 4 This option sets the format_string to yymmddhhnnss and the file type to DAS shots See Also format_string 1 das v1 9 Release 3 95 lw pI Purpose Line width Syntax w Description Sets the line and points at 3 pixels width instead of 1 GUI MEG See Also gd vga 96 uGRAPH User s Manual T Purpose Retrieve over scales from DAS shots Syntax M n m Description When importing DAS shots data files rebuilts the full dynamic by correcting overs scales of 100 000 shots This option sets the DAS data mode adjusts the correction of over scales with a maximum absolute difference n 0 lt n lt 50 000 between two consecutive data default is n 40 000 Use m 0 to not correct over scales keep original data see also option shot for exports m by itself avoids all DAS specific computations See Also das F7 mdas shot v1 9 Release 3 97 mdas Da IO Purpose uDAS shot data format Syntax mdas Description Specify that imported data are uDAS data logger format without header v4 YY MM DD HH NN SS Chan_1 Chan_2 Chan_3 Chan_4 This option sets the format_string to ymdhns and the file type to DAS shots See Also das format_string he2. Description By default channels of multiple files are concatenated The a option append them in time thus the files must have the same numter of channels Examples mgr filel dat file2 dat a where the two files have 8 channels for instance appends the files and display data as a unique continuous file of 8 channels On the contrary mgr filel dat file2 dat concatenates the files and display 16 different channels Remarks If the a option is forgotten when loading a large amount of files it will usually produce an error because the number of channels is limited to 30 from A to U while total number of imported files is limited to 200 See Also merge limitations 20 uGRAPH User s Manual b AMA Purpose Extract data from a specific date and time begin Syntax b time_string Description Specify a begin date and time by time_string to keep only data with time reference after this limit Examples mgr example dat i ymdhns b 9509181520 imports data in MDAS format with date and time after 1995 09 18 15 20 00 Remarks This option applies after all other time and date options have been taken into account For instance it supposes that date and time format has been correctly defined with import options See Also Je v1 9 Release 3 21 bk A Purpose Syntax Description Examples See Also 22 Add time event marks on graphics bk filename Display dashed areas on the background of graphics to mark
3. Option Script file argument list com Connect to an EDAS data logger on port COM test Test the file s format and display information tmp Change directory for temporary files Exit default Automatic exit after exporting data or GIF using argument commands not GUI Exit GUI Importing Data Files 12 Alte y Ctrley Main Commands default All columns imported as data channels i Specify column format date time and data ic Interpret coma as decimal point im Interpret minus as separator x Exclude first lines xt Exclude lines with text Multiple Files default Append channels for visualization only a Append files in time merge Merge files using common time reference Date and Time b Extract from specific date amp time begin e Extract until specific date amp time end it Impose a sample period nt Exclude time recovering r Center data versus sample period S Time lag sort Sort time Er Time restore y Specify date amp time reference yn Specify date amp time reference from filename uGRAPH User s Manual Command Summary commend Summary Preset Formats defaults Files with uGRAPH header or uDAS binary files LTERM capture files das PC DAS shot files mdas MDAS shot files uDAS v4 reunion Reunion tiltmeter binary files Data Processing Calibration Channel Names and Units J Apply full calibration on the data cn Use only names amp units CT
4. Remarks See Also v1 9 Release 3 Display the File menu Alte Esc returns to main menu Display the available File menu function keys F1 Export shiftF1 Make GIF AltF1 Merge appears only with concatenated files ctrlFl Sort Data AltXx F10 Exit It is not necessary to use this command to access functions this is just a help for the user GUI menu F1 F 1 F1 CF 1 X F10 53 GUI G a at Purpose Display the Graph menu Syntax AIG Esc returns to main menu Description Display the available Graph menu function keys F2 Info AltF2 Names shiftF2 Title ctrlF2 Reset Colors F6 Line ctrlF Marker shiftF6 Grid AltF6 Bold Remarks It is not necessary to use this command to access functions this is just a help for the user See Also GUI menu F2 F 2 Fa Fa F6 FO FG FE 54 uGRAPH User s Manual GUI H Purpose Display the on line help Syntax Atd 0 9 amp gt select pages VA PgUp PgDn vertical scroll into page Al Esc or H quit or returns to previous screen Description Display 10 pages of quick help 0 Introduction default from command line 1 How to use GRAPH 2 General options and index 3 Import export file format options 4 Data calibration 5 Data calculation options 6 Graphic options 7 Main menu functions default from GUI 8 Limitations 9 About UGRAPH See Also mgr h1p Windows help file v1 9 Release 3 55 GUI 7 pe Purpose Gr
5. directory filename extension Description Data filename is the main arguments passed to GRAPH It uses DOS syntax to specify where the file is and its name drive is the letter of drive disk followed by default is current drive directory is the path of folders separated by and using for up directory default is current directory of the drive filename is a string of 8 characters maximum extension is a string of 3 letters maximum separated from the filename by default is all files corresponding to filename For the data filename arguments group of files can be specified using star and to replace group or single characters of the filenames and access multiple files Examples mgr c mgr example dat mgr data sta asc a Remarks uGRAPH uses the di r DOS function to interpret filename argument s and access files See MS DOS documentation for a complete review of filename possibilities See Also bk c gif 38 uGRAPH User s Manual format_string 4 _ eee Purpose Syntax Description Examples v1 9 Release 3 Column formatting channels Lxymdhnsbi gtlkq The format_string allows to define each column meaning time and data for import 1 and export t data file formatting One character or expression between brackets stands for one column 1 to9 thenA toU channel number all channels in order automatically added if no channel character is
6. sc vga v1 9 Release 3 105 phase ee Purpose Full screen mode Syntax phase phase rad Description Sets the angle unit default is degree for phase files as produced by HiCum See Also hicum 106 uGRAPH User s Manual Z Purpose Center data versus sample period Syntax r Description When importing file s this option subtracts p 2 on time reference where p is the sample period This applies especially to EDAS data loggers which produce result of an integration referenced to the end time of the period Remarks Attention The data will not be causal anymore This option can be used when decimation d is applied on data to avoid time delays See Also d v1 9 Release 3 107 s Purpose Time shift Syntax Sin Description Applies n hours negative or positive of time correction on the imported data file s This option is useful to process local time or GMT referenced data See also LAG flag in calibration_file See Also calibration_file hi cum 108 uGRAPH User s Manual sc Purpose Screen colors Syntax SCin Description Set the screen colors for graphics Four modes n are available 0 16 colors saturated on black background default 1 2 colors gray on black background 2 2 colors gray on white background 3 16 colors dark on white background GUI F9 See Also v1 9 Release 3 109 shot De Purpose 5 digit shots DAS data Syntax shotI maxshots Description
7. Calibrate in frequency DAS processes only CV Calibrate in voltage polynomial factors cg Calibrate in physical unit general factor amp constant Filtering d Decimate data average oy df Apply moving average ed Extract data under sampling fx Remove noise differential threshold criteria nan Define Not a Number value ts spike Remove noise intelligent criteria vm Remove noise maximum threshold criteria vn Remove noise minimum threshold criteria Data Fitting ato do Remove offset mean value at dl Remove trend linear regression tw dh Remove first harmonics sinusoidal decomposition F7 Data fitting preview GUI Specific Calculations ats dc Compute cumulative sum D Jdd Compute derivative F8 f Compute formula arithmetic ShitEg hicum Compute periodic histogram HiCum m Retrieve over scales from DAS shots ShitE7 Show over scales limits GUD v1 9 Release 3 13 Command Summary Exporting Data File Main Commands default Data exported after import options and data processes application with space separated columns and GRAPH header F1 nh No header F1 o Specify output data filename Fi t Export data and specify column format Formatting Options iso ISO standard for date and time OS Specify column separator shot Keep 5 digit shots for DAS data tf Export numerical data format xi No information lines in header Graphics Main Commands default All channels on separ
8. It increases the sampling period and reduces the amount of data by a factor n Remarks This option must be used under special conditions since it does not respect the Shannon s theory and could generate aliasing Prefer d the option to decimate data See Also d 36 uGRAPH User s Manual f S Purpose Syntax Description Examples Remarks GUI See Also v1 9 Release 3 Compute formula f formula_string f formula_string Creates new channel s as the result of an arithmetic combination of existing channels using formula defined by formula_string Several formula can be specified in order to use the result of the previous one for instance Accessing to formula needs a single data file or multiple files in append mode a For concatenated files use the merge function first mer ge The first formula applies eventually on result of data calculations like derivative cumulative sum mean and linear corrections mgr example mgr dd f 12 2 f 4 3 g 5 6 imports example data computes the derivative of all channels creates a new channel 5 as the average of 1 and 2 creates a 6 channel as the difference between 4 and 3 and plots the results on separated axis p p Because some of the formula_string characters are reserved to DOS prefer script files to specify formula F8 a formula_string merge 37 filename e Purpose Specify a file Syntax drive
9. T SEE Purpose Moving average filter Syntax AIT Filtering moving average n Esc to cancel F3 returns to original data Description Compute the moving average on n consecutive data for all channels low pass filtering 1 i J i n 1 Remarks Moving average applies a phase delay on the signal equal to n 2 time sampling in order to remain causal Command df See Also dd F3 v1 9 Release 3 61 GUI V po Purpose Display the View menu Syntax Alty ESc returns to main menu Description Display the View menu function keys F4 Normalize F5 Magnify F7 Data Fit shiftF7 OverScale Remarks It is not necessary to use this command to access functions this is just a help for the user See Also GUI menu F4 F5 F7 F7 62 uGRAPH User s Manual GUI Ww SS Purpose Harmonic correction Syntax atw Enter harmonic binary combination 1 to 15 n F3 returns to original data Description Correct phase data from its first 4 harmonics The number n is equal to the decimal value of binary combination of harmonics where harmonic 1 1 fundamental harmonic 2 2 harmonic 3 4 and harmonic 4 8 Example n 15 corresponds to the sum of fundamental and harmonics 2 3 and 4 Command dh See Also hicum F3 F7 I v1 9 Release 3 63 Al GUI X Purpose Exit Syntax ay Description Exits the program without prompting See Also F10 64 uGRAPH User s Manual GUI Z S A Purpose Zoom time interv
10. averages regression arithmetic change date time and data formats with a set of options on the MS DOS command line Visualize these data file s as time referenced graphics in an interactive mode channel selection scale adjustment zooming simple formula and data fitting with keyboard or mouse functions and export the final graphic in a GIF image a View graphics in real time from EDAS data loggers connected on the serial port The syntax of UGRAPH is brackets stand for optional arguments mgr filename filename2 options script1 script2 and you get a graph of your data and or processed data file The Figure 1 shows basic principles of uGRAPH 6 uGRAPH User s Manual Getting Started ASCII data file s EDAS data logger ee Date amp time data processing DOS prompt BATCH N Script file Visualization Graphic User graphic analysis inerce Formatted ASCII data file GAP image Figure 1 Basic principles of uUGRAPH Inputs outputs and interfaces Installing GRAPH uGRAPH is delivered as a single software package mgrpack exe auto extractable zipped file small enough to be stored on a floppy disk which contains all the files executable help and documentation If you want to access to UGRAPH from any of your data directories it is advised to install it in your MS DOS path For correct installation use the following steps 1 Exe
11. files to specify graph type GUI any of graph_string characters Ari See Also graph_string 44 uGRAPH User s Manual gd MM Purpose Grid off Syntax gd Description Turns off the background grid of graphics GUI Shit FG v1 9 Release 3 45 gif po Purpose Make a GIF image Syntax gif gi f filename Description Exports the graphic in a GIF image file mgr gi f in the current directory or in filename Example mgr example mgr gif example gif produces a GIF image file named example gif included in the software package Remarks To obtain the best results use SVGA resolution vga full display screen pe and set the screen colors to white background SC This option makes a screen copy and writes a binary file in GIF87a format no transparency color Prefer the gi f extension for filename if you want an automatic recognition with photo editor software s With t this option is the main batch uGRAPH function because it forces the program to exit after all processes done without entering GUI mode GUI oni See Also graph_string pe Sc vga 46 uGRAPH User s Manual graph_string _8epeens Purpose Syntax Description Examples Remarks v1 9 Release 3 Graphic type coding channels ve fi sos rygcbm The graph_string format allows to specify a graphic parameters in a single word It is used both on the command line g and on keyboard while
12. filtering Syntax viml channels max vnl channels min Description Removes data values of channels above a maximum max and a minimum min when importing data file s channels optional specifies one or more channels instead of all channels By default the entire line of data is excluded Use nan to replace invalid data by a Not a Number Examples vm 1000 excludes all channels data greater than 1000 vn26 450 excludes channels 3 and 6 data lower than 450 vm2 25 2 vn5 1 3 excludes channel 2 data greater than 25 2 and channel 5 data lower than 1 3 See Also fx spike 120 uGRAPH User s Manual Z Purpose Exclude first lines of file Syntax Xin Description Excludes first n lines of imported file s This option allows importing files that contain lines of headers It will apply to all imported files See Also i xt v1 9 Release 3 121 xi Purpose No information in header Syntax xi Description Excludes information lines in exported file header By default header information lines FINFO are kept and append when exported and may be numerous after a lot of import export operation This option allows avoiding it while keeping the file header See Also header nh t 122 uGRAPH User s Manual xt Purpose Exclude lines with text Syntax xt Description Excludes all lines of imported file s that contain some text or letters like comments or remarks This option allows
13. specified X unused column NaN for export y year after 1970 m month 01 to 12 d day in month 01 to 31 j ordinal day 001 to 366 h hour n minute S second b month name 3 letters t Matlab s datenum format floating number of days since January 1 0000 1 data index or phase as x axis fractions of time can be added after date and time characters for export group into one column without separator the dot is allowed Here is some shortcut letters and their equivalent g Lyyyymmdd 1 hhnnss k hhnn q hh nn Jix Chan_1 Chan_2 Chan_3 Chan_4 imports all column as data channels default import format if no header is present and no preset format specified i 1ymd hhnn 23 Chan_1 YYYY MM DD HHNN Chan_2 Chan_3 39 format_string Sa imports a file with channel 1 year month day concatenated 2 digit hour and minutes and channels 2 and 3 t ymds134 YYYY MM DD SSSSS Chan_1 Chan_3 Chan_4 exports a file with 4 digit year month day seconds in the day from 0 to 86399 and channels 1 3 and 4 Jtiyi or O gt a T ped Q gt a 7 N exports a file with 4 digit year ordinal day with fractions and all channels Remarks For import each letter of the format _string is interpreted independently and the date and time is reconstructed as the sum of each Then order of app
14. visualize data see GUI Characters used are 1 to 9 then A to U uppercase for channels for all channels on the same axis to select intervals or coma to separate axis between channels and specify the axis relative size for example two comas previous axe will be double V versus to make XY graphs next channel will be X axis instead of time or data index e error next channel will be display as error bar of the previous one Any combination of line and marker types preceding channel s solid line default dotted line dots X crosses S squares O circles bars Any of one colors preceding a channel the number stands for default channel attribution r red 1 y yellow 2 g green 3 C cyan 4 b blue 5 m magenta 6 23 1 4 draws channels 2 and 3 in first double size axis channel 1 in a second axis and channel 4 in a third one 1 4v5 draws channels 1 to 4 versus channel 5 S1 5 B draws channels 1 to 5 with dotted line and squares and B 11 with bars all in separated axis 1e4 5 draws channel 1 using errors channel 4 and channel 5 in a second axis Because some of the graph_string characters are reserved to DOS coma and pipe prefer script files to specify graph type on the command line 47 graph_string eee o Line style is by default a continuous line between data interrupted when the time interval exceeds 1 5 times the acquisition p
15. E A EEEN 14 rap EEE E S E cactuexsseccunds cacewaxtcaceunde Ceceyeteretevndeceie 14 Reference 17 Technical Notes 126 References and Acknowledgment sssssssssscssesescssessescscessescscesseccscenseccscensecessessensesenses 128 Index 131 v1 9 Release 3 iii Contents poems ooo iv uGRAPH User s Manual Getting Started O v1 9 Release 3 3 Getting Started Getting Started o o Introduction What is GRAPH UGRAPH is a simple tool to help analysis of time data series It reads regular raw ASCII data files offers standard processing and produces an interactive and intuitive visualization via time referenced graphics Results can be exported in new file under various data formats or GIF image Other software s allow to produce high quality graphics but usually require the very last update of computer performances as soon as you want to process large data files GRAPH is a tiny stand alone MS DOS program mgr exe about 100 Kb running with standard graphic display and processor 80286 or higher It does not need RAM and can handle up to 30 channels and 200 files together of unlimited size because all the processes are sequential All options can be specified on a single line at the MS DOS prompt or into alias script files such as full automatic processing graph outputs are allowed uGRAPH can be used in three different ways From almost any ASCII data file s process data filtering extraction
16. GRAPH The Micro Graphic Data Analyzer Visualization Data Analysis File Formatting BETA VERSION JUNE 2004 User s Manual MGR v1 9 Release 3 How to contact EDAS Francois Beauducel Software developer technical support bug reports lt Observatoire Volcanologique et Sismologique de Guadeloupe Le Hou lmont 97113 Gourbeyre Guadeloupe FWI beauducel ipgp jussieu fr http www ipgp jussieu fr beaudu mgr htm Michel Van Ruymbeke EDAS Project manager Andr Somerhausen EDAS hardware and software developer lt Observatoire Royal de Belgique Avenue Circulaire 3 1180 Bruxelles Belgium labvruy oma be http wwww oma be KSB ORB D1 LABO edas 2 uGRAPH User s Manual Francois Beauducel 1995 2004 by FBSoft Written in Paris Brussels Yogyakarta Guadeloupe amp Lanzarote May 2004 Contents L1 Contents iii Getting Started 5 TinttO DUCE Oi MAAIE E EE ET A AE EOE ET 6 Basic Operations cscevecsessexsscgscecassssveronsesnonnsnssuecencevesuvinssneduadssvenssasshedeesesoesotagskceuecesversusestesateds 9 Command Summary 11 General Purpose Commands is sccevivsfecsusasiedsusscecsudusvedsveus lectwaxstocswadecactuoxsvelsvavelecauaceielsvaussels 12 Importing Data Files eenei n nE EEEE EAEEREN 12 Data Processing e ssssiisssssssesessssssscdesissscsossasssanssosssassascessasseteosssoacobdasesesnassnasencasdsseasasssssodasaseses 13 Exporting Data Filerna ceia i aeniea eA TEE T
17. H can produce with this option a continuous time increasing automatically when negative time jumps are encountered This option may be used when time reference is unknown but it is better to use if possible yn option to get complement information from data filename Examples A data file without the year will possibly have dates jumping from December to January and then one year will be added option 7 mdhn to specify format 12 31 23 50 1234 5 6789 0 gt 1970 12 31 23 50 01 01 00 00 1234 6 6788 9 gt 1971 01 01 00 00 If the complete date is missing and hours jump from 23 to 00 a day will be added option 1 hns to specify format 23 59 59 1234 5 6789 0 gt 1970 01 01 23 59 59 00 00 00 1234 6 6788 9 gt 1970 01 02 00 00 00 See Also a i yn 118 uGRAPH User s Manual vga 3 Purpose Syntax Description Remarks GUI See Also v1 9 Release 3 VGA video mode vgain Sets the screen resolution Five modes n are available depending on the hardware video card 0 320 x 200 pixels 1 640 x 350 pixels EGA 2 640 x 480 pixels VGA default 3 800 x 600 pixels SVGA 4 1024 x 768 pixels XGA The default resolution VGA is usually sufficient for data analysis but higher modes may be necessary to produce better quality graphics see gi f Lower modes can be used to run UGRAPH on pocket PC Shift F9 pe gif 119 vm vn aaa Purpose Threshold data
18. Without argument maxshots keeps the 5 digit shots numbers when exporting DAS data file By default DAS data are corrected from 100 000 shots over scales see m to reconstruct full dynamic data values This option will produce phase wrapping as made by EDAS data loggers This may be useful when using d decimation option on DAS data When maxshots is specified uses this value to apply DAS corrections over scales frequency conversion See Also d das m mdas 110 uGRAPH User s Manual sort A Purpose Sort data in time Syntax sort Description Sets the data in chronological order and if necessary deletes redundant data This allows faster display and clean file exporting GUI WET See Also nt v1 9 Release 3 Ill spike Purpose Remove spikes Syntax spike n Description Removes aberrant data in the signal using an intelligent criteria This function allows to remove local data points out of n times the RMS of the signal Values of n between 5 and 10 are advised and the process can be done iteratively GUI AtS See Also fx vm vn 112 uGRAPH User s Manual t S Sv Purpose Syntax Description Examples Remarks GUI See Also v1 9 Release 3 Export file format t t format_string Exports imported data as a new file without entering GUI mode By default t option uses the imported format 1 Specify the format_string will determine the column format da
19. Y axis between exact maximum and minimum instead of rounded values and indicates the values on axis legend For axis with multiple channel draws each channel on its own scale and indicates ticks as percent unknown scale This is useful for data comparison when scales or units are different GUI F4 See Also F5 42 uGRAPH User s Manual fx Z Purpose Noise filtering difference Syntax fXN x Description Exclude data of channel N if absolute difference between 2 data is more than x value If no nan option is specified the entire data line will be excluded Otherwise the single data will be replaced by NaN Examples fxB 50 tests the data of channel B and excludes it if abs d d _ gt 50 See Also nan spike vm vn v1 9 Release 3 43 g B Purpose Graphic type Syntax Q graph_string Description Select channel to draw line style and colors to use This option allows to determine the first graphic pattern which will be displayed e g for very large files default is all channels on separated axis solid lines and default colors Examples g 01 3 plots channels 1 to 3 on separated axis with dotted line and circle markers default colors g 1 2 sb4 plots on the first axis channel 1 solid line and channel 2 dots and on the second axis of half size channel 4 blue solid line and square markers Remarks Because some of the graph_string characters are reserved to DOS prefer script
20. ader 1 98 uGRAPH User s Manual merge m Purpose Syntax Description GUI See Also v1 9 Release 3 Merge concatenated files merge When multiple data files have been imported without append command a they are concatenated Each file is displayed sequentially with its own data channels This function merges the channels to produce a new single file with a single time reference If the time periods are different or if some data are missing for a given date and time intervals data are interpolated using the neighbor method nearest data value Ifa nan command has been specified missing data are replaced by Not_a_Number This allows to access to formula calculation XY axis drawing and to export a data file with all channels in a single time referenced table Shift F1 a F F1 F8 nan t 99 nan ash Purpose Not a Number Syntax nan nan n Description Filtered data will be replaced by a NaN Not A Number value equal to n default is le 37 which will be ignored in graphics and calculations and used to export X columns see format_string If this option is not specified when importing file s with filtering any invalid data will exclude the entire line all channels See Also format_string Fx F1 spike t vm vn 100 uGRAPH User s Manual nh O a Purpose No header Syntax nh Description Puts no header in exported file By default a uGRAPH header is added to t
21. al Syntax Enter zoom begin date YYMMDDhhnnss time_string Enter zoom end date YYMMDDhhnnss time_string Description Specify a begin and or end date and time by time_string to zoom the first graphic display Command zb ze See Also mouse v1 9 Release 3 65 GUI F7 e Purpose Export data and specify column format Syntax F1 Output File Name filename Esc to cancel Output File Format format_string Merge Files Y N yn Include File Header Y N yn Description Writes data corresponding to the displayed time interval in a new ASCII file filename using column formatting format_string and optional text header filename can be any valid DOS file name By default a name is proposed that corresponds to the one defined by O command if apply or an automatic name constructed from the first data file name with an extension in format nn where nn is a number between 00 and 99 format_string defines the column formatting By default the import format is proposed from 7 command text header or preset formats If multiple files have been imported without append option a export them will produce a single data file containing each file concatenated with a header in front of each It is here proposed to merge them Default is no Except if the previous answer has been no it is here proposed to include a header in the data file Default is yes Command o t merge nh See Also filename format_
22. am without any argument will launch the on line help You will have access to a set of 10 pages using arrow keys or page number that covers most of the options of UGRAPH A Windows help file is provided with the software package mgr hlp it offers an interactive document with cross links and can be open under Windows 3 1 95 98 2000 NT and XP The present document is also available in a PDF file mgr pdf it can be read and printed on any operating system with the Adobe Acrobat Reader See the Web site http www adobe com to get the software free download Execute the example script For a quick demo of UGRAPH possibilities go to the program directory and type mgr example mgr This produces the following graph EXAMPLE OF CALIBRATION FILE 1500 1000 cunkwn gt N 1000 40 Chan 4 Cunkwn gt 4 Time v1 9 Release 3 9 Command Summary ST This chapter lists uGRAPH commands by functional area There is two categories of commands the arguments DOS prompt Batch and script files the keyboard and mouse functions GUI graphic user interface Since some of the commands have an equivalent in both categories GUI function keys are noted in left margin when applicable v1 9 Release 3 11 Command Summary General Purpose Commands At Atx F10 Help no argument Display on line help Main Commands filename Import the file filename as data
23. aphic and data information See F2 56 uGRAPH User s Manual GUI L ee Purpose Linear correction Syntax M F3 returns to original data Description Correct each channel from its linear regression trend computed on the viewed time interval D d at b Command d1 See Also AtA F3 v1 9 Release 3 57 GUI N pe Purpose Display the Screen menu Syntax aN Esc returns to main menu Description Display the Screen menu function keys F9 Colour B amp w shiftF9 VGA Mode ctrlFQ Full Screen Remarks It is not necessary to use this command to access functions this is just a help for the user See Also GUI menu F9 Shift Fg Cirit Fg 58 uGRAPH User s Manual GUI O Sn Purpose Offset correction Syntax a0 F3 returns to original data Description Remove mean value of each channel computed on the viewed time interval D d mean d Command do See Also AtA F3 v1 9 Release 3 39 GUI S pe Purpose Remove spikes Syntax aS Remove spikes STD n Esc to cancel Description Remove aberrant data in the signal using an intelligent criteria This function allows to remove local data points out of n times the RMS of the signal This process cannot be undo and will degrade the data on a regular noisy signal Values between 5 and 10 are advised and the process can be done iteratively Command spike See Also ATA 60 uGRAPH User s Manual GUI
24. ata channel Examples See format_string examples See Also header format_string t v1 9 Release 3 9 Purpose Coma as decimal point Syntax ic Description Interprets all comas as decimal points when importing data file s Some countries use coma as decimal point in numerical formats without this option uGRAPH may interpret comas as column separator This option does not affect exporting format The point is always used See Also format_string 1 1m 92 uGRAPH User s Manual Purpose Syntax Description See Also v1 9 Release 3 Minus as separator im Interprets all minus as column separator when importing data file s Without this option UGRAPH may interpret minus as negative numbers This option does not affect exporting format format_string 1 1C 93 iso OO Purpose ISO 8601 format Syntax iso Description Uses ISO 8601 standard format for date and time when exporting file F1 or i e adds minus between date field and colon between time field Only two export formats will respect the ISO standard see format_string ymdhns YYYY MM DD HH NN SS yjhns YYYY DDD HH NN SS These complete format can be truncated at the condition that the order for date and time are respected Year Month Day and Hours Minutes Seconds i e the biggest first Since 2 digit years are forbidden any y will be replaced automatically by Y See Also format_string t 94 uGRAPH User s Manual
25. ated axis solid lines graph_string 9 Specify graphic type channels and styles SEY gif Make GIF image l F2 test Display statistical information on data GUI Graph Parameters bk Adds time event marks book Meo c Define or change channel names and units E2 c Define or change graph title SitE2 default Return to original channel colors Fe g Define line type re g Define marker type sits gd Turns grid off ates lw Use heavy lines Display Features novga Use EGA CGA video mode Eg pe Use full screen no header window F9 SC Specify screen color mode SttEg vga Specify display resolution mode Scale Scrolling and Zooming X axis zoom in X axis zoom out az zb X axis zoom begin 14 uGRAPH User s Manual Command Summary sora Sarma Atz arrows Home End Esc F5 Shites F4 v1 9 Release 3 ze default default es fs X axis zoom end X and Y axis scrolling Go to X axis begin Go to X axis end Return to X axis full scale Magnify scales Equal scale interval for all axis Full normalize scales Graphic User Interface Menu default Display the File menu Display the Data menu Display the View menu Display the Graph menu Display the Screen menu Return to main GUI menu 15 Reference Sn This chapter describes all uGRAPH command line options and menu functions in alphabetic order The Graphic User Interface functions are referenced as GUI function key v1 9 Releas
26. cessing through the following keywords order has no importance DATE date and time of file creation PROG complete path and line command when calling uGRAPH INFO copy of a maximum of ten information lines from original file header use option X1 to exclude it from exported files TITL copy of title from calibration file original file header or defined by t F6 key SHOT data are original DAS shots must correct over scale SAMP time sampling in seconds CHAN time and data format including channel names and units into parenthesis preceded by an underscore This is the only needed line for valid header Others are optional File header of an exported file DATE 2000 09 01 10 13 54 PROG D METEO DATA mgr cr1x0005 dat i xyj hhnn iso c meteo clb TITL MGR EXAMPLE 2 METEO STATION SAMP 900s CHAN YYYY MM DD HH NN SS Wind_Speed_ m s wind_Dir_ deg IRRad_ W my Atm_Pressure_ mbar Batt_ Vv 2000 03 18 11 30 00 0 305 123 5 440 4 722 14 06 2000 03 18 11 45 00 0 303 67 8 438 6 722 14 04 87 header re Remarks A file with this text header can be loaded by uGRAPH without the import option 1 Thus it is advised to keep this header in all exported files but if you do not want it use nh option or answer no at the appropriate question when using the F7 key See Also Ji nh t x xi 88 uGRAPH User s Manual hicum EE Purpose Syntax Des
27. cription Remarks GUI See Also v1 9 Release 3 HiCum periodic histogram hicum wave Computes HiCum algorithm on all channels Given a known tide wave or simple period defined by wave this function computes the mean of signal in regular phase intervals 360 divided in 1 intervals The wave argument can be specified in three different ways 1 xxx xxx Doodson argument for a tide wave i e 164 555 for S1 2 wave_name tide wave name i e S1 M2 see mgr_tide dat file 3 n period in samples This function transforms time referenced data into phase data In GUI mode some additional functions are available in this mode like first harmonic fitting values N fitting preview F7 and correction W To computes correctly the phases of tide waves data must be referenced in UT Universal Time GMT Use S option to apply a delay if necessary Shift F8 Alt AtW F7 hicum hs phase s 89 hs pS Purpose HiCum phase samples Syntax hs n Description Determine the number of phase intervals for HiCum computing default is 360 GUI pa See Also Alt AtW F7 hicum phase s 90 uGRAPH User s Manual Z Purpose Import file format Syntax 1 format_string Description Specifies the column format date time and data for file s import When no EDAS header is available in the file s or no preset format is specified the default is 7 and imports each raw as d
28. cute the package by double clicking on it or under a MS DOS prompt window C TEMP mgrpack 2 Execute the BATCH file instal 1 bat C TEMP instal 3 To access UGRAPH from any directory reboot your computer otherwise call c mgr mgr from the MS DOS prompt or in your BATCH files instead of mgr UGRAPH Package Contents Strictly speaking UGRAPH can run properly with the only file mgr exe v1 9 Release 3 7 Getting Started Getting Started o oo However to be fully functional it needs three other files in a directory included in your MS DOS PATH mgr exe Main executable mgr_help dat On line help file mgr_tide dat Earth tide wave list mgr ini Script initialization file day exe Date amp time converter The other files provided in the package are mgr pdf User s manual this document example clb Example of calibration file example bok Example of book file example dat Example of data file example2 dat Example of data file with header readme txt Information for installation 1isezmoi txt Full history of previous updates in French UGRAPH Philosophy uGRAPH has been first developed for data processing of the UDAS data logger Micro Data Acquisition System and was named at this time uDAS Grapher It has been written during my doctorate thesis field missions supported by IPGP and ORB from 1995 to 1997 and a lot on my personal free time In 1996 it became a part of t
29. d F3 v1 9 Release 3 29 dd SS Purpose Syntax Description Remarks GUI See Also 30 Difference dd dd n Compute the difference between 2 or n consecutive data for all channels If a regular sample period T has been detected it computes D X fi n p p intl ti ti n 1 which is the approximate derivative normalized by T per sample period Otherwise it divides by the time interval in second and give values expressed in data unit per second During the graphic visualization use F3 to return to original data undo When n is more than 2 it is equivalent to differentiate after applying a moving average filter on n data Atp dc df F3 AID sample_period uGRAPH User s Manual df AM MMMM Purpose Moving average filter Syntax dfin Description Compute the moving average on n consecutive data for all channels low pass filtering l 1 D gt Did n s j i n 1 During the graphic visualization use F3 to return to original data undo GUI mT See Also dd F3 v1 9 Release 3 21 dh T Purpose Harmonic correction Syntax dh n Description Correct phase data from its first 4 harmonics The number n is equal to the decimal value of binary combination of harmonics where harmonic 1 1 fundamental harmonic 2 2 harmonic 3 4 and harmonic 4 8 For instance n 15 corresponds to the sum of harmonics 1 2 3 4 During the graphic visualization use F3 to return to ori
30. e Syntax Description Examples See Also v1 9 Release 3 Formula coding channel lt x gt cstelvw Formula can be used to process simple calculation on channels or to keep the result of a data calculation simply a copy of a channel The formula_string is a combination of characters for channels and operators read in the order of appearance 1 to U or channel number or all channels 0 time vector in Unix format number of seconds lt x gt constant number real addition subtraction product division right and left modes All following channels will be added subtracted multiplied with or divided by previous result until an other mode encountered Addition mode is default 1 and e logarithm base 10 and exponential of previous result C S and t cosinus sinus and tangent of previous result in radian V and W synchronised time events mode For instance V123 produces a function with steps where there is events on all channels 1 2 and 3 at a same time and flat no where else V12 3w4 excludes events present also on channel 4 1 2 3 4 ch1 ch2 ch3 ch4 123 lt 3 gt 4 ch1 ch2 ch3 3 ch4 123 4 ch4 ch1 ch2 ch3 2 or lt 1 gt 2 or 2 lt 1 gt 1 ch2 12e elchl ch2 31 log ch3 0 lt le 8 gt s sin time 10 f F8 41 fs pS Purpose Normalize scale mode Syntax fs Description For axis with single channel magnify the
31. e 3 17 18 uGRAPH User s Manual Scripts EP Purpose Syntax Description Examples Remarks v1 9 Release 3 Script files argument list filenamel filename2 Script files allow specifying an unlimited number of arguments to UGRAPH A script file is a simple text file that contains a list of argument filenames and or valid options separated by spaces or a carriage return character Recursive calls are ignored mgr example mgr uses arguments in the script file example mgr example dat mdas c example clb g 1 2 b4 pe bk example bok i e data filename import format options calibration and graphic options mgr sta dat a G stafmt mgr stadsp mgr gif will append all the files sta dat using the import format options in stafmt mgr script file display the data using graphic options in stadsp mgr script file then export the result in a GIF image named mgr gif in this case The arguments given on the command line are limited by MS DOS line length cannot exceed 127 characters and some of them are strictly reserved to DOS coma pipe lt gt double quote This limits the number of arguments passed to UGRAPH and limits the use of some options To solve this problem script files must be used The file mgr ini if exists is interpreted as script a file It can be used to set permanent options 19 a Purpose Append files in time Syntax a
32. earance has no importance and numerical values are able to exceed their normal limits i e 12 for month 31 for days 24 for hours 60 for minutes and seconds This allows a lot of possibilities in format and a very simple coding For instance a column that codes the number of second in a day from 0 to 86399 will be simply coded as S In that sense d and j are strictly equivalent day For export the principle is to never lost information on date and time even if uncompleted formats are specified For example yS year and number of seconds in the year dn absolute number of days in fact since 1970 01 01 and number of minutes in the day yd yj year and number of day in the year ordinal date Thus d and j are also equivalent at export if only year is specified and not the month Indeed the j character has been kept in order to fix 3 digit number with leading zeros especially when using the ISO standard at export see iso Fractions dot are not allowed at import for year y and month m since they do not constitute regularly spaced bases leap year 28 to 31 days for months In these cases the fractions will be ignored and only the integer part will be considered However for the time characters d h n S and J fractionate parts will be converted in hour minutes or second correctly See Also i iso F1 header t tr 40 uGRAPH User s Manual formula_string _ _ irre Purpos
33. en display in a GIF image file filename The export takes few seconds while the mouse cursor disappears To obtain best results use SVGA resolution PED full display screen CQ and set the screen colors to white background F9 This option makes a screen copy and writes a binary file in GIF87a format no transparency color Prefer the gi f extension for filename if you want an automatic recognition with photo editor software s Jor filename F F9 CF 9 ShtFg 69 GUI F2 pe Purpose Graphic and data information Syntax F2 or I channels selects one channel selects all channels F6 changes line type cti Eg changes marker type F2 for phase type only displays a second page of information Enter validates selection Esc returns to graph Description Displays one or two window s with actual graphic and data parameters and allows selecting channels to draw and graphic type Gr graph number and line type Name channel name unit and number RMS Difference an estimation of short term noise root mean square of derivative Resol smallest non zero value between two consecutive data Mean Value average of displayed data see O Linear Coeff linear regression rate of displayed data see L Valid Data percent of existing data calculated from global time interval and time period Over Scale for DAS data type only number of over scale corrected see m Over Range fo
34. eo card compatibility 0 320 x 200 pixels 1 640 x 350 pixels EGA 2 640 x 480 pixels VGA default 3 800 x 600 pixels SVGA 4 1024 x 768 pixels XGA Remarks The default resolution VGA is usually sufficient for data analysis but higher modes may be necessary to produce better quality graphics see Shit 1 Lower modes can be used to run UGRAPH on pocket PC Command vga See Also AIN F9 F9 84 uGRAPH User s Manual GUI F9 EE Purpose Full screen mode Syntax CHI Eg CEQ returns to normal screen mode Description Toggles normal screen full screen mode Default screen mode includes a header with clock and information on file s and channels The full screen mode contains only data axis and a bottom line for simplified legend and prompt Command pe See Also AIN F9 CF v1 9 Release 3 85 GUI F10 e e Purpose Exit Syntax F10 Do you really want to quit Enter to confirm Description Exit the program with prompt confirmation See Also ANg 86 uGRAPH User s Manual header __ H Sr Purpose Syntax Description Example v1 9 Release 3 Header files DATE creation date PROG command_line INFO information TITL title SHOT n SAMP time_sampling CHAN time and data format The file header of UGRAPH is managed internally by the program or created by EDAS download utilities It allows handling basic information on file formats and pro
35. eriod If no regular acquisition period is detected the line is continuous For line types see also the F6 and CEG keys GUD See Also g F2 F6 F6 48 uGRAPH User s Manual GUI menu NN Purpose Syntax Description See Also v1 9 Release 3 Graphic user interface functions Any GUI functions keyboard or mouse graph_string Enter gt Home End PgUp PgDn Esc When entering GUI mode UGRAPH displays a graph screen and a set of functions are available on keyboard or mouse see all following GUI pages s Release 3a FB May 2004 Fri 14 May 2004 07 37 54 Time Any graph_string character prompts for graphic string editing Enter applies and Esc cancels or keys zoom in or out in time by a factor of 2 At the bottom left of the screen the zoom factor is indicated default is X1 See also mouse functions Left and right arrow keys gt shift the view backward or forward by half screen if a zoom is active At the bottom left and bottom right of the graph axis date and time interval is displayed Home and End function keys go to the begin or end of the time interval keeping the zoom factor Esc returns to plain time view no zoom graph_string GUI mouse GUI functions 49 GUI A pe Purpose Display the Data menu Syntax AtA ESC returns to main menu Description Display the available Data menu function keys Alto offset AltL Linear AltD Derivative Altc CumS
36. excluding data lines that contain text or non numerical characters It will apply to all imported files See Also i xX v1 9 Release 3 123 y D Purpose Specify date and time reference Syntax y time_string Description Specifies date and time reference when importing uncompleted file s This option will impose a part of date and time to all data See Also iat time_string yn 124 uGRAPH User s Manual M Purpose Syntax Description Examples See Also v1 9 Release 3 Specify date and time reference from filename yn date_string Searches for time reference in the imported data filenames The time will be completed for each file The date_string uses the same codes defined for format_string but it describes in this case the meaning of each character of the filename X replaces an unknown character sta0225 d97 is one of the daily files acquired containing columns with hours minutes and data channels but no date reference except in the filename itself with format StaMMDD dYY here on February 25 1997 To import all the similar files and complete the time reference use the following options mgr sta i hn a yn xxxmmdd xyy a filename format_string 1 y 125 zb ze Purpose Zoom time interval Syntax zb time_string Ze time_string Description Specify a begin and or end date and time by time_string to zoom the first graphic display GUI AR See Also b e 126 uGRAPH Use
37. ginal data undo Examples mgr tide dat hicum s2 dh 1 computes a periodic histogram on wave S2 then removes the fundamental to give the residue GUI Altyy See Also hicum F3 F7 I 32 uGRAPH User s Manual dl S Purpose Linear correction Syntax dl Description Correct all channels from its linear regression trend During the graphic visualization use F3 to return to original data undo GUI Ay See Also do F3 F7 I v1 9 Release 3 33 do ee Purpose Mean value correction Syntax do Description Correct all channels from its mean value offset During the graphic visualization use F3 to return to original data undo GUI AO See Also d1 F3 F7 7 34 uGRAPH User s Manual NNN Purpose Extract data until a specific date and time end Syntax time_string Description Specify end date and time by time_string to keep only data with time reference before this limit Examples mgr example dat i ymdhns e 950920 imports data in MDAS format with date and time before 1995 09 20 00 00 00 Remarks This option applies after all other time and date options have been taken into account For instance it supposes that date and time format has been correctly defined with import options See Also b v1 9 Release 3 35 ed ee Purpose Extract data under sampling Syntax edin Description For each data channels imports one data every n data starting with the first data
38. he EDAS European Data Acquisition for Scientists project of the Royal Observatory of Belgium ORB The related functions specific to these materials are still supported and have been extended to recent EDAS hardware s and software s In this framework it has been oriented to help the work on data acquisition stations in natural conditions i e using very basic portable computers for instance without Windows and RAM and with a special need of fast and simple manipulation in order to get a quick view of the data in the field Regarding these constraints we tried to make the software as simple as possible with a lot of automatic settings On the other hand the intuitive aspect and quickness of the program have encountered so much success that it is presently used also on desk computers to process a large range of files and data types For this reason it has been recently renamed UGRAPH and is currently used by various laboratories observatories in the world for data analysis Since UGRAPH is mainly used by students technicians and researchers for monitoring routine data processing an research it must be efficient and must answer to general and specific problems For this reason UGRAPH is an evolutionary software Do not hesitate to contact us if you feel that additional functions of general interest may be added 8 uGRAPH User s Manual Getting Started ett Sart Basic Operations Getting Help Running the progr
39. he file when exported in order to import it without format options GUI F1 See Also header i X xi v1 9 Release 3 101 nt Purpose No negative time Syntax nt Description When importing file s this option excludes any back time data lines See Also i sort 102 uGRAPH User s Manual 2 Purpose Output file name Syntax 0 filename Description Specifies the output data filename for command line batch By default exported data file will have the name of the first imported data file with extension nn where nn is a 2 digit number automatically set to avoid existing file replacement GUI Fi See Also filename t v1 9 Release 3 103 os pS Pu rpose Output separator character Syntax OS n Description Specifies the ASCII code n for separator character between columns default is a space Here are some values of ASCII codes see a table in your MS DOS User Guide for others 9 tabulation TAB 32 space default 44 coma 45 minus 58 colon 59 semicolon See Also o t tf 104 uGRAPH User s Manual pe Le Purpose Full screen mode Syntax pe Description Sets the graphic screen in full screen mode Default screen mode includes a header with clock and information on file s and channels The full screen mode contains only data axis and a bottom line for simplified legend and prompt It is adapted to export images see g f GUI Cii Fg See Also gif
40. l See Also o os t v1 9 Release 3 115 fime_string a Purpose Date and time coding Syntax YYMMDDHHNNSSsss Description Date and time coding format used by various functions of UGRAPH The complete time_string format is formed by 15 digits 2 digit year month day hour minute second and 3 digit millisecond This string can be truncated anywhere from the right keeping the most significant digits Examples 99 1999 01 01 00 00 00 950920 1995 09 20 00 00 00 000807221455 2000 08 07 22 14 55 Remarks The 2 digit year is interpreted as followed 70 to 99 1970 to 1999 and 00 to 38 2000 to 2038 Years before 1970 and after 2038 cannot be handled by uGRAPH See Also b bk c e header limitations y 116 uGRAPH User s Manual tmp e Purpose Temporary drive Syntax tmp tmp drive Description Specifies the drive for temporary file Without this option UGRAPH use C Default is local drive Remarks uGRAPH needs some drive space to process data about twice the size of imported data files If some RAM is available it may be efficient to set a RAM drive and define it as temporary drive to accelerate processes See Also limitations v1 9 Release 3 117 tr sc Purpose Time restore Syntax tr Description Allows automatic continuous time restore when the imported file s has an uncompleted time reference When the time reference is uncompleted in the data files and files are append uGRAP
41. ls Given a known tide wave or simple period defined by wave this function computes the mean of signal in regular phase intervals 360 divided in p intervals The wave argument can be specified in three different ways 1 xxx xxx Doodson argument for a tide wave i e 164 555 for S1 2 wave_name tide wave name i e SL M2 see mgr_tide dat file 3 n period in samples p corresponds to the number of phase intervals into 360 This function transforms time referenced data into phase data Some additional functions are available in this mode like first harmonic fitting values N fitting preview F7 and correction W Remarks To computes correctly the phases of tide waves data must be referenced in UT Universal Time GMT Use S option to apply a delay if necessary Command hicum See Also Alt AtW F7 hs phase 82 uGRAPH User s Manual GUI F9 oe Purpose Screen colors Syntax F9 F9 F9 F9 I Description Set the screen colors Four modes available hit successively F9 key 2 colors gray on black background 2 colors gray on white background 16 colors dark on white background 16 colors saturated on black background default Command sc See Also Alty Shit Fg C Fg v1 9 Release 3 83 GUI F9 S Purpose VGA video mode Syntax Shif Eg Enter VGA video mode 0 to 4 n Esc to cancel Description Sets the screen resolution Six modes n are available depending on the hardware vid
42. ls of example data file and give a title uGRAPH User s Manual c cf cg cn cv Remarks Calibration file format of previous versions are still accepted uGRAPH detects the header line to read them normally Versions up to 1 8a DIV FREQ FACT CST X XA2 XA3 UNIT NAME Versions up to 1 6a DIV FREQ CST X XA2 XA3_ UNIT NAME Attention the variable CST in these old files correspond to AO in the new version and not CST which is now applied after the multiplication by FACT See Also bk filename m S time_string ctl Fo At Eo v1 9 Release 3 25 com e _ Purpose Real time graphics for uDAS data logger Syntax comx COMmx nnn Description Connect to an EDAS data logger via the COM port x 1 or 2 and display graphic of the data in real time after at least 2 data are received Most of the functions are then allowed zoom scales analysis exporting except formula The first syntax is used for UDAS EEPROM v4 or previous the second syntax is for higher versions when specifying the UDAS or nanoDAS identification number nnn between 001 and 255 Examples mgr com1 connects to a UDAS EEPROM up to v4 on the COM port 1 mgr com2 1 connects to a UDAS EEPROM greater than v4 or nanoDAS with identification number 1 on the COM port 2 26 uGRAPH User s Manual d Purpose Syntax Description Examples See Also v1 9 Release 3 Decimate data average din Fo
43. mum For single channel axes indicates maximum and minimum numerical values on the Y axis legend For multiple channel axes draws each channel on its own scale and indicates percent on Y axis legend unknown scale This allows comparison of different type of data After a zoom use F5 to adjust scales on the new X axis interval Command fs See Also F5 v v1 9 Release 3 73 GUI F5 po Purpose Magnify scale Syntax F5 Description Magnifies Y axis for all channels in order to view existing data in the current X axis interval After a zoom use F5 again to adjust scales on the new X axis interval See Also AY Zooming 74 uGRAPH User s Manual GUI FS ea Purpose Equal scale Syntax Shit E5 F5 returns to normal scale mode Description Adjusts all Y axis scales at the same interval value This is useful when units of all displayed channels are consistent Command es See Also Alyy v1 9 Release 3 75 GUI F6 po Purpose Line type Syntax F6 FET F6 4 Enter validates the choice Description Changes the line type of displayed channels Hitting F6 successively sets the line type to dotted line none solid line default Command g See Also graph_string Cle 76 uGRAPH User s Manual GUI F6 Purpose Marker type Syntax Cini Fg Ctrleg C Fe C F6 Oleg F6 1 Enter validates the choice Description Changes the marker type of displayed channels Hitting CUE successively se
44. on do d1 dd AO ANI AltD 79 GUI F7 ee Purpose Shot over scale limits Syntax Shite7 Description Displays over scale limits for DAS shots data See Also m das mdas 80 uGRAPH User s Manual GUI F8 S 3 Purpose Syntax Description Command See Also v1 9 Release 3 Compute formula F8 Replace channel n Y N yn Enter formula for channel n formula_string Esc to cancel Creates new channel s as the result of an arithmetic combination of existing channels using formula defined by the formula_string The created channel will be labeled automatically If a formula has already been created UGRAPH proposes to replace the previous formula channel Answering N for No will create a new channel Accessing to formula needs a single data file or multiple files in append mode a For concatenated files use the merge function first merge Formula applies eventually on result of data calculations like derivative cumulative sum mean and linear corrections A simple use of the formulas is a copy of a channel to keep in memory these data calculation as separated channels from original data f a formula_string merge 8l GUI F8 SS Purpose HiCum periodic histogram Syntax Shif Eg HiCum Enter the wave name Doodson argument or integer period wave Esc to cancel Enter the number of samples p default is 360 Description Computes HiCum algorithm on all channe
45. r s Manual Technical Notes A v1 9 Release 3 127 Technical Notes Technical Notes References and Acknowledgments Beauducel F Structures and mechanical behaviour of Merapi volcano Java A methodological approach of the deformation field Doctorate Thesis Univ Paris 7 250 pp 1998 Executable program has been compressed with LZEXE written by Fabrice Bellard 1989 SVGA display BGI driver and C source written by Jordan Hargraphix Software 1991 1994 GIF exporting C source code written by Sverre H Huseby 1992 uDAS binary format v8 and HiCum implemented thanks to Andr Somerhausen help Serial protocol interrupt implemented thanks to G Leblanc great book 1993 and AE Belgium documentation 1995 Many thanks for useful comments and bug reports to J Ammann C Antenor P Catherine M F Esnoult H Delorme H Gunawan P Kowalski P Mourot and A Somerhausen 128 uGRAPH User s Manual v1 9 Release 3 129 v1 9 Release 3 Index 131 Index 132 uGRAPH User s Manual
46. r DAS data type only number of excluded data for over scale correction see m Harmonic n 1 to 4 for phase data only phase and amplitude of the first four harmonics see M Mouse left button click on a channel line change line type 70 uGRAPH User s Manual GUI F2 I left button double click on a channel line select one channel only right button click on a channel line change graph number right button double click select all none channel left button click on the Enter area accept selections and redraw Command test partial equivalence See Also graph_string F7 AG 1 A L Oy m v1 9 Release 3 71 GUI F3 po Purpose Undo Syntax F3 Undo last_operation Y N yn ESC to cancel Description Undo the last operation and return to orginal data This function works with the following operations offset correction O linear correction L a derivative finite difference AD cumulative sum O harmonic correction W remove noise spike correction S formula F8 periodic histogram HiCum PFa For the formula the undo function is available only once last calculated formula Idem for spike correction and HiCum back to original data See Also AtA 72 uGRAPH User s Manual GUI F4 Sn Purpose Full normalize scale Syntax F4 F4 again returns to normal scale mode Description Normalizes Y axis for all channels between their minimum and maxi
47. r each data channels computes the average of n data and imports the result starting by the first data line It increases the sampling period and reduces the amount of data by a factor n For DAS shot data computes the sum of the data and not the average in order to allow future calibration in frequency mgr example dat d 6 imports example data originally with a 10 min sampling period and decimates to obtain one data per hour Because the data are DAS shots values are summed and not averaged amount of shots per hour Add the r option to center the average data on the new time sampling period in order to avoid delay but in this case the data will not be causal anymore b ed r 27 das eS Purpose PC DAS data format Syntax das Description Specify that imported data are in PC DAS files format DD MM YY HH NN Chan_1 Chan_2 Chan_3 Chan_4 Chan_5 Chan_6 Chan_7 Chan_8 it reads the date in the first line of file applies it for all the data file sets the format_string to hn and the file type to DAS shots Examples mgr u m95 a das appends all the files U m95 located in the current directory using PC DAS format See Also 1 mdas 28 uGRAPH User s Manual dc 23MM Purpose Cumulative sum Syntax dc Description Compute the cumulative sum for all channels i D d j l During the graphic visualization use F3 to return to original data undo GUI al See Also d
48. s a real counter not FM signal thus time sampling will not be applied and decimation will compute the sum and not the average of the data FACT and CST general factor and constant of calibration applied after the polynomial physical unit per Volt for DAS data AO to A3 and BO to B3 3 order polynomials factors in Volt per Hz for DAS data by default all factors equal 0 except A1 BO 1 The complete calibration formula is given by the relation a a x a x a x d fact f by yx b x b x cst where d is the calibrated data and x is original data frequency in Hz for DAS data A single calibration file can be used to specify several calibration parameters varying in time The two lines VALID and LAG followed by a new table of parameters for each channels can be added below the previous ones This allows to describe for instance the evolution of sensors parameters on the same station There is five ways to use a calibration file C apply full calibration cn apply only names units and book marks for graphics Cf calibrates data in Frequency unit apply only DIV FREQ and SENSOR_NAME CV calibrates data in Voltage unit apply only DIV FREQ 3 order polynomials AO to B3 and SENSOR_NAME CQ calibrates data in Geophysical units only FACT CST and SENSOR_NAME and UNIT mgr example dat i ymdhns c example clb uses default calibration file to name channe
49. specific time events related with data for instance intervention on the station using filename a text file containing lines in the following format begin_time end_time level text_info where begin_time is the begin date and time of event time_string format end_time is the end date and time of event time_string format level is a number to determine the type of dashing 0 Y default 1 YW 2 WN 3 LY 4 5 7 text_info is ignored and can be used to describe the event mgr example dat i ymdhns bk example bok displays 3 different types of events below the example data file The file example bok is 9509161530 9509161800 0 Electronic checking 9509190705 9509190715 6 Seismic event 9509200500 9509200515 2 Data transfert ye uGRAPH User s Manual Purpose Syntax Description v1 9 Release 3 c cf cg cn cv Calibration of the data Ci filename CF filename Cg filename cn filename CV filename To give names and units to the channels a graph title and to calibrate the data uGRAPH uses a calibration file with a specific format This file must contain all information about the data you want to process Especially for DAS data for what specific calculations apply If filename does not exist it will be created and filled with default values like example clb Calibration file is a text file which contains all calibration parameters and other da
50. string Alt Alt r 1 header 66 uGRAPH User s Manual GUI F7 Purpose Syntax Description Command See Also v1 9 Release 3 Merge concatenated files Alte 4 Merge the Files Y N yn Esc to cancel When multiple data files have been imported without append command a they are concatenated Each file is displayed sequentially with its own data channels This function merge the channels to produce a new single file with a single time reference If the time periods are different or if some data are missing for a given date and time intervals data are interpolated using the neighbor method If a nan command has been specified missing data are replaced by Not_a_Number This allows to access to formula calculation XY axis drawing and to export a data file with all channels in a single time referenced table Default answer is yes merge a F F1 F8 Not_a Number 67 GUI F1 pe Purpose Sort data in time Syntax Oley Sort the Data Y N yn Esc to cancel Description Sets the data in chronological order and if necessary deletes redundant data This allows faster display and clean file exporting Default answer is yes Command sort See Also ANE Jnt 68 uGRAPH User s Manual GUI F7 S S Purpose Syntax Description Remarks Command See Also v1 9 Release 3 Make GIF image Shift E1 Enter GIF File Name filename ESC to cancel Exports the scre
51. ta information as keywords followed by arguments then a table of parameters for each channel TITLE text_title BOOK begin_time end_time level BOOK begin_time end_time level VALID begin_time end_time LAG hour SENSOR_NAME UNIT DIV FREQ FACT CST AO A3 BO B3 Chan_1 unkwn 1 0 1 0 Oo 0 I1 0 Chan_z VALID begin_time end_time LAG hour SENSOR_NAME UNIT DIV FREQ FACT CST AO A3 BO B3 Chan_1 unkwn 1 0 1 0 O n O 1 0 Chan_2 where TITLE define text line used as title for graphics BOOK book marks same as bk option The number of these lines is unlimited VALID define the validity time domain of the following calibration parameters begin_time and end_time in time_string format end_time can be omitted for the last set of parameters valid until last data LAG define the time lag same as S option These information must be followed by a table of description and calibration 23 c cf cg cn cv Examples 24 parameters for each channels separated by spaces SENSOR_NAME sensor name 16 characters max UNIT physical unit name 7 characters max DIV 2 16 or 128 frequency divisor for DAS data set in UDAS box FREQ initial frequency in Hz for DAS data shots only this frequency value will fix the number of over scales at the beginning of the file O value also means no change from previous data and 1 value means the sensor i
52. te time and data for file export A header will be added to the file by default see nh to avoid it See format_string examples With g1 f this option is the main batch uGRAPH function because it forces the program to exit after all processes done without entering GUI mode Fi format_string header 1 nh o os tf Lio test aS Purpose File test mode Syntax test testin Description Displays in DOS text mode information about file format and data you may import This function supposes that the import format is OK so use 1 if you do not know it exactly Two modes n are available 0 displays number of columns and acquisition period reads only file header default 1 display also statistics on the data like in the Data Information Window in GUI mode reads the whole file See Also a 114 uGRAPH User s Manual tf S Purpose Export numerical format Syntax t C_printf_format Description Specifies the numerical format for export data file using C_printf_format string Default is 1 8g for 8 digit maximum generic float format which works correctly with integers and floats and reduce file space Example t 03 4F will write the data in a formatted columns with 3 digit before point leading zeros if necessary and 4 digit after the decimal point Remarks Attention Respect strictly the C syntax because UGRAPH does not make any verification See any C code printf command manua
53. ts the line type to dots crosses squares circles bars none default Command g See Also graph_string F6 v1 9 Release 3 77 GUI F6 a e Purpose Grid on off Syntax Shit Eg Description Turns the grid on or off grid on by default Command gd See Also 78 uGRAPH User s Manual GUI 7 o Purpose Syntax Description See Also v1 9 Release 3 Data fitting preview F7 F7 F7 Enter applies the offset or linear correction Displays average linear trend or period counting This function has two different modes 1 If the displayed data are original i e there is no Offset Linear Derivative or Cumulative Sum calculations then press FZ successively shows the average the linear trend returns to normal mode If a single channel is displayed the numerical values of the fitting will be displayed on the right side of the graph These grey lines are shown for each graph and correspond to the correction which will be applied when using Offset or Linear modes Press Enter applies the correction similar to O or Alt Note that in X Y mode the average shows a small cross the gravity centre of data instead of a line 2 If one of the Offset Linear or Derivative modes are active and only one channel is displayed then press FZ once indicates on the right vertical label the average period of the signal obtained by counting time intervals between zeros positive transiti
54. um AltT Filter Altw WaveHarm appears only with phase type files AltS Spike F3 Undo F8 Formula appears only with single appended or merged files shiftF8 Hi cum appears only with time referenced files Example Data ca Offset Linear Derivate CumSum Filter Spike F3 Undo F8 Formula SNAPS HiCum Remarks It is not necessary to use this command to access functions this is just a help for the user See Also GUI menu ALO Ati AnD al AIT as F3 F8 Shift Eo 50 uGRAPH User s Manual GUI C Sn Purpose Cumulative sum Syntax AG F3 returns to original data Description Compute and display the cumulative sum for all channels D S j 1 Command dc See Also AtA F3 v1 9 Release 3 Jl GUI D pe Purpose Difference or derivative Syntax AtD Approximate Derivative n Esc to cancel F3 returns to original data Description Compute and display the difference between 2 or n consecutive data for all channels If a regular sample period T has been detected it computes p i fi n p l ti ti n 1 which is the approximate derivative normalized by T per sample period Otherwise it divides by the time interval in second and gives values expressed in data unit per second Remarks When n is more than 2 itis equivalent to differentiate after applying a moving average filter on n data Command dd See Also AtA F3 52 uGRAPH User s Manual GUI F o Purpose Syntax Description
Download Pdf Manuals
Related Search