r3cal

r3cal: Resistor Color Code Calculator: Direnç Renk Kodu Hesaplayıcı

English | Türkçe

A modern, multilingual resistor color code calculator for Python. Supports 4, 5, and 6-band resistors, N/A bands, live previews, and an optional bilingual (EN/TR) interface. Works both as a standalone GUI and as an embeddable widget inside your own Tkinter application.

📦 Installation

pip install r3cal

Python 3.11+ is required. Tkinter ships with the standard library on Windows and macOS. On Linux you may need:

sudo apt install python3-tk        # Debian / Ubuntu
sudo dnf install python3-tkinter   # Fedora

✨ Features

🚀 Quick Start

Standalone

!python -m r3cal

import r3cal, tkinter as tk; r3cal.R3Cal(tk.Tk()); tk.mainloop()

or

import tkinter as tk
import r3cal

r3cal.R3Cal(tk.Tk())
tk.mainloop()

Embedded in your own window

import tkinter as tk
from tkinter import ttk
import r3cal

root = tk.Tk()
root.title("My App")
root.geometry("1000x800")

frame = ttk.Frame(root, padding=6)
frame.pack(fill="both", expand=True)

app = r3cal.R3Cal(frame)   # embed inside a Frame
root.mainloop()

Direct class import

from r3cal import R3Cal
import tkinter as tk

R3Cal(tk.Tk())
tk.mainloop()

🎨 Usage

1. Choose 4 / 5 / 6 bands at the top.
2. Pick a language: English, Türkçe, or English + Türkçe.
3. For each band, do any of these:
   • Select a color from the dropdown, or
   • Type the color number (1–13) and press Enter, or
   • Type the English name (Red), or
   • Type the Turkish name (Kırmızı).
4. Results update live: resistance, tolerance, min/max, tempco.
5. Use A+ / A− at the bottom to scale the interface font.

Color number reference

📚 API Reference

class r3cal.R3Cal(container)

Creates the calculator widget. container can be either:

• a tkinter.Tk / tkinter.Toplevel → standalone window,
• a tkinter.ttk.Frame → embedded widget.

The instance exposes:

Color tables (module-level)

from r3cal import DIGIT, MULTIPLIER, TOLERANCE, TEMPCO, COLORS

Helper functions

from r3cal import parse_color, fmt_resistance

parse_color("3")             # → "Red"
parse_color("Kırmızı")       # → "Red"
parse_color("1 - Black")     # → "Black"
fmt_resistance(2200)         # → "2.2 kΩ"

🧪 Examples

220 Ω, 4-band (Red-Red-Brown-Gold)

Result: 220 Ω ±5 %, Min 209 Ω, Max 231 Ω.

220 Ω, 6-band with N/A tempco

Result: 220 Ω ±5 %, Tempco N/A.

N/A tolerance

Any 4-band resistor with tolerance set to Black or White shows Tolerance = N/A and Minimum / Maximum = N/A.

🖼️ Screenshot

┌─────────────────────────────────────────────────────────────┐
│  Language / Dil: [ English + Türkçe ▾ ]   Bands: ●4 ●5 ●6   │
├─────────────────────────────────────────────────────────────┤
│  Bands / Bantlar                                            │
│  Band/Bant 1 (Digit/Rakam):        [3 - Red (Kırmızı)  ▾]  │
│  Band/Bant 2 (Digit/Rakam):        [3 - Red (Kırmızı)  ▾]  │
│  Band/Bant 3 (Multiplier/Çarpan):  [2 - Brown (Kahv.)  ▾]  │
│  Band/Bant 4 (Tolerance/Tolerans): [11 - Gold (Altın)  ▾]  │
├─────────────────────────────────────────────────────────────┤
│  Results / Sonuçlar                                         │
│  Resistance / Direnç:                220 Ω                  │
│  Tolerance / Tolerans:               ±5 %                   │
│  Minimum:                            209 Ω                  │
│  Maximum / Maksimum:                 231 Ω                  │
│  Temperature Coefficient / …:        -                      │
└─────────────────────────────────────────────────────────────┘

🛠️ Development

git clone https://github.com/WhiteSymmetry/r3cal.git
cd r3cal
pip install -e .
python -m r3cal

📄 License

AGPL-3.0 License — see LICENSE.

🙏 Acknowledgements

Color tables follow the IEC 60062 standard and standard resistor datasheets. Built with Tkinter only — no third-party runtime dependencies.

Türkçe

English | Türkçe

Python için çok dilli, modern bir direnç renk kodu hesaplayıcısı. 4, 5 ve 6 bantlı dirençleri destekler; N/A bantlar, canlı renk önizlemeleri ve isteğe bağlı iki dilli (EN/TR) arayüz sunar. Hem bağımsız bir GUI olarak hem de kendi Tkinter uygulamanıza gömülebilir bir bileşen olarak çalışır.

📦 Kurulum

pip install r3cal

