Pianifica la notte
perfetta

0. Modalità Base e Avanzata

AstroDashboard PRO offre due livelli di utilizzo selezionabili in qualsiasi momento dal pulsante in alto a destra nel menu.

• Modalità Base — pensata per chi inizia o vuole semplicità: inserisci il target, l'app calcola automaticamente le pose ottimali in base al tuo setup e alla finestra notturna disponibile. Il meteo è semplificato, i filtri avanzati sono nascosti, Dark e Bias sono facoltativi. La sequenza N.I.N.A. è pronta in un click senza configurazioni complesse.
• Modalità Avanzata — per utenti esperti: controllo completo su filtri narrowband e broadband, autofocus con tre trigger indipendenti, dithering configurabile, HDR, meridian flip e pianificazione multi-notte. Ogni parametro è nelle tue mani.

Puoi passare da una modalità all'altra in qualsiasi momento senza perdere i dati già inseriti. Al primo accesso l'app ti guida nella scelta.

1. Dati Ambientali e Meteo Tattico

Prima di puntare il telescopio, devi sapere cosa ti aspetta sopra la testa. Questa sezione aggrega dati satellitari professionali in tempo reale direttamente nel tuo browser.

• Mappa a Raggio (50 Km): Progettata per gli astrofotografi itineranti. Il cerchio simbolico di 50 km ti permette di valutare a colpo d'occhio dove spostarti per trovare "buchi di sereno". Attiva i layer sovrapposti (Nuvole Basse, Medie, Alte, Jet Stream, Umidità, Luna) e scorri la timeline per vedere l'evoluzione nelle prossime ore.
• Jet Stream: Il vero nemico del Seeing. Un valore sotto i 50 km/h sopra la tua posizione garantisce cieli stabili e stelle puntiformi. Oltre i 100 km/h la turbolenza atmosferica devasterà i dettagli fini — inutile usare focali lunghe.
• Allarme Umidità: Se il dato supera l'85% (indicatore rosso), attiva le fasce riscaldanti anticondensa al massimo della potenza prima che la temperatura scenda al punto di rugiada. Una volta che l'ottica è appannata, la serata è compromessa.
• Inquinamento Lunare: Mostra la percentuale di cielo "bruciato" dalla luce della Luna in base alla sua fase e posizione. La penalità si azzera automaticamente quando la Luna è sotto l'orizzonte. Un valore alto scoraggia le riprese a banda larga — considera filtri narrowband (Ha, OIII, SII) che tagliano il continuo lunare.
• Inquinamento Luminoso (Layer Atlas 2024): Attiva il layer Inq. Luminoso per sovrapporre alla mappa la scala di Bortle a colori reali (dati VIIRS 2024 di David Lorenz): blu scuro = cielo pristino (Bortle 1–2), verde = rurale (3–4), giallo = suburbano (5), arancione = periferia urbana (6–7), bianco = centro città (8–9). Quando il layer è attivo compare automaticamente la legenda colorata sotto i pulsanti. Usa questo layer per individuare visivamente il tuo livello Bortle reale e impostarlo nel selettore — influisce direttamente sui consigli filtri dell'assistente.
• Selettore Bortle: Imposta il livello di inquinamento luminoso del tuo sito di osservazione (1 = cielo buio totale, 9 = centro città). Il valore viene usato dall'assistente filtri per calibrare i consigli sui filtri: cieli scuri (1–3) non richiedono filtri LP; cieli suburbani (4–7) beneficiano di filtri broadband (CLS, L-Pro, Quadband); cieli urbani (8–9) rendono indispensabile il narrowband (Ha/OIII dual-band). Clicca ℹ️ per istruzioni su come trovare il tuo Bortle con il layer mappa.

2. Planetario Ibrido e Motore SIMBAD

Il planetario non mostra semplicemente le stelle: calcola in tempo reale l'altitudine sull'orizzonte di ogni oggetto e ti presenta solo i target fotografi camente utili per la tua nottata.

• Database Locale (Oggetti Consigliati): Contiene i target più celebri con metadati completi: tipo, magnitudine, distanza e "Consiglio Tattico" specifico. Il consiglio non è generico — suggerisce filtri, avverte di saturazioni al nucleo, indica la stagionalità ottimale.
• Slider Temporale: Trascina la barra dell'orario per simulare la volta celeste a qualsiasi ora della notte. Gli oggetti scompaiono quando scendono sotto i 20° di altitudine (zona di turbolenza e bassa trasparenza), in modo da non mostrarti mai target inutilizzabili.
• Ricerca Universale SIMBAD: Se l'oggetto che cerchi non è nel database locale, inserisci il nome (es. "Sh2-132", "Abell 85", "IC 1871") e il motore interroga in tempo reale l'Università di Strasburgo. Riceverai le coordinate assolute J2000 e potrai pianificare immediatamente la ripresa.
• Sistema Solare: Pianeti e Luna sono sempre visibili in lista separata. Utile per pianificare sessioni planetarie o verificare l'interferenza lunare sul tuo target Deep Sky.

3. Setup Ottico, Campionamento e Simulatore FOV

Questa sezione trasforma i dati fisici del tuo strumento in informazioni operative: quanti arcsec copre il tuo sensore? L'oggetto entra nel campo? A che angolo devi orientare la camera?

• Scala di Campionamento (arcsec/pixel): Inserisci focale (mm) e dimensione pixel (µm): il sistema calcola il campionamento e lo classifica in tre zone. Verde: campionamento ideale (1–2 arcsec/px). Giallo: sottocampionamento lieve (stelle leggermente squadrate). Rosso: sovracampionamento eccessivo — stai sprecando fotoni e risoluzione.
• Simulatore FOV Realistico (DSS2): Carica l'immagine reale del cielo profondo dall'archivio DSS2 e vi sovrappone il rettangolo del tuo sensore in scala e orientamento corretti. Quello che vedi è esattamente quello che otterrai nella tua immagine finale.
• Rotazione FOV e Position Angle (PA): Lo slider di rotazione (0–360°) ruota il rettangolo del sensore sulla mappa. L'angolo scelto viene salvato nella sequenza e comunicato al rotatore automatico di N.I.N.A. durante l'export. Se trascini la mappa per spostare il centro del FOV rispetto al target originale, le coordinate aggiornate vengono mostrate in tempo reale nel box "Centro FOV" con indicatore di offset attivo — e puoi sempre tornare al centro esatto con il bottone ⌖ Reset.
• Modalità Mosaico: Quando il target è più grande del tuo campo inquadrato, attiva il mosaico e imposta la griglia (es. 2×2, 3×2) con la percentuale di sovrapposizione desiderata. Il sistema calcola automaticamente il tempo disponibile per pannello e genera il report strategico. Per N.I.N.A. usa il Framing Assistant con le coordinate del centro: il software divide automaticamente i pannelli.

3a. Profili di Configurazione

Il sistema Profili permette di memorizzare e ripristinare istantaneamente configurazioni complete: posizione GPS, telescopio, sensore (incluse le attrezzature personalizzate), tutti i parametri Smart e PRO, filtri, trigger, lingua e orizzonte personalizzato. Ideale per chi usa più strumenti o cambia postazione di osservazione.

• Dove si trova: Il pulsante 👤 è nell'intestazione della sezione Setup Ottico, accanto all'icona ℹ️. Su desktop mostra il testo "Profilo" (o il nome del profilo attivo); su mobile mostra l'icona con il nome troncato se troppo lungo.
• Salvare un profilo: Configura il setup completo (posizione, telescopio, sensore, parametri di sessione), poi clicca 👤 → digita un nome nel campo "Nuovo profilo" (es. "Newton Terrazza") → clicca Salva. Il profilo viene memorizzato nel browser e il nome compare nel pulsante. Se il nome è già esistente, viene richiesta conferma di sovrascrittura.
• Caricare un profilo: Clicca 👤 → seleziona il profilo dal menu a tendina → clicca ✔ Usa. La pagina si ricarica automaticamente con tutte le impostazioni del profilo selezionato, incluse attrezzatura personalizzata e orizzonte personalizzato.
• Esportare un profilo (backup): Seleziona un profilo dal menu a tendina → clicca ⬇ Esporta JSON. Il file scaricato contiene l'intera configurazione: conservalo come backup o trasferiscilo su un altro dispositivo.
• Importare un profilo da file: Clicca Importa JSON e seleziona il file precedentemente esportato. Il profilo viene aggiunto alla lista; se il nome coincide con uno esistente, quest'ultimo viene sovrascrit­to automaticamente. Dopo l'importazione selezionalo dal menu e clicca ✔ Usa per applicarlo.
• Su mobile — Pressione lunga: Su dispositivi touch il tocco normale apre il popup di gestione profili. Per leggere la descrizione del campo, tieni premuto il pulsante 👤 per circa 600 ms: il tooltip informativo appare e si chiude automaticamente dopo 4 secondi.

