Indice
1. Tre oggetti diversi
| Oggetto | Esempio | Ruolo |
|---|---|---|
| Servizio CORE | math.numeric | Implementa primitive numeriche condivise. Non è un'analisi da lanciare direttamente. |
| API pubblica | NUMERIC_API_v1 | È il contratto stabile attraverso cui moduli e Script Bridge usano il servizio. |
| Modulo Analysis | analysis.regression | Espone un workflow scientifico all'utente, seleziona Dataset/variabili, pubblica risultati e provenance. |
2. Perché questa separazione è importante
Un modulo Analysis non dovrebbe incorporare una copia privata degli algoritmi comuni quando la stessa operazione è già esposta dal servizio numerico. La separazione consente di mantenere un solo comportamento numerico condiviso e di lasciare ai moduli la semantica scientifica.
3. Cosa offre NUMERIC_API_v1
La API comprende operazioni per array reali e complessi, interpolazione e resampling, calculus, statistiche numeriche, least squares, polynomial e nonlinear fitting, smoothing/filtering, peak primitives, baseline, root finding, optimization, uncertainty propagation e operazioni Dataset-aware. La reference descrive inoltre discovery, edge case, persistenza e Script Bridge.
4. Quando leggere la reference API
- stai sviluppando un modulo;
- stai scrivendo uno script Octave/Python che usa Script Bridge;
- devi conoscere firma, opzioni, shape o comportamento con nonfinite;
- devi capire quali primitive sono pubbliche invece di implementarne una privata.
5. Quando invece usare un modulo Analysis
Se vuoi svolgere un'analisi scientifica normale da GUI, partire da un Dataset e ottenere risultati persistenti, consulta prima il catalogo dei moduli numerici. La reference API è per integrazione e sviluppo, non è un elenco di pulsanti da eseguire.