RF One-Port Calibration

Estimate the three error terms from known one-port standards, then apply the coefficients to correct new measurements made under the same conditions.

Measurements and standards

Supply three or more distinct known standards and the corresponding measured coefficients in the same order. The model separates directivity, reflection tracking, and source match. Apply the result to new measurements made under the same conditions. The solver rejects degenerate standards. Repeating a known reflection coefficient adds no independent information.

Operation reference

Jump to an operation

calibration.one_port_solve

A contains the measured Γ values and B contains the known standards in the same order. The result includes directivity, reflection tracking, source match, and solve diagnostics.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Complex vectors or a struct containing the error coefficients (complex_vectors_or_error_struct)
Units
Dimensionless
Result
Numerical and diagnostic fields
Purpose
Three-term error model estimated from one-port standards
gxtxt_api_call("RF_NETWORK_API_v1", "calibration.one_port_solve", args)
Recorded result · calibration.one_port_solve:complex

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      3,
      1
    ],
    "real": [
      -0.7602343209106873,
      0.17705420333347624,
      0.8781546946104252
    ],
    "imaginary": [
      0.205534451915352,
      0.043124789993973414,
      -0.11646163677586814
    ]
  },
  {
    "kind": "array",
    "shape": [
      3,
      1
    ],
    "real": [
      -0.81,
      0.17,
      0.93
    ],
    "imaginary": [
      0.23,
      0.05,
      -0.17
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "directivity_real": 0.020000000000000018,
  "directivity_imaginary": -0.009000000000000008,
  "tracking_real": 0.9399999999999997,
  "tracking_imaginary": 0.030000000000000027,
  "source_match_real": 0.033000000000000286,
  "source_match_imaginary": -0.01999999999999995,
  "residual_norm": 3.4050107584574765e-16
}
Rejected input or attempted run · calibration.one_port_solve:degenerate

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      3,
      1
    ],
    "real": [
      -0.9587628865979381,
      0.02,
      0.9417475728155339
    ]
  },
  {
    "kind": "array",
    "shape": [
      3,
      1
    ],
    "real": [
      1,
      1,
      1
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

"GXTXT:ScriptBridge:RemoteError: RF_NETWORK_API_v1/calibration.one_port_solve: calibration standards are not independent"

calibration.one_port_apply

A contains the measured Γ values and B is the struct of complex calibration coefficients. The operation returns corrected Γ for each compatible measurement.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Complex vectors or a struct containing the error coefficients (complex_vectors_or_error_struct)
Units
Dimensionless
Result
Numerical and diagnostic fields
Purpose
Application of supplied one-port error coefficients
gxtxt_api_call("RF_NETWORK_API_v1", "calibration.one_port_apply", args)
Recorded result · calibration.one_port_apply:held-out

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      -0.3057030753422854
    ],
    "imaginary": [
      0.2503102207692132
    ]
  },
  {
    "kind": "struct",
    "fields": {
      "directivity_real": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          0.020000000000000018
        ]
      },
      "directivity_imaginary": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          -0.009000000000000008
        ]
      },
      "tracking_real": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          0.9399999999999997
        ]
      },
      "tracking_imaginary": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          0.030000000000000027
        ]
      },
      "source_match_real": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          0.033000000000000286
        ]
      },
      "source_match_imaginary": {
        "kind": "array",
        "shape": [
          1,
          1
        ],
        "real": [
          -0.01999999999999995
        ]
      }
    }
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": -0.34,
  "value_imaginary": 0.27999999999999997
}