RF Network Composition and De-embedding

Cascade RF networks or connect them in series or shunt. De-embed test fixtures and shift the reference planes using per-port delays.

Order networks and fixtures

Multiply cascaded blocks in the physical order in which the signal traverses the ports. For left de-embedding, the fixture is to the left of the DUT. For right de-embedding, it follows the DUT. To remove both sides, also specify right_fixture. Keep the same ABCD convention when composing blocks and use consistent reference impedances if you start with S. Port extension uses per-port delays and frequency in hertz.

Operation reference

Jump to an operation

compose.cascade

A and B are the two-port blocks in traversal order. For ABCD matrices, the product is A·B.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
Network cascade
gxtxt_api_call("RF_NETWORK_API_v1", "compose.cascade", args)
Recorded result · compose.cascade

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      1.2,
      0.22,
      4.4,
      1.64
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  }
}

compose.deembed_left

A is the measured chain and B is the left fixture. Solve the system for the left fixture to isolate the device under test.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
De-embedding of the left test fixture
gxtxt_api_call("RF_NETWORK_API_v1", "compose.deembed_left", args)
Recorded result · compose.deembed_left

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.0,
      0.0,
      1.0
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  }
}

compose.deembed_right

A is the measured chain and B is the right fixture. The operation removes the fixture from the output side.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
De-embedding of the right test fixture
gxtxt_api_call("RF_NETWORK_API_v1", "compose.deembed_right", args)
Recorded result · compose.deembed_right

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.0,
      0.0,
      1.0
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  }
}

compose.deembed_both

A is the measured chain and B is the left fixture. Set right_fixture for the right fixture. The solve requires both fixture blocks to be invertible.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
De-embedding of both test fixtures
gxtxt_api_call("RF_NETWORK_API_v1", "compose.deembed_both", args)
Recorded result · compose.deembed_both

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.0,
      0.0,
      1.0
    ]
  },
  {
    "kind": "empty"
  },
  {
    "kind": "struct",
    "fields": {
      "right_fixture": {
        "kind": "array",
        "shape": [
          2,
          2
        ],
        "real": [
          1.0,
          0.0,
          0.0,
          1.0
        ]
      }
    }
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  }
}

compose.series

A and B are the networks connected in series. Their impedance matrices are added.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
Series network connection
gxtxt_api_call("RF_NETWORK_API_v1", "compose.series", args)
Recorded result · compose.series

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      60.0,
      5.0,
      5.0,
      75.0
    ],
    "imaginary": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      61.0,
      5.1,
      7.0,
      76.2
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  }
}

compose.shunt

A and B are the networks connected in parallel. Their admittance matrices are added.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
Shunt network connection
gxtxt_api_call("RF_NETWORK_API_v1", "compose.shunt", args)
Recorded result · compose.shunt

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      60.0,
      5.0,
      5.0,
      75.0
    ],
    "imaginary": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      61.0,
      5.1,
      7.0,
      76.2
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  }
}

compose.port_extension

A is S. Set frequency_hz and delay_seconds to shift the reference planes using input and output phase shifts.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
2 × 2 matrices (two_by_two_matrices)
Units
Depends on the representation
Result
Numerical and diagnostic fields
Purpose
Two-port reference-plane shift using explicit delays
gxtxt_api_call("RF_NETWORK_API_v1", "compose.port_extension", args)
Recorded result · compose.port_extension

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      0.1,
      0.6,
      0.6,
      0.2
    ],
    "imaginary": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  },
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      1.0,
      0.1,
      2.0,
      1.2
    ]
  },
  {
    "kind": "empty"
  },
  {
    "kind": "struct",
    "fields": {
      "frequency_hz": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          10000000.0
        ]
      },
      "delay_seconds": {
        "kind": "array",
        "shape": [
          2,
          1
        ],
        "real": [
          2e-09,
          1e-09
        ]
      }
    }
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.09685831611286312,
      0.5893723504372133,
      0.5893723504372133,
      0.19842294026289556
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      -0.024868988716485484,
      -0.11242878875143478,
      -0.11242878875143478,
      -0.025066646712860848
    ]
  }
}