4. Calcolatore Sessione Smart

In modalità Smart il sistema è il tuo assistente esperto. Analizzi il target, comunichi le caratteristiche del tuo setup e lasci che l'algoritmo generi una sequenza bilanciata e ottimizzata per le condizioni di quella specifica notte.

• L'Algoritmo Predittivo: Il calcolo non è una media generica. Considera il rapporto focale del tuo ottico (f/4 vs f/8 cambia radicalmente i tempi), il tipo di sensore (OSC o Mono), i filtri attivi, l'inquinamento lunare attuale, la magnitudine superficiale del target e l'indice di Bortle del sito di osservazione. Cieli bui (Bortle 1–4) riducono il tempo necessario; cieli urbani (Bortle 6–9) aumentano la stima progressivamente. Per nebulose a emissione con filtri narrowband attivi la penalità è attenuata. Dalla v6.3: i sensori OSC supportano filtri Dual-band e Quad-band — il calcolo usa la formula fisica dello swamping (RN, QE, bandwidth, f-ratio, blue-shift) per stimare la posa minima ottimale. Quando la combinazione di fattori porta a stime irragionevoli, il sistema sconsiglia l'integrazione e suggerisce alternative.
• Generazione Sequenza Ottimale: Clicca "Genera Sequenza Ottimale" e il sistema distribuisce le pose sulla finestra notturna disponibile (orario inizio–fine che hai impostato), bilanciando il tempo tra i filtri e riservando le calibrazioni. Per i sensori Mono calcola separatamente L, R, G, B e narrowband.
• Dithering Smart: Se attivi il dithering, specifica la frequenza (ogni N pose). Il sistema sottrae automaticamente l'overhead di dithering dal tempo totale: quello che vedi in "Tempo Acquisizione" è il tempo reale di integrazione netta.
• Mappatura Nomi Filtri N.I.N.A.: Per i sensori Mono, ogni filtro ha un campo dove inserire il nome esatto come lo riconosce la tua ruota portafiltri in N.I.N.A. (es. "Hα 3nm" invece di "Ha"). Se i nomi non corrispondono esattamente, N.I.N.A. darà errore durante la sequenza.
• Multinotte Smart: Se l'integrazione calcolata supera la finestra notturna disponibile, il sistema mostra il pulsante "Pianifica Progetto Multi-Notte". Qui il riferimento è l'obiettivo calcolato dall'assistente smart. Aggiungi quante sessioni servono, assegna le pose per notte e scarica un file N.I.N.A. separato per ciascuna.

5. Calcolatore PRO — Sei Tu il Direttore

Il modulo PRO ribalta la logica: non chiede al sistema cosa fare, ma esegue esattamente quello che decidi tu. È lo strumento per chi ha già un piano preciso in testa e vuole tradurlo in una sequenza N.I.N.A. professionale senza compromessi.

• Calcolatore di Sequenze: La griglia mostra tutti i filtri del tuo setup (Light per OSC, oppure L/R/G/B/Ha/OIII/SII per Mono). Per ogni filtro imposti: numero di pose, secondi di esposizione, Gain, Offset, Binning e frequenza di Dithering (con checkbox indipendente per filtro). La barra di riempimento confronta il tuo TPT (Tempo Totale Pianificato) con la finestra notturna: 🟢 verde se tutto entra, 🟡 arancione se il margine è stretto, 🔴 rossa se sfori — in quel caso appare automaticamente il pulsante "Progettazione Multinotte".
• Triggers Pre-Flight: Prima dell'imaging configuri: Raffredda Camera (imposti la temperatura target), Slew & Center con Plate Solving (N.I.N.A. punta e risolve la posizione), Rotatore Automatico (ruota la camera all'angolo impostato nel simulatore FOV), Avvia Autoguida e Meridian Flip automatico.
• Autofocus Avanzato: Tre modalità indipendenti: all'avvio della sequenza, al cambio di filtro (ideale per filtri con offset di fuoco diversi) e alla variazione dell'HFR (il metodo più intelligente: N.I.N.A. misura il deterioramento del fuoco in tempo reale e interviene solo quando necessario, evitando autofocus inutili). Ogni trigger attivo contribuisce al budget autofocus: il sistema stima automaticamente il numero di procedure AF nella finestra notturna in base ai trigger selezionati, al tipo di OTA e alla curva di temperatura prevista da Open-Meteo. Il tempo totale stimato viene sottratto dal budget disponibile, esattamente come il dithering. Puoi accettare la stima con un click o impostare il numero manualmente.
• Triggers Post-Flight: Warm Up Camera, Park Montatura, Chiudi Cover/Cap motorizzato, Accendi Flat Panel — tutto automatico al termine della sequenza.
• Mappatura Filtri PRO: Come nella sezione Smart, ogni filtro ha il suo campo nome N.I.N.A. La modifica in un pannello si sincronizza automaticamente nell'altro.

6. Progettazione Multinotte

Quando un progetto richiede più ore di quante ne offre una singola notte, la Progettazione Multinotte ti permette di distribuire il lavoro su più sessioni mantenendo sempre il controllo sul progresso complessivo.

• TPT — Tempo Totale Pianificato: È l'obiettivo fisso del tuo progetto. In modalità Smart corrisponde alle ore calcolate dall'assistente smart; in modalità PRO è calcolato dalla tua griglia di pose. Non cambia mai: è il traguardo che devi raggiungere sommando tutte le notti.
• Barra di Avanzamento: Parte rossa a 0% e diventa verde solo quando la somma del "Tempo Pianificato" nelle varie sessioni raggiunge o supera il TPT. È il tuo indicatore visivo di completamento progetto.
• Gestione Sessioni: Per ogni notte aggiungi una scheda con: orario inizio e fine (la finestra utile di quella specifica notte), numero di pose per filtro in quella sessione, e verifica automatica se le pose entrano nella finestra — con avviso di sforamento se necessario.
• Export per Notte: Ogni sessione genera il suo file N.I.N.A. indipendente, completo di tutti i trigger configurati (AF, guida, flip, ecc.) e delle coordinate FOV aggiornate. La notte 1 potrebbe contenere solo L e R, la notte 2 solo G, B e Ha — tu decidi la strategia.

7. Esportazione e Automazione

• Export N.I.N.A. Smart: Genera un file JSON per N.I.N.A. Advanced Sequencer con la sequenza calcolata dall'assistente smart. La struttura include: UnparkScope all'avvio, raffreddamento camera, Slew & Center, Autofocus iniziale, autoguida, WaitForTime (attende l'orario di inizio sessione), imaging con TimeCondition (stop all'orario fine sessione), Meridian Flip automatico, dithering configurato. Post sessione: WarmUp e Park automatici. Trascina il file dentro N.I.N.A. e la notte parte da sola.
• Export N.I.N.A. PRO (Advanced Sequence): Il JSON PRO è una sequenza nativa N.I.N.A. di livello avanzato. Struttura completa: UnparkScope → CoolCamera → Center → RunAutofocus → SolveAndRotate → StartGuiding → WaitForTime → imaging con TimeCondition → WarmCamera → ParkScope. Ogni filtro ha la sua struttura con LoopCondition nativo, trigger di dithering per-filtro, gain/offset/binning individuali e FilterInfo completo con FlatWizardSettings per piena compatibilità con la ruota portafiltri N.I.N.A.
• Export ASIAIR: Genera un file CSV con le coordinate di precisione e mostra a schermo il riepilogo del piano di scatto ottimizzato per l'interfaccia tablet di ASIAIR/ASIAIR+/ASIAIR Pro. Include l'angolo di rotazione camera suggerito per l'inquadratura ottimale.
• Coordinate FOV Personalizzate: Se hai spostato la mappa durante la simulazione FOV, le coordinate del centro aggiornato vengono usate in tutti gli export (N.I.N.A. Smart, PRO e Multinotte). Il badge "⚠ Offset attivo" ti avvisa quando le coordinate di export differiscono dal centro nominale del target.

