FAQ

FAQ — Frequently Asked Questions / Perguntas Frequentes

🇬🇧 Common beginner questions, answered plainly. If your question isn't here, check the Glossary for terms, or the Manual for the full workflow.

🇧🇷 Perguntas comuns de iniciante, respondidas de forma simples. Se sua pergunta não estiver aqui, confira o Glossary pra termos, ou o Manual pro fluxo completo.

---

What kind of file do I open? / Que tipo de arquivo eu abro?

🇬🇧 A FITS file (.fits, .fit, or .fts) — the standard astronomical image format (see Glossary). AstroFind also reads SER video, XISF, 16-bit TIFF/PNG, BMP, JPEG, RAW camera formats, and PDS/PDS4 planetary files, plus ZIP/TAR/7Z/RAR archives (auto-extracted). If your file has none of these extensions, it's probably not a telescope image AstroFind can process.

🇧🇷 Um arquivo FITS (.fits, .fit, ou .fts) — o formato de imagem astronômica padrão (veja Glossary). O AstroFind também lê vídeo SER, XISF, TIFF/PNG 16-bit, BMP, JPEG, formatos RAW de câmera, e arquivos planetários PDS/PDS4, além de arquivos ZIP/TAR/7Z/RAR (extraídos automaticamente). Se seu arquivo não tem nenhuma dessas extensões, provavelmente não é uma imagem de telescópio que o AstroFind consegue processar.

---

I don't have a telescope — where do I get data? / Não tenho telescópio — onde consigo dados?

🇬🇧 You don't need one to practice. Many observatories and public sky surveys publish real FITS images for free: SDSS, PanSTARRS, CFHT, and rental services like iTelescope.Net. If you're doing a school project, ask about the IASC (International Astronomical Search Collaboration) program, which distributes real asteroid-search datasets to classrooms.

🇧🇷 Você não precisa de um pra praticar. Muitos observatórios e levantamentos públicos do céu publicam imagens FITS reais e gratuitas: SDSS, PanSTARRS, CFHT, e serviços de aluguel como iTelescope.Net. Se você está fazendo um projeto escolar, pergunte sobre o programa IASC (International Astronomical Search Collaboration), que distribui conjuntos de dados reais de busca de asteroides pra turmas.

---

What is an MPC observatory/station code, and do I need one? / O que é um código de observatório/estação do MPC, e preciso de um?

🇬🇧 It's a unique 3-character identifier (e.g. T05, W96) the Minor Planet Center assigns to a specific observing location, required to formally submit observations. Applying is free — see minorplanetcenter.net. If you're practicing or doing a school exercise without a code yet, you can use 500 (meaning "geocentric") as a placeholder — your report will generate, just note it is not eligible for a formal submission until you have a real code.

🇧🇷 É um identificador único de 3 caracteres (ex. T05, W96) que o Minor Planet Center atribui a um local de observação específico, necessário pra submeter observações formalmente. Solicitar é gratuito — veja minorplanetcenter.net. Se você está praticando ou fazendo um exercício escolar sem código ainda, pode usar 500 (significando "geocêntrico") como placeholder — seu relatório será gerado, só lembre que não é elegível pra submissão formal até você ter um código real.

---

How do I report an asteroid observation to the MPC? / Como eu reporto uma observação de asteroide ao MPC?

🇬🇧 After measuring your object with the Aperture tool (see Tutorial item 12), fill in your observer details in Edit → Preferences → Observer, then go to File → Export ADES XML… (Ctrl+E). In the preview dialog you can submit directly to the MPC over HTTP, or send it by email. A valid MPC station code is required for a formal submission.

🇧🇷 Depois de medir seu objeto com a ferramenta Abertura (veja Tutorial item 12), preencha seus dados de observador em Editar → Preferências → Observador, depois vá em Arquivo → Exportar ADES XML… (Ctrl+E). No diálogo de pré-visualização você pode submeter diretamente ao MPC por HTTP, ou enviar por e-mail. Um código de estação MPC válido é necessário pra uma submissão formal.

