Indice
1. In parole semplici
Un Parameter Set è un piccolo file portabile che associa nomi di parametri a valori numerici. Serve quando vuoi separare i parametri di un modello dal codice e dal Dataset, per esempio per rieseguire una valutazione con coefficienti già stimati.
2. Formato
parameter,value
mu,10.8
Kp,77.2È possibile aggiungere # model_id=my.model oppure una colonna opzionale model_id.
3. Helper pubblici
ps = gxtxt_read_parameter_set(path, expected_names, expected_model_id)
ps = gxtxt_validate_parameter_set(ps, expected_names, expected_model_id)
4. Validazioni
- header obbligatorio;
- nomi non vuoti e non duplicati;
- valori numerici finiti;
- expected names mancanti/inattesi → errore;
- riordino automatico secondo
expected_names; model_idverificato quando presente in entrambe le parti.
5. Uso tipico
curvefit.family_global può usare un Parameter Set come sorgente dei parametri congelati in modalità Evaluate. In questo modo “fit dei parametri” e “valutazione del modello con parametri noti” restano due operazioni diverse.
Riferimento tecnico completo
Questa parte raccoglie integralmente la documentazione tecnica pertinente distribuita con GX-TXT per gli argomenti e i moduli trattati in questa pagina.
GX-TXT Shared Parameter-Set API v1
GX-TXT Shared Parameter-Set API v1
GX-TXT Pipeline v0.7.8.
Formato compatibile
Il formato minimo rimane:
parameter,value
p1,1.25
p2,8
Metadata model_id è opzionale. Sono accettati:
# model_id=my.model
o una colonna opzionale model_id.
Helper
ps = gxtxt_read_parameter_set(path, expected_names, expected_model_id)
ps = gxtxt_validate_parameter_set(ps, expected_names, expected_model_id)ps contiene:
path
names
values
model_id
Validazioni
- header
parameter,valueobbligatorio; - nomi vuoti vietati;
- valori devono essere numerici e finiti;
- duplicati vietati;
- se
expected_namesè fornito: parametri mancanti/inattesi sono errori; - output riordinato esattamente come
expected_names; model_idviene verificato solo quando è disponibile sia nel file sia nel consumer.
Per un model plugin GX-TXT, l’ordine atteso è quello di
[parameters] names= esposto nel runtime come
model.param_names.