8. Orizzonte Personalizzato

Il modulo Orizzonte Personalizzato genera un profilo di ostruzione azimutale preciso dalla tua postazione, riflettendo muri, tetti, colline e alberi che limitano la visibilità reale del cielo. Il profilo viene integrato nel grafico altitudine del simulatore FOV e può essere esportato direttamente nei formati nativi di N.I.N.A. e Stellarium.

• Foto panoramica consigliata: Usa una foto sferica 360°×180° (formato equirettangolare) scattata dalla posizione esatta del telescopio. Le app Google Photo Sphere (Pixel), GoPro Max o qualsiasi camera 360° producono il formato corretto. In alternativa unisci una serie di foto con Hugin o PTGui. Per Stellarium, rimuovi il cielo dalla foto (Photoshop, GIMP o remove.bg) e salva in PNG — la trasparenza permette di vedere le stelle attraverso il cielo rimosso.
• Algoritmo di rilevamento (Sobel): L'algoritmo Sobel rileva automaticamente il bordo di massimo contrasto tra cielo e terreno in ogni colonna dell'immagine. Funziona anche su foto con cielo rimosso (nero o trasparente). Algoritmi alternativi: Gradiente (massimo salto di luminanza), Soglia (primo pixel sotto un valore) e Prima zona scura (transizione dopo una zona luminosa sostenuta). Passa il mouse sui label dei parametri per leggere la spiegazione di ognuno.
• Calibrazione parametri: I tre parametri principali da regolare sono: Altitudine centro — abbassa finché la linea tratteggiata (0°) coincide con l'orizzonte reale lontano; Az. partenza Nord — regola finché i segni cardinali nell'anteprima coincidono con i riferimenti noti dalla bussola; FOV verticale — impostato automaticamente a 180° per le foto sferiche 2:1, altrimenti regola in base all'angolo verticale della tua panoramica.
• Correzione manuale: Dopo il rilevamento automatico, clicca direttamente sull'anteprima per correggere la linea in qualsiasi punto. Il pennello ha un raggio di blend di ±30 pixel che interpola fluidamente la correzione con i valori adiacenti, evitando salti bruschi nel profilo.
• Integrazione nel grafico FOV: Una volta applicato con il pulsante Applica a FOV, il profilo appare nel grafico altitudine come zona rossa — esattamente come N.I.N.A. La soglia varia nel tempo seguendo l'azimut del DSO: quando il target entra in una zona di ostruzione, il grafico lo mostra chiaramente prima che accada.
• Export per N.I.N.A. (.hrz): Il file segue la convenzione astronomica standard: Azimut 0°=Nord, crescente verso Est; altitudine in gradi sopra l'orizzonte matematico. Il profilo è già corretto con le tue coordinate GPS — fondamentale inserirle anche nelle impostazioni dell'Osservatorio in N.I.N.A. altrimenti i calcoli di visibilità saranno imprecisi.
• Export per Stellarium (.zip): Lo zip include la foto panoramica in PNG (con canale alfa), il file landscape.ini di tipo spherical con le coordinate della postazione e la rotazione corretta per l'allineamento Nord, e il file horizon.txt con il profilo az/alt. Estrai lo zip nella cartella landscapes/ di Stellarium e seleziona il paesaggio nelle impostazioni.
• Persistenza e backup: Il profilo viene salvato automaticamente in localStorage — al prossimo avvio dell'app sarà già attivo nel grafico FOV senza ricaricare la foto. Il pulsante Backup (.json) scarica un file di ripristino completo: se la cache viene svuotata, usa ↩ Ripristina sopra il grafico per riacquisire il profilo in un clic, con applicazione automatica al FOV.

0. Basic and Advanced Mode

AstroDashboard PRO offers two usage levels selectable at any time from the button in the top-right menu.

• Basic Mode — designed for beginners or those who want simplicity: enter your target, the app automatically calculates optimal frames based on your setup and the available night window. Weather is simplified, advanced filters are hidden, Dark and Bias frames are optional. The N.I.N.A. sequence is ready in one click without complex settings.
• Advanced Mode — for experienced users: full control over narrowband and broadband filters, autofocus with three independent triggers, configurable dithering, HDR, meridian flip and multi-night planning. Every parameter is in your hands.

You can switch between modes at any time without losing entered data. On first access, the app guides you through the choice.

1. Tactical Weather & Environmental Data

Before pointing your telescope, you need to know what's above your head. This section aggregates professional satellite data in real time directly in your browser.

• 50km Radius Map: Designed for mobile astrophotographers. The symbolic 50km circle lets you instantly evaluate where to relocate to find "clear sky holes". Activate overlapping layers (Low/Mid/High Clouds, Jet Stream, Humidity, Moon) and scroll the timeline to forecast conditions over the next hours.
• Jet Stream: The true enemy of Seeing. Values below 50 km/h guarantee stable skies and pinpoint stars. Above 100 km/h, atmospheric turbulence will destroy fine detail — avoid long focal lengths.
• Humidity Alarm: If the reading exceeds 85% (red indicator), activate your dew heaters at full power before the temperature drops to the dew point. Once optics fog up, the session is ruined.
• Moon Pollution: Shows the percentage of sky "burned" by moonlight based on current phase and position. The penalty automatically drops to zero when the Moon is below the horizon. High values discourage broadband imaging — consider narrowband filters (Ha, OIII, SII) which cut lunar continuum.
• Light Pollution Layer (Atlas 2024): Enable the Light Pollution layer to overlay the Bortle colour scale on the map (VIIRS 2024 data by David Lorenz): dark blue = pristine sky (Bortle 1–2), green = rural (3–4), yellow = suburban (5), orange = urban fringe (6–7), white = city centre (8–9). When the layer is active, a colour legend appears automatically below the buttons. Use this layer to visually identify your real Bortle level and set it in the selector — it directly affects the filter advisor recommendations.
• Bortle Selector: Sets the light pollution level of your observing site (1 = pristine dark sky, 9 = city centre). The value is used by the filter advisor to calibrate filter advice: dark skies (1–3) need no LP filters; suburban skies (4–7) benefit from broadband filters (CLS, L-Pro, Quadband); urban skies (8–9) make narrowband (Ha/OIII dual-band) essential. Click ℹ️ for instructions on finding your Bortle using the map layer.

2. Hybrid Planetarium & SIMBAD Engine

The planetarium doesn't just show stars: it calculates altitude above the horizon for every object in real time and presents only the targets that are photographically useful for your night.

• Local Database (Recommended Targets): Contains the most celebrated targets with full metadata: type, magnitude, distance and specific "Tactical Tip". Tips are not generic — they suggest filters, warn of core saturation, indicate optimal seasons.
• Time Slider: Drag the time bar to simulate the sky at any hour of the night. Objects disappear when they drop below 20° altitude (turbulence and low transparency zone), so you never see unusable targets.
• Universal SIMBAD Search: If your target isn't in the local database, type its name (e.g. "Sh2-132", "Abell 85", "IC 1871") and the engine queries the University of Strasbourg in real time. You'll receive J2000 absolute coordinates and can immediately plan your session.
• Solar System: Planets and the Moon are always available in a separate list. Useful for planning planetary sessions or checking lunar interference on your Deep Sky target.

3. Optical Setup, Sampling & FOV Simulator

This section transforms your instrument's physical data into operational information: how many arcseconds does your sensor cover? Does the object fit the frame? What angle should you orient the camera?

• Sampling Scale (arcsec/pixel): Enter focal length (mm) and pixel size (µm): the system calculates your image scale and classifies it into three zones. Green: ideal sampling (1–2 arcsec/px). Yellow: slight undersampling (slightly blocky stars). Red: excessive oversampling — you are wasting photons and resolution.
• Realistic FOV Simulator (DSS2): Loads the real deep sky image from the DSS2 archive and overlays your sensor rectangle at the correct scale and orientation. What you see is exactly what you'll get in your final image.
• FOV Rotation & Position Angle (PA): The rotation slider (0–360°) rotates the sensor rectangle on the map. The chosen angle is saved in the sequence and sent to N.I.N.A.'s auto-rotator during export. If you drag the map to offset the FOV center from the original target, updated coordinates are shown in real time in the "FOV Center" box with an active offset indicator — and you can always return to the exact center with the ⌖ Reset button.
• Mosaic Mode: When the target is larger than your field of view, enable mosaic and set the grid (e.g. 2×2, 3×2) with the desired overlap percentage. The system automatically calculates the time per panel and generates the strategic report. For N.I.N.A. use the Framing Assistant with the center coordinates.