Python 3.11+ gereklidir. Tkinter, Windows ve macOS'ta standart kütüphaneyle birlikte gelir. Linux'ta ayrıca kurmanız gerekebilir:

sudo apt install python3-tk        # Debian / Ubuntu
sudo dnf install python3-tkinter   # Fedora

✨ Özellikler

🚀 Hızlı Başlangıç

Bağımsız çalıştırma

python -m r3cal

veya

import tkinter as tk
import r3cal

r3cal.R3Cal(tk.Tk())
tk.mainloop()

Kendi pencerenize gömme

import tkinter as tk
from tkinter import ttk
import r3cal

root = tk.Tk()
root.title("Uygulamam")
root.geometry("1000x800")

frame = ttk.Frame(root, padding=6)
frame.pack(fill="both", expand=True)

app = r3cal.R3Cal(frame)   # bir Frame içine göm
root.mainloop()

Sınıfı doğrudan içe aktarma

from r3cal import R3Cal
import tkinter as tk

R3Cal(tk.Tk())
tk.mainloop()

🎨 Kullanım

1. Üstten 4 / 5 / 6 bant seçin.
2. Bir dil seçin: English, Türkçe veya English + Türkçe.
3. Her bant için şunlardan herhangi birini yapın:
   • Açılır menüden bir renk seçin, veya
   • Renk numarasını (1–13) yazıp Enter'a basın, veya
   • İngilizce adı yazın (Red), veya
   • Türkçe adı yazın (Kırmızı).
4. Sonuçlar anında güncellenir: direnç, tolerans, min/maks, tempco.
5. Alttaki A+ / A− butonlarıyla arayüz yazı boyutunu ölçekleyin.

Renk numarası referansı

📚 API Referansı

class r3cal.R3Cal(container)

Hesaplayıcı bileşenini oluşturur. container şunlardan biri olabilir:

• bir tkinter.Tk / tkinter.Toplevel → bağımsız pencere,
• bir tkinter.ttk.Frame → gömülü bileşen.

Örnek üzerinden erişilebilen öznitelikler:

Renk tabloları (modül düzeyinde)

from r3cal import DIGIT, MULTIPLIER, TOLERANCE, TEMPCO, COLORS

Yardımcı fonksiyonlar

from r3cal import parse_color, fmt_resistance

parse_color("3")             # → "Red"
parse_color("Kırmızı")       # → "Red"
parse_color("1 - Black")     # → "Black"
fmt_resistance(2200)         # → "2.2 kΩ"

🧪 Örnekler

220 Ω, 4 bant (Kırmızı-Kırmızı-Kahverengi-Altın)

Sonuç: 220 Ω ±5 %, Min 209 Ω, Maks 231 Ω.

220 Ω, 6 bant — N/A tempco'lu

Sonuç: 220 Ω ±5 %, Tempco N/A.

N/A tolerans

Toleransı Siyah veya Beyaz olan herhangi bir 4 bantlı direnç Tolerans = N/A ve Minimum / Maksimum = N/A gösterir.

🖼️ Ekran Görüntüsü

┌─────────────────────────────────────────────────────────────┐
│  Language / Dil: [ English + Türkçe ▾ ]   Bands: ●4 ●5 ●6   │
├─────────────────────────────────────────────────────────────┤
│  Bands / Bantlar                                            │
│  Band/Bant 1 (Digit/Rakam):        [3 - Red (Kırmızı)  ▾]  │
│  Band/Bant 2 (Digit/Rakam):        [3 - Red (Kırmızı)  ▾]  │
│  Band/Bant 3 (Multiplier/Çarpan):  [2 - Brown (Kahv.)  ▾]  │
│  Band/Bant 4 (Tolerance/Tolerans): [11 - Gold (Altın)  ▾]  │
├─────────────────────────────────────────────────────────────┤
│  Results / Sonuçlar                                         │
│  Resistance / Direnç:                220 Ω                  │
│  Tolerance / Tolerans:               ±5 %                   │
│  Minimum:                            209 Ω                  │
│  Maximum / Maksimum:                 231 Ω                  │
│  Temperature Coefficient / …:        -                      │
└─────────────────────────────────────────────────────────────┘

🛠️ Geliştirme

git clone https://github.com/<kullanıcı>/r3cal.git
cd r3cal
pip install -e .
python -m r3cal

📄 Lisans

AGPL-3.0 Lisansı — ayrıntılar için LICENSE.

🙏 Teşekkür

Renk tabloları IEC 60062 standardını ve standart direnç veri sayfalarını takip eder. Yalnızca Tkinter ile inşa edilmiştir — üçüncü taraf çalışma zamanı bağımlılığı yoktur.

---

## Notlar

- **`python -m r3cal`** komutunun çalışması için `r3cal/__main__.py` dosyası gerekir:

```python
# r3cal/__main__.py
import tkinter as tk
from .r3cal import R3Cal

R3Cal(tk.Tk())
tk.mainloop()