Astropy
Visão Geral
Astropy é o pacote Python central para astronomia, fornecendo funcionalidades essenciais para pesquisa astronômica e análise de dados. Use astropy para transformações de coordenadas, cálculos de unidades e quantidades, operações com arquivos FITS, cálculos cosmológicos, manipulação precisa de tempo, manipulação de dados tabulares e processamento de imagens astronômicas.
Quando Usar Esta Skill
Use astropy quando as tarefas envolverem:
- Conversão entre sistemas de coordenadas celestes (ICRS, Galáctico, FK5, AltAz, etc.)
- Trabalho com unidades e quantidades físicas (converter Jy para mJy, parsecs para km, etc.)
- Leitura, escrita ou manipulação de arquivos FITS (imagens ou tabelas)
- Cálculos cosmológicos (distância de luminosidade, tempo de retrospecto, parâmetro de Hubble)
- Manipulação precisa de tempo com diferentes escalas de tempo (UTC, TAI, TT, TDB) e formatos (JD, MJD, ISO)
- Operações com tabelas (leitura de catálogos, cruzamento, filtragem, junção)
- Transformações WCS entre coordenadas de pixel e mundo
- Constantes astronômicas e cálculos
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 quantidades
DISTÂNCIA = 100 * u.pc
distância_km = distância.to(u.km)
# Coordenadas
coord = SkyCoord(ra=10.5*u.degree, dec=41.2*u.degree, frame='icrs')
coord_galático = coord.galactic
# Tempo
t = Time('2023-01-15 12:30:00')
jd = t.jd # Data Juliana
# Arquivos FITS
dados = fits.getdata('image.fits')
cabeçalho = fits.getheader('image.fits')
# Tabelas
tabela = Table.read('catalog.fits')
# Cosmologia
d_L = Planck18.luminosity_distance(z=1.0)
Capacidades Principais
1. Unidades e Quantidades (astropy.units)
Lide com grandezas físicas com unidades, realize conversões de unidades e garanta consistência dimensional em cálculos.
Operações-chave:
- Criar quantidades multiplicando valores por unidades
- Converter entre unidades usando o método
.to() - Realizar aritmética com manipulação automática 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 completa, sistemas de unidades, equivalências, otimização de desempenho e aritmética de unidades.
2. Sistemas de Coordenadas (astropy.coordinates)
Represente posições celestes e transforme entre diferentes sistemas de coordenadas.
Operações-chave:
- Criar coordenadas com
SkyCoordem qualquer sistema (ICRS, Galáctico, FK5, AltAz, etc.) - Transformar entre sistemas de coordenadas
- Calcular separações angulares e ângulos de posição
- Corresponder coordenadas a catálogos
- Incluir distância para operações de coordenadas 3D
- Lidar com movimentos próprios e velocidades radiais
- Consultar objetos nomeados em bancos de dados online
Veja: references/coordinates.md para descrições detalhadas de sistemas de coordenadas, transformações, sistemas dependentes do observador (AltAz), correspondência de catálogos e dicas de desempenho.
3. Cálculos Cosmológicos (astropy.cosmology)
Realize cálculos cosmológicos usando modelos cosmológicos padrão.
Operações-chave:
- Usar cosmologias embutidas (Planck18, WMAP9, etc.)
- Criar modelos cosmológicos personalizados
- Calcular distâncias (luminosidade, comovente, diâmetro angular)
- Calcular idades e tempos de retrospecto
- Determinar o parâmetro de Hubble em qualquer desvio para o vermelho
- 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)
Leia, escreva e manipule arquivos FITS (Flexible Image Transport System).
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 (arrays NumPy)
- Lidar com dados de tabela (tabelas binárias e ASCII)
- Criar novos arquivos FITS (único ou múltiplas extensões)
- 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, manipulação de imagens e tabelas, arquivos com múltiplas extensões e considerações de desempenho.
5. Operações com Tabelas (astropy.table)
Trabalhe com dados tabulares com suporte a unidades, metadados e vários formatos de arquivo.
Operações-chave:
- Criar tabelas a partir de arrays, listas ou dicionários
- Ler/escrever tabelas em vários formatos (FITS, CSV, HDF5, VOTable)
- Acessar e modificar colunas e linhas
- Ordenar, filtrar e indexar tabelas
- Realizar operações de banco de dados (junção, grupo, agregação)
- Empilhar e concatenar tabelas
- Trabalhar com colunas cientes de unidades (
QTable) - Lidar com dados ausentes com mascaramento
Veja: references/tables.md para criação de tabelas, operações de I/O, manipulação de dados, ordenação, filtragem, junções, agrupamento e dicas de desempenho.
6. Manipulação de Tempo (astropy.time)
Representação precisa do 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êntrica, heliocêntrica)
- Trabalhar com arrays de tempo de forma eficiente
- 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 Mundial (astropy.wcs)
Transforme 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 imagens
- 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
Framework para criar e ajustar modelos matemáticos a dados astronômicos.
Visualização
Ferramentas para exibição de imagens astronômicas com alongamento e escala 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:.2f}, b={c_gal.b.deg:.2f}")
# Transformar para alt-az (requer tempo e localização)
from astropy.time import Time
from astropy.coordinates import EarthLocation, AltAz
tempo_observação = Time('2023-06-15 23:00:00')
local_observação = EarthLocation(lat=40*u.deg, lon=-120*u.deg)
aa_frame = AltAz(obstime=tempo_observação, location=local_observação)
c_altaz = c.transform_to(aa_frame)
print(f"Alt={c_altaz.alt.deg:.2f}, Az={c_altaz.az.deg:.2f}")
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
dados = hdul[1].data
cabeçalho = hdul[1].header
# Acessar valores do cabeçalho
exptime = cabeçalho['EXPTIME']
nome_filtro = cabeçalho['FILTER']
# Analisar dados
média = np.mean(dados)
mediana = np.median(dados)
print(f"Média: {média:.2f}, Mediana: {mediana:.2f}")
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:.2f}")
print(f"Distância de diâmetro angular: {d_A:.2f}")
# Idade do universo naquele desvio para o vermelho
idade = Planck18.age(z)
print(f"Idade em z={z}: {idade.to(u.Gyr):.2f}")
# Tempo de retrospecto
t_retrospecto = Planck18.lookback_time(z)
print(f"Tempo de retrospecto: {t_retrospecto.to(u.Gyr):.2f}")
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
correspondências = sep < max_sep
# Criar catálogos correspondentes
cat1_correspondido = cat1[correspondências]
cat2_correspondido = cat2[idx[correspondências]]
print(f"Encontradas {len(cat1_correspondido)} correspondências")
Melhores Práticas
- Sempre use unidades: Anexe unidades às quantidades para evitar erros e garantir consistência dimensional
- Use gerenciadores de contexto para arquivos FITS: Garante o fechamento adequado dos arquivos
- Prefira arrays a loops: Processe múltiplas coordenadas/tempos como arrays para melhor desempenho
- Verifique os sistemas de coordenadas: Confirme o sistema 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 ausentes
- Especifique escalas de tempo: Seja explícito sobre escalas de tempo (UTC, TT, TDB) para temporização precisa
- 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 frequentemente usados: 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, quantidades, conversões e equivalênciasreferences/coordinates.md- Sistemas de coordenadas, transformações e correspondência de catálogosreferences/cosmology.md- Modelos cosmológicos e cálculosreferences/fits.md- Operações e manipulação de arquivos FITSreferences/tables.md- Criação de tabelas, I/O e operaçõesreferences/time.md- Formatos, escalas e cálculos de temporeferences/wcs_and_other_modules.md- WCS, NDData, modelagem, visualização, constantes e utilitários
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.