gds-csv-info(1)

NAME
gds-csv-info - Shows information from GDS oscilloscope .CSV files

SYNOPSIS
gds-csv-info csv-files... csv-directories...

DESCRIPTION

  Function
gds-csv-info displays information about the content of GDS oscilloscope .CSV files in a window. These are files containing data of the form

    Memory Length,500
    Trigger Level,1.360E+00
    Source,CH1
    Vertical Units,V
    Vertical Scale,5.000E-01
    Vertical Position,-9.600E-01
    Horizontal Units,s
    Horizontal Scale,2.500E-04
    Horizontal Position,0.000E+00
    Horizontal Mode,Main
    Sampling Period,1.000E-05
    Firmware,V1.0
    Time,11-Jun-09 19:08
    Waveform Data
    1.98
    0.02
    <in total Memory Length lines of data>

The program only considers files with particular names. See ARGUMENTS below. All other files are ignored. The information displayed for each file are

    Name Time Source Length Mode

A '?' in a column indicates the information couldn't be found. For example, because the file doesn't contain GDS CSV data.

  Together with nautilus
The script is suitable as a GNOME nautilus(1) file browser script extension. When gds2000tools is installed the installation also tries to install the script in a way it can be found and used by the nautilus-script-manager(1) (when installed as root), or directly as a nautilus script extension for a user (when installed by a normal user).

ARGUMENTS

csv-files...
    A list of files, potentially containing GDS oscilloscope CSV data. Only file names of the form

    *.csv
        Any kind of .csv data, for example obtained with gdsh(1)'s gds-csv command

    DS????.CSV
        Single waveform data, obtained by a save operation to a USB stick or SD card.

    A????CH?.CSV
        Single waveform data, obtained as part of a Save All save operation to a USB stick or SD card

    A????RF?.CSV
        Reference A - D data, obtained as part of a Save All save operation to a USB stick or SD card

    and

    A????W??.CSV
        Memory data, obtained as part of a Save All save operation to a USB stick or SD card

    are considered. Note the upper case. All other file arguments are ignored.

csv-directories...
    A list of directories, potentially containing oscilloscope CSV data. Each directory is searched for files with names as described above. The search is not recursive.

BUGS
The window provides a Cancel and OK button. Both close the window. This is a limitation of zenity(1).

FILES

*.csv, DS????.CSV, A????CH?.CSV, A????RF?.CSV, A????W??.CSV
    Oscilloscope CSV files.

~/.gnome2/nautilus-scripts
    Script installation directory when installed by a non-root user.

/usr/share/nautilus-scripts
    Script installation directory when installed by a superuser. Supposed to be used by nautilus-script-manager(1).

EXAMPLES
Displaying information from the command line

    gds-csv-info /media/usbstick/*.CSV

To display information from within nautilus select one or more files or directories and use the menu File->Scripts->gds-csv-info, or the context menu (right click).

SEE ALSO
nautilus(1), nautilus-script-manager(1), zenity(1).

COPYRIGHT
Copyright © 2010 Thomas Weidenfeller

gds2000tools/gds-csv-info is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version .B 3 as published by the Free Software Foundation.

gds2000tools/gds-csv-info is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with gds2000tools/gds-csv-info. If not, see <http://www.gnu.org/licenses/>.