RF Network: Matrix Shapes and Reference Impedances

Prepare network matrices for RF_NETWORK_API_v1 and verify the reference impedance, port ordering, and wave convention.

Port indices and wave conventions

In an S matrix, the row identifies the destination port and the column identifies the source port. For two-port Touchstone files the order is S11, S21, S12, S22. The RF package uses one-based port indices. Keep the reference impedance in ohms as a scalar or one value per port. Set wave_convention='power' or 'traveling' when working with complex references, and use the same convention throughout a comparison.

Operation reference

Jump to an operation

Reserved surfaces and public interfaces

  • ::GX::RFNetworkAPIv1::apiInfo

    Access policy
    REGISTERED_TYPED_ADAPTER
    Public operation
    api_info
    Usage conditions
    The original math.rf_network module reads the installed descriptor, version, and capabilities from a fixed path. The api_info adapter calls that function directly and preserves all fields, capability order, and the original provider version string. It types only the declared API version. The shared registry’s describe metadata has its own contract. The call reads installed metadata only.
  • ::GX::RFNetworkAPIv1::call

    Access policy
    REGISTERED_TYPED_ADAPTER
    Public operation
    call
    Usage conditions
    The public call takes family, action, a, b, c, and an optional typed options struct. It checks the full operation ID against the module’s list and uses ScientificTransportv1 with the original kernel. If options is omitted, the Tcl default applies. The call returns all fields declared by resultTypes through the existing codec, preserving binary64 real or complex components, shapes, and unit strings. Calls for individual families and actions remain available. Signal bulk execution follows its own path. The typed result documents the data returned by the transport. The raw Tcl interface has its own contract.
  • ::GX::RFNetworkAPIv1::listOperations

    Access policy
    REGISTERED_TYPED_ADAPTER
    Public operation
    list_operations
    Usage conditions
    The list_operations call reads the module’s installed TSV and returns its exact identifiers in their original order. Script Bridge registration keys belong to a separate list. For Signal, the original list adds statistical_contract. operation_schema, validate_operation, and the adapters have separate registrations. The call rejects unknown arguments and reads the installed module descriptors.
  • ::GX::RFNetworkAPIv1::operationMetadata

    Access policy
    REGISTERED_TYPED_ADAPTER
    Public operation
    operation_metadata
    Usage conditions
    The operation_metadata call looks up an actual operation ID in the module’s TSV and merges the original family and help metadata. For Signal it retains the complete operationSchema result, including ui_field and final_scientific_checks. It returns argument descriptors and result fields in the original order and preserves the strings for units, defaults, and bounds. An unknown ID returns the module’s original error. The operation reads installed metadata.

api_info

Access
Registered in the Python Job
Arguments
[]
Result
Complete result from the original module through the existing typed transport. The module remains the source of the computation and its provenance.
Purpose
Information about the installed module and its capabilities
gxtxt_api_call("RF_NETWORK_API_v1", "api_info", args)
Recorded result · api_info

Download the example script (ZIP).

Example operands preview

[]

Result preview

{
  "api_id": "RF_NETWORK_API_v1",
  "api_version": 1,
  "provider_id": "math.rf_network",
  "provider_version": "1.2.0",
  "capabilities": [
    "convert",
    "compose",
    "metric",
    "quality",
    "sweep",
    "calibration",
    "causality",
    "complex_reference",
    "touchstone_contract"
  ]
}

list_operations

Access
Registered in the Python Job
Arguments
[]
Result
Complete result from the original module through the existing typed transport. The module remains the source of the computation and its provenance.
Purpose
Ordered list of module operations
gxtxt_api_call("RF_NETWORK_API_v1", "list_operations", args)
Recorded result · list_operations

Download the example script (ZIP).

Example operands preview

[]

Result preview

[
  "convert.representation",
  "convert.renormalize",
  "compose.cascade",
  "compose.deembed_left",
  "compose.deembed_right",
  "compose.deembed_both",
  "compose.series",
  "compose.shunt",
  "metric.return_loss",
  "metric.insertion_loss"
]

operation_metadata

Access
Registered in the Python Job
Arguments
operation
Result
Complete result from the original module through the existing typed transport. The module remains the source of the computation and its provenance.
Purpose
Metadata for the requested operation
gxtxt_api_call("RF_NETWORK_API_v1", "operation_metadata", args)
Recorded result · operation_metadata

Download the example script (ZIP).

Example operands preview

[
  "convert.representation"
]

Result preview

{
  "id": "convert.representation",
  "summary": "convert representation",
  "api_id": "RF_NETWORK_API_v1",
  "api_version": 1,
  "operands": "network,reference,unused,options",
  "input_shapes": "square_matrix;positive_real_scalar_or_ports",
  "result_shapes": "square_matrix",
  "units": "S_dimensionless;Z_ohm;Y_siemens;ABCD_mixed",
  "complex_behavior": "complex_network",
  "errors": "InvalidReference;IllConditioned;Singular;DimensionMismatch",
  "arguments": [
    "network",
    "reference",
    "unused",
    "options"
  ],
  "argument_descriptors": [
    {
      "name": "network",
      "shape": "square_matrix",
      "source": "cell,range,column,scalar,option"
    },
    {
      "name": "reference",
      "shape": "positive_real_scalar_or_ports",
      "source": "cell,range,column,scalar,option"
    },
    {
      "name": "unused",
      "shape": "action-specific",
      "source": "cell,range,column,scalar,option"
    },
    {
      "name": "options",
      "shape": "action-specific",
      "source": "cell,range,column,scalar,option"
    }
  ],
  "signature": "rf.convert.representation(network, reference, unused, options)",
  "worksheet_example": "Apply rf.convert.representation using Worksheet ranges A1:A20 and B1:B20; set action-specific operands in the guided dialog.",
  "result_fields": [
    "square_matrix"
  ],
  "unit_behavior": "S_dimensionless;Z_ohm;Y_siemens;ABCD_mixed"
}

call

Access
Registered in the Python Job
Arguments
family, action, a, b, c, options
Result
Complete result from the original module through the existing typed transport. The module remains the source of the computation and its provenance.
Purpose
Invocation of the operation identified by family and action
gxtxt_api_call("RF_NETWORK_API_v1", "call", args)
Recorded result · call

Download the example script (ZIP).

Example operands preview

[
  "convert",
  "representation",
  {
    "kind": "array",
    "shape": [
      2,
      2
    ],
    "real": [
      0,
      1,
      1,
      0
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      50
    ]
  },
  {
    "kind": "empty"
  },
  {
    "kind": "struct",
    "fields": {
      "source": {
        "kind": "text",
        "value": "s"
      },
      "target": {
        "kind": "text",
        "value": "abcd"
      }
    }
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      1.0,
      0.0,
      0.0,
      1.0
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  },
  "source": "s",
  "target": "abcd"
}