Manual

User Manual / Manual do Usuário

🇬🇧 This is the complete manual, organised around the real workflow an observer follows: observation → reduction → submission. It links out to Tutorial for feature-by-feature detail and Glossary for terminology. If you just want the fast path, see Quick-Start instead.

🇧🇷 Este é o manual completo, organizado em torno do fluxo de trabalho real que um observador segue: observação → redução → submissão. Ele aponta pro Tutorial para detalhe função a função e pro Glossary pra terminologia. Se você só quer o caminho rápido, veja o Quick-Start em vez disso.

---

Part 1 — Before you open AstroFind: planning your observation / Parte 1 — Antes de abrir o AstroFind: planejando sua observação

🇬🇧 English Good asteroid astrometry starts before you even take a picture:

1. Pick a field near the ecliptic (the plane where planets and most asteroids orbit — see Glossary) — this maximises your odds of catching something.
2. Take at least 2 images, ideally 3–4, of the exact same field, spaced 20–60 minutes apart. This gives an asteroid time to visibly shift between exposures. Keep exposure times consistent so brightness measurements are comparable.
3. Record accurate timestamps. AstroFind reads the DATE-OBS FITS header; if your acquisition software doesn't write UTC (Universal Time) directly, note the correct offset — see FAQ.
4. If you don't have your own telescope, download real FITS data from a public survey or your school's IASC dataset — see FAQ "I don't have a telescope".
5. Take calibration frames (bias, dark, flat) with the same equipment if your images aren't already pre-processed — see Tutorial item 6.

🇧🇷 Português Uma boa astrometria de asteroide começa antes mesmo de você tirar uma foto:

1. Escolha um campo perto da eclíptica (o plano onde os planetas e a maioria dos asteroides orbitam — veja Glossary) — isso maximiza suas chances de flagrar algo.
2. Tire pelo menos 2 imagens, idealmente 3-4, do mesmo campo exato, espaçadas de 20-60 minutos. Isso dá tempo pro asteroide se deslocar visivelmente entre as exposições. Mantenha tempos de exposição consistentes pra que as medições de brilho sejam comparáveis.
3. Registre timestamps precisos. O AstroFind lê o cabeçalho FITS DATE-OBS; se seu software de aquisição não grava UTC (Tempo Universal) diretamente, anote o offset correto — veja o FAQ.
4. Se você não tem telescópio próprio, baixe dados FITS reais de um levantamento público ou do conjunto de dados IASC da sua escola — veja o FAQ "Não tenho telescópio".
5. Tire frames de calibração (bias, dark, flat) com o mesmo equipamento, se suas imagens ainda não vierem pré-processadas — veja o Tutorial item 6.

---

Part 2 — Loading and preparing images / Parte 2 — Carregando e preparando imagens

🇬🇧 English Open AstroFind and load your files with File → Open FITS… (Ctrl+O) or drag-and-drop. Each image opens as a numbered sub-window. If it looks nearly black, adjust the display stretch in Images → Background and Range… — this is cosmetic only (see Tutorial items 1–2).

If your images need calibration, do it now: Processing → Calibration… (or the step-by-step Calibration Wizard) applies your bias/dark/flat master frames, removes background gradients via the sliding-median filter, and repairs bad/hot pixels automatically — see Tutorial items 6–7. If your data is already pre-processed (common for downloaded survey images), skip straight to Part 3.

🇧🇷 Português Abra o AstroFind e carregue seus arquivos com Arquivo → Abrir FITS… (Ctrl+O) ou arrastar-e-soltar. Cada imagem abre como uma subjanela numerada. Se parecer quase preta, ajuste o esticamento de exibição em Imagens → Fundo e Alcance… — isso é só cosmético (veja Tutorial itens 1-2).

Se suas imagens precisam de calibração, faça agora: Processamento → Calibração… (ou o Assistente de Calibração passo a passo) aplica seus frames mestres de bias/dark/flat, remove gradientes de fundo via filtro de mediana deslizante, e conserta pixels ruins/quentes automaticamente — veja Tutorial itens 6-7. Se seus dados já vêm pré-processados (comum em imagens de levantamento baixadas), pule direto pra Parte 3.

