Correlation Commands

These commands set the correlation coefficient between fading channels for the selected path when configuring a custom correlation matrix. Although you can only edit the lower triangle of the correlation matrix over the user interface, you can edit the full matrix over SCPI. Editing a correlation coefficient will cause the coefficient in the transposed position to be updated as well (to the complex conjugate of the entered value). 

Numerical Choices:

FSIMulator[1]|2 – These choices correspond to the Master Setups used in the selected configuration. Only multi-user MIMO uses more than one Master Setup.

FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16 – The fader number refers to the fader simulation block that you are configuring within the correlation group. 

PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24 – These choices select the paths to be correlated. 

TX[1]|2|3|4 – For MIMO OTA multiprobe test ([:SOURce]:FSIMulator:OTA:MProbe:[:STATe] command is set to ON), Tx Correlation is used, since there is no Rx correlation.


[:SOURce]:FSIMulator[1]|2:CORRelation:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:
FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24 "<val>"

[:SOURce]:FSIMulator[1]|2:CORRelation:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:
FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24?

This command sets the correlation coefficient between the two fader blocks on the selected path as a complex number. The <val> must be a quoted string representing a complex number, e.g. "0.5 - 0.3i". with an absolute value between 0 and 1. Out of range values are clipped to a magnitude (absolute value) of 1; however, the phase of the out-of-range value is used.  

Range: absolute value ≤ 1
 

[:SOURce]:FSIMulator[1]|2:CORRelation:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:
FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:IMAGinary <val>

[:SOURce]:FSIMulator[1]|2:CORRelation:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:
FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:IMAGinary?

This command sets only the imaginary value of the correlation coefficient between the two fader blocks on the selected path. If setting the new imaginary component of the complex number causes the complex number to be out of range, then the real component will be clipped to the closest number such that the complex number is in range. If the new imaginary component itself is out of range, then it will be clipped to the closest number that is in range, and the real component will be clipped to 0. If the imaginary component is not a number, then nothing will be changed.  

Range: absolute value ≤ 1
 

[:SOURce]:FSIMulator[1]|2:CORRelation:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:
FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:REAL <val>

[:SOURce]:FSIMulator[1]|2:CORRelation:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:REAL?

This command sets only the real value of correlation coefficient between the two fader blocks on the selected path. If setting the new real component of the complex number causes the complex number to be out of range, then the imaginary component will be clipped to the closest number such that the complex number is in range. If the new real component itself is out of range, then it will be clipped to the closest number that is in range, and the imaginary component will be clipped to 0. If the real component is not a number, then nothing will be changed. 

Range: absolute value ≤ 1

 

[:SOURce]:FSIMulator[1]|2:CORRelation:SPATial:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16?

Correlation coefficients represent the product of spatial and polarization correlation. For diagnostic purposes, the spatial correlation can be queried separately. This query is useful for MIMO OTA test.

 

[:SOURce]:FSIMulator[1]|2:CORRelation:SPATial:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:IMAGinary?

This query returns the imaginary value of the spatial correlation coefficient between the specified faders. This query is useful for MIMO OTA test.

 

[:SOURce]:FSIMulator[1]|2:CORRelation:SPATial:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:REAL?

This query returns the real value of the spatial correlation coefficient between the specified faders. This query is useful for MIMO OTA test.

 

[:SOURce]:FSIMulator[1]|2:CORRelation:TX[1]|2|3|4:
TX[1]|2|3|4:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24 <val>

[:SOURce]:FSIMulator[1]|2:CORRelation:TX[1]|2|3|4:
TX[1]|2|3|4:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24?

This command sets the Tx correlation coefficient on the selected path as a complex number. The <val> must be a quoted string representing a complex number, e.g. "0.5 - 0.3i". with an absolute value between 0 and 1. Out of range values are clipped to a magnitude (absolute value) of 1; however, the phase of the out-of-range value is used.    

This command is only valid when the [:SOURce]:FSIMulator:OTA:MProbe:[:STATe] command is set to ON.  

Range: ±1±i (complex number, magnitude ≤ 1)

 

[:SOURce]:FSIMulator[1]|2:CORRelation:TX[1]|2|3|4:
TX[1]|2|3|4:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:IMAGinary <val>

[:SOURce]:FSIMulator[1]|2:CORRelation:TX[1]|2|3|4:
TX[1]|2|3|4:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:IMAGinary?

This command sets only the imaginary value of the Tx correlation coefficient on the selected path. If setting the new imaginary component of the complex number causes the complex number to be out of range, then the real component will be clipped to the closest number such that the complex number is in range. If the new imaginary component itself is out of range, then it will be clipped to the closest number that is in range, and the real component will be clipped to 0. If the imaginary component is not a number, then nothing will be changed.  

This command is only valid when the [:SOURce]:FSIMulator:OTA:MProbe:[:STATe] command is set to ON.  

Range: ±1±i (complex number, magnitude ≤ 1)

 

[:SOURce]:FSIMulator[1]|2:CORRelation:TX[1]|2|3|4:
TX[1]|2|3|4:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:REAL <val>

[:SOURce]:FSIMulator[1]|2:CORRelation:TX[1]|2|3|4:
TX[1]|2|3|4:PATH[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24:REAL?

This command sets only the real value of the Tx correlation coefficient on the selected path. If setting the new real component of the complex number causes the complex number to be out of range, then the imaginary component will be clipped to the closest number such that the complex number is in range. If the new real component itself is out of range, then it will be clipped to the closest number that is in range, and the imaginary component will be clipped to 0. If the real component is not a number, then nothing will be changed.  

This command is only valid when the [:SOURce]:FSIMulator:OTA:MProbe:[:STATe] command is set to ON.  

Range: ±1±i (complex number, magnitude ≤ 1)