3a. Configuration Profiles

The Profile system lets you instantly save and restore complete configurations: GPS location, telescope, sensor (including custom equipment), all Smart and PRO parameters, filters, triggers, language and custom horizon. Ideal for users who work with multiple instruments or switch observation sites.

• Where to find it: The 👤 button is in the Setup Ottico section header, next to the ℹ️ icon. On desktop it shows the text "Profile" (or the active profile name); on mobile it shows the icon with a truncated name if too long.
• Saving a profile: Configure your complete setup (location, telescope, sensor, session parameters), then click 👤 → type a name in the "New profile" field (e.g. "Newton Rooftop") → click Save. The profile is stored in the browser and the name appears in the button. If the name already exists, you will be asked to confirm overwrite.
• Loading a profile: Click 👤 → select the profile from the dropdown menu → click ✔ Use. The page automatically reloads with all the settings from the selected profile, including custom equipment and custom horizon.
• Exporting a profile (backup): Select a profile from the dropdown → click ⬇ Export JSON. The downloaded file contains the complete configuration: keep it as a backup or transfer it to another device.
• Importing a profile from file: Click Import JSON and select a previously exported file. The profile is added to the list; if the name matches an existing one, it is automatically overwritten. After importing, select it from the menu and click ✔ Use to apply it.
• On mobile — Long press: On touch devices a normal tap opens the profile management popup. To read the field description, hold the 👤 button for about 600 ms: the info tooltip appears and closes automatically after 4 seconds.

4. Smart Session Calculator

In Smart mode the system is your expert assistant. You analyze the target, share your setup specs and let the algorithm generate a balanced sequence optimized for the conditions of that specific night.

• Predictive Algorithm: The calculation is not a generic average. It factors in your optical focal ratio (f/4 vs f/8 radically changes integration times), sensor type (OSC or Mono), active filters, current moon pollution, target surface brightness and the Bortle index of your observing site. Dark skies (Bortle 1–4) reduce required time; urban skies (Bortle 6–9) progressively increase the estimate. For emission nebulae with narrowband filters active, the penalty is reduced. From v6.3: OSC sensors support Dual-band and Quad-band filters — the calculation uses the physical swamping formula (RN, QE, bandwidth, f-ratio, blue-shift correction) to estimate the optimal minimum exposure. When combinations of factors lead to unreasonable estimates, the system advises against imaging and suggests alternatives.
• Generate Optimal Sequence: Click "Generate Optimal Sequence" and the system distributes frames across the available night window (start–end times you set), balancing time between filters and reserving time for calibration frames. For Mono sensors it calculates L, R, G, B and narrowband independently.
• Smart Dithering: Enable dithering and specify frequency (every N frames). The system automatically subtracts dithering overhead from total available time — the "Acquisition Time" shown is real net integration time, already accounting for all overhead.
• N.I.N.A. Filter Name Mapping: For Mono sensors, each filter has a field where you enter its exact name as N.I.N.A. recognizes it from your filter wheel (e.g. "Hα 3nm" instead of "Ha"). If names don't match exactly, N.I.N.A. will throw an error during the sequence.
• Smart Multi-Night: If the calculated integration exceeds the available night window, the "Plan Multi-Night Project" button appears. The reference here is the smart assistant's calculated goal. Add as many sessions as needed, assign frames per night and download a separate N.I.N.A. file for each.

5. PRO Builder — You Are the Commander

The PRO module flips the logic: it doesn't ask the system what to do, it executes exactly what you decide. This is the tool for those who already have a precise plan and want to translate it into a professional N.I.N.A. sequence without compromise.

• Sequence Builder: The grid shows all filters for your setup (Light for OSC, or L/R/G/B/Ha/OIII/SII for Mono). For each filter you set: frame count, exposure time, Gain, Offset, Binning and Dithering frequency (with independent per-filter checkbox). The fill bar compares your TPT (Total Planned Time) against the night window: 🟢 green if everything fits, 🟡 orange if the margin is tight, 🔴 red if you overflow — the "Multi-Night Planning" button then appears automatically.
• Pre-Flight Triggers: Before imaging you configure: Cool Camera (set target temperature), Slew & Center with Plate Solving, Auto Rotator (rotates to the angle set in the FOV simulator), Start Autoguiding and automatic Meridian Flip.
• Advanced Autofocus: Three independent modes: at sequence start, on filter change (ideal for filters with different focus offsets), and on HFR increase (the smartest method: N.I.N.A. measures focus degradation in real time and intervenes only when necessary, avoiding unnecessary refocus runs). Every active trigger contributes to the autofocus budget: the system automatically estimates the number of AF routines in the night window based on the selected triggers, OTA type, and the temperature curve forecast by Open-Meteo. The estimated total time is subtracted from the available budget, exactly like dithering. You can accept the estimate with one click or set the count manually.
• Post-Flight Triggers: Warm Up Camera, Park Mount, Close motorized Cover/Cap, Turn On Flat Panel — all automatic at sequence end.
• PRO Filter Mapping: As in the Smart section, each filter has its N.I.N.A. name field. Changes in one panel sync automatically to the other.

6. Multi-Night Planning

When a project requires more hours than a single night offers, Multi-Night Planning lets you distribute the work across multiple sessions while always keeping track of overall progress.

• TPT — Total Planned Time: The fixed goal of your project. In Smart mode it corresponds to the smart assistant's calculated hours; in PRO mode it's calculated from your frame grid. It never changes: it's the milestone you must reach by summing all nights.
• Progress Bar: Starts red at 0% and turns green only when the sum of "Planned Time" across all sessions reaches or exceeds the TPT. Your visual project completion indicator.
• Session Management: For each night add a card with: start and end time (the useful window for that specific night), frames per filter for that session, and automatic check whether frames fit in the window — with overflow warning if needed.
• Per-Night Export: Each session generates its own independent N.I.N.A. file, complete with all configured triggers (AF, guiding, flip, etc.) and updated FOV coordinates. Night 1 might contain only L and R, night 2 only G, B and Ha — you decide the strategy.

7. Export & Automation

• N.I.N.A. Smart Export: Generates a JSON file for N.I.N.A. Advanced Sequencer with the smart assistant-calculated sequence. Structure includes: UnparkScope at start, camera cooling, Slew & Center, initial Autofocus, autoguiding, WaitForTime (waits for session start time), imaging with TimeCondition (stops at session end time), automatic Meridian Flip, configured dithering. Post-session: WarmUp and Park automatic. Drag the file into N.I.N.A. and the night runs itself.
• N.I.N.A. PRO Export (Advanced Sequence): The PRO JSON is a native N.I.N.A. advanced-level sequence. Full structure: UnparkScope → CoolCamera → Center → RunAutofocus → SolveAndRotate → StartGuiding → WaitForTime → imaging with TimeCondition → WarmCamera → ParkScope. Each filter has its own structure with native LoopCondition, per-filter dithering triggers, individual gain/offset/binning and full FilterInfo with FlatWizardSettings for complete compatibility with the N.I.N.A. filter wheel.
• ASIAIR Export: Generates a CSV file with precision coordinates and displays a visual shooting plan optimized for the ASIAIR/ASIAIR+/ASIAIR Pro tablet interface. Includes the suggested camera rotation angle for optimal framing.
• Custom FOV Coordinates: If you moved the map during FOV simulation, the updated center coordinates are used in all exports (N.I.N.A. Smart, PRO and Multi-Night). The "⚠ Offset active" badge warns you when export coordinates differ from the target's nominal center.

8. Custom Horizon

The Custom Horizon module generates an accurate azimuthal obstruction profile from your observation site, capturing walls, rooftops, hills and trees that limit real sky visibility. The profile integrates into the FOV simulator altitude chart and can be exported directly in native N.I.N.A. and Stellarium formats.

