Aggiunta di isotopi personalizzati al database di Radiacode (app Android)

Se desideri aggiungere i tuoi isotopi al database nell'applicazione Radiacode per Android, puoi farlo modificando un file CSV specifico. Questo ti permette di personalizzare gli isotopi e le loro linee spettrali secondo le tue esigenze.

Passaggi per Aggiungere Isotopi Personalizzati:

1. Individua la Directory dell'Applicazione:

  • Utilizzando un gestore di file sul tuo dispositivo Android, naviga al seguente percorso:
Android\data\com.almacode.radiacode\files

2. Prepara il File CSV:

  • Copia e Rinomina il File:
    • Trova il file denominato AppIsotopes.csv nella directory.
    • Fai una copia di questo file e rinomina la copia in Isotopes.csv.
    • Questo assicura che i tuoi isotopi personalizzati vengano caricati al posto di quelli predefiniti.

3. Modifica il File Isotopes.csv:

  • Apri il file Isotopes.csv con un editor di testo che supporta il formato CSV.
  • Aggiungi o Modifica i Dati degli Isotopi:
    • Inserisci i tuoi isotopi personalizzati seguendo la struttura della tabella specificata di seguito.

Struttura della Tabella per Isotopes.csv:

Il file CSV dovrebbe essere strutturato con le seguenti colonne, separate da virgole:

1. Prima Colonna (Nome del Nucleo/Nucleo Discendente):

  • Inserisci il nome del nucleo o del suo discendente.
  • Esempio: Cs-137

2. Seconda Colonna (Nome del Nucleo Genitore):

  • Inserisci il nome del nucleo genitore, se applicabile.
  • Se non c'è un nucleo genitore, lascia questo campo vuoto.
  • Esempio: Ba-137m (Nucleo Genitore: Cs-137)

3. Terza Colonna (Energia in keV):

  • Specifica il livello di energia della linea spettrale in kilo-elettronvolt (keV).
  • Esempio: 661.7

4. Quarta Colonna (Intensità della Linea in Percentuale):

  • Inserisci l'intensità della linea del nucleo, espressa in percentuale (%).
  • Questo rappresenta l'intensità relativa al nucleo genitore e a tutti i suoi discendenti.
  • Esempio: 85

5. Quinta Colonna (Tipo di Linea):

  • Indica il tipo di linea spettrale utilizzando i seguenti codici:
    • 5: Linea semplice (emissione gamma regolare)
    • 3: Linea tratteggiata a raggi X (non selezionabile, solitamente per emissioni di raggi X)
  • Esempio: 5

Esempio di Voce in Isotopes.csv:
Cs-137,,661.7,85,5 Ba-137m,Cs-137,661.7,85,3
  • Spiegazione:
    • La prima linea definisce il nucleo Cs-137 senza nucleo genitore, che emette un raggio gamma a 661.7 keV con un'intensità dell'85%, e il tipo di linea è semplice.
    • La seconda linea definisce il discendente Ba-137m del nucleo genitore Cs-137, con la stessa energia e intensità, ma il tipo di linea è una linea tratteggiata a raggi X.

Note Importanti:

Posizione del File:

  • Il file Isotopes.csv deve essere posizionato esattamente nella directory:
Android\data\com.almacode.radiacode\files

Denominazione del File:

  • Assicurati che il file sia denominato esattamente Isotopes.csv affinché l'applicazione lo riconosca.

Backup dei Dati Originali:

  • È consigliabile conservare un backup del file originale AppIsotopes.csv nel caso tu debba ripristinare le modifiche.

Linee Guida per la Formattazione:

  • Ogni voce dovrebbe essere su una nuova riga.
  • I campi devono essere separati da virgole senza spazi aggiuntivi.
  • Non includere righe di intestazione o colonne extra.

Codifica dei Caratteri:

  • Salva il file in codifica UTF-8 per garantire il corretto riconoscimento dei caratteri.

Riavvia l'Applicazione:

  • Dopo aver salvato le modifiche, riavvia l'applicazione Radiacode per caricare i nuovi isotopi.
Consigli per una Personalizzazione di Successo:

Inserimento Dati Accurato:

  • Ricontrolla i livelli di energia e le intensità per garantirne l'accuratezza.
  • Dati errati possono portare a una misidentificazione degli isotopi.

Coerenza dei Tipi di Linea:

  • Usa i codici corretti per il tipo di linea per assicurare che le linee spettrali vengano visualizzate correttamente nell'applicazione.

Test:

  • Dopo aver aggiunto i tuoi isotopi personalizzati, testa l'applicazione con sorgenti note per verificare che le nuove voci funzionino come previsto.

Risoluzione dei Problemi:

Isotopi Personalizzati Non Visualizzati:

  • Verifica il nome e la posizione del file.
  • Assicurati che non ci siano errori di formattazione nel file CSV.

Errori o Arresti Anomali dell'Applicazione:

  • Controlla che non ci siano errori di digitazione o voci non valide nel file Isotopes.csv.
  • Ripristina il file originale AppIsotopes.csv se necessario.

Problemi di Permessi:

  • Assicurati che l'applicazione abbia i permessi necessari per leggere file esterni.
  • Potrebbe essere necessario modificare le impostazioni dell'app o i permessi di Android.

Risorse Aggiuntive:

Manuale Utente:

  • Consulta il manuale utente di Radiacode per informazioni più dettagliate sulla formattazione dei dati degli isotopi.

Supporto:

  • Se incontri problemi, contatta il supporto di Radiacode per assistenza.

Seguendo queste istruzioni, puoi aggiungere efficacemente i tuoi isotopi all'applicazione Radiacode per Android, adattandola alle tue specifiche esigenze e migliorandone le capacità analitiche.