Command: ChnMultipleSortExt

Display all  Hide all

Command: ChnMultipleSortExt

Sorts the values in data channels. DIAdem sorts texts according to the ASCII table.

Input Parameters

ChnList1	Specifies one or more channels. Channel list variable A channel list is a Channel or Channel list object, or a text that refers to one or several channels. For more information about the value range, refer to Channel lists.
ChnList2	Specifies one or more channels. Channel list variable A channel list is a Channel or Channel list object, or a text that refers to one or several channels. For more information about the value range, refer to Channel lists.
MultipleSortExtOrder	Specifies whether DIAdem sorts values and text in ascending or descending order. String variable The String variable uses the following script terms: Script Term Interface Term, Explanation "Up" Sort in ascending order "Down" Sort in descending order For each control channel you must enter a script term which is separated by a comma. If you use two control channels and define a different sorting order for each channel, the string variable may look as follows: "Down,Up”. If you want to sort both control channels in ascending order, you only need to use a script term: "Up”. If you use more than the two control channels and have only entered two script terms in the MultipleSortExtOrder variable, DIAdem uses the last script term for all other control channels.
MultipleSortExtCaseSensitive	Specifies whether and how DIAdem sorts text case-sensitively. String variable The String variable uses the following script terms: Script Term Interface Term, Explanation "CaseInsensitive" Ignore Upper/Lower Case "UpperCase" Uppercase First "LowerCase" Lowercase First For each control channel you must enter a script term which is separated by a comma. If you use three control channels and define different case sensitivity for each channel, the string variable may look as follows:"CaseInsensitive,UpperCase,LowerCase". If you want to sort all three control channels by UpperCase, you only need to use this script term once:"UpperCase". If you use more than three control channels and have only entered three script terms in the MultipleSortExtCaseSensitive variable, DIAdem uses the last script term for all other control channels.
MultipleSortExtIP	Specifies that DIAdem stores the results in the original channels. Boolean variable Note  If you do not specify a value for the MultipleSortExtIP variable, DIAdem creates new result channels.

Return Parameters

The channels containing values or text, which DIAdem sorts in ascending or descending order, are in the first channel list. The channels that contain values or texts which DIAdem moves according to the values of the channels to be sorted are in the second channel list.

DIAdem sorts the first channel to be sorted in ascending or descending order. DIAdem accordingly moves the values or text of the following channels and of the included channels to the same positions as their counterparts in the first channel. If two values in the first channel are the same, DIAdem includes the sort criteria of the second channel. If two more values in the second channel are also the same, the third channel is used, and so on. If there are two entries with the same channel in the channel list, DIAdem only includes one.

DIAdem generates the same number of result channels as the number of channels to be sorted and the further channels to be sorted. The shortest channel to be sorted specifies the length of all result channels. However, DIAdem does not use 0 length channels for the determination of the length. After calculating, DIAdem fills the 0 length channels up to the length of the result channels with NoValues.

If you want to use waveform channels in this dialog box, this function converts the channels into numeric channels (Rule 1 for Calculating with Waveform Channels.

The following example creates a text channel and a numeric channel. DIAdem sorts the text channel and sorts the numeric channel at the same time.

Dim MyChnGroup1, MyChnGroup2, MyTextChn1, MyTextChn2, MyNumericChn1, MyNumericChn2, i
Data.Root.Clear
Set MyChnGroup1 = Data.Root.ChannelGroups.Add ("Sorted")
Set MyChnGroup2 = Data.Root.ChannelGroups.Add ("Moved")
Set MyTextChn1 = MyChnGroup1.Channels.Add("Text", DataTypeString)
Set MyNumericChn1 = MyChnGroup1.Channels.Add("Numbers", DataTypeChnFloat64)
Set MyNumericChn2 = MyChnGroup2.Channels.Add("MovedNumbers", DataTypeChnFloat64)
MyTextChn1.Values(1) = "abc"
MyTextChn1.Values(2) = "aBc"
MyTextChn1.Values(3) = "Abc"
MyTextChn1.Values(4) = "Abc"
For I = 1 To 4
  MyNumericChn1.Values(I) = I
  MyNumericChn2.Values(I) = I
Next

Set ChnResult = ChnMultipleSortExt(MyChnGroup1.Channels ,MyNumericChn2, "Up,Down", "UpperCase,CaseInsensitive", 0)

dd.Data.Root.Clear() 
MyChnGroup1 = dd.Data.Root.ChannelGroups.Add ("Sorted") 
MyChnGroup2 = dd.Data.Root.ChannelGroups.Add ("Moved") 
MyTextChn1 = MyChnGroup1.Channels.Add("Text", dd.DataTypeString) 
MyNumericChn1 = MyChnGroup1.Channels.Add("Numbers", dd.DataTypeChnFloat64) 
MyNumericChn2 = MyChnGroup2.Channels.Add("MovedNumbers", dd.DataTypeChnFloat64) 
MyTextChn1.Values[1] = "abc" 
MyTextChn1.Values[2] = "aBc" 
MyTextChn1.Values[3] = "Abc" 
MyTextChn1.Values[4] = "Abc" 
for I in range( 1, 4 + 1): 
    MyNumericChn1.Values[I] = I 
    MyNumericChn2.Values[I] = I 
dd.ChnResult = dd.ChnMultipleSortExt(MyChnGroup1.Channels ,MyNumericChn2, "Up,Down", "UpperCase,CaseInsensitive", 0) 

Dialog Box Call

Call SUDDlgShow("Main", ResourceDrv & "AnaChnMultipleSort")

Sort Channel Values

Related Topics

Command: ChnAverage | Command: ChnConvertTextToAssignment | Command: ChnDeriveCalc | Command: ChnDetrendCalc | Command: ChnDifferentiate | Command: ChnEnclosedArea | Command: ChnIntegrate | Command: ChnMirror | Command: ChnMultipleSort | Command: ChnNormalize | Command: ChnNovHandle | Command: ChnOptimizeDataType | Command: ChnPeakFind | Command: ChnPhaseUnwrap | Command: ChnPhaseWrap | Command: ChnRangeLimit | Command: ChnRelativize | Command: ChnRMS | Command: ChnRound | Command: ChnSum