• Recommended photo format: Use a 360°×180° spherical photo (equirectangular format) taken from your exact telescope position. Google Photo Sphere (Pixel), GoPro Max or any 360° camera produces the correct format. Alternatively stitch a photo series with Hugin or PTGui. For Stellarium, remove the sky from the photo (Photoshop, GIMP or remove.bg) and save as PNG — the transparency lets Stellarium show stars through it.
• Detection algorithm (Sobel): The Sobel algorithm automatically detects the maximum contrast edge between sky and ground in each image column. Works even on photos with removed sky (black or transparent). Alternative algorithms: Gradient (maximum luminance jump), Threshold (first pixel below a value) and First Dark Band (transition after a sustained bright zone). Hover over parameter labels to read an explanation of each one.
• Parameter calibration: The three main parameters to adjust are: Center altitude — lower until the dashed line (0°) aligns with the real far horizon; North start Az. — adjust until the cardinal markers in the preview match known compass references; Vertical FOV — automatically set to 180° for 2:1 spherical photos, otherwise adjust to match the vertical angle of your panorama.
• Manual correction: After automatic detection, click directly on the preview to correct the line at any point. The brush has a ±30px blend radius that smoothly interpolates the correction with adjacent values, avoiding sharp jumps in the profile.
• FOV chart integration: Once applied with the Apply to FOV button, the profile appears in the altitude chart as a red zone — exactly like N.I.N.A. The threshold varies over time following the DSO azimuth: when the target enters an obstruction zone, the chart shows it clearly before it happens.
• N.I.N.A. export (.hrz): The file follows the standard astronomical convention: Azimuth 0°=North, increasing eastward; altitude in degrees above the mathematical horizon. The profile is already corrected with your GPS coordinates — it's essential to also enter them in N.I.N.A.'s Observatory settings, otherwise visibility calculations will be inaccurate.
• Stellarium export (.zip): The zip includes the panoramic photo as PNG (with alpha channel), the landscape.ini file of spherical type with site coordinates and correct rotation for North alignment, and the horizon.txt file with the az/alt profile. Extract the zip into Stellarium's landscapes/ folder and select the landscape in settings.
• Persistence and backup: The profile is saved automatically to localStorage — on the next app launch it will already be active in the FOV chart without reloading the photo. The Backup (.json) button downloads a complete restore file: if the cache is cleared, use ↩ Restore above the chart to recover the profile in one click, with automatic FOV application.

0. Modo Básico y Avanzado

AstroDashboard PRO ofrece dos niveles de uso seleccionables en cualquier momento desde el botón en el menú superior derecho.

• Modo Básico — pensado para principiantes o quienes buscan simplicidad: introduce tu objetivo, la app calcula automáticamente las poses óptimas según tu setup y la ventana nocturna disponible. El tiempo atmosférico es simplificado, los filtros avanzados están ocultos y los Darks y Bias son opcionales. La secuencia N.I.N.A. está lista en un click sin configuraciones complejas.
• Modo Avanzado — para usuarios expertos: control total sobre filtros narrowband y broadband, autofocus con tres disparadores independientes, dithering configurable, HDR, meridian flip y planificación multi-noche. Cada parámetro está en tus manos.

Puedes cambiar entre modos en cualquier momento sin perder los datos introducidos. En el primer acceso la app te guía en la elección.

1. Clima Táctico y Datos Ambientales

Antes de apuntar el telescopio, necesitas saber qué hay sobre tu cabeza. Esta sección agrega datos satelitales profesionales en tiempo real directamente en tu navegador.

• Mapa de Radio 50km: Diseñado para astrofotógrafos itinerantes. El círculo de 50 km te permite evaluar de un vistazo dónde desplazarte para encontrar "claros en las nubes". Activa las capas superpuestas y desliza la línea de tiempo para prever las condiciones de las próximas horas.
• Jet Stream: El verdadero enemigo del Seeing. Por debajo de 50 km/h garantiza cielos estables y estrellas puntiformes. Por encima de 100 km/h, la turbulencia atmosférica destruirá los detalles finos — evita focales largas.
• Alarma de Humedad: Si supera el 85% (indicador rojo), activa las cintas calefactoras anticondensación a máxima potencia antes de que la temperatura baje al punto de rocío. Una vez que la óptica se empaña, la sesión está arruinada.
• Contaminación Lunar: Muestra el porcentaje de cielo "quemado" por la luz de la Luna según su fase y posición actual. La penalización se anula automáticamente cuando la Luna está bajo el horizonte. Valores altos desaconsejan la fotografía de banda ancha — considera filtros narrowband (Ha, OIII, SII).
• Capa de Contaminación Lumínica (Atlas 2024): Activa la capa Contam. Lumínica para superponer en el mapa la escala Bortle en colores reales (datos VIIRS 2024 de David Lorenz): azul oscuro = cielo prístino (Bortle 1–2), verde = rural (3–4), amarillo = suburbano (5), naranja = periferia urbana (6–7), blanco = centro ciudad (8–9). Al activar la capa aparece automáticamente la leyenda de colores bajo los botones. Usa esta capa para identificar visualmente tu nivel Bortle real y configurarlo en el selector.
• Selector Bortle: Establece el nivel de contaminación lumínica de tu sitio de observación (1 = cielo oscuro total, 9 = centro urbano). El valor lo usa el asistente de filtros para calibrar los consejos de filtros: cielos oscuros (1–3) no requieren filtros LP; cielos suburbanos (4–7) se benefician de filtros broadband (CLS, L-Pro, Quadband); cielos urbanos (8–9) hacen indispensable el narrowband (dual-band Ha/OIII). Haz clic en ℹ️ para instrucciones sobre cómo encontrar tu Bortle con la capa del mapa.

2. Planetario Híbrido y Motor SIMBAD

El planetario no solo muestra estrellas: calcula en tiempo real la altitud sobre el horizonte de cada objeto y te presenta únicamente los objetivos fotográficamente útiles para tu noche.

• Base de Datos Local (Objetivos Recomendados): Contiene los objetivos más célebres con metadatos completos: tipo, magnitud, distancia y "Consejo Táctico" específico. Los consejos no son genéricos — sugieren filtros, advierten de saturaciones en el núcleo, indican la estacionalidad óptima.
• Control Deslizante de Tiempo: Arrastra la barra de tiempo para simular el cielo a cualquier hora de la noche. Los objetos desaparecen cuando bajan de los 20° de altitud (zona de turbulencia y baja transparencia).
• Búsqueda Universal SIMBAD: Si tu objetivo no está en la base de datos local, escribe su nombre (ej. "Sh2-132", "Abell 85") y el motor consulta en tiempo real la Universidad de Estrasburgo. Recibirás las coordenadas absolutas J2000 y podrás planificar la sesión inmediatamente.
• Sistema Solar: Planetas y Luna están siempre disponibles en una lista separada. Útil para planificar sesiones planetarias o verificar la interferencia lunar en tu objetivo Deep Sky.

3. Óptica, Muestreo y Simulador FOV

Esta sección transforma los datos físicos de tu instrumento en información operativa: ¿cuántos segundos de arco cubre tu sensor? ¿El objeto entra en el campo? ¿A qué ángulo debes orientar la cámara?

• Escala de Muestreo (arcsec/pixel): Introduce distancia focal (mm) y tamaño de píxel (µm): el sistema calcula tu escala de imagen y la clasifica. Verde: muestreo ideal. Amarillo: ligero submuestreo. Rojo: sobremuestreo excesivo — estás desperdiciando fotones y resolución.
• Simulador FOV Realista (DSS2): Carga la imagen real del cielo profundo del archivo DSS2 y superpone el rectángulo de tu sensor a escala y orientación correctas. Lo que ves es exactamente lo que obtendrás en tu imagen final.
• Rotación FOV y Ángulo de Posición (PA): El control deslizante de rotación (0–360°) gira el rectángulo del sensor en el mapa. El ángulo elegido se guarda en la secuencia y se envía al rotador automático de N.I.N.A. durante la exportación. Si arrastras el mapa para desplazar el centro del FOV, las coordenadas actualizadas se muestran en tiempo real con un indicador de desplazamiento activo — y puedes volver al centro exacto con el botón ⌖ Reset.
• Modo Mosaico: Cuando el objetivo es más grande que tu campo, activa el mosaico y configura la cuadrícula con el porcentaje de solapamiento deseado. El sistema calcula automáticamente el tiempo por panel y genera el informe estratégico.

3a. Perfiles de Configuración

El sistema de Perfiles permite guardar y restaurar instantáneamente configuraciones completas: posición GPS, telescopio, sensor (incluido equipo personalizado), todos los parámetros Smart y PRO, filtros, triggers, idioma y horizonte personalizado. Ideal para quienes usan varios instrumentos o cambian de ubicación de observación.

