Tutorials

Indice dei contenuti

Per iniziare

Formati supportati

Lettura: FITS/FIT, XISF, TIFF/TIF, PNG, JPG/JPEG, BMP, e oltre 20 formati RAW nativi di fotocamera (CR2/CR3/CRW per Canon, NEF/NRW per Nikon, ARW per Sony, DNG, ORF/ORI per Olympus, RW2 per Panasonic, RAF per Fujifilm, PEF/PTX per Pentax, ed altri).

Salvataggio: FITS, XISF, TIFF, PNG, JPG con profondità di bit 8/16/32-bit interi e 32-bit float per i formati scientifici.

Multi-immagine: I file FITS multi-extension e XISF multi-immagine sono supportati con caricamento per-extension/immagine.

Apertura di immagini

• Apri singola: Clicca Apri (File menu o Toolbar) oppure premi Ctrl+O, seleziona file e fai clic su Apri.
• Apri multiple: Seleziona più file nella dialog (Ctrl+Click, Shift+Click) per caricarli in parallelo.
• Drag & Drop: Trascina i file direttamente sulla finestra di TStar per aprirli rapidamente.
• Caricamento in background: l'import avviene senza bloccare completamente l'interfaccia, con progress feedback in UI.

Salvataggio di immagini

• Salva: Clicca Salva (Toolbar o Ctrl+S), scegli formato e profondità di bit nella dialog opzioni.
• Salva con nome: File > Salva con nome per cambiare percorso/nome.
• Opzioni di salvataggio:
  • Formato: FITS/XISF/TIFF/PNG/JPG (auto-selezionato dall'estensione)
  • Profondità bit: 32-float, 32-int, 16-int, 8-int (formato-dipendente)
  • Burn Annotations: Se abilitate nel Image Annotator, le annotazioni vengono bruciate nell'immagine salvata
• Preservazione metadati: FITS mantiene l'header completo, XISF preserva proprietà e ICC profile, TIFF è minimale, PNG/JPG non hanno preservazione header.

Navigazione di base

• Zoom In/Out: Rotella del mouse oppure Ctrl + e Ctrl -.
• Pan: Clicca e trascina per spostarti sull'immagine (modalità Pan/Zoom di default).
• Fit to Window: Premi Ctrl+0 per adattare l'immagine alla finestra.
• 1:1 Zoom: Clicca il pulsante 1:1 per lo zoom al 100% (1 pixel = 1 pixel display).
• Undo/Redo: Ctrl+Z / Ctrl+Shift+Z per annullare/ripristinare.
• Magnifier Loupe: lente di ispezione locale per controlli di dettaglio.

Workspace Projects

Organizza il flusso di lavoro con Workspace Projects. Ogni progetto mantiene directory dedicata e stato sessione salvabile in file progetto.

Creare un nuovo progetto

• Clicca File > New Project... nel menu o nel toolbar (icona cartella con +).
• Scegli nome progetto e directory di lavoro.
• Il progetto diventa attivo e la sua directory diventa il working directory per File > Open/Save.
• Lo stato del progetto viene salvato in file .tsproj.

Aprire un progetto esistente

• Clicca File > Open Project... e seleziona il file .tsproj.
• Oppure usa il menu Project Manager nella sidebar sinistra per accesso rapido.
• Usa File > Recent Projects per progetti aperti recentemente (con timestamp).
• Alla riapertura vengono ripristinate le principali informazioni di workspace.

Vantaggi del workspace projects

• Isolamento: Sessioni separate per diversi target (Andromeda imaging, Orione narrowband, etc.).
• Organizzazione: Light frames, master calibration (bias/dark/flat), e output elaborati in una struttura coerente.
• Workflow awareness: Script e operazioni batch mantengono consapevolezza dei percorsi specifici del progetto.
• Portabilità: possibilità di trasferire il file progetto e relativi dati.
• State persistence: il progetto conserva stato operativo tra sessioni.

Lavorare con workspace projects

• Un progetto alla volta: Solo un progetto può essere attivo. Chiudere un progetto resetta la working directory ad AppData.
• Salva stato: Lo stato è preservato automaticamente quando chiudi il progetto o TStar. Usa File > Save Workspace Project (Ctrl+S) per save esplicito.
• Project info nella UI: Il titolo della finestra mostra il nome progetto corrente e il percorso directory nella statusbar.
• Chiusura: Usa File > Close Project per disattivare il progetto corrente. Opzione delete project disponibile nel Project Manager.

Struttura directory suggerita

• /Light/ - Raw light frames
• /Dark/ - Dark calibration frames
• /Flat/ - Flat field frames
• /Bias/ - Bias frames (se usati)
• /Processed/ - Output elaborati, stacked frames
• /Scripts/ - Script customizzati (.tss format)

Controlli di navigazione

• Zoom In/Out: Rotella del mouse oppure Ctrl + e Ctrl -.
• Pan: Clicca e trascina in modalità Pan/Zoom (default).
• Fit to Window: Premi Ctrl+0 per adattare l'immagine alla finestra.
• 1:1 Zoom: Clicca il pulsante 1:1 per zoom esatto al 100%.
• Undo/Redo: Ctrl+Z / Ctrl+Shift+Z.

Gestione viste multiple

• Apri più viste di immagini in finestre indipendenti con aspect ratio preservato.
• Affianca automaticamente (griglia, verticale, orizzontale) per analisi fianco a fianco.
• Riduci (shade) le viste alle barre del titolo e monitora dal pannello di anteprima laterale destro.
• Nascondi opzionalmente le viste minimizzate dal workspace mantenendo accesso rapido.
• Usa la lente d'ingrandimento (loupe 50×50 pixel con zoom 4×) per controlli precisi di fuoco.
• Linked Views: Abilita sincronizzazione zoom/pan tra viste aperte tramite View menu.
• Shift+Resize: Crea una nuova vista di crop dal rettangolo selezionato.

Sidebar panels

• Console Dock (Left): Log di elaborazione e messaggi di progress.
• Header Panel (Left): Visualizza FITS metadata (parole chiave, WCS, exposure, temperatura CCD, ecc.).
• History Panel (Left): Timeline visuale di undo/redo operations.
• Right Sidebar: Thumbnail carousel delle viste minimizzate per attivazione rapida.

Modalità di visualizzazione

Usa il menu a tendina Display Mode nella barra degli strumenti (combo box) per trasformare dati lineari grezzi in visualizzazione ottimale. Ogni modalità applica una diversa curva di trasferimento del segnale (STF) in tempo reale.

Linear

Visualizzazione diretta senza trasformazione. Valori pixel grezzi (0.0-1.0 range normalizzato) mappati direttamente ai livelli display. Contrasto tipicamente molto basso, utile per ispezionare dato grezzo.

Auto Stretch (Statistico)

Stretch automatico basato su mediana e MAD (Mean Absolute Deviation). Ideale per anteprime rapide:

• Target Median preset: 0.10, 0.15, 0.20, 0.25 (default), 0.30, 0.35, 0.40, 0.50 - controlla luminosità visualizzazione.
• RGB Link: Se abilitato (icona linked), tutti i canali usano statistiche globali. Se disabilitato (unlinked), ogni canale usa proprie statistiche per stretch indipendente.
• Black Point Clipping: Nero clippato a 5σ sotto mediana (default configurabile).

Histogram (Equalizzazione Istogramma)

Equalizzazione istogramma classica. Distribuisce valori pixel uniformemente sull'intervallo display, aumentando contrasto generale. Utile per immagini a scarso contrasto con distribuzione pixel ben definita. Accedi a Process > Stretch Tools > Histogram Transformation per controllo preciso (ombre/mezzitoni/alte luci).

ArcSinh (Inverse Hyperbolic Sine)

Stretch non lineare che comprime alte luci mantenendo colore stellare naturale. Formula: f(x) = asinh(x × stretchFactor) / asinh(stretchFactor). Eccellente per deep-sky con stelle brillanti + nebulae deboli. Accesso a Process > Stretch Tools > ArcSinh Stretch per parametri regolabili (Stretch Factor, Black Point, Human Luminance).

Square Root

Stretch sqrt(x). Meno aggressivo di Log, contrasto moderato con preservazione colore discreta.

Logarithmic

Stretch logaritmico log(x + 1). Molto aggressivo, comprime strutture deboli e espande alte luci. Utile per immagini altissimo range dinamico.

24-bit High-Precision Display

Abilitabile nelle Settings per gradienti più fluidi e banding ridotto. Usa calcoli virgola mobile ad alta precisione anziché binning istogramma 16-bit standard. Riduce banding visibile in auto-stretched preview, specialmente nei cieli gradienti.

Display Controls nella Toolbar

• RGB Link Toggle: Icone linked/unlinked determinano se canali usano statistiche identiche (linked) o indipendenti (unlinked).
• Channel View Menu: RGB (tutti canali), R (rosso solo), G (verde solo), B (blu solo) - inspeziona canali individuali per diagnosi qualità.
• Invert Toggle: Inverte tutti pixel (0→1, 1→0). Utile per negativi.
• False Color Toggle: Abilita pseudo-color visualization per ispezionare dettagli deboli.
• Burn Display Button: Applica trasformazione visualizzazione corrente PERMANENTEMENTE al buffer immagine. Dopo burn, visualizzazione ritorna a Linear ma dati sono modificati.
• AutoStretch Target Median Menu: preset rapidi per regolare la luminosità dell'auto-stretch.

Strumenti di stretching

Accedi a tutti gli stretch tools via Process > Stretch Tools submenu. Ogni tool offre parametri regolabili per trasformare dati lineari grezzi in immagini visualizzabili.

Auto Stretch (Statistical)

Applica automaticamente stretch basato su analisi statistica (mediana + MAD). Ideale per anteprime rapide dei dati lineari. Parametri:

• Target Median: 0-1, default 0.25. Controlla luminosità visualizzazione.
• Linked Channels: Abilita per statistiche globali, disabilita per stretch per-canale.
• Normalize: Normalizza a max dopo stretch.
• Black Point Sigma: Clipping threshold in σ deviazioni standard (default 5).

GHS (Generalized Hyperbolic Stretch)

Strumento stretch avanzato con controllo indipendente di ombre, mezzitoni e alte luci. Modello iperbolicogeneralizzato con protezione ombre/alte luci selettiva. Accedi via Process > Stretch Tools > GHS.

• Histogram View Controls: Zoom buttons (1-100×, default 1×), Grid toggle (default checked), Curve overlay toggle (default checked), Channel toggles R/G/B (default tutte spuntate), Log scale checkbox (default unchecked).
• Stretch Mode Combobox: Opzioni: "Generalized Hyperbolic Stretch" (default), "Inverse GHS", "ArcSinh Stretch", "Inverse ArcSinh". Seleziona la famiglia di stretch.
• Color Mode Combobox: Opzioni: "RGB (Independent)" (default), "Human Weighted Luminance", "Even Weighted Luminance", "Saturation". Applica stretch a canali indipendenti o formula luminanza ponderata.
• D (Stretch) Spinbox+Slider: Range 0-10 (step 0.01), default 0. Fattore di stretch (iperbolicità). 0=nessuno, aumenta per più stretch.
• B (Intensity) Spinbox+Slider: Range -5 a 15 (step 0.01), default 0. Aggiustamento intensità locale (contrasto). Negative=darker, positive=brighter.
• SP (Symmetry Point) Spinbox+Slider: Range 0-1 (step 0.001, 4 decimali), default 0. Punto di simmetria dello stretch. 0=ombre dominanti, 0.5=neutrale, 1=alteluci dominanti.
• LP (Shadow/Low Protection) Spinbox+Slider: Range 0-1 (step 0.001, 4 decimali), default 0. Protezione ombre dal clipping. 0=nessuna, 1=piena protezione.
• HP (Highlight/High Protection) Spinbox+Slider: Range 0-1 (step 0.001, 4 decimali), default 1. Protezione alte luci dal clipping. 0=nessuna, 1=piena protezione (default massima).
• BP (Black Point) Spinbox+Slider: Range 0-0.3 (step 0.0001, 5 decimali), default 0. Offset clipping nero pre-stretch. Aumenta per nascondere rumore in ombre.
• Clip Mode Combobox: Opzioni: "Clip" (default), "Rescale", "RGB Blend", "Global rescale". Come gestire valori fuori range 0-1 dopo stretch.
• Preview Checkbox: Default checked. Anteprima live dello stretch.
• Logarithmic Histogram Checkbox: Default unchecked. Mostra istogramma in scala logaritmica (utile per esaminare code deboli).
• Clipping Labels: Label "Low Clipping: X%" e "High Clipping: X%" mostrano percentuale pixel tagliati alle estremità dopo stretch.
• Reset Button: Azzera tutti i parametri a default.
• Apply Button: Applica GHS transformation.

Curves Transformation

Interactive spline-based curve adjustment. Regola curve tonali per ogni canale RGB indipendentemente o insieme con visualizzazione istogramma real-time.

• Histogram View Controls: Log checkbox (default unchecked - scala lineare), Grid checkbox (default checked - griglia overlay), Channel toggles R/G/B (default tutte spuntate).
• Curve Editor (Interactive Graph): Click nel grafico per aggiungere control point, drag per muovere, right-click per cancellare. Istogramma auto 1024-bin display sotto. Curve spline interpolazione tra punti.
• Point Stats Label: Mostra coordinate (x, y) del punto attuale selezionato per inputs precisi.
• Preview Checkbox: Default checked. Anteprima live della curva.
• Reset Button: Azzera curva a diagonale lineare (identità: nessun cambiamento).
• Apply Button: Applica curve transformation.
• Cancel Button: Chiude senza applicare.

Histogram Transformation

Stretch manuale dell'istogramma con controlli precisi per ombre, mezzitoni e alte luci (sistema Levels-style). Anteprima in tempo reale con statistiche clipping.

• Histogram View Controls: Zoom buttons (1-100×, default 1×), Reset Zoom (1:1), Channel toggles R/G/B (default tutte spuntate). Display istogramma auto-aggiornato.
• Shadows Spinbox+Slider: Range 0-1 (7 decimali precision), default 0. Punto ombre (input level sinistro). Muovi il nero.
• Midtones Spinbox+Slider: Range 0.0001-0.9999 (7 decimali), default 0.5. Gamma midtone. Influenza mezzitoni senza alterare ombre/alte luci.
• Highlights Spinbox+Slider: Range 0-1 (7 decimali), default 1. Punto alte luci (input level destro). Muovi il bianco.
• Auto Stretch Button: Calcola automaticamente optimal shadows/midtones/highlights dai dati immagine (ignora manuale).
• Clipping Labels: Mostra "Low Clipping: X%" e "High Clipping: X%" - percentuale pixel tagliati a nero/bianco.
• Preview Checkbox: Default checked. Anteprima live dello stretch.
• Reset Button: Riporta shadows=0, midtones=0.5, highlights=1 (linear).
• Apply Button: Applica histogram stretch.
• Cancel Button: Chiude senza applicare.

ArcSinh Stretch

Stretch specializzato formula ArcSinh che preserva colore stellare aumentando contrasto dolcemente. Accedi via Process > Stretch Tools > ArcSinh Stretch. Formula: f(x) = asinh(x × factor) / asinh(factor).

• Stretch Factor Spinbox+Slider: Range 0-1000 (0.1 precision), default 0. Non-linearità. Aumenta per massimo effetto delle regioni scure.
• Black Point Spinbox+Slider: Range 0-0.20 (5 decimali precision, 0.00001 step), default 0. Costante sottratta dall'immagine pre-stretch (noise floor).
• Human-Weighted Luminance Checkbox: Default checked. Se spuntato, usa Rec.709 luminosa efficienza occhio umano per immagini colore; se no, usa luminanza lineare pura.
• Preview Checkbox: Default checked. Anteprima live.
• Clipping Labels: Mostra "Low Clipping: X%" e "High Clipping: X%" della curva output.
• Reset Button: Azzera stretch factor=0, black point=0.
• Apply Button: Applica arcsinh stretch.
• Cancel Button: Chiude senza applicare.

Star Stretch

Tool specializzato per stretching stelle preservando colore e dimensione. Parametri:

• Stretch Amount: Controlla espansione non lineare stelle.
• Color Boost: Aumenta saturazione cromatica specificamente per stelle.
• SCNR Optional: Rimozione rumore verde durante stretch.
• Star Mask Usage: Funziona ottimamente con star masks applicate per preservare colori nebula.

Advanced Stretch Parameters (Stretch Dialog)

• Curves Boost (S-Curve): Applica S-curve enhancement (0-1 strength).
• HDR Compression: Highlight compression (0-1 intensity, knee 0-1).
• Luminance-Only Mode: Preserva saturazione durante stretch (Rec.709/601/2020 color space).
• High-Range Mode (VeraLux-style): HDR rescaling con pedestal, soft/hard ceiling percentiles, softclip rolloff.

Gestione del colore

Accedi ai tool colore via Process > Color Management. Questi tool regolano bilanciamento cromatico, rimozione gradienti e dominanti.

Auto Background Extraction (ABE)

Rimuove gradienti e inquinamento luminoso con modello polinomiale/RBF: Accedi via Process > Color Management > Auto Background Extraction.

• Workflow: Disegna poligoni nel viewer per selezionare regioni di background puro (da escludere dal modello).
• Degree Spinbox: Range 0-6, default 2. Grado polinomiale del modello (complessità). 0=costante, 2-3=quadratico (default), 6=molto complesso.
• Samples Spinbox: Range 10-10000, default 100. Numero di punti campionati per il fit del modello.
• Downsample Spinbox: Range 1-16, default 4. Fattore downsampling per velocità (1=no downsampling, 4=4x veloce, minore qualità).
• Patch Size Spinbox: Range 5-151 (step 2), default 15. Kernel size in pixel per calcolo mediana attorno punti campionati.
• Enable RBF Checkbox: Default checked. Se spuntato, usa Radial Basis Functions per interpolazione; se no, usa polinomiale puro.
• RBF Smooth Spinbox: Range 0.01-10.0 (step 0.1), default 1.0. Parametro smoothing per RBF (solo se "Enable RBF" è checked).
• Normalize Background Checkbox: Default checked. Se spuntato, allinea i background dei canali RGB allo stesso livello (ATTENZIONE: distrugge PCC se già applicato).
• Result = Background Model Checkbox: Default unchecked. Se spuntato, output è solo il modello di background anziché l'immagine corretta.
• Clear Selections Button: Cancella tutti i poligoni disegnati.
• Apply Button: Esegue ABE.

Catalog Background Extraction (CBE)

Estrazione background via reference survey catalogo HiPS (PanSTARRS, DSS2, unWISE): Accedi via Process > Color Management > Catalog Background Extraction.

• Requirements: Immagine DEVE essere plate-solved (WCS metadata obbligatori).
• HiPS Survey Combobox: Opzioni: "PanSTARRS DR1 (Color)" (RGB composito), "DSS2 Red (Optical)" (default, red filter), "unWISE (Infrared)" (infrarosso). Seleziona survey reference per rimozione background.
• Smoothing Scale Spinbox: Range 16-1024 px (step 16), default 128 px. Sigma Gaussiana per estrazione background. Più grande = background smooth, meno dettagli persi.
• Protect Stars (Morphological Filter) Checkbox: Default checked. Se spuntato, applica apertura morfologica per prevenir stelle brillanti dal bias gradiente. Disabilita se stelle non sono problema.
• Output Background Map Checkbox: Default unchecked. Se spuntato, output è solo la gradient map computed anziché immagine corretta.
• Clear Cache Button: Elimina tutte le immagini HiPS reference cached (liberaspace disco).
• Apply Button: Esegue catalog background extraction (richiede download HiPS da internet).
• Close Button: Chiude dialog.

Photometric Color Calibration (PCC)

Calibra colori usando catalogo stellare reference (Gaia/APASS): Accedi via Process > Color Management > Photometric Color Calibration.

• Requirements (Critical): Immagine DEVE essere plate-solved (WCS metadata OBBLIGATORI). Nessun WCS = dialog disabled.
• Status Label: Mostra stato corrente (Ready, downloading catalogo, processing, completato, error).
• Background Neutralization Checkbox: Default checked. Se spuntato, esegui neutralizzazione background durante calibrazione (raccomandato prima di PCC).
• Run PCC Button: Avvia calibrazione. Fase 1: Download stelle reference catalogo (Gaia DR3/APASS). Fase 2: Estrai stelle immagine con SEP photometry. Fase 3: Fit colori RGB via least-squares matching. Output: moltiplicatori kr, kg, kb e background mean statistiche.
• PCC Distribution Dialog: Visualizza scatter plots Red/Green e Blue/Green scatter plot: asse X=colore référence, asse Y=colore misurato. Deviazioni dalla diagonale = color calibration error.

Spectrophotometric Color Calibration (SPCC)

Calibrazione scientifica basata curvé risposta spettrale: Accedi via Process > Color Management > SPCC.

• Method: Usa database spettrale (filtri, sensori, curve SED) per calibrazione fisicamente coerente.
• Features: Model fitting, optional chromatic gradient correction, plate-solved + star photometry required.
• Accuracy: Superior per rendering cromatico fisico-accurato.

Background Neutralization

Rimuove dominanti cromatiche nel cielo di fondo: Accedi via Process > Color Management > Background Neutralization.

• Seleziona regione cielo puro, tool bilancia i canali RGB automaticamente.

Temperature / Tint

Bilanciamento manuale del bianco via temperatura colore e tinta: Accedi via Process > Color Management > Temperature/Tint.

• Temperature Slider: Range -100 a +100, default 0. Negativo=freddo (blu), positivo=caldo (rosso). Regola la temperatura colore in modo lineare.
• Tint Slider: Range -100 a +100, default 0. Negativo=verde, positivo=magenta. Corregge dominanti verde/magenta indipendentemente dalla temperatura.
• Preview Checkbox: Default checked. Anteprima live dei cambiamenti.
• Protect Shadows/Highlights Checkbox: Default checked. Protegge pixel near-black e near-white da color cast (evita color fringing negli estremi).
• Reset Button: Azzera temperature e tint a 0.
• Apply Button: Applica white balance correction.
• Cancel Button: Chiude senza applicare.

Magenta Correction

Soppressione dedicata dominante magenta: Accedi via Process > Color Management > Magenta Correction.

• Amount Slider + Spinbox: range 0.0-1.0 (slider 0-100), controlla intensità correzione.
• Threshold Slider + Spinbox: range 0.0-1.0 (slider 0-100), soglia di intervento sulle aree magenta.
• Restrict to Stars Checkbox: limita la correzione alle stelle tramite star mask.
• Apply / Close: applica o chiude dialog.

Selective Color Correction

Regolazione precisa colori in intervalli tonalità specifici: Accedi via Process > Color Management > Selective Color Correction.

• Preset Combobox: preset di gamma hue preconfigurati.
• Hue Start / Hue End Spinbox: range 0-360, definisce intervallo tonalità.
• Intensity Spinbox: range 0-2, step 0.1, default 1.0.
• Minimum Chroma Spinbox: range 0-1, step 0.05, default 0.05.
• Smoothness Spinbox: range 0-60, default 10.0.
• Invert Checkbox: inverte la selezione cromatica.
• Show Mask Checkbox: mostra maschera di selezione.
• Reset / Apply / Close: controllo workflow.

SCNR (Subtractive Chromatic Noise Reduction)

Rimuove dominante verde generico: Accedi via Process > Color Management > SCNR.

• Common in: Immagini OSC/DSLR.
• Method Combobox: Average Neutral (più comune), Maximum Neutral, Minimum Neutral.
• Amount Slider + Spinbox: range 0.0-1.0 (slider 0-100), intensità correzione.
• Apply / Close: applica o chiude.

Saturation

Regolazione saturation cromatica globale o per hue ranges specifici: Accedi via Process > Color Management > Saturation.

• Amount Slider: Range 0-500 (mostrato come 0.0-5.0×), default 100 (1.0×). Moltiplicatore intensità saturation. 0=grigio, 1=originale, 5=saturation massima.
• BG Factor Slider: Range 0-500 (mostrato come 0.0-5.0×), default 100 (1.0×). Fattore saturation del background separatamente.
• Hue Presets Combobox: Opzioni: "All Colors", "Reds", "Yellows", "Greens", "Cyans", "Blues", "Magentas", default "All Colors". Preset rapidi per limitare effetto a colori specifici.
• Hue Center Slider: Range 0-360°, default 0°. Centro hue per saturation selettiva (quando non è "All Colors").
• Hue Width Slider: Range 0-360°, default 360°. Larghezza dell'intervallo hue attorno al centro.
• Hue Smooth Slider: Range 0-180°, default 30°. Smoothness della transizione ai bordi del range hue (feathering).
• Preview Checkbox: Default checked. Anteprima live.
• Reset Button: Azzera tutti a valori neutri.
• Apply Button: Applica saturation changes.
• Cancel Button: Chiude senza applicare.

Workspace Color Management

Comportamento cromatico coerente tra strumenti e sessioni nel workspace del progetto. Color profile management e ICC profile support.

Elaborazione AI

Cosmic Clarity

Tool esterno per denoise/sharpen con opzioni GPU e parametri dedicati:

• Mode Combobox: selezione modalità di elaborazione (varia con disponibilità GPU/provider).
• GPU Device Combobox: scelta dispositivo GPU.
• Sharpen Channels Separately Checkbox: elabora i canali RGB separatamente.
• Auto Detect PSF Checkbox: stima automatica PSF.
• Non-Stellar PSF Slider: range 10-80 (mostrato 1.0-8.0), default 30.
• Stellar Amount Slider: range 0-100 (0.00-1.00), default 50.
• Non-Stellar Amount Slider: range 0-100 (0.00-1.00), default 50.
• Luminance Denoise Slider: range 0-100 (0.00-1.00), default 50.
• Color Denoise Slider: range 0-100 (0.00-1.00), default 50.
• Scale Combobox: opzioni 2x, 3x, 4x.
• OK/Cancel: applica o annulla.

GraXpert

Integrazione GraXpert per rimozione gradienti con controllo versione AI:

• AI Version Combobox: Latest (auto), 3.0.2, 3.0.1, 2.0.0.
• Use GPU Acceleration Checkbox: abilita/disabilita uso GPU.
• Strength Spinbox: range 0.0-1.0, step 0.05, default 0.10.
• OK/Cancel: conferma o annulla.

StarNet++

Rimozione stelle con StarNet++ (integrazione esterna):

• Generate Star Mask Checkbox: crea anche maschera stelle.
• Use GPU Checkbox: esecuzione GPU (se disponibile).
• Linear Data Checkbox: default checked, indica dati lineari pre-stretch.
• Stride Spinbox: range 16-2048, step 32, default 256.
• Run/Close: avvia o chiude il dialog.

Aberration Remover (RAR)

Correzione aberrazioni tramite modello esterno:

• Provider Combobox: CPU, DirectML, CUDA.
• Patch Size Spinbox: range 128-2048, default 512.
• Overlap Spinbox: range 16-512, default 64.
• Browse/Download Model: selezione modello locale o download da GitHub.
• Run: esegue correzione.

Pipeline immagini (preprocessing)

Segui questi passaggi: Conversione → Calibrazione → Registrazione → Stacking.

Image Conversion

Conversione file RAW e debayer:

• Conversion Dialog: Add Files, Remove, Clear All, Browse Output, Convert.
• Output Format Combobox: FITS, XISF, TIFF.
• Bit Depth Combobox: 16-bit o 32-bit float (default 32-bit float).
• Apply Debayering Checkbox: default checked per camere colore.
• Debayer Dialog: pattern Auto/RGGB/BGGR/GRBG/GBRG, metodi Edge-aware o Bilinear, pulsante Apply.

Image Calibration

Calibrazione light frames con master bias/dark/flat:

• Use Bias/Dark/Flat Checkboxes: tutti default checked.
• Select Buttons: selezione master bias, dark, dark-flat, flat.
• Create Buttons: create master bias/dark/flat.
• Cosmetic Correction: checkbox + mode combobox (Sigma-clipping / From Master Dark).
• Hot/Cold Sigma Spinbox: range 1.0-20.0, default 3.0.
• Bias Level Spinbox: 0-65535.
• Pedestal Spinbox: 0-10000.
• Debayer Options: checkbox debayer + algoritmo Bilinear/VNG/Super Pixel + pattern Bayer.
• Start Calibration: avvia pipeline di calibrazione.

Gestione file: Add Files, Remove, Clear All, log in tempo reale e cancel operazione.

Image Registration

Allineamento stelle tra frame:

• Load Folder: carica sequenza da directory.
• Set Reference / Auto: frame di riferimento manuale o automatico.
• Allow Rotation Checkbox: default checked.
• High Precision (subpixel) Checkbox: default checked.
• Detection Sigma: 1.0-10.0, default 4.0.
• Match Tolerance: 0.0001-0.01, default 0.002.
• Min/Max Stars: 5-100 (default 20) / 50-2000 (default 500).
• Start Registration: avvia allineamento e aggiorna tabella/log.

Image Stacking

Integrazione frame con metodi e rejection avanzata:

• Method Combobox: Mean, Median, Sum, Maximum, Minimum.
• Rejection Combobox: None, Percentile, Sigma Clipping, MAD Clipping, Sigma-Median, Winsorized Sigma, Linear Fit, Generalized ESD.
• Weighting Combobox: None, Star Count, FWHM, Noise, Roundness, Quality, Stack Count.
• Normalization Combobox: None, Additive, Multiplicative, Additive + Scaling, Multiplicative + Scaling.
• Sigma Low/High: 0.1-10.0 (default 3.0 / 3.0).
• Drizzle Controls: enable drizzle 2x, fast mode, scale (1.0-4.0, default 2.0), pixfrac (0.1-1.0, default 0.9).
• Debayer Controls: checkbox + pattern RGGB/BGGR/GBRG/GRBG + algoritmo VNG/Bilinear.
• Filter Controls: filter combo, mode (Percent/K-Sigma), value 1.0-100.0 (default 90).
• Other Checkboxes: equalize RGB, fast norm, overlap norm, output norm [0,1], 32-bit output, rejection maps, maximize framing.
• Start Stacking: avvia integrazione con log dettagliato.

Gestione dataset: Add/Remove Files, Load Folder, Select/Deselect All, Set Reference, Pick Comet First/Last, Compute Comet Shifts.

Operazioni sui canali

Extract / Combine Channels

Divide un'immagine RGB in canali separati o li combina.

Linear Fit

Equalizza l'intensità dei canali RGB abbinando le mediane.

Image Blending

Fonde due immagini con modalità blend e mascheratura range:

• Base/Top Combobox: selezione immagine base e immagine superiore.
• Blend Mode Combobox: Normal, Multiply, Screen, Overlay, Add, Subtract, Difference, Soft Light, Hard Light.
• Target Channel Combobox: Red, Green, Blue, All/RGB.
• Opacity Slider: 0-100, default 100.
• Low/High Range Sliders: 0-1000 e 0-1000 (default 0/1000).
• Feather Slider: 0-500, default 0.
• Show Preview / High Res Checkbox: anteprima e risoluzione preview.

Star Recomposition

Ricombina starless + stelle con controllo blend/stretch:

• Starless / Stars Combobox: selezione viste input.
• Stretch Mode Combobox: Generalized Hyperbolic Stretch, Inverse GHS, ArcSinh Stretch, Inverse ArcSinh.
• Color Mode Combobox: RGB Independent, Human Weighted Luminance, Even Weighted Luminance, Saturation.
• Clip Mode Combobox: Clip, Rescale, RGB Blend, Global Rescale.
• Spin/Slider Pairs: regolazioni numeriche sincronizzate dei parametri di fusione.
• Apply/Cancel: applica o annulla.

Extract / Recombine Luminance

Estrazione e fusione luminanza con controllo colore:

• Source Combobox: selezione immagine sorgente luminanza.
• Color Space Combobox: HSL, HSV, CIE L*a*b*.
• Blend Slider: 0-100, default 100.
• Apply/Close: applica ricombinazione o chiude.

Remove Pedestal

Sottrae il valore minimo di pixel. Essenziale prima dello stretching.

Perfect Palette Picker

Compositi narrowband guidati:

• Load Buttons: caricamento canali richiesti per scenario.
• Auto Stretch Channels Checkbox: default checked.
• Stretch Slider: range 10-50, default 25.
• Apply to New View: crea output in nuova view.

Continuum Subtraction

Sottrazione continuo banda larga da canali narrowband:

• Q Factor Spin/Slider: 0.10-2.00, default 0.80.
• Threshold Spinbox: 0.5-50.0, default 5.0.
• Curves Blend Spinbox: 0.0-1.0, default 0.50.
• Output Linear Only Checkbox: output lineare senza log transform.
• Denoise with Cosmic Clarity Checkbox: denoise opzionale.
• Execute/Clear/Refresh: esecuzione e gestione input.

Align Channels

Allineamento dei canali con scelta riferimento e opzioni di trasformazione:

• Reference Channel Combobox: canale di riferimento.
• Align Channel Checkboxes: abilita/disabilita allineamento per canale target.
• Allow Rotation / Allow Scale: abilita componenti geometriche aggiuntive.
• Threshold Spinbox: range 2.0-20.0 sigma, step 0.5, default 4.0.
• Refresh List / Align / Close: aggiorna input, avvia, chiude.

NB → RGB Stars

Combinazione stelle NB con stelle RGB:

• Load Buttons: Ha, OIII, SII (optional), OSC stars (optional).
• Ha:OIII Ratio Slider: 0-100, default 30.
• Saturation Slider: 0-300, default 100.
• Star Stretch Slider: 0-800, default 500.
• Enable Star Stretch Checkbox: default checked.
• Preview Combine / Push Final: anteprima e invio risultato in nuova view.

Narrowband Normalization

Normalizzazione scenari SHO/HSO/HOS/HOO:

• Scenario Combobox: SHO, HSO, HOS, HOO.
• Mode Combobox: Non-linear (Mode=1), Linear (Mode=0).
• Blend Mode Combobox: Screen, Add, Linear Dodge, Normal.
• Lightness Combobox: opzioni di gestione luminanza (off/original/Ha).
• SCNR Checkbox: default checked.
• Preview / Apply to Current / Push as New: workflow completo.

Multiscale Decomposition

Decomposizione multiscala con controllo layer:

• Layers Spinbox: 1-10.
• Base Sigma Spinbox: 0.3-5.0, step 0.1.
• Gain/Threshold/Denoise/Amount: slider+spin sincronizzati per layer.
• Mode Combobox: mu-sigma thresholding o linear.
• Preview Combobox: output finale, residuo o dettaglio layer.
• Linked RGB Checkbox: default checked.
• Apply to Image / Send to New Image: output in-place o nuova view.

Maschere

• Mask Type Combobox: Binary, Range Selection, Lightness, Chrominance, Star Mask, e 8 color masks (Red/Orange/Yellow/Green/Cyan/Blue/Violet/Magenta).
• Preview Stretch Combobox: Linear, Auto Stretch, Histogram, ArcSinh, Sqrt, Log.
• Preview Size Combobox: 512px o 1024px.
• Tool Buttons: Move/Select, Freehand, Ellipse, Select Entire Image.
• Generate Preview / OK / Cancel / Clear Shapes: genera anteprima, applica, annulla, reset forme.
• Main Checkboxes: Use Lightness (default checked), Invert Range, Link Limits, Screening.
• Main Sliders: Blur (0-300), Color Fuzz (0-60), Smoothness (0-200).

Utilità

Plate Solving

Identifica coordinate celesti e scrive WCS header:

• Engine Combobox: ASTAP o Internal Native Solver.
• Calculate Pixel Scale: calcolo scala via parametri strumento/sensore.
• Search Simbad: ricerca oggetto e coordinate.
• Solve / Cancel / Close: avvio e gestione solving.
• Log Panel: output passi di solving e diagnostica.

Pixel Math

Espressioni matematiche su canali con editor testo e applicazione diretta:

• Expression Editor: area testo per formula.
• Rescale Result Checkbox: rimappa min-max a 0-1.
• Apply / Cancel: applica o annulla.

Star Analysis

Analisi stelle con tabella statistiche:

• Threshold Slider: range 1-20, default 5.
• Log Scale Checkbox: visualizzazione in scala log.
• Mode Button: passa tra vista metriche e distribuzione flusso.
• Stats Table: tabella risultati (FWHM/shape/flux).

FITS Header Editor

Visualizza e modifica keyword header FITS:

• Table Editor: elenco keyword/value/comment.
• Set: aggiunge o aggiorna keyword.
• Delete Selected: rimuove righe selezionate.
• Save Changes: salva modifiche header.

Image Annotator

Annotazioni astronomiche con cataloghi e griglia WCS:

• Catalog Checkboxes: Constellations, IC, LdN, Messier, NGC, Sh2, Stars.
• WCS Grid Checkbox: overlay RA/Dec.
• Color Combobox: Yellow, Red, Green, Cyan, White.
• Annotate Image: genera annotazioni automatiche.
• Undo / Redo: storico modifiche annotazioni.
• Clear All: reset annotazioni.

Image Binning

Riduce la risoluzione aggregando pixel adiacenti per migliorare il rapporto segnale/rumore o ridurre la dimensione dei dati:

• Fattori supportati: 1x1 (nessun binning), 2x2 e 3x3.
• Use cases: preprocessing per dataset rumorosi o sotto-campionati, esport rapido per analisi esplorativa, riduzione temporanea della risoluzione per elaborazioni pesanti.
• Comportamento: operazione distruttiva sull'immagine attiva; viene creato uno stato di undo prima dell'applicazione.

Image Upscale

Ingrandisce un'immagine scegliendo il metodo di interpolazione più adatto al tuo scopo:

• Metodi: Nearest (più veloce, preserva transizioni nette), Bilinear (veloce), Bicubic (più preciso), Lanczos4 (migliore qualità).
• Consigli: usa Lanczos4 per ingrandimenti finali di qualità, Bicubic per compromesso qualità/velocità; evita Nearest per output destinati alla presentazione se non richiesto per motivi specifici.
• Aspect Ratio: l'Upscale preserva l'aspect ratio di origine quando l'opzione è attiva nella dialog.

CLAHE

Contrasto locale adattivo:

• Clip Slider: range 1-5000, default 200.
• Tile Slider: range 1-128, default 8.
• Opacity Slider: range 0-100, default 100.
• Preview Checkbox: default checked.
• Reset / Apply / Close: controllo flusso completo.

Wavescale HDR

HDR multiscala con parametri di compressione:

• Compression Slider: 10-500, default 150.
• Scales Slider: 2-10, default 5.
• Gamma Slider: 10-1000, default 500.
• Dimming Slider: 50-300, default 100.
• Opacity Slider: 0-100, default 100.
• Compare Checkbox: mostra originale.
• Update Preview / Apply / Close: anteprima e applicazione.

Aberration Inspector

Griglia 3×3 per valutazione qualità ottica.

Blink Comparator

Confronto alternato tra due viste:

• View 1 / View 2 Combobox: selezione finestre da comparare.
• Blink Rate Spinbox: 50-5000 ms, step 50, default 500.
• Play/Pause: avvia o ferma alternanza.
• Refresh Views: aggiorna lista viste.

Correction Brush

Rimozione artefatti locale: Content-Aware con template matching + seamless clone, oppure Standard (mediana). Non usa modelli AI.

• Radius Slider: 1-200, default 12.
• Feather Slider: 0-100, default 50.
• Opacity Slider: 0-100, default 100.
• Method Combobox: Content-Aware (Slow, Best), Standard (Median).
• Auto-stretch Preview: on/off.
• Target Median Spinbox: 0.01-0.9, default 0.25.
• Linked Channels: default checked.
• Undo / Redo / Apply to Document: storico e commit nel documento attivo.
• Zoom Out / Zoom In / Fit: controlli vista nel dialog.

Rotate & Crop

Ritaglio e rotazione interattivi:

• Rotation Spinbox+Slider: -180° a +180°, step 0.1, default 0.
• Aspect Ratio Combobox: Free, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16.
• Apply: applica su immagine attiva.
• Batch Crop: applica crop a tutte le immagini aperte.

Star Halo Removal

Riduzione aloni stellari con preview locale:

• Reduction Slider: range 0-3.
• Linear Data Checkbox: default unchecked.
• Preview Checkbox: default checked.
• Apply Target Combobox: overwrite active view o create new view.
• Zoom +/- / Fit / Reset / Apply: controlli completi nel dialog.

Morphology

Operazioni morfologiche per riduzione stelle/dettagli:

• Operation Combobox: Erosion, Dilation, Opening, Closing.
• Apply Target Combobox: overwrite view attiva o crea nuova view.
• Preview Checkbox: default checked.
• Parameter Spin/Slider Pairs: controlli numerici sincronizzati per kernel/iterazioni.
• Zoom +/-, Fit, Reset, Apply: workflow completo nel dialog.

RAW to FITS Converter

Conversione batch RAW con gestione formato output:

• Output Format Combobox: FITS, XISF, TIFF.
• Bit Depth Combobox: 16-bit, 32-bit float (default 32-bit float).
• Debayer Checkbox: default checked.
• Add/Remove/Clear Files: gestione lista batch.
• Browse Output: selezione cartella destinazione.
• Convert: avvia conversione.

Effetti

AstroSpike

Spike di diffrazione artificiali:

• Add Star / Eraser: aggiunge o cancella stelle target.
• Size Slider: 1-50, default 4.
• Erase Slider: 5-200, default 20.
• Enable Halo / Enable Rainbow: effetti opzionali.
• Undo/Redo, Reset, Apply: gestione completa editing.

RAW Editor

Editor luce/colore con controlli continui (slider+spinbox) e Apply/Cancel.

Scripting e automazione

TStar Scripts

Browser script integrati:

• Script List: elenco script disponibili.
• Preview Panel: mostra contenuto script.
• Run Script: esegue script selezionato.
• Edit Script: apre script in modifica.
• Refresh: ricarica lista script.

Script Runner

Esecuzione script personalizzati .tss con variabili:

• Script Editor: area testo sorgente script.
• Output Log: log esecuzione.
• Predefined Script Combobox: selezione script predefiniti.
• Variables Table: gestione variabili runtime.
• Add/Remove Variable: gestione parametri.
• Load/Save: carica/salva file script.
• Run/Stop: avvio e interruzione esecuzione.

Scorciatoie da tastiera

Consigli e buone pratiche

• Lavora sempre su una copia dei tuoi dati originali.
• Usa Annulla frequentemente — ogni operazione è reversibile.
• Per i migliori risultati, esegui lo stretch DOPO la rimozione del fondo.
• Abilita RGB Link per le immagini a colori per mantenere il bilanciamento cromatico.
• Controlla il pannello Console per i messaggi di elaborazione.