---

My images look almost completely black — is something wrong? / Minhas imagens parecem quase totalmente pretas — tem algo errado?

🇬🇧 No — this is completely normal. Telescope images store far more brightness range than a screen can show by default. Open Images → Background and Range… and try a different display stretch (Square-root, Asinh, or Histogram Equalization usually help). This only changes what you see, never the underlying measurement data.

🇧🇷 Não — isso é totalmente normal. Imagens de telescópio guardam uma faixa de brilho muito maior do que uma tela consegue mostrar por padrão. Abra Imagens → Fundo e Alcance… e teste um esticamento de exibição diferente (Raiz Quadrada, Asinh, ou Equalização de Histograma geralmente ajudam). Isso só muda o que você vê, nunca os dados de medição subjacentes.

---

My images don't have a plate solution — what do I do? / Minhas imagens não têm solução de plate — o que eu faço?

🇬🇧 Go to Edit → Preferences → Connections and make sure your astrometry.net API key is set. Then select your images, open Processing → Data Reduction and let it run. AstroFind submits each image and downloads the WCS solution automatically. No internet? Install ASTAP, set its path in Connections → ASTAP, and switch the backend selector to "ASTAP (local, offline)".

🇧🇷 Vá em Editar → Preferências → Conexões e confirme que sua chave de API do astrometry.net está configurada. Depois selecione suas imagens, abra Processamento → Redução de Dados e deixe rodar. O AstroFind envia cada imagem e baixa a solução WCS automaticamente. Sem internet? Instale o ASTAP, configure o caminho dele em Conexões → ASTAP, e mude o seletor de backend pra "ASTAP (local, offline)".

---

The plate solver keeps timing out or failing — help? / O plate solver fica dando timeout ou falhando — socorro?

🇬🇧 Two common causes: (1) the API key is wrong, expired, or missing — check it at nova.astrometry.net → Account; (2) the image has too few detected stars — the solver typically needs 10–15+. Try lowering the detection threshold in Settings → Detection, or use a longer/better exposure. You can also increase the solver timeout in Settings → Connections → Timeout (default 300 s).

🇧🇷 Duas causas comuns: (1) a chave de API está errada, expirada, ou ausente — confira em nova.astrometry.net → Account; (2) a imagem tem poucas estrelas detectadas — o solver geralmente precisa de 10-15+. Tente diminuir o limiar de detecção em Configurações → Detecção, ou use uma exposição mais longa/melhor. Você também pode aumentar o timeout do solver em Configurações → Conexões → Timeout (padrão 300 s).

---

I don't have internet — can I still use AstroFind? / Não tenho internet — ainda dá pra usar o AstroFind?

🇬🇧 Yes, with a couple of limitations. Images that already have a WCS solution in their header (from a dedicated plate solver or observatory software) load and work immediately — AstroFind detects the existing WCS and skips online solving. For images without a WCS, install ASTAP for fully offline plate solving, and use a local FITS BINTABLE catalog instead of the online VizieR lookup if you need catalog overlay too.

🇧🇷 Sim, com algumas limitações. Imagens que já têm uma solução WCS no cabeçalho (de um plate solver dedicado ou software de observatório) carregam e funcionam imediatamente — o AstroFind detecta o WCS existente e pula a resolução online. Pra imagens sem WCS, instale o ASTAP pra plate solving totalmente offline, e use um catálogo FITS BINTABLE local em vez da consulta online ao VizieR se também precisar de sobreposição de catálogo.

---

Blink mode doesn't show anything moving — is that normal? / O modo blink não mostra nada se movendo — isso é normal?

🇬🇧 Yes — most asteroid fields show no moving object at all; that's expected in real searches. A real asteroid appears as a tiny dot that shifts position between frames while background stars stay fixed — it does not streak across the screen like a shooting star. Make sure your images are spaced 30–60 minutes apart and check the Known Object Overlay (Ctrl+K) to see if any known asteroids are predicted in the field, as a sanity check.

