gds-csv-to-afg(1)

NAME
gds-csv-to-afg - Convert GDS oscilloscope waveform data to GW Instek AFG function generator data

SYNOPSIS
gds-csv-to-afg [-d] [-f csv|scpi] [-h] [-o out. (csv|scpi|...)] [-t afg3051|afg3081] [-v] [--] [gds.csv]

DESCRIPTION
gds-csv-to-afg(1) converts GW Instek GDS oscilloscope waveform CSV data to GW Instek AFG function generator waveform data.

  Alternative
Owners of a GDS-2000 series oscilloscope might consider the generator's Direct Waveform Reconstruction (DWR), aka DSO Link feature instead. Using DWR / DSO Link, however, results in the loss of remote access to the GDS-2000, since that link is then occupied by the AFG-3000.

OPTIONS

-d  Adjust DC component of the signal to maximize available amplitude range. Sample values are centered around 0 V. Usage is recommended for the SCPI format.

-f csv|scpi
    Output format. csv indicates GW Instek AFG CSV file format. scpi indicates GW Instek AFG SCPI commands.

-h  Short help information.

-o filename
    Output file with the function generator arbitrary waveform data. - indicates standard output (default). If -f is not given, the output format is taken from the file extension of filename. If -f is given, -f overrides.

-t afg3051|afg3081
    Function generator type. Default afg3051. This option controls the maximum output rate.

-v  Verbose messages.

--  End of options on the command line.

ARGUMENTS

gds.csv
    Input CSV file with GW Instek GDS oscilloscope waveform data in GW Instek oscilloscope data format. - indicates standard input.

FILES

$HOME/.gds-csv-to-afgrc
    Overrides defaults of the program.

BUGS

The data generation for the AFG-3000 function generator series is based on very preliminary information. The information stored in AFG csv files is rather limited.

If the input memory length exceeds the generator's 1 M point capacity gds-csv-to-afg exists with an error message, and does not attempt low-pass filtering and resampling to make the data fit.

gds-csv-to-afg has no means to load the data into the function generator.

EXAMPLES
The following example obtains some waveform data from channel 1 of a GW Instek GDS oscilloscope, and converts it to an rdf file to be later directly loaded into a AFG-3000 series generator. The command line has been split over multiple lines for presentation purposes only.

    gds-csv 1 | gds-csv-to-afg                  \
                   -t afg3051                   \
                   -d                           \
                   -o /media/usbstick/wave1.csv \
                   --                           \
                   -

SEE ALSO
gds-csv-to-rigol(1), gdsh(1).

Arbitrary Function Generator AFG-3000 Series User Manual. GW Instek Part No. 82FG-30820M01. May 2010 edition.

COPYRIGHT
Copyright © 2010 Thomas Weidenfeller

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

gds2000tools/gds-funcgen 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-funcgen. If not, see <http://www.gnu.org/licenses/>.