Communitygithub.com

Astropy

Pacote Python essencial para astronomia, oferecendo funcionalidades fundamentais para pesquisa astronômica e análise de dados. 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.

O que é Astropy?

Astropy é o pacote principal de Python para astronomia, fornecendo funcionalidades essenciais para pesquisa e análise de dados astronômicos. Ele unifica módulos para transformações de coordenadas celestes (ICRS, Galáctico, AltAz), cálculos com unidades físicas, leitura e escrita de arquivos FITS, cálculos cosmológicos (distância de luminosidade, tempo de lookback), manipulação precisa de tempo em diferentes escalas (UTC, TAI, TDB), operações com tabelas (cruzamento de catálogos, filtragem) e o Sistema de Coordenadas Mundiais (WCS). A habilidade é útil para astrônomos e cientistas de dados que trabalham com observações astronômicas, permitindo desde a simples conversão de unidades até análises complexas de imagens e catálogos. Ela suporta as plataformas Claude Code, Cursor e Codex, e inclui referências detalhadas para cada módulo. O uso do astropy promove boas práticas como sempre anexar unidades, usar gerenciadores de contexto para arquivos FITS e preferir arranjos a loops para melhor desempenho.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/K-Dense-AI/claude-scientific-skills/astropy

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 SkyCoord em 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

  1. Sempre use unidades: Anexe unidades às grandezas para evitar erros e garantir consistência dimensional
  2. Use gerenciadores de contexto para arquivos FITS: Garante o fechamento adequado dos arquivos
  3. Prefira arranjos a loops: Processe múltiplas coordenadas/tempos como arranjos para melhor desempenho
  4. Verifique os referenciais de coordenadas: Confirme o referencial antes das transformações
  5. Use a cosmologia apropriada: Escolha o modelo cosmológico correto para sua análise
  6. Lide com dados ausentes: Use colunas mascaradas para tabelas com valores faltantes
  7. Especifique escalas de tempo: Seja explícito sobre escalas de tempo (UTC, TT, TDB) para medições precisas
  8. Use QTable para tabelas cientes de unidades: Quando as colunas da tabela tiverem unidades
  9. Verifique a validade do WCS: Confirme o WCS antes de usar transformações
  10. 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

Arquivos de Referência

Para informações detalhadas sobre módulos específicos:

  • references/units.md - Unidades, grandezas, conversões e equivalências
  • references/coordinates.md - Sistemas de coordenadas, transformações e cruzamento de catálogos
  • references/cosmology.md - Modelos e cálculos cosmológicos
  • references/fits.md - Operações e manipulação de arquivos FITS
  • references/tables.md - Criação de tabelas, E/S e operações
  • references/time.md - Formatos de tempo, escalas e cálculos
  • references/wcs_and_other_modules.md - WCS, NDData, modelagem, visualização, constantes e utilitários

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas