Chapter 11: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
 
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
=Sequence Testing=
=Sequence Testing=
==Goal==
== Goal ==
The goal of sequence testing is to run different (type of) tests after each other, without the intervention of a test engineer. These tests can be of the same type or of completely different types.


The goal of sequence testing is to run different tests after each other without the intervention of a test engineer. These tests can be of the same type or completely different types.  
The sequence testing functionality can for example be used to:
* Run a radiated emission test, a conducted emission test and a radiated immunity test (all performed in the same anechoic chamber) after each other.
* Another example is the situation where different amplifiers are used for different frequency bands. For this situation, multiple [[TSF]] files can be generated where each TSF file defines one of the frequency bands. All the created TSF files, can then be placed in a sequence so they can be run like one test. The same is true for antenna polarisation, where a horizontal and a vertical TSF file can be created and be put into a single sequence.
* three (or more) different conducted emission frequency bands can be added to a sequence file, and be tested sequentially after each other.


For example: a radiated emission test, a conducted emission test and a radiated immunity test (performed in an anechoic chamber) can be started after each other. Another example is the case where different amplifiers are used for different frequency bands. TSF files for each frequency band are created and put in a sequence so they can be run like one test. The same is true for antenna polarisation. A horizontal and a vertical TSF file can be created and put into a sequence.


On the other hand, three different conducted emission frequency bands can be added to a sequence file, and be tested sequentially after each other.
{{Warning|Sequence testing allows unattended testing. However some tests can cause dangerous situations. Please be especially aware with immunity testing!}}


{{Warning|Sequence testing allows unattended testing. However some tests can cause dangerous situations. Please be especially aware with immunity testing!}}
Especially in combination with the [[#Pause|Pause]] test, sequence testing can be very attractive to easily automate a fixed combination of tests.


== Creating and saving a sequence ==
== Creating and saving a sequence ==
Line 42: Line 45:
Check if the correct sequence name is mentioned.
Check if the correct sequence name is mentioned.


== Adding a test to a sequence ==
=== Adding a test to a sequence ===


When a sequence file has to be modified, the file can be opened from the menu:
When a sequence file has to be modified, the file can be opened from the menu:
Line 58: Line 61:
If the changed TSF file should also be updated in the sequence, the corresponding TSF file has to be removed from the sequence, and the changed TSF file has to be added again to the sequence.}}
If the changed TSF file should also be updated in the sequence, the corresponding TSF file has to be removed from the sequence, and the changed TSF file has to be added again to the sequence.}}


== Changing a test in a sequence ==
=== Changing a test in a sequence ===
The configuration of a TSF that is already included in a sequence, can be changed by selecting the test in the sequence and pressing the {{ScreenElement|Edit}} button.
The configuration of a TSF that is already included in a sequence, can be changed by selecting the test in the sequence and pressing the {{ScreenElement|Edit}} button.


The TSF window of the selected test will be shown, and it is possible to change any parameter. When all the required parameters are changed, pressing the {{ScreenElement|Store}} button will update the configuration of the TSF file in the Sequence, and the TSF window will be closed.
The TSF window of the selected test will be shown, and it is possible to change any parameter. When all the required parameters are changed, pressing the {{ScreenElement|Store}} button will update the configuration of the TSF file in the Sequence, and the TSF window will be closed.


== Removing a test from a sequence ==
=== Removing a test from a sequence ===
On the other hand, TSF files can be deleted from the sequence list, by selecting the test in the sequence and pressing the {{ScreenElement|delete}} button.
On the other hand, TSF files can be deleted from the sequence list, by selecting the test in the sequence and pressing the {{ScreenElement|delete}} button.


==Changing the order of the tests==
=== Changing the order of the tests ===
The order off the tests in the sequence can be changed by selecting the desired test and click the up or down arrow in order to promote or demote this specific test.
 
== Starting a sequence ==
A sequence can be started by selecting from the menu:
{{Menu|Tests|Sequence|Start Sequence...}}
 
