# :SOURce:FNAMe

Simulated and AWG Commands

- :SOURce:AMPLitude
- :SOURce:CDIVide
- :SOURce:DIFFerential
- :SOURce:FILTer:CUToff
- :SOURce:FILTer:RTIMe
- :SOURce:FILTer:STATe
- :SOURce:FILTer:TYPE
- :SOURce:FNAMe
- :SOURce:FORMat
- :SOURce:FOTWo:JITTer
- :SOURce:FOTWo:STATe
- :SOURce:FUNCtion
- :SOURce:INVert
- :SOURce:JITTer:BLIMit
- :SOURce:JITTer:BLSTate
- :SOURce:JITTer:DRJ?
- :SOURce:JITTer:DRN?
- :SOURce:JITTer:RJ
- :SOURce:JITTer:STATe
- :SOURce:LEVel
- :SOURce:NOISe:RN
- :SOURce:NOISe:STATe
- :SOURce:OENable
- :SOURce:OFFSet
- :SOURce:PATTern
- :SOURce:PLENgth
- :SOURce:PWIDth
- :SOURce:SEED
- :SOURce:SKEW
- :SOURce:SRATe
- :SOURce:SSC:FREQuency
- :SOURce:SSC:PATTern
- :SOURce:SSC:PERCent
- :SOURce:SSC:PHASe
- :SOURce:SSC:PPM
- :SOURce:SSC:STATe
- :SOURce:SSC:STYPe
- :SOURce:WTYPe

## Command Syntax

    :SOURceN:FNAMe  <filename>

<filename> is a string. This command supports the `DEFault` common child command.

Where N identifies a simulated instrument's specific channel in the form "<connection1-8>_<ch1-8>" (for example, `SOURce4_2`). With connection 1, the connection number part (that is, "1_") is optional, and you can simply use the channel number "<ch1-8>" (for example, `SOURce3` which is the same as `SOURce1_3`).

## Query Syntax

    :SOURceN:FNAMe?

## Description

For simulated instruments, loads a waveform file (.h5) to define the waveform. To apply the pattern to the source waveform, use the `:SOURce:WTYPe` command.

### Default User and Demo Folders

The default user data folder for storing waveform files is in `%USER_DATA_DIR%\Waveforms` as shown in this picture. It is good practice to include a path substitution string with the filename. For example, `%USER_DATA_DIR%\Waveforms\filename`.

The default demo folders for loading waveform files is in `%DEMO_DIR%\Waveforms` as shown in the following picture. It is good practice to include a path substitution string with the subfolders and filename. For example, `%DEMO_DIR%\Waveforms\filename`.

Including a path substitution string in the filename ensures that the file will be saved in (or loaded from) the desired folder. Failure to do so may result either in a file created in an parent folder or a file error. Do not append a filename extension as the extension is automatically added.

## Example Command Sequence

    :SOURce2:WTYPe FILE
    :SOURce2:FNAMe "MyPattern.csv"