seasonality-table

A Python library to generate monthly returns (seasonality) tables for financial analysis.

Finansal analiz icin aylik getiri (mevsimsellik) tablolari olusturan bir Python kutuphanesi.

Installation / Kurulum

pip install seasonality-table

Usage / Kullanim

Basic Usage / Temel Kullanim

from seasonality_table import get_returns_table

# Get Bitcoin monthly returns table
# Bitcoin aylik getiri tablosu
table = get_returns_table("BTC-USD")
table

Parameters / Parametreler

Examples / Ornekler

from seasonality_table import get_returns_table

# Example 1: Stock data without colors
# Ornek 1: Renksiz hisse verisi
table = get_returns_table("AAPL", is_colored=False)

# Example 2: Custom date range
# Ornek 2: Ozel tarih araligi
table = get_returns_table("MSFT", start_date="2020-01-01", end_date="2024-12-31")

# Example 3: Using Open price instead of Close
# Ornek 3: Close yerine Open fiyati kullanma
table = get_returns_table("BTC-USD", column="Open")

# Example 4: Using custom DataFrame
# Ornek 4: Ozel DataFrame kullanma
import pandas as pd
my_df = pd.read_csv("my_data.csv")
table = get_returns_table(df=my_df, column="price", date="date_column")

Output / Cikti

The function returns a pivot table showing monthly returns (%) by year and month.

Fonksiyon, yil ve aya gore aylik getirileri (%) gosteren bir pivot tablo dondurur.

• Green cells: Positive returns / Yesil hucreler: Pozitif getiri
• Red cells: Negative returns / Kirmizi hucreler: Negatif getiri

Example Output / Ornek Cikti

Requirements / Gereksinimler

• Python >= 3.8
• pandas >= 1.0.0
• yfinance >= 0.2.0

License / Lisans

MIT License

Author / Yazar

cagrigungor - www.cagrigungor.com

Contact / Iletisim: iletisim@cagrigungor.com