A file selection window will be shown, in which a sequence file (*.SEQ) can be selected. As soon as the sequence file is opened, {{RadiMation}} will start to perform all tests that are selected in the sequence, in the order in which they are specified.
 
While the sequence is running, the Sequence Overview window is being shown, which shows the contents of the sequence file, and indicates which test is currently running.
 
The sequence overview window can also be made visible by selecting from the menu: {{Menu|Tests|Sequence|Sequence overview...}}.
 
[[Image:Sequence overview.png]]
 
== Stopping (a test in) a sequence ==
To end the currently running test in the sequence, press the {{ScreenElement|Stop}} button in the test itself. {{RadiMation}} will then interrupt the current test as soon as possible, save the already determined test data, and continue to the next test that was configured in the sequence.
 
There are two ways to stop the complete sequence:
# Press the {{ScreenElement|Stop sequence}} button in the Sequence overview window.
# Select the menu entry {{Menu|Tests|Sequence|Stop Sequence...}}.
 
When the {{ScreenElement|Auto close}} checkbox is unchecked, the sequence overview window will not automatically close at the end of the sequence. This allows to review the actual status of the sequence, and if it has actually finished running all tests. The sequence overview window has to be closed manually by the user.
 
When the {{ScreenElement|Auto close}} checkbox is checked, the sequence overview window will be closed automatically if the sequence has finished executing all tests.
 
== Pause test ==
{{:Pause test}}
 
== Command Line Interface (CLI) ==
From {{RadiMation}} version 2023.1.2, it is possible to automatically start a sequence from the command line.
This can be accomplished by calling "radicli.exe", which is available in the same directory in which {{RadiMation}} is also installed.
 
{{Note|When a sequence is started with the command line interface and there is an active instance of RadiMation, the sequence will be started in the active instance. Otherwise {{RadiMation}} will be automatically started with the same version as the radicli.exe used.}}
 
"C:\Program Files (x86)\Raditeq\RadiMation\Version x.y.z\radicli.exe"


The order off the tests in the sequence can be changed by selecting the desired test and click the up or down arrow in order to promote or demote this specific test.
To start a sequence from the command line, first open command prompt and go to the correct path. Then pass at least the verb "startsequence", eut filename and the sequence filename.
 
{{Example|header=Example to start the sequence:
|text=cd "C:\Program Files (x86)\Raditeq\RadiMation\Version x.y.z\"
 
radicli.exe startsequence --eut "C:\EUT_Files\eutfile.eut" --sequence "C:\sequence files\sequencefile.seq"
}}
 
The possible arguments are:
{|class="wikitable"
!style="column-width: 350px;" | Argument
! Description
|-
| startsequence || Required verb that specifies that a sequence should be started from the command line interface.
|-
| --eut <eutfilename> || Required argument that specifies the EUT filename that should be used.
|- style="break-inside:avoid-column"
| --sequence <sequencefilename> || Required argument that specifies the sequence filename to use.
|-
| --help || Shows all the possible command line arguments that can be used.
|}


==Stopping test in sequence==
It is also possible to close the {{RadiMation}} instance by calling "radicli.exe"


There are two ways of stopping a test in a sequence. The first one is only stopping the current running test. The second one is stopping the complete sequence, including the current running test.
{|class="wikitable"
To end the current test press stop, to end the current test and sequence press stop sequence. The stop sequence button will appear only when running a test in sequence mode.
!style="column-width: 350px;" | Argument
! Description
|-
| close|| Required verb that specifies that {{RadiMation}} should be closed from the command line interface.
|-
| --help || Shows all the possible command line arguments that can be used.
|}


[[Image:Stop Sequence Window.png]]
{{Example|header=Example to close {{RadiMation}}:
|text=radicli.exe close
}}


[[Category:Manual]]
[[Category:Manual]]

Latest revision as of 12:17, 22 October 2024

Sequence Testing[edit]

Goal[edit]