• Dónde encontrarlo: El botón 👤 está en el encabezado de la sección Setup Óptico, junto al icono ℹ️. En escritorio muestra el texto "Perfil" (o el nombre del perfil activo); en móvil muestra el icono con el nombre truncado si es demasiado largo.
• Guardar un perfil: Configura tu setup completo (ubicación, telescopio, sensor, parámetros de sesión), luego haz clic en 👤 → escribe un nombre en el campo "Nuevo perfil" (ej. "Newton Terraza") → haz clic en Guardar. El perfil se almacena en el navegador y el nombre aparece en el botón. Si el nombre ya existe, se pedirá confirmación de sobreescritura.
• Cargar un perfil: Haz clic en 👤 → selecciona el perfil del menú desplegable → haz clic en ✔ Usar. La página se recarga automáticamente con todos los ajustes del perfil seleccionado, incluido equipo personalizado y horizonte personalizado.
• Exportar un perfil (copia de seguridad): Selecciona un perfil del menú → haz clic en ⬇ Exportar JSON. El archivo descargado contiene la configuración completa: guárdalo como copia de seguridad o transfierelo a otro dispositivo.
• Importar un perfil desde archivo: Haz clic en Importar JSON y selecciona un archivo exportado previamente. El perfil se añade a la lista; si el nombre coincide con uno existente, se sobreescribe automáticamente. Tras la importación, selecciónalo del menú y haz clic en ✔ Usar para aplicarlo.
• En móvil — Pulsación larga: En dispositivos táctiles un toque normal abre el popup de gestión de perfiles. Para leer la descripción del campo, mantén pulsado el botón 👤 durante unos 600 ms: el tooltip informativo aparece y se cierra automáticamente tras 4 segundos.

4. Calculadora de Sesión Smart

En modo Smart el sistema es tu asistente experto. Analizas el objetivo, compartes las características de tu equipo y dejas que el algoritmo genere una secuencia equilibrada y optimizada para las condiciones de esa noche específica.

• Algoritmo Predictivo: El cálculo no es una media genérica. Considera la relación focal de tu óptica, el tipo de sensor (OSC o Mono), los filtros activos, la contaminación lunar actual, la magnitud superficial del objetivo y el índice Bortle del sitio de observación. Los cielos oscuros (Bortle 1–4) reducen el tiempo necesario; los cielos urbanos (Bortle 6–9) aumentan la estimación. Para nebulosas de emisión con filtros narrowband activos, la penalización se reduce. Desde la v6.3: los sensores OSC soportan filtros Dual-band y Quad-band — el cálculo usa la fórmula física de swamping (RN, QE, ancho de banda, f-ratio, corrección blue-shift) para estimar la exposición mínima óptima. Cuando los factores llevan a estimaciones irrazonables, el sistema desaconseja continuar y sugiere alternativas.
• Generar Secuencia Óptima: Haz clic en "Generar Secuencia Óptima" y el sistema distribuye las tomas en la ventana nocturna disponible, equilibrando el tiempo entre filtros y reservando tiempo para los frames de calibración.
• Dithering Smart: Activa el dithering y especifica la frecuencia (cada N tomas). El sistema resta automáticamente el overhead de dithering del tiempo total disponible.
• Mapeo de Nombres de Filtros N.I.N.A.: Para sensores Mono, cada filtro tiene un campo donde introduces su nombre exacto tal como lo reconoce tu rueda de filtros en N.I.N.A. Si los nombres no coinciden exactamente, N.I.N.A. dará error.
• Multi-Noche Smart: Si la integración calculada supera la ventana nocturna disponible, aparece el botón "Planificar Proyecto Multi-Noche". El referente aquí es el objetivo sugerido por la IA. Añade las sesiones necesarias y descarga un archivo N.I.N.A. separado para cada una.

5. Constructor PRO — Tú Eres el Comandante

El módulo PRO invierte la lógica: no pide al sistema qué hacer, sino que ejecuta exactamente lo que tú decides. Es la herramienta para quienes ya tienen un plan preciso y quieren traducirlo en una secuencia N.I.N.A. profesional sin compromisos.

• Constructor de Secuencias: La cuadrícula muestra todos los filtros (Light para OSC, o L/R/G/B/Ha/OIII/SII para Mono). Para cada filtro configuras: número de tomas, tiempo de exposición, Gain, Offset, Binning y frecuencia de Dithering (con checkbox independiente por filtro). La barra de relleno compara tu TPT con la ventana nocturna: 🟢 verde si todo cabe, 🟡 naranja si el margen es ajustado, 🔴 rojo si hay desbordamiento.
• Disparadores Pre-Vuelo: Antes del imaging configuras: Enfriar Cámara, Slew & Center con Plate Solving, Rotador Automático, Iniciar Autoguiado y Meridian Flip automático.
• Autofocus Avanzado: Tres modos independientes: al inicio de la secuencia, al cambiar de filtro y al incremento del HFR (N.I.N.A. mide el deterioro del enfoque en tiempo real e interviene solo cuando es necesario, evitando enfocados innecesarios). Cada disparador activo contribuye al presupuesto de autofocus: el sistema estima automáticamente el número de procedimientos AF en la ventana nocturna según los disparadores seleccionados, el tipo de OTA y la curva de temperatura prevista por Open-Meteo. El tiempo total estimado se resta del presupuesto disponible, igual que el dithering. Puedes aceptar la estimación con un clic o introducir el número manualmente.
• Disparadores Post-Vuelo: Calentar Cámara, Aparcar Montura, Cerrar Tapa motorizada, Encender Panel Flat — todo automático al terminar la secuencia.

6. Planificación Multi-Noche

Cuando un proyecto requiere más horas de las que ofrece una sola noche, la Planificación Multi-Noche te permite distribuir el trabajo en varias sesiones manteniendo siempre el control del progreso global.

• TPT — Tiempo Total Planificado: El objetivo fijo de tu proyecto. En modo Smart corresponde a las horas recomendadas por la IA; en modo PRO se calcula desde tu cuadrícula de tomas. La barra de progreso se vuelve verde solo cuando la suma de las sesiones planificadas alcanza el TPT.
• Gestión de Sesiones: Para cada noche añades una tarjeta con: horario de inicio y fin, tomas por filtro en esa sesión, y verificación automática de si las tomas caben en la ventana — con aviso de desbordamiento si es necesario.
• Exportación por Noche: Cada sesión genera su propio archivo N.I.N.A. independiente con todos los disparadores configurados y coordenadas FOV actualizadas.

7. Exportación y Automatización

• Export N.I.N.A. Smart: Genera un JSON para N.I.N.A. Advanced Sequencer con la secuencia calculada. Estructura completa: UnparkScope al inicio, enfriamiento cámara, Slew & Center, Autofocus inicial, autoguiado, WaitForTime (espera la hora de inicio), imaging con TimeCondition (parada a la hora de fin), Meridian Flip automático, dithering configurado. Post-sesión: WarmUp y Park automáticos. Arrastra el archivo a N.I.N.A. y la noche se conduce sola.
• Export N.I.N.A. PRO (Advanced Sequence): El JSON PRO es una secuencia N.I.N.A. nativa de nivel avanzado. Estructura completa: UnparkScope → CoolCamera → Center → RunAutofocus → SolveAndRotate → StartGuiding → WaitForTime → imaging con TimeCondition → WarmCamera → ParkScope. Cada filtro tiene su estructura con LoopCondition nativo, disparadores de dithering por filtro, gain/offset/binning individuales y FilterInfo completo con FlatWizardSettings para compatibilidad total con la rueda de filtros de N.I.N.A.
• Export ASIAIR: Genera un archivo CSV con coordenadas de precisión y muestra el plan de tomas visual optimizado para la interfaz tablet de ASIAIR. Incluye el ángulo de rotación de cámara sugerido.
• Coordenadas FOV Personalizadas: Si desplazaste el mapa durante la simulación FOV, las coordenadas actualizadas se usan en todas las exportaciones. El badge "⚠ Offset activo" te avisa cuando las coordenadas de exportación difieren del centro nominal del objetivo.

8. Horizonte personalizado

El módulo de horizonte personalizado genera un perfil de obstrucción azimutal preciso desde tu emplazamiento de observación, capturando muros, tejados, colinas y árboles que limitan la visibilidad real del cielo. El perfil se integra en el gráfico de altitud del simulador FOV y puede exportarse directamente en los formatos nativos de N.I.N.A. y Stellarium.

