Command Line Switches

Command line switches allow automated Bode Tool operation from the command line. Refer to the usage and examples below.

Usage

bode_NT [-control<0-9>]
[-firstMotor <0-9>][-secondMotor <0-9>] [-phantomMotor<0-9>]
[-startFreq <0-20000>] [-endFreq<0-20000>]
[-stepPercent<0-400>]
[-exciteAmp<0-32767>]
[-autoStart] [-autoStop]
[-sineSweep] [-noise]
[-numSamples <0- >]
[-fftPoints <0- >]
[-percentOverlap<0-50>]
[-testType <0- >]
[-firstCoeff <1 - -1> ][-secondCoeff <1 - -1> ]
[-secondMotorEnabled <0, 1>
[-userInput <>] [-userOutput <>]
[-customInput <>] [-customOutput <>]
] [-port <0- >]
[-serverName <server name> ]
[-plant]
[-fileName <file name>]

Most command line switches shown above are direct analogies to the data that would be entered into the fields in the Bode Tool GUI.

Instructions

When using the command line switches in a script, set as many parameters as you can. The Bode Tool will use the values from the last session, if you do not specify the value at the command line.

Be sure to specify -noise or -sineSweep.

When using the -noise switch, specify the testType (usage below) to make sure you have the intended test type.

Examples

bode_NT -control 1
Starts the Bode Tool on controller 1

bode_NT -exciteAmp 5000 -autoStart
Starts a sine sweep test with an amplitude of 8000 and a default frequency range.

bode_NT -firstMotor 3 -phantomMotor 5 -exciteAmp 5000 -autoStart
Starts a sine sweep test on motor 3 using motor 5 as the phantom and amplitude of 5000.

Bode NT -noise -exciteAmp 5000
Starts a random noise test on motor 1 with an amplitude of 5000.

Notes

The -autoStart switch starts a sine sweep test with the specified command line settings as soon as the program starts. The results will be displayed when the test in completed. For safety reasons, the large abort button will be displayed during the test.

The -autoStop switch causes the Bode Tool to exit after the measurement is taken. Using this switch along with the -autoStart facilitates automated data collection with the Bode Tool using a batch file or something similar. In this situation, renaming and saving fr.txt will make it easier to collect frequency response measurements at many locations or perform other repetitive tests.

The -exciteAmp switch sets both the sine sweep amplitude and noise amplitude to the value specified by -exciteAmp.

The -fileName command line switch that causes the bode tool to use file name specified instead of fr.txt for storing the test data. This is useful during automated tests that require several trials controlled by an external program. The -fileName switch must be last of all the command line switches entered.

Using the -secondMotor or -secondCoeff command line switches are considered to imply that the test should be performed as a two motor test, if in the sine sweep mode.

The -secondMotorEnabled mode turns the multiple motor test mode on and off. This is useful for running automated test on multiple motor systems where you want to test the motor in a linear, yaw, and independent mode.

The -testType mode lets the user choose what type of noise based test to use. The index indicates which test type to use, in the order they are listed in the drop down box in the main Bode Tool screen.

For example:
Closed Loop - 0
Controller - 1
...
User Buffer - 5

The userInput and userOutput switches correspond to the User Buffer test type indices.

The customInput and customOutput switches correspond to the Custom test type indexes. Custom index uses only hex inputs, whether they are led by "0x" or not.

For example:
-customInput 0x100 is the same as -customInput 100
-customInput 0xabc and -custom abc are both equivalent and valid

Previous | Next