---

Part 3 — Data reduction: detection and plate solving / Parte 3 — Redução de dados: detecção e plate solving

🇬🇧 English Run Processing → Data Reduction (Ctrl+D). Behind the scenes, AstroFind:

1. Detects every star-like source with SEP (Source Extractor), skipping bad pixels and accounting for the estimated sky background.
2. Analyses each source's shape to flag streaks (fast-moving objects within a single exposure) and separate blended sources with ClumpFind.
3. Sends the star pattern to your chosen plate solver — astrometry.net (online) or ASTAP (offline) — to determine the exact WCS solution (where the image points, its scale, and orientation).
4. Optionally writes the WCS solution back into the FITS header, and overlays a reference star catalog (VizieR or a local FITS BINTABLE) for cross-checking.

See Tutorial items 8–10 for full detail on each of these. Wait for the green checkmark next to every image before moving on.

🇧🇷 Português Rode Processamento → Redução de Dados (Ctrl+D). Nos bastidores, o AstroFind:

1. Detecta toda fonte parecida com estrela com o SEP (Source Extractor), pulando pixels ruins e levando em conta o fundo de céu estimado.
2. Analisa a forma de cada fonte pra sinalizar traços (objetos de movimento rápido dentro de uma única exposição) e separar fontes blendadas com o ClumpFind.
3. Envia o padrão de estrelas ao plate solver escolhido — astrometry.net (online) ou ASTAP (offline) — pra determinar a solução WCS exata (pra onde a imagem aponta, sua escala e orientação).
4. Opcionalmente grava a solução WCS de volta no cabeçalho FITS, e sobrepõe um catálogo de estrelas de referência (VizieR ou um FITS BINTABLE local) pra conferência cruzada.

Veja o Tutorial itens 8-10 pro detalhe completo de cada um desses. Espere o sinal verde de confirmação ao lado de cada imagem antes de continuar.

---

Part 4 — Finding the moving object / Parte 4 — Encontrando o objeto em movimento

🇬🇧 English Two complementary approaches:

• Manual blink (B to toggle, Space to step) — you visually watch the frames cycle and spot the dot that shifts while stars stay put. Enable Laplacian/Unsharp-Mask sharpening in the Blink panel for faint candidates.
• Automated Moving Object Detection (Processing → Moving Object Detection…) — an algorithm links detections across 3+ frames into candidate tracklets automatically. Still visually confirm any candidate before measuring it.

Check the Known Object Overlay (Ctrl+K) at any point — it queries SkyBoT to mark already- catalogued asteroids in the field, so you know immediately if your candidate is already known. Full detail: Tutorial items 4 and 16–17.

🇧🇷 Português Duas abordagens complementares:

• Blink manual (B liga/desliga, Space avança) — você observa visualmente os quadros alternando e detecta o ponto que muda enquanto as estrelas ficam paradas. Ative o realce Laplaciano/Unsharp-Mask no painel Blink pra candidatos fracos.
• Detecção Automática de Objeto em Movimento (Processamento → Detecção de Objeto em Movimento…) — um algoritmo liga detecções em 3+ quadros em candidatos a tracklet automaticamente. Ainda assim, confirme visualmente qualquer candidato antes de medir.

Confira a Sobreposição de Objeto Conhecido (Ctrl+K) a qualquer momento — ela consulta o SkyBoT pra marcar asteroides já catalogados no campo, então você sabe na hora se seu candidato já é conhecido. Detalhe completo: Tutorial itens 4 e 16-17.

---

Part 5 — Measuring / Parte 5 — Medindo

🇬🇧 English Activate the Aperture tool (A) and click the object in every frame where it's visible. For each click, AstroFind:

