RF Network: forme e riferimenti

Prepara le matrici di rete per RF_NETWORK_API_v1, scegli l’impedenza di riferimento e controlla l’ordine delle porte e la convenzione delle onde.

Indici e convenzioni

La matrice S usa riga per porta di destinazione e colonna per porta sorgente. Nei file Touchstone a due porte seguono S11, S21, S12, S22. Il pacchetto RF usa indici di porta da uno. Conserva l’impedenza di riferimento in ohm, scalare o per porta. Specifica wave_convention='power' oppure 'traveling' quando lavori con riferimenti complessi e riusa la stessa convenzione nei confronti.

Riferimento delle operazioni

Vai a un’operazione

Superfici riservate e facciate

  • ::GX::RFNetworkAPIv1::apiInfo

    Regola di accesso
    REGISTERED_TYPED_ADAPTER
    Operazione pubblica
    api_info
    Condizioni d’uso
    Il modulo originale math.rf_network legge il descrittore, la versione e le capacità dell’installazione da un percorso fisso. L’adattatore api_info richiama direttamente questa funzione e mantiene tutti i campi, l’ordine delle capacità e la stringa originale della versione del fornitore. Applica la tipizzazione alla sola versione API dichiarata. I metadati describe del registro condiviso hanno un contratto distinto. La chiamata legge solo metadati dell’installazione.
  • ::GX::RFNetworkAPIv1::call

    Regola di accesso
    REGISTERED_TYPED_ADAPTER
    Operazione pubblica
    call
    Condizioni d’uso
    La chiamata pubblica riceve family, action, a, b, c ed eventualmente options tipizzato. Controlla l’identificatore completo nella lista del modulo e usa ScientificTransportv1 con il kernel originario. Se ometti options si applica il valore Tcl predefinito. La chiamata restituisce tutti i campi previsti da resultTypes tramite il codec esistente, con componenti reali o complesse in binary64, forme e unità originali. Restano disponibili anche le chiamate per singola famiglia e azione. L’esecuzione in blocco di Signal segue il proprio percorso. Il risultato tipizzato documenta i dati restituiti dal trasporto. L’interfaccia grezza Tcl ha un proprio contratto.
  • ::GX::RFNetworkAPIv1::listOperations

    Regola di accesso
    REGISTERED_TYPED_ADAPTER
    Operazione pubblica
    list_operations
    Condizioni d’uso
    L’operazione list_operations legge il TSV installato del modulo e restituisce i suoi identificatori esatti nell’ordine originario. Le chiavi di registrazione dello Script Bridge appartengono a un elenco distinto. Per Signal l’elenco originale aggiunge statistical_contract. operation_schema, validate_operation e gli adattatori hanno registrazioni separate. La chiamata rifiuta argomenti sconosciuti e legge i descrittori del modulo installato.
  • ::GX::RFNetworkAPIv1::operationMetadata

    Regola di accesso
    REGISTERED_TYPED_ADAPTER
    Operazione pubblica
    operation_metadata
    Condizioni d’uso
    L’operazione operation_metadata cerca un ID effettivo nel TSV del modulo e unisce i metadati originali della famiglia e della guida. Per Signal mantiene il risultato completo di operationSchema, comprese le chiavi ui_field e final_scientific_checks. Restituisce i descrittori degli argomenti e i campi di esito nell’ordine originario. Conserva le stringhe di unità, valori predefiniti e limiti. Se l’ID è sconosciuto restituisce l’errore originale del modulo. L’operazione legge i metadati installati.

api_info

Accesso
registrata nel Job Python
Argomenti
[]
Esito
Risultato completo del modulo originale, restituito tramite il trasporto tipizzato esistente. Calcolo e provenienza restano quelli del modulo.
Funzione
Informazioni e capacità del modulo installato
gxtxt_api_call("RF_NETWORK_API_v1", "api_info", args)
Risultato registrato · api_info

Scarica lo script dell’esempio (ZIP).

Operandi del caso, anteprima

[]

Esito, anteprima

{
  "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

Accesso
registrata nel Job Python
Argomenti
[]
Esito
Risultato completo del modulo originale, restituito tramite il trasporto tipizzato esistente. Calcolo e provenienza restano quelli del modulo.
Funzione
Elenco ordinato delle operazioni del modulo
gxtxt_api_call("RF_NETWORK_API_v1", "list_operations", args)
Risultato registrato · list_operations

Scarica lo script dell’esempio (ZIP).

Operandi del caso, anteprima

[]

Esito, anteprima

[
  "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

Accesso
registrata nel Job Python
Argomenti
operation
Esito
Risultato completo del modulo originale, restituito tramite il trasporto tipizzato esistente. Calcolo e provenienza restano quelli del modulo.
Funzione
Metadati dell’operazione richiesta
gxtxt_api_call("RF_NETWORK_API_v1", "operation_metadata", args)
Risultato registrato · operation_metadata

Scarica lo script dell’esempio (ZIP).

Operandi del caso, anteprima

[
  "convert.representation"
]

Esito, anteprima

{
  "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

Accesso
registrata nel Job Python
Argomenti
family, action, a, b, c, options
Esito
Risultato completo del modulo originale, restituito tramite il trasporto tipizzato esistente. Calcolo e provenienza restano quelli del modulo.
Funzione
Esecuzione dell’operazione indicata da famiglia e azione
gxtxt_api_call("RF_NETWORK_API_v1", "call", args)
Risultato registrato · call

Scarica lo script dell’esempio (ZIP).

Operandi del caso, anteprima

[
  "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"
      }
    }
  }
]

Esito, anteprima

{
  "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"
}