🇧🇷 Sim — a maioria dos campos de asteroide não mostra nenhum objeto em movimento; isso é esperado em buscas reais. Um asteroide real aparece como um pontinho que muda de posição entre os quadros enquanto as estrelas de fundo ficam fixas — ele não risca a tela como uma estrela cadente. Confira se suas imagens estão espaçadas 30-60 minutos, e verifique a Sobreposição de Objeto Conhecido (Ctrl+K) pra ver se algum asteroide conhecido é previsto no campo, como checagem de sanidade.

---

Why does the Log Panel show a DATE-OBS warning? / Por que o Painel de Log mostra um aviso de DATE-OBS?

🇬🇧 Your FITS file has a DATE-OBS header without timezone info and no TIMESYS keyword. AstroFind assumes UTC (Universal Time) in that case. If your camera records local time instead, set the offset in Settings → Observer → Time Zone, or reconfigure the camera/acquisition software to record UTC directly (recommended for scientific work).

🇧🇷 Seu arquivo FITS tem um cabeçalho DATE-OBS sem informação de fuso horário e sem a palavra-chave TIMESYS. Nesse caso, o AstroFind assume UTC (Tempo Universal). Se sua câmera registra hora local em vez disso, configure o offset em Configurações → Observador → Fuso Horário, ou reconfigure a câmera/software de aquisição pra registrar UTC diretamente (recomendado pra trabalho científico).

---

What are the most common errors, and what do I do about them? / Quais são os erros mais comuns, e o que eu faço?

🇬🇧

Symptom	Likely cause / fix
Image loads but appears totally black or white	Adjust the stretch in Images → Background and Range…
"No WCS solution" when trying to measure	Run Processing → Data Reduction first (plate solving)
Plate solver fails/times out	Check API key, too few stars, or increase timeout — see above
Verification dialog's "Known Objects" list looks empty	Normal if no catalogued asteroid is nearby; shows a placeholder message
Measurement Table stays empty after clicking	Make sure the Aperture tool (A) is active, not Select (S)
ADES export button greyed out / report incomplete	Fill in required observer fields first (Edit → Preferences → Observer)
Can't submit to MPC	You need a valid 3-character MPC observatory code

🇧🇷

Sintoma	Causa provável / correção
Imagem carrega mas fica toda preta ou branca	Ajuste o esticamento em Imagens → Fundo e Alcance…
"Sem solução WCS" ao tentar medir	Rode Processamento → Redução de Dados primeiro (plate solving)
Plate solver falha/dá timeout	Confira a chave de API, poucas estrelas, ou aumente o timeout — veja acima
Lista "Objetos Conhecidos" do diálogo de Verificação parece vazia	Normal se nenhum asteroide catalogado estiver próximo; mostra uma mensagem de placeholder
Tabela de Medições fica vazia depois de clicar	Confirme que a ferramenta Abertura (A) está ativa, não Selecionar (S)
Botão de exportar ADES desabilitado / relatório incompleto	Preencha os campos obrigatórios de observador primeiro (Editar → Preferências → Observador)
Não consigo submeter ao MPC	Você precisa de um código de observatório MPC válido de 3 caracteres

---

Is AstroFind free? Can I use it for a class or a paid project? / O AstroFind é gratuito? Posso usar num projeto de aula ou pago?

🇬🇧 Yes, AstroFind is free and open-source, released under the AGPL-3.0 license (a strong copyleft license: commercial use is allowed, but if you distribute a modified version — even as a network service — you must also make its source code available under the same license). See the LICENSE file in the repository for the exact terms.

🇧🇷 Sim, o AstroFind é gratuito e de código aberto, distribuído sob a licença AGPL-3.0 (uma licença copyleft forte: uso comercial é permitido, mas se você distribuir uma versão modificada — mesmo como serviço de rede — precisa também disponibilizar o código-fonte sob a mesma licença). Veja o arquivo LICENSE no repositório para os termos exatos.

---

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