1. Fits a precise stellar profile (elliptical Gaussian PSF, via Levenberg-Marquardt) to get a sub-pixel centroid (exact centre position).
2. Converts that pixel position to sky coordinates (RA/Dec) using the WCS solution, then applies the full ICRS → CIRS → Topocentric correction chain (refraction, aberration, precession, nutation) for sub-arcsecond accuracy.
3. Measures aperture photometry against the local sky background, then converts it to a calibrated magnitude via differential photometry against catalog stars, with airmass correction.
4. Opens the Verification dialog, showing your star-match residuals and any known object nearby — review it before the measurement is recorded. If you click wrong, Ctrl+Z undoes it.

Check your results any time in the Measurement Table. Full detail: Tutorial items 11–14.

🇧🇷 Português Ative a ferramenta Abertura (A) e clique no objeto em cada quadro onde ele é visível. A cada clique, o AstroFind:

1. Ajusta um perfil estelar preciso (PSF gaussiana elíptica, via Levenberg-Marquardt) pra obter um centroide de sub-pixel (posição central exata).
2. Converte essa posição de pixel em coordenadas de céu (AR/Dec) usando a solução WCS, depois aplica a cadeia completa de correção ICRS → CIRS → Topocêntrico (refração, aberração, precessão, nutação) pra precisão de sub-arcossegundo.
3. Mede fotometria de abertura contra o fundo de céu local, depois converte pra uma magnitude calibrada via fotometria diferencial contra estrelas de catálogo, com correção de massa de ar.
4. Abre o diálogo de Verificação, mostrando seus resíduos de correspondência com estrelas e qualquer objeto conhecido próximo — revise antes de a medição ser registrada. Se você clicar errado, Ctrl+Z desfaz.

Confira seus resultados a qualquer momento na Tabela de Medições. Detalhe completo: Tutorial itens 11-14.

---

Part 6 — Optional: stacking for faint objects / Parte 6 — Opcional: empilhamento para objetos fracos

🇬🇧 English If your candidate is too faint to measure reliably in a single frame, use Processing → Image Stacker… to combine several aligned exposures (increasing signal-to-noise roughly by √N). If you already suspect the object's rate of motion, Track & Stack aligns frames to the moving object instead of the stars, keeping the asteroid itself sharp. Full detail: Tutorial item 15.

🇧🇷 Português Se seu candidato é fraco demais pra medir com confiança num único quadro, use Processamento → Empilhador de Imagens… pra combinar várias exposições alinhadas (aumentando a razão sinal-ruído aproximadamente por √N). Se você já suspeita da taxa de movimento do objeto, o Track & Stack alinha os quadros ao objeto em movimento em vez das estrelas, mantendo o próprio asteroide nítido. Detalhe completo: Tutorial item 15.

---

Part 7 — Generating and submitting the report / Parte 7 — Gerando e submetendo o relatório

🇬🇧 English Before exporting, make sure Edit → Preferences → Observer is filled in: your observer/measurer names, telescope description, contact email, and — if you have one — your 3-character MPC observatory code (see Glossary, FAQ).

Then open File → Export ADES XML… (Ctrl+E). The Report Preview dialog renders your observations as readable HTML (and lets you check the XML/PSV directly), lets you pick the magnitude band (photometric filter) used, and shows the proper motion computed for your object. Every report is tagged <sys>ICRF</sys> — the coordinates went through the full ICRS→CIRS→Topocentric chain described in Part 5.

From there:

• Submit to MPC (HTTP) — sends the report directly.
• Submit to MPC (Email) — opens your email client, pre-addressed.
• School mode: if your teacher's email is configured (Edit → Preferences → Observer → Teacher's Email), a one-click "send to teacher" button appears instead.

Full detail: Tutorial item 18.

🇧🇷 Português Antes de exportar, confirme que Editar → Preferências → Observador está preenchido: seus nomes de observador/medidor, descrição do telescópio, e-mail de contato, e — se tiver — seu código de observatório MPC de 3 caracteres (veja Glossary, FAQ).

