O que Astropy faz?
Visão Geral
Astropy é o pacote principal de Python para astronomia, fornecendo funcionalidades essenciais para pesquisa e análise de dados astronômicos. Use astropy para transformações de coordenadas, cálculos de unidades e grandezas, operações com arquivos FITS, cálculos cosmológicos, manipulação precisa de tempo, dados tabulares e processamento de imagens astronômicas.
Quando Usar Esta Habilidade
Use astropy quando as tarefas envolverem:
- Conversão entre sistemas de coordenadas celestes (ICRS, Galáctico, FK5, AltAz, etc.)
- Trabalhar com unidades e grandezas físicas (converter Jy para mJy, parsecs para km, etc.)
- Ler, escrever ou manipular arquivos FITS (imagens ou tabelas)
- Cálculos cosmológicos (distância de luminosidade, tempo de lookback, parâmetro de Hubble)
- Manipulação precisa de tempo com diferentes escalas (UTC, TAI, TT, TDB) e formatos (JD, MJD, ISO)
- Operações com tabelas (ler catálogos, cruzamento, filtragem, junção)
- Transformações WCS entre coordenadas de pixel e mundo
- Constantes e cálculos astronômicos
Início Rápido
import astropy.units as u
from astropy.coordinates import SkyCoord
from astropy.time import Time
from astropy.io import fits
from astropy.table import Table
from astropy.cosmology import Planck18
# Unidades e grandezas
distance = 100 * u.pc
distance_km = distance.to(u.km)
# Coordenadas
coord = SkyCoord(ra=10.5*u.degree, dec=41.2*u.degree, frame='icrs')
coord_galactic = coord.galactic
# Tempo
t = Time('2023-01-15 12:30:00')
jd = t.jd # Data Juliana
# Arquivos FITS
data = fits.getdata('image.fits')
header = fits.getheader('image.fits')
# Tabelas
table = Table.read('catalog.fits')
# Cosmologia
d_L = Planck18.luminosity_distance(z=1.0)
Capacidades Principais
1. Unidades e Grandezas (astropy.units)
Lida com grandezas físicas com unidades, realiza conversões de unidades e garante consistência dimensional nos cálculos.
Operações-chave:
- Criar grandezas multiplicando valores por unidades
- Converter entre unidades usando o método
.to() - Realizar aritmética com tratamento automático de unidades
- Usar equivalências para conversões específicas de domínio (espectral, Doppler, paralaxe)
- Trabalhar com unidades logarítmicas (magnitudes, decibéis)
Veja: references/units.md para documentação abrangente sobre sistemas de unidades, equivalências, otimização de desempenho e aritmética de unidades.
2. Sistemas de Coordenadas (astropy.coordinates)
Representa posições celestes e transforma entre diferentes referenciais de coordenadas.
Operações-chave:
- Criar coordenadas com
SkyCoordem qualquer referencial (ICRS, Galáctico, FK5, AltAz, etc.) - Transformar entre sistemas de coordenadas
- Calcular separações angulares e ângulos de posição
- Cruzar coordenadas com catálogos
- Incluir distância para operações de coordenadas 3D
- Lidar com movimentos próprios e velocidades radiais
- Consultar objetos nomeados de bancos de dados online
Veja: references/coordinates.md para descrições detalhadas de referenciais de coordenadas, transformações, referenciais dependentes do observador (AltAz), cruzamento com catálogos e dicas de desempenho.
3. Cálculos Cosmológicos (astropy.cosmology)
Realiza cálculos cosmológicos usando modelos cosmológicos padrão.
Operações-chave:
- Usar cosmologias integradas (Planck18, WMAP9, etc.)
- Criar modelos cosmológicos personalizados
- Calcular distâncias (luminosidade, comóvel, diâmetro angular)
- Calcular idades e tempos de lookback
- Determinar o parâmetro de Hubble em qualquer redshift
- Calcular parâmetros de densidade e volumes
- Realizar cálculos inversos (encontrar z para uma dada distância)
Veja: references/cosmology.md para modelos disponíveis, cálculos de distância, cálculos de tempo, parâmetros de densidade e efeitos de neutrinos.
4. Manipulação de Arquivos FITS (astropy.io.fits)
Lê, escreve e manipula arquivos FITS (Sistema Flexível de Transporte de Imagem).
Operações-chave:
- Abrir arquivos FITS com gerenciadores de contexto
- Acessar HDUs (Unidades de Dados de Cabeçalho) por índice ou nome
- Ler e modificar cabeçalhos (palavras-chave, comentários, histórico)
- Trabalhar com dados de imagem (arranjos NumPy)
- Manipular dados de tabela (tabelas binárias e ASCII)
- Criar novos arquivos FITS (extensão única ou múltipla)
- Usar mapeamento de memória para arquivos grandes
- Acessar arquivos FITS remotos (S3, HTTP)
Veja: references/fits.md para operações abrangentes de arquivos, manipulação de cabeçalhos, tratamento de imagens e tabelas, arquivos de múltiplas extensões e considerações de desempenho.
5. Operações com Tabelas (astropy.table)
Trabalha com dados tabulares com suporte a unidades, metadados e vários formatos de arquivo.
Operações-chave:
- Criar tabelas a partir de arranjos, listas ou dicionários
- Ler/escrever tabelas em vários formatos (FITS, CSV, HDF5, VOTable)
- Acessar e modificar colunas e linhas
- Classificar, filtrar e indexar tabelas
- Realizar operações estilo banco de dados (junção, agrupamento, agregação)
- Empilhar e concatenar tabelas
- Trabalhar com colunas cientes de unidades (QTable)
- Lidar com dados ausentes usando mascaramento
Veja: references/tables.md para criação de tabelas, operações de E/S, manipulação de dados, classificação, filtragem, junções, agrupamento e dicas de desempenho.
6. Manipulação de Tempo (astropy.time)
Representação precisa de tempo e conversão entre escalas e formatos de tempo.
Operações-chave:
- Criar objetos Time em vários formatos (ISO, JD, MJD, Unix, etc.)
- Converter entre escalas de tempo (UTC, TAI, TT, TDB, etc.)
- Realizar aritmética de tempo com TimeDelta
- Calcular tempo sideral para observadores
- Calcular correções de tempo de viagem da luz (baricêntrico, heliocêntrico)
- Trabalhar com arranjos de tempo eficientemente
- Lidar com tempos mascarados (ausentes)
Veja: references/time.md para formatos de tempo, escalas de tempo, conversões, aritmética, recursos de observação e manipulação de precisão.
7. Sistema de Coordenadas Mundiais (astropy.wcs)
Transforma entre coordenadas de pixel em imagens e coordenadas mundiais.
Operações-chave:
- Ler WCS de cabeçalhos FITS
- Converter coordenadas de pixel para coordenadas mundiais (e vice-versa)
- Calcular pegadas de imagem
- Acessar parâmetros WCS (pixel de referência, projeção, escala)
- Criar objetos WCS personalizados
Veja: references/wcs_and_other_modules.md para operações e transformações WCS.
Capacidades Adicionais
O arquivo references/wcs_and_other_modules.md também cobre:
NDData e CCDData
Contêineres para conjuntos de dados n-dimensionais com metadados, incerteza, mascaramento e informações WCS.
Modelagem
Estrutura para criar e ajustar modelos matemáticos a dados astronômicos.
Visualização
Ferramentas para exibição de imagens astronômicas com esticamento e escalonamento apropriados.
Constantes
Constantes físicas e astronômicas com unidades adequadas (velocidade da luz, massa solar, constante de Planck, etc.).
Convolução
Kernels de processamento de imagem para suavização e filtragem.
Estatística
Funções estatísticas robustas, incluindo corte sigma e rejeição de outliers.
Instalação
# Instalar astropy
uv pip install astropy
# Com dependências opcionais para funcionalidade completa
uv pip install astropy[all]
Fluxos de Trabalho Comuns
Convertendo Coordenadas entre Sistemas
from astropy.coordinates import SkyCoord
import astropy.units as u
# Criar coordenada
c = SkyCoord(ra='05h23m34.5s', dec='-69d45m22s', frame='icrs')
# Transformar para galáctico
c_gal = c.galactic
print(f"l={c_gal.l.deg}, b={c_gal.b.deg}")
# Transformar para alt-az (requer tempo e localização)
from astropy.time import Time
from astropy.coordinates import EarthLocation, AltAz
observing_time = Time('2023-06-15 23:00:00')
observing_location = EarthLocation(lat=40*u.deg, lon=-120*u.deg)
aa_frame = AltAz(obstime=observing_time, location=observing_location)
c_altaz = c.transform_to(aa_frame)
print(f"Alt={c_altaz.alt.deg}, Az={c_altaz.az.deg}")
Lendo e Analisando Arquivos FITS
from astropy.io import fits
import numpy as np
# Abrir arquivo FITS
with fits.open('observation.fits') as hdul:
# Exibir estrutura
hdul.info()
# Obter dados de imagem e cabeçalho
data = hdul[1].data
header = hdul[1].header
# Acessar valores do cabeçalho
exptime = header['EXPTIME']
filter_name = header['FILTER']
# Analisar dados
mean = np.mean(data)
median = np.median(data)
print(f"Média: {mean}, Mediana: {median}")
Cálculos de Distância Cosmológica
from astropy.cosmology import Planck18
import astropy.units as u
import numpy as np
# Calcular distâncias em z=1.5
z = 1.5
d_L = Planck18.luminosity_distance(z)
d_A = Planck18.angular_diameter_distance(z)
print(f"Distância de luminosidade: {d_L}")
print(f"Distância de diâmetro angular: {d_A}")
# Idade do universo naquele redshift
age = Planck18.age(z)
print(f"Idade em z={z}: {age.to(u.Gyr)}")
# Tempo de lookback
t_lookback = Planck18.lookback_time(z)
print(f"Tempo de lookback: {t_lookback.to(u.Gyr)}")
Cruzamento de Catálogos
from astropy.table import Table
from astropy.coordinates import SkyCoord, match_coordinates_sky
import astropy.units as u
# Ler catálogos
cat1 = Table.read('catalog1.fits')
cat2 = Table.read('catalog2.fits')
# Criar objetos de coordenadas
coords1 = SkyCoord(ra=cat1['RA']*u.degree, dec=cat1['DEC']*u.degree)
coords2 = SkyCoord(ra=cat2['RA']*u.degree, dec=cat2['DEC']*u.degree)
# Encontrar correspondências
idx, sep, _ = coords1.match_to_catalog_sky(coords2)
# Filtrar por limite de separação
max_sep = 1 * u.arcsec
matches = sep < max_sep
# Criar catálogos correspondentes
cat1_matched = cat1[matches]
cat2_matched = cat2[idx[matches]]
print(f"Encontradas {len(cat1_matched)} correspondências")
Melhores Práticas
- Sempre use unidades: Anexe unidades às grandezas para evitar erros e garantir consistência dimensional
- Use gerenciadores de contexto para arquivos FITS: Garante o fechamento adequado dos arquivos
- Prefira arranjos a loops: Processe múltiplas coordenadas/tempos como arranjos para melhor desempenho
- Verifique os referenciais de coordenadas: Confirme o referencial antes das transformações
- Use a cosmologia apropriada: Escolha o modelo cosmológico correto para sua análise
- Lide com dados ausentes: Use colunas mascaradas para tabelas com valores faltantes
- Especifique escalas de tempo: Seja explícito sobre escalas de tempo (UTC, TT, TDB) para medições precisas
- Use QTable para tabelas cientes de unidades: Quando as colunas da tabela tiverem unidades
- Verifique a validade do WCS: Confirme o WCS antes de usar transformações
- Armazene em cache valores usados com frequência: Cálculos caros (por exemplo, distâncias cosmológicas) podem ser armazenados em cache
Documentação e Recursos
- Documentação Oficial do Astropy: https://docs.astropy.org/en/stable/
- Tutoriais: https://learn.astropy.org/
- GitHub: https://github.com/astropy/astropy
Arquivos de Referência
Para informações detalhadas sobre módulos específicos:
references/units.md- Unidades, grandezas, conversões e equivalênciasreferences/coordinates.md- Sistemas de coordenadas, transformações e cruzamento de catálogosreferences/cosmology.md- Modelos e cálculos cosmológicosreferences/fits.md- Operações e manipulação de arquivos FITSreferences/tables.md- Criação de tabelas, E/S e operaçõesreferences/time.md- Formatos de tempo, escalas e cálculosreferences/wcs_and_other_modules.md- WCS, NDData, modelagem, visualização, constantes e utilitários