• Formato de foto recomendado: Usa una foto esférica 360°×180° (formato equirectangular) tomada desde la posición exacta del telescopio. Google Photo Sphere (Pixel), GoPro Max o cualquier cámara 360° produce el formato correcto. Alternativamente une una serie de fotos con Hugin o PTGui. Para Stellarium, elimina el cielo de la foto (Photoshop, GIMP o remove.bg) y guarda en PNG — la transparencia permite ver las estrellas a través de él.
• Algoritmo de detección (Sobel): El algoritmo Sobel detecta automáticamente el borde de máximo contraste entre cielo y suelo en cada columna de la imagen. Funciona incluso con fotos con cielo eliminado (negro o transparente). Algoritmos alternativos: Gradiente, Umbral y Primera zona oscura. Pasa el ratón sobre las etiquetas de parámetros para leer la explicación de cada uno.
• Calibración de parámetros: Los tres parámetros principales son: Altitud centro — baja hasta que la línea punteada (0°) coincida con el horizonte real lejano; Az. inicio Norte — ajusta hasta que los marcadores cardinales en la vista previa coincidan con referencias conocidas de la brújula; FOV vertical — establecido automáticamente en 180° para fotos esféricas 2:1.
• Corrección manual: Tras la detección automática, haz clic directamente en la vista previa para corregir la línea en cualquier punto. El pincel tiene un radio de mezcla de ±30px que interpola suavemente la corrección con los valores adyacentes.
• Integración en el gráfico FOV: Una vez aplicado con el botón Aplicar al FOV, el perfil aparece en el gráfico de altitud como zona roja — exactamente como N.I.N.A. El umbral varía con el tiempo siguiendo el azimut del DSO.
• Exportación para N.I.N.A. (.hrz): El archivo sigue la convención astronómica estándar: Azimut 0°=Norte, creciente hacia el Este. Es fundamental introducir también las coordenadas GPS en la configuración del Observatorio de N.I.N.A., de lo contrario los cálculos de visibilidad serán imprecisos.
• Exportación para Stellarium (.zip): El zip incluye la foto panorámica en PNG (con canal alfa), el archivo landscape.ini de tipo spherical con las coordenadas del sitio y la rotación correcta para la alineación Norte, y el archivo horizon.txt. Extrae el zip en la carpeta landscapes/ de Stellarium.
• Persistencia y copia de seguridad: El perfil se guarda automáticamente en localStorage. El botón Backup (.json) descarga un archivo de restauración completo: si se borra la caché, usa ↩ Restaurar sobre el gráfico para recuperar el perfil en un clic.

0. 基础模式与高级模式

AstroDashboard PRO 提供两种使用级别，可随时通过右上角菜单中的按钮切换。

• 基础模式 — 专为初学者或追求简洁的用户设计：输入目标天体，应用将根据您的设备配置和可用夜间时间窗口自动计算最佳曝光帧数。气象信息经过简化，高级滤镜已隐藏，暗场和偏置场为可选项。N.I.N.A. 序列一键生成，无需复杂设置。
• 高级模式 — 适合有经验的用户：全面控制窄带和宽带滤镜、具有三种独立触发器的自动对焦、可配置的抖动、HDR、子午线翻转和多夜规划。每个参数都由您掌控。

您可以随时在两种模式之间切换，而不会丢失已输入的数据。首次访问时，应用将引导您进行选择。

1. 战术气象与环境数据

在指向望远镜之前，您需要了解头顶上方的情况。本部分直接在您的浏览器中实时汇聚专业的卫星数据。

• 50公里半径地图：专为移动天文摄影师设计。象征性的50公里圆圈让您一眼就能评估应移动到哪里寻找"晴空洞"。激活叠加图层（低云、中云、高云、急流、湿度、月光），滑动时间轴预测未来数小时的天气变化。
• 急流 (Jet Stream)：视宁度的真正敌人。您所在位置上方低于50 km/h保证天空稳定、星点清晰。超过100 km/h，大气湍流将摧毁精细细节 — 避免使用长焦段。
• 湿度警报：若读数超过85%（红色指示），请在温度降到露点之前将除露带调到最大功率。一旦光学元件起雾，拍摄会话就毁了。
• 月光污染：根据当前月相和位置显示被月光"烧毁"的天空百分比。当月亮在地平线以下时，惩罚值自动归零。数值高时不建议宽带拍摄 — 考虑使用能截断月光连续谱的窄带滤镜（Ha、OIII、SII）。
• 光污染图层（Lorenz 2024 地图集）：启用光污染图层，将博特尔色彩比例尺叠加到地图上（David Lorenz的VIIRS 2024数据）：深蓝色 = 原始天空（博特尔1–2）、绿色 = 农村（3–4）、黄色 = 郊区（5）、橙色 = 城市边缘（6–7）、白色 = 市中心（8–9）。激活图层时，颜色图例自动显示在按钮下方。使用此图层直观识别您的真实博特尔等级并在选择器中设置 — 直接影响滤镜建议。
• 博特尔选择器：设置您观测地点的光污染等级（1 = 完全黑暗天空，9 = 市中心）。滤镜助手使用此值来校准滤镜建议：暗天空（1–3）不需要LP滤镜；郊区天空（4–7）受益于宽带滤镜（CLS、L-Pro、四频带）；城市天空（8–9）使窄带（Ha/OIII双频带）不可或缺。点击ℹ️获取使用地图图层查找您的博特尔等级的说明。

2. 混合星图与 SIMBAD 引擎

星图不只是显示星星：它实时计算每个天体在地平线上的高度，只向您展示今晚摄影上有用的目标。

• 本地数据库（推荐目标）：包含最著名的目标及完整元数据：类型、星等、距离和专属"拍摄建议"。建议并非泛泛而谈 — 它们推荐滤镜、警告核心过曝、指示最佳拍摄季节。
• 时间滑块：拖动时间条模拟夜间任意时刻的天空。当天体降至20°高度以下（湍流和低透明度区域）时自动消失，确保您看到的都是可用目标。
• 通用 SIMBAD 搜索：如果您的目标不在本地数据库中，输入名称（如"Sh2-132"、"Abell 85"），引擎将实时查询斯特拉斯堡大学。您将获得J2000绝对坐标，可立即规划拍摄会话。
• 太阳系：行星和月球始终在单独列表中。适合规划行星拍摄会话或检查月光对深空目标的干扰。

3. 光学设置、采样率与视场模拟器

本部分将您仪器的物理数据转化为操作信息：您的传感器覆盖多少角秒？目标能否放入画面？应以什么角度定向相机？

• 采样率 (arcsec/pixel)：输入焦距（mm）和像素大小（µm）：系统计算您的图像比例并分为三个区间。绿色：理想采样（1–2 arcsec/px）。黄色：轻微欠采样（星点略显方形）。红色：过度过采样 — 您在浪费光子和分辨率。
• 真实视场模拟器 (DSS2)：从DSS2档案加载真实深空图像，并以正确比例和方向叠加您的传感器矩形。您看到的就是最终图像中将获得的内容。
• 视场旋转与位置角 (PA)：旋转滑块（0–360°）在地图上旋转传感器矩形。选定角度保存在序列中，并在导出时发送给 N.I.N.A. 的自动旋转器。如果您拖动地图将视场中心偏离原始目标，更新的坐标将实时显示在"视场中心"框中，并有偏移激活指示 — 您随时可以通过 ⌖ 重置按钮返回精确中心。
• 拼接模式：当目标大于您的视场时，启用拼接并设置网格（如2×2、3×2）和所需重叠百分比。系统自动计算每个面板的可用时间并生成策略报告。

3a. 配置文件管理

配置文件系统允许您即时保存和恢复完整配置：GPS位置、望远镜、传感器（包括自定义设备）、所有智能和专业参数、滤镜、触发器、语言以及自定义地平线。非常适合使用多台仪器或更换观测地点的用户。

