Public Overridable Sub SetResourceMap( _
   ByVal value() As Integer _
) 

public virtual void SetResourceMap( 
   int[] value
)

public:
virtual void SetResourceMap( 
   array<int>^ value
) 

Parameters

value

The array specifying the type of each subcarrier and symbol time resource within the signal.

A "resource" is a single subcarrier at a single symbol time. The ResourceMap specifies the type of each resource in the signal. The number of entries in the array should be equal to the number of subcarriers (FftLength - GuardUpperSubcarriers - GuardLowerSubcarriers) times the number of symbols to analyze.

Each value is the array should be one of: 0 = Data, 1 = Pilot, 2 = Unknown Pilot, 3 = Preamble, 4 = Idle, or 5 = Unspecified. Each data subcarrier is detected based on the modulation format assigned to that subcarrier in the ResourceModulation array. Each pilot subcarrier is assumed to have a value specified in the PilotValues array. Each unknown pilot subcarrier is detected, like a data subcarrier, based on the modulation format assigned to that subcarrier in the ResourceModulation array. Both pilot and unknown pilot subcarriers are used for pilot tracking. Each preamble subcarrier is assumed to have a value specified in the PreambleValues array. Each null subcarrier is assumed to be unused and have a nominal signal level of zero. Each unspecified subcarrier is assumed to be completely unknown - it could have some other signal on it so the analyzer makes no assumptions about what value it may have.

In addition to the subcarrier type, as described above, each ResourceMap value also contains information about user ID and antenna number for each subcarrier and symbol time. The above subcarrier type is contained in the bottom three bits of the value (bits 0-2). The next three bits contain the bottom three bits of a user ID (bits 3-5). The three bits above that contain an antenna number (bits 6-8). The bit above that is an "all antenna" flag which specifies whether all antennas are used for this subcarrier and symbol time (bit 9). Finally, the next 5 bits (bits 10-14) contain the top five bits of the user ID (so the user ID has a total of 8 bits).

The user ID allows the subcarriers to be split into logically separate groups. Each user ID can have a different boosting level. For subcarriers that have a QamLevel of 0 (meaning unknown), each user ID separately determines the modulation format. EVM and power levels are computed separately for each user ID.

The antenna number and the "all antenna" flag are used when doing MIMO analysis. The antenna number and all antenna flag apply only to pilot, unknown pilot, and preamble subcarrier types. Data, null, and unspecified subcarrier types are assumed to always apply to all antennas.

For pilot, unknown pilot, and preamble subcarrier types, if the all antenna flag is set then it is assumed that these signals are broadcast simultaneously on all antennas. For pilot subcarriers, the PilotValues array can contain values for the pilots on the first antenna, followed by values for the pilots on the second antenna, and so on. Alternatively, if all pilots broadcast the same value on all antennas, then the PilotValues array need not contain values after the first antenna. Similarly, for preamble subcarriers, the PreambleValues array can contain values for the preambles on the first antenna, followed by values for preambles on the second antenna, and so on. Alternatively, if all preambles broadcast the same value on all antennas, then the PreambleValues array need not contain values after the first antenna.

For pilot, unknown pilot, and preamble subcarrier types, if the all antenna flag is not set, then it is assumed that only one transmitter antenna (specified by the antenna number bits) broadcasts this pilot or preamble. For that subcarrier and symbol time, it is assumed that all other antennas broadcast nothing.

If the ResourceMap array is shorter than the number of used subcarriers times the ResultLength, the analyzer will loop back and re-use entries in the array. The ResourceRepeatIndex property specifies the number of symbols from the start of the array to loop back to.

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

Reference