The goal of sequence testing is to run different (type of) tests after each other, without the intervention of a test engineer. These tests can be of the same type or of completely different types.

The sequence testing functionality can for example be used to:

  • Run a radiated emission test, a conducted emission test and a radiated immunity test (all performed in the same anechoic chamber) after each other.
  • Another example is the situation where different amplifiers are used for different frequency bands. For this situation, multiple TSF files can be generated where each TSF file defines one of the frequency bands. All the created TSF files, can then be placed in a sequence so they can be run like one test. The same is true for antenna polarisation, where a horizontal and a vertical TSF file can be created and be put into a single sequence.
  • three (or more) different conducted emission frequency bands can be added to a sequence file, and be tested sequentially after each other.


Warning-48px.png
Warning: Sequence testing allows unattended testing. However some tests can cause dangerous situations. Please be especially aware with immunity testing!

Especially in combination with the Pause test, sequence testing can be very attractive to easily automate a fixed combination of tests.

Creating and saving a sequence[edit]

From the main menu, select:

   Menu.svg File
      Menu.svg New
         Menu.svg Sequence

A new sequence file will be created. To add a test to a sequence, open the test configuration menu for the desired test, and select the desired TSF file.

This sequence file can be saved through the pull down menu:

   Menu.svg File
      Menu.svg Save as


EXAMPLE 1:

Select:

   Menu.svg File
      Menu.svg New
         Menu.svg Sequence

Enter a description for this sequence file


   Menu.svg Tests
      Menu.svg Radiated immunity
         Menu.svg Substitution

select the desired TSF file from the list.


Sequence Select TSF File Window.png

The TSF file will now be added in the sequence window as shown the picture below.

Sequence Configuration Window.png

To save the sequence file, select:

   Menu.svg File
      Menu.svg Save sequence as...

Check if the correct sequence name is mentioned.

Adding a test to a sequence[edit]

When a sequence file has to be modified, the file can be opened from the menu:

   Menu.svg File
      Menu.svg Open
         Menu.svg Sequence...

The list of current TSF files in the sequence will be displayed.

To add a new test to a sequence, select the desired test from the Tests, pull down menu.

A list of the available TSF files for this test method will be shown. Select the desired TSF file by double clicking on it.

The TSF file will be added to the sequence file.

Information.png
Note: A copy of the selected TSF file will be added to the sequence. This means that if the original TSF file is changed afterwards, the copied TSF that is present in the sequence, will still use the original test parameters.

If the changed TSF file should also be updated in the sequence, the corresponding TSF file has to be removed from the sequence, and the changed TSF file has to be added again to the sequence.

Changing a test in a sequence[edit]

The configuration of a TSF that is already included in a sequence, can be changed by selecting the test in the sequence and pressing the Edit button.

The TSF window of the selected test will be shown, and it is possible to change any parameter. When all the required parameters are changed, pressing the Store button will update the configuration of the TSF file in the Sequence, and the TSF window will be closed.

Removing a test from a sequence[edit]

On the other hand, TSF files can be deleted from the sequence list, by selecting the test in the sequence and pressing the delete button.

Changing the order of the tests[edit]

The order off the tests in the sequence can be changed by selecting the desired test and click the up or down arrow in order to promote or demote this specific test.

Starting a sequence[edit]

A sequence can be started by selecting from the menu:

   Menu.svg Tests
      Menu.svg Sequence
         Menu.svg Start Sequence...

A file selection window will be shown, in which a sequence file (*.SEQ) can be selected. As soon as the sequence file is opened, RadiMation® will start to perform all tests that are selected in the sequence, in the order in which they are specified.

While the sequence is running, the Sequence Overview window is being shown, which shows the contents of the sequence file, and indicates which test is currently running.

The sequence overview window can also be made visible by selecting from the menu:

   Menu.svg Tests
      Menu.svg Sequence
         Menu.svg Sequence overview... .

Sequence overview.png

Stopping (a test in) a sequence[edit]

