Quick Start

Quick Start / Início Rápido

🇬🇧 From zero to your first asteroid measurement in 10 steps. No telescope required — you can practice with FITS images downloaded from the internet. See Glossary for any word you don't recognise.

🇧🇷 Do zero à sua primeira medição de asteroide em 10 passos. Não precisa de telescópio — dá pra praticar com imagens FITS baixadas da internet. Veja o Glossary pra qualquer palavra que você não reconheça.

---

Step 1 — Install AstroFind / Passo 1 — Instalar o AstroFind

🇬🇧 English AstroFind runs on Linux only (Ubuntu, Debian, Fedora, Arch, Rocky, openSUSE, and others are all supported). "Installing" means putting the program's files on your computer so you can run it. The easiest way is the universal installer script, which detects your Linux distribution automatically and downloads the right package for you:

curl -LO https://codeberg.org/petrinhu/astrofind/releases/download/v0.9.0-beta/install.sh
chmod +x install.sh
./install.sh

(chmod +x makes the downloaded file "executable" — allowed to run as a program.) If you prefer a specific package format (.rpm, .deb, or Arch's PKGBUILD) or want to compile from source code yourself, see the project's INSTALL.md file for exact per-distribution commands.

🇧🇷 Português O AstroFind roda apenas em Linux (Ubuntu, Debian, Fedora, Arch, Rocky, openSUSE, entre outras, são todas suportadas). "Instalar" significa colocar os arquivos do programa no seu computador pra você poder executá-lo. O jeito mais fácil é o script instalador universal, que detecta sua distribuição Linux automaticamente e baixa o pacote certo pra você:

curl -LO https://codeberg.org/petrinhu/astrofind/releases/download/v0.9.0-beta/install.sh
chmod +x install.sh
./install.sh

(chmod +x torna o arquivo baixado "executável" — permitido rodar como programa.) Se preferir um formato de pacote específico (.rpm, .deb, ou o PKGBUILD do Arch) ou quiser compilar do código-fonte você mesmo, veja o arquivo INSTALL.md do projeto para os comandos exatos por distribuição.

---

Step 2 — Launch AstroFind and the first-run wizard / Passo 2 — Abrir o AstroFind e o assistente de primeira execução

🇬🇧 English Open AstroFind from your applications menu (search for "AstroFind"), or run AstroFind from a terminal. The first time it opens, a Setup Wizard appears asking for:

• Your observer site (approximate latitude/longitude, or a nearby city) — needed later to correct for atmospheric effects and to compute your telescope's horizon.
• Your pixel scale (how many arcseconds of sky one camera pixel covers) — optional at this stage, you can leave defaults and fix it later in Settings.
• An astrometry.net API key (optional, free to obtain at nova.astrometry.net) — needed later for automatic "plate solving" (see Step 7). You can skip this now and add it later.

You can change any of this afterwards in Edit → Preferences… (Ctrl+,).

🇧🇷 Português Abra o AstroFind pelo menu de aplicativos (procure por "AstroFind"), ou rode AstroFind no terminal. Na primeira vez, um Assistente de Configuração aparece pedindo:

• Seu local de observação (latitude/longitude aproximada, ou uma cidade próxima) — necessário depois pra corrigir efeitos atmosféricos e calcular o horizonte do seu telescópio.
• Sua escala de pixel (quantos arcossegundos de céu cada pixel da câmera cobre) — opcional nessa etapa, dá pra deixar o padrão e ajustar depois em Configurações.
• Uma chave de API do astrometry.net (opcional, gratuita em nova.astrometry.net) — necessária depois pra "resolver a chapa" automaticamente (veja Passo 7). Pode pular agora e adicionar depois.

Qualquer uma dessas configurações pode ser alterada depois em Editar → Preferências… (Ctrl+,).

---

Step 3 — Get sample FITS images / Passo 3 — Conseguir imagens FITS de exemplo

🇬🇧 English A FITS file (Flexible Image Transport System) is the standard file format astronomers use to store a telescope picture — it's like a .jpg, but it keeps the exact numeric brightness of every pixel (instead of compressing it away) plus a text header describing where and when the photo was taken. You need at least 2 FITS images of the same patch of sky, ideally 3 or more, taken 20–60 minutes apart (an asteroid needs time to visibly move between shots).

If you don't have a telescope, you can download real, free FITS images from public sky surveys — for example SDSS, PanSTARRS, or an IASC search campaign dataset (ask your teacher if this is a class project). Look for files ending in .fits, .fit, or .fts.

🇧🇷 Português Um arquivo FITS (Flexible Image Transport System) é o formato de arquivo padrão que astrônomos usam pra guardar uma foto de telescópio — é parecido com um .jpg, mas guarda o brilho numérico exato de cada pixel (em vez de comprimir e perder informação) além de um cabeçalho de texto descrevendo onde e quando a foto foi tirada. Você precisa de pelo menos 2 imagens FITS do mesmo pedaço de céu, idealmente 3 ou mais, tiradas com 20–60 minutos de intervalo (um asteroide precisa de tempo pra se mover visivelmente entre as fotos).

Se você não tem telescópio, dá pra baixar imagens FITS reais e gratuitas de levantamentos públicos do céu — por exemplo SDSS, PanSTARRS, ou um conjunto de dados de campanha IASC (pergunte ao seu professor se for um projeto escolar). Procure arquivos terminados em .fits, .fit, ou .fts.

---

Step 4 — Open your images / Passo 4 — Abrir suas imagens

🇬🇧 English Drag and drop your FITS files onto the AstroFind window, or use File → Open FITS… (Ctrl+O). Each image opens in its own numbered sub-window. If the pictures look almost completely black, don't worry — see Step 5.

🇧🇷 Português Arraste e solte seus arquivos FITS na janela do AstroFind, ou use Arquivo → Abrir FITS… (Ctrl+O). Cada imagem abre em sua própria subjanela numerada. Se as fotos parecerem quase totalmente pretas, não se preocupe — veja o Passo 5.

---

Step 5 — Adjust the display / Passo 5 — Ajustar a exibição

🇬🇧 English Telescope images store far more brightness detail than a normal screen can show at once, so AstroFind needs to "stretch" the pixel values into a viewable range. Open Images → Background and Range… and try a different transfer function (Linear, Square-root, Log, Asinh, or Histogram Equalization) until stars become clearly visible. This step is purely cosmetic — it never changes the underlying data used for measurement.

🇧🇷 Português Imagens de telescópio guardam muito mais detalhe de brilho do que uma tela normal consegue mostrar de uma vez, então o AstroFind precisa "esticar" os valores de pixel pra uma faixa visível. Abra Imagens → Fundo e Alcance… e teste uma função de transferência diferente (Linear, Raiz Quadrada, Log, Asinh, ou Equalização de Histograma) até as estrelas ficarem bem visíveis. Esse passo é puramente cosmético — nunca altera os dados usados na medição.

---

Step 6 — Calibrate (optional) / Passo 6 — Calibrar (opcional)

🇬🇧 English If your images already come pre-processed (common with downloaded survey data or a pre-processing pipeline), skip this step. Otherwise, open Processing → Calibration… and supply a master dark frame (removes thermal noise) and/or master flat field (corrects uneven pixel sensitivity). The Calibration Wizard walks you through this step by step.

🇧🇷 Português Se suas imagens já vêm pré-processadas (comum em dados de levantamento baixados ou num pipeline de pré-processamento), pule este passo. Caso contrário, abra Processamento → Calibração… e forneça um dark frame mestre (remove ruído térmico) e/ou um flat field mestre (corrige sensibilidade desigual de pixel). O Assistente de Calibração conduz você passo a passo.

---

Step 7 — Detect stars and solve for WCS / Passo 7 — Detectar estrelas e resolver o WCS

🇬🇧 English Click Processing → Data Reduction (Ctrl+D). AstroFind automatically detects every star in each image, then sends the star pattern to a plate solver — either the online astrometry.net service or the offline ASTAP program — which figures out precisely where in the sky the image is pointing. The result is a WCS (World Coordinate System) solution written into each image, which lets AstroFind translate any pixel position into a real sky coordinate (Right Ascension / Declination). Wait for a green checkmark next to each image — this can take 1–5 minutes per image the first time.

🇧🇷 Português Clique em Processamento → Redução de Dados (Ctrl+D). O AstroFind detecta automaticamente todas as estrelas em cada imagem, depois envia o padrão de estrelas a um plate solver ("resolvedor de chapa") — o serviço online astrometry.net ou o programa offline ASTAP — que descobre com precisão pra onde no céu a imagem está apontando. O resultado é uma solução WCS (World Coordinate System) gravada em cada imagem, que permite ao AstroFind traduzir qualquer posição de pixel numa coordenada real de céu (Ascensão Reta / Declinação). Espere o sinal verde de confirmação ao lado de cada imagem — pode levar de 1 a 5 minutos por imagem na primeira vez.

---

Step 8 — Blink to find the moving object / Passo 8 — Fazer blink para achar o objeto em movimento

🇬🇧 English Press B to start blink mode: AstroFind flashes through your images rapidly, in the same spot on screen. Every star stays in exactly the same place — except one faint dot, which jumps back and forth. That jumping dot is your asteroid candidate. Press Space to step through frames one at a time if the automatic blink is too fast.

🇧🇷 Português Pressione B pra iniciar o modo blink: o AstroFind alterna rapidamente entre suas imagens, no mesmo ponto da tela. Toda estrela fica exatamente no mesmo lugar — exceto um pontinho fraco, que pula de um lado pro outro. Esse pontinho que pula é seu candidato a asteroide. Pressione Space pra avançar quadro a quadro se o blink automático estiver rápido demais.

---

Step 9 — Measure and verify / Passo 9 — Medir e verificar

🇬🇧 English Switch to the Aperture tool (A) and click directly on the moving object in each image where you can see it. AstroFind fits a precise stellar profile (PSF) to get a sub-pixel centroid position, converts it to sky coordinates using the WCS solution, and measures its brightness (magnitude). A Verification dialog appears each time, cross-checking your click against known catalogued asteroids — useful to confirm you didn't accidentally measure a known object or a background star.

🇧🇷 Português Mude pra ferramenta Abertura (A) e clique diretamente no objeto em movimento em cada imagem onde ele aparece. O AstroFind ajusta um perfil estelar preciso (PSF) pra obter uma posição de centroide com precisão de sub-pixel, converte pra coordenadas de céu usando a solução WCS, e mede seu brilho (magnitude). Um diálogo de Verificação aparece a cada clique, conferindo se o que você clicou bate com asteroides já catalogados — útil pra confirmar que você não mediu por acidente um objeto já conhecido ou uma estrela de fundo.

---

Step 10 — Export and submit your ADES report / Passo 10 — Exportar e enviar seu relatório ADES

🇬🇧 English Before exporting, fill in your observer details once in Edit → Preferences → Observer (your name, telescope description, and — if you have one — your 3-character MPC observatory code). Then open File → Export ADES XML… (Ctrl+E). ADES (Astrometry Data Exchange Standard) is the XML report format the MPC requires for all new submissions. Preview it in the Report dialog, then either submit it directly to the MPC (HTTP), send it by email, or — if this is a school project — send it to your teacher instead.

🎉 Congratulations — you've gone from a folder of raw pictures to a submittable scientific report. For every feature in more depth, continue to Tutorial. For the full observation workflow used by regular observers, see Manual.

Advanced: the exact WCS/ADES/refraction/aberration mathematics used internally is described in docs/technical-reference.md.

🇧🇷 Português Antes de exportar, preencha uma vez seus dados de observador em Editar → Preferências → Observador (seu nome, descrição do telescópio, e — se tiver — seu código de observatório MPC de 3 caracteres). Depois abra Arquivo → Exportar ADES XML… (Ctrl+E). ADES (Astrometry Data Exchange Standard) é o formato de relatório XML que o MPC exige pra todas as novas submissões. Pré-visualize no diálogo de Relatório, depois envie diretamente ao MPC (HTTP), mande por e-mail, ou — se for um projeto escolar — envie pro seu professor.

🎉 Parabéns — você saiu de uma pasta de fotos cruas até um relatório científico pronto pra envio. Pra aprofundar em cada função, continue no Tutorial. Pro fluxo de trabalho completo usado por observadores regulares, veja o Manual.

Avançado: a matemática exata de WCS/ADES/refração/aberração usada internamente está descrita em docs/technical-reference.md.