Depois abra Arquivo → Exportar ADES XML… (Ctrl+E). O diálogo de Pré-visualização de Relatório renderiza suas observações como HTML legível (e permite conferir o XML/PSV diretamente), permite escolher a banda de magnitude (filtro fotométrico) usada, e mostra o movimento próprio calculado pro seu objeto. Todo relatório é marcado com <sys>ICRF</sys> — as coordenadas passaram pela cadeia completa ICRS→CIRS→Topocêntrico descrita na Parte 5.

A partir daí:

• Submeter ao MPC (HTTP) — envia o relatório diretamente.
• Submeter ao MPC (E-mail) — abre seu cliente de e-mail, pré-endereçado.
• Modo escola: se o e-mail do professor estiver configurado (Editar → Preferências → Observador → E-mail do Professor), um botão "enviar pro professor" com um clique aparece em vez disso.

Detalhe completo: Tutorial item 18.

---

Part 8 — Managing your work: sessions and projects / Parte 8 — Gerenciando seu trabalho: sessões e projetos

🇬🇧 English Save your whole working state (loaded images, measurements, calibration frames) with File → Save Project… (.gus format) so you can close AstroFind and resume exactly where you left off. Use File → Compare Sessions… to compare photometry/astrometry results side by side across two saved sessions — useful for spotting systematic errors or double-checking a suspicious measurement. Full detail: Tutorial items 19–20.

🇧🇷 Português Salve todo o seu estado de trabalho (imagens carregadas, medições, frames de calibração) com Arquivo → Salvar Projeto… (formato .gus) pra poder fechar o AstroFind e retomar exatamente de onde parou. Use Arquivo → Comparar Sessões… pra comparar resultados de fotometria/ astrometria lado a lado entre duas sessões salvas — útil pra detectar erros sistemáticos ou conferir uma medição suspeita. Detalhe completo: Tutorial itens 19-20.

---

Part 9 — For classroom/school use / Parte 9 — Para uso em sala de aula/escola

🇬🇧 English AstroFind's guided Workflow panel ("school mode", docked on the left) shows every stage above as a checklist with a ▶ Do it button, so students can follow the process without memorising menu paths. Teachers can pre-configure observer details, API keys, and their own email address, then export a settings file (File → Export School Configuration) for students to import (File → Import School Configuration) — no need for each student to set anything up individually.

🇧🇷 Português O painel de Workflow guiado do AstroFind ("modo escola", ancorado à esquerda) mostra cada etapa acima como uma lista de verificação com um botão ▶ Fazer, pra alunos seguirem o processo sem decorar caminhos de menu. Professores podem pré-configurar dados de observador, chaves de API, e seu próprio e-mail, depois exportar um arquivo de configuração (Arquivo → Exportar Configuração da Escola) pra os alunos importarem (Arquivo → Importar Configuração da Escola) — sem cada aluno precisar configurar nada individualmente.

---

Advanced / Avançado

🇬🇧 Every algorithm referenced above — WCS projections, the ICRS→CIRS→Topocentric coordinate chain, refraction/aberration/precession/nutation formulas, elliptical PSF fitting, photometric zero-point and growth curves, FFT-based image registration, ClumpFind, and the ADES/MPC report schema — is documented with full mathematics in docs/technical-reference.md in the project repository. That document is aimed at contributors and advanced users; everyone else can safely treat these as "AstroFind handles it automatically".

🇧🇷 Todo algoritmo referenciado acima — projeções WCS, a cadeia de coordenadas ICRS→CIRS→Topocêntrico, fórmulas de refração/aberração/precessão/nutação, ajuste de PSF elíptica, zero-point fotométrico e curvas de crescimento, registro de imagem por FFT, ClumpFind, e o esquema de relatório ADES/MPC — está documentado com a matemática completa em docs/technical-reference.md no repositório do projeto. Esse documento é voltado a contribuidores e usuários avançados; todo mundo mais pode tratar isso com segurança como "o AstroFind cuida disso automaticamente".

---

See also / Veja também: Home · Quick-Start · Tutorial · Glossary · FAQ