User Line Units Name

Controls: Calibration Menu >> User Units >> User Line
Macro: UserName

If the selected User Line does not use a .CAL or .FRD file, this control allows you to specify the units associated with the above Units/Volt factor. The units name must be 4 characters or less. It should not include any size prefix like 'm' or 'k', so you may need to adjust the Units/Volt factor appropriately.

Note that 'SPL' should not be entered manually as a units name. Instead, use 'Pa' (Pascal) to enable the SPL button in Y-log Spectrum mode. To convert from SPL to Pa, see Formulas for Working with Sound. (If you use a .CAL or .FRD file, you can use either SPL or Pa and Daqarta will make the conversion automatically.)

If the line uses a .CAL or .FRD file, this control will be disabled but will show the Unit name from the file.

It will also be disabled whenever the units have been manually set to 'Pa', and the SPL button is active. Note that in waveform display mode (Spectrum and Sgram/PT buttons off), or if Spectrum is active but Y-log is off, the SPL button is also disabled. To change the name in this case, you must make sure Spectrum and Y-log are active (so that the SPL button is enabled), then toggle SPL off to enable Units Name. Then you can change from 'Pa' to something else.

If you are viewing data from a file instead of live, and the file is a .DQA or .WAV type, closing it after changing the Units (with User Units active and the line enabled so the change is visible) will result in a prompt to save the changed file.

Macro Notes:

If the relevant User Line dialog is open, UserName="Pa" will set the name to 'Pa' (Pascals). You can optionally omit the quotes as in UserName=Pa, but it's a good idea to use them; quotes are mandatory if there is an internal space in the name, as in UserName="My U". Note that only the first 4 characters will be accepted.

To change the name directly when the dialog is not open, use a Uxx. prefix before the macro command to specify which line it refers to, as in U0L.UserName=Pa.

U0L. through U7R. specify Input lines 0-7 and the Left or Right channel of each.

If your card has only Master Input lines, UIL. or UIR. prefixes will specify them here.

If your card has only Master Output lines, specify them with UOL. or UOR. prefixes.

Otherwise, UWL. and UWR. prefixes specify Wave Out lines.

If a data file is open, UIL. and UIR. prefixes specify Left and Right Input lines, while UOL. and UOR. specify Output lines.

You can read the current UserName as a numeric variable, as in UA=LO.UserName. (Note that since names can hold only 4 characters, they fit into an integer variable like U0-UZ or Q0-QZ.) You can then test it with an IF statement like IF.UA="Pa".

Alternatively, you can test the current name directly with IF.LO.UserName="Pa".

You can copy the current name to a string such as a message like Msg, a String Array like Str0, or a Label or Field by specifying alphanumeric format with (A) suffix, as in Field1=LO.UserName(A).

See also User Units dialog, User Line Dialog