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
No matching operations.
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"
}