To end the currently running test in the sequence, press the Stop button in the test itself. RadiMation® will then interrupt the current test as soon as possible, save the already determined test data, and continue to the next test that was configured in the sequence.

There are two ways to stop the complete sequence:

  1. Press the Stop sequence button in the Sequence overview window.
  2. Select the menu entry
   Menu.svg Tests
      Menu.svg Sequence
         Menu.svg Stop Sequence... .

When the Auto close checkbox is unchecked, the sequence overview window will not automatically close at the end of the sequence. This allows to review the actual status of the sequence, and if it has actually finished running all tests. The sequence overview window has to be closed manually by the user.

When the Auto close checkbox is checked, the sequence overview window will be closed automatically if the sequence has finished executing all tests.

Pause test[edit]

A Pause test is available in RadiMation® to insert informational messages between two tests in a sequence. This Pause test can for example be used to direct the end-user to change the test setup, or it can be a reminder to turn off the amplifier. It is allowed to include multiple Pause tests (also after each other) in a sequence, so it can be used to easily automate a fixed sequence of steps.

The Pause test is available from the menu via:


   Menu.svg Tests
      Menu.svg Other
         Menu.svg Pause

The Pause Data window is used to configure the Pause test.

Pause Data.png

The following elements are available on this window:

ScreenElementDescription.svg Note Is the note (or informational message) that should be shown during the pause period, when the pause test is started.
ScreenElementDescription.svg Automatically disappear after If the checkbox is activated, it is possible to specify a timeout (in seconds) after which the pause test should automatically close. This option allows to show a message for only a determined amount of time, between two tests. When the specified time has passed, the sequence will automatically continue with the next test in the sequence.
ScreenElementDescription.svg Ok Saves the current configuration of the pause test to the TSF file and closes the window.
ScreenElementDescription.svg Cancel Closes the window, without storing the modifications to the TSF file.


The Pause window will be shown, when the Pause test is included in the sequence.

Pause.png

The informational message that was specified in the Pause Data window is shown in a bigger font, to make it more visible. The shown message can also be selected and copied to clipboard (using Ctrl+C).

If a timeout has been specified, the window will automatically close after the specified timeout period. It is however also possible to close the window with the Ok button.

The Pause window will remember its position and size, and will be shown on the same position with the same size, the next time it shown again. This allows the end-user to place the Pause window on a convenient and visible location.

The pause test will not store any test results, and therefore no test results will be added to the list of performed tests in the EUT file.

Command Line Interface (CLI)[edit]

From RadiMation® version 2023.1.2, it is possible to automatically start a sequence from the command line. This can be accomplished by calling "radicli.exe", which is available in the same directory in which RadiMation® is also installed.

Information.png
Note: When a sequence is started with the command line interface and there is an active instance of RadiMation, the sequence will be started in the active instance. Otherwise RadiMation® will be automatically started with the same version as the radicli.exe used.
"C:\Program Files (x86)\Raditeq\RadiMation\Version x.y.z\radicli.exe"

To start a sequence from the command line, first open command prompt and go to the correct path. Then pass at least the verb "startsequence", eut filename and the sequence filename.

Example to start the sequence:

cd "C:\Program Files (x86)\Raditeq\RadiMation\Version x.y.z\"

radicli.exe startsequence --eut "C:\EUT_Files\eutfile.eut" --sequence "C:\sequence files\sequencefile.seq"


The possible arguments are:

Argument Description
startsequence Required verb that specifies that a sequence should be started from the command line interface.
--eut <eutfilename> Required argument that specifies the EUT filename that should be used.
--sequence <sequencefilename> Required argument that specifies the sequence filename to use.
--help Shows all the possible command line arguments that can be used.

It is also possible to close the RadiMation® instance by calling "radicli.exe"

Argument Description
close Required verb that specifies that RadiMation® should be closed from the command line interface.
--help Shows all the possible command line arguments that can be used.
Example to close RadiMation®:

radicli.exe close