• 位置：👤 按钮位于光学设置部分的标题栏中，紧靠 ℹ️ 图标。在桌面端显示文字"配置"（或当前配置文件名称）；在移动端显示图标，名称过长时自动截断显示。
• 保存配置文件：完整配置您的设置（位置、望远镜、传感器、拍摄参数）后，点击 👤 → 在"新建配置"字段输入名称（如"牛顿天台"）→ 点击保存。配置文件存储在浏览器中，名称将显示在按钮上。若名称已存在，系统将请求确认是否覆盖。
• 加载配置文件：点击 👤 → 从下拉菜单选择配置文件 → 点击 ✔ 使用。页面将自动重新加载，应用所选配置文件的全部设置，包括自定义设备和自定义地平线。
• 导出配置文件（备份）：从下拉菜单选择配置文件 → 点击 ⬇ 导出JSON。下载的文件包含完整配置：可作为备份保存或传输至其他设备。
• 从文件导入配置：点击导入JSON并选择之前导出的文件。配置文件将添加到列表中；若名称与已有配置相同，将自动覆盖。导入后从菜单选择并点击 ✔ 使用 即可应用。
• 移动端——长按操作：在触摸设备上，普通点击将打开配置管理弹窗。如需查看字段说明，请长按 👤 按钮约600毫秒：信息提示框将出现并在4秒后自动关闭。

4. 智能序列计算

在智能模式下，系统是您的专家助手。您分析目标、提供设备规格，让算法为该特定夜晚的条件生成平衡且优化的序列。

• 预测算法：计算并非通用平均值。它考虑您的光学焦比、传感器类型（彩色或黑白）、激活的滤镜、当前月光污染、目标表面亮度以及观测地点的博特尔指数。暗天空（博特尔1–4）减少所需时间；城市天空（博特尔6–9）增加估计时间。对于使用窄带滤镜的发射星云，惩罚有所减轻。从v6.3起：彩色传感器（OSC）支持双波段和四波段滤镜——计算使用物理swamping公式（读出噪声、量子效率、带宽、焦比、蓝移修正）估算最优最短曝光时间。当多重因素导致估算不合理时，系统会建议放弃并推荐替代方案。
• 生成最佳曝光序列：点击"生成最佳曝光序列"，系统在可用夜间窗口内分配帧数，平衡滤镜间的时间并为校准帧预留时间。黑白传感器独立计算 L、R、G、B 和窄带。
• 智能抖动：启用抖动并指定频率（每N帧）。系统自动从总可用时间中扣除抖动开销 — 您看到的"采集时间"已是扣除所有开销后的真实净积分时间。
• N.I.N.A. 滤镜名称映射：对于黑白传感器，每个滤镜都有一个字段用于输入 N.I.N.A. 从滤镜轮识别的确切名称（如"Hα 3nm"而非"Ha"）。名称不完全匹配时，N.I.N.A. 将报错。
• 智能多夜规划：如果计算的积分超过可用夜间窗口，"计划多夜拍摄"按钮出现。参考目标是智能助手计算的目标。添加所需会话并为每个会话下载单独的 N.I.N.A. 文件。

5. PRO 构建器 — 您是指挥官

PRO 模块颠覆逻辑：它不询问系统该做什么，而是精确执行您的决定。这是已有明确计划并希望将其转化为专业 N.I.N.A. 序列的用户的工具。

• 序列构建器：网格显示您设备的所有滤镜（彩色相机显示 Light，黑白显示 L/R/G/B/Ha/OIII/SII）。每个滤镜可设置：帧数、曝光时间、Gain、Offset、Binning 和抖动频率（每个滤镜有独立复选框）。填充进度条将您的 TPT 与夜间窗口比较：🟢 绿色表示一夜可完成，🟡 橙色表示时间紧张，🔴 红色表示超出。
• 拍摄前触发器：拍摄前配置：相机降温（设置目标温度）、指向并居中（星板解析）、自动旋转器（旋转至视场模拟器中设定的角度）、开始自动导星和自动中天翻转。
• 高级自动对焦：三种独立模式：序列开始时、切换滤镜时（适合焦点偏移不同的滤镜）和HFR增大时（最智能的方法：N.I.N.A.实时测量对焦恶化情况，仅在必要时触发，避免不必要的对焦操作）。
• 拍摄后触发器：相机回温、赤道仪归位、关闭电动镜头盖、开启平场灯 — 序列结束时全部自动执行。

6. 多夜拍摄规划

当项目所需时间超过单夜可用时间时，多夜拍摄规划让您将工作分配到多个会话，同时始终掌控整体进度。

• TPT — 总计划时间：您项目的固定目标。智能模式下对应智能助手计算的小时数；PRO 模式下从您的帧数网格计算。进度条只有当所有计划夜晚的总和达到或超过 TPT 时才变绿。
• 会话管理：每个夜晚添加一张卡片，包含：开始和结束时间（该特定夜晚的有效窗口）、该会话每个滤镜的帧数，以及帧数是否能在窗口内完成的自动检查。
• 按夜导出：每个会话生成其独立的 N.I.N.A. 文件，包含所有已配置的触发器和更新的视场坐标。第1夜可能只包含 L 和 R，第2夜只包含 G、B 和 Ha — 由您决定策略。

7. 导出与自动化

• N.I.N.A. 智能导出：为 N.I.N.A. 高级序列器生成完整 JSON 文件。结构包括：序列开始时取消停靠、相机降温、指向并居中、初始自动对焦、自动导星、WaitForTime（等待会话开始时间）、含TimeCondition（会话结束时间停止）的拍摄过程、自动中天翻转、已配置抖动。会话后：自动回温和归位。将文件拖入 N.I.N.A.，整夜自动运行。
• N.I.N.A. PRO 导出（高级序列）：PRO 生成的 JSON 是原生 N.I.N.A. 高级序列。完整结构：取消停靠→降温→指向→自动对焦→旋转→导星→WaitForTime→含TimeCondition的拍摄→回温→归位。每个滤镜有自己带原生 LoopCondition 的结构、独立的抖动触发器、各自的 gain/offset/binning，以及含 FlatWizardSettings 的完整 FilterInfo，确保与 N.I.N.A. 滤镜轮完全兼容。
• ASIAIR 导出：生成含精确坐标的 CSV 文件，并显示为 ASIAIR/ASIAIR+/ASIAIR Pro 平板界面优化的可视拍摄计划，包括建议的相机旋转角度。
• 自定义视场坐标：如果在视场模拟过程中移动了地图，更新的中心坐标将用于所有导出（N.I.N.A. 智能、PRO 和多夜）。当导出坐标与目标名义中心不同时，"⚠ 偏移激活"徽章会提醒您。

8. 自定义地平线

自定义地平线模块从您的观测站生成精确的方位角遮挡轮廓，捕捉限制真实天空可见性的墙壁、屋顶、山丘和树木。该轮廓集成到FOV模拟器的高度图中，可直接以N.I.N.A.和Stellarium的原生格式导出。

• 推荐照片格式：使用在望远镜精确位置拍摄的360°×180°球形照片（等距矩形格式）。Google Photo Sphere（Pixel）、GoPro Max或任何360°相机均可生成正确格式。对于Stellarium，请从照片中移除天空并保存为PNG——透明度让Stellarium能透过它显示星星。
• 检测算法（Sobel）：Sobel算法自动检测图像每列中天空与地面之间的最大对比度边缘。即使在天空已移除的照片上也能正常工作。将鼠标悬停在参数标签上可阅读每个参数的说明。
• 参数校准：需调整的三个主要参数：中心高度角——向下调整直到虚线（0°）与远处真实地平线对齐；北向起始方位角——调整直到预览中的方位标记与罗盘已知参考物对齐；垂直视场角——对于2:1球形照片自动设置为180°。
• 手动修正：自动检测后，直接点击预览图上的任意位置修正线条。笔刷具有±30像素的混合半径，可与相邻值平滑插值。
• FOV图表集成：通过应用到FOV按钮应用后，轮廓以红色区域显示在高度图中——与N.I.N.A.完全一致。阈值随时间随DSO方位角变化。
• N.I.N.A.导出（.hrz）：文件遵循标准天文惯例：方位角0°=北，向东增加。还必须在N.I.N.A.的天文台设置中输入GPS坐标，否则可见性计算将不准确。
• Stellarium导出（.zip）：压缩包包含PNG格式全景照片（带透明通道）、spherical类型的landscape.ini（含站点坐标和北向旋转）以及horizon.txt文件。将压缩包解压到Stellarium的landscapes/文件夹中。
• 持久化与备份：轮廓自动保存到localStorage。使用备份（.json）下载恢复文件：若缓存被清除，点击↩ 恢复即可一键恢复并自动应用到FOV。