similarity-capacitor
Use when working with capacitor similarity calculations - comparing ceramic/electrolytic/film capacitor MPNs, understanding value/voltage/dielectric matching, or capacitor-specific similarity logic.
소스 정보
- 저장소
- Cantara/lib-electronic-components
- 최근 소스 활동
- 2026년 1월 24일 10:06
- 감지된 SKILL.md 언어
- 영어
- 스타
- 4
- 포크
- 0
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- similarity-capacitor
- description
- Use when working with capacitor similarity calculations - comparing ceramic/electrolytic/film capacitor MPNs, understanding value/voltage/dielectric matching, or capacitor-specific similarity logic.
# Capacitor Similarity Calculator Skill
Guidance for working with `CapacitorSimilarityCalculator` in the lib-electronic-components library.
---
**For metadata-driven similarity architecture**, see `/similarity-metadata`:
- SpecImportance levels (CRITICAL, HIGH, MEDIUM, LOW, OPTIONAL)
- ToleranceRule types (exactMatch, percentageTolerance, minimumRequired, etc.)
- SimilarityProfile contexts (DESIGN_PHASE, REPLACEMENT, COST_OPTIMIZATION, etc.)
- Calculator integration patterns and gotchas
---
## Overview
The `CapacitorSimilarityCalculator` compares capacitors based on:
- **Capacitance value** - Must match for high similarity
- **Package size** - 0402, 0603, 0805, etc.
- **Voltage rating** - Should be compatible
- **Dielectric type** - X5R, X7R, C0G, etc.
## Applicable Types
```java
ComponentType.CAPACITOR
ComponentType.CAPACITOR_CERAMIC_MURATA
ComponentType.CAPACITOR_CERAMIC_TDK
ComponentType.CAPACITOR_CERAMIC_SAMSUNG
ComponentType.CAPACITOR_CERAMIC_YAGEO
ComponentType.CAPACITOR_ELECTROLYTIC_NICHICON
// Any type starting with "CAPACITOR_"
```
Returns `false` for `null` type.
## Similarity Scoring
| Condition | Score |
|-----------|-------|
| Same value, same package, same voltage | ~0.8+ |
| Same value, different package | ~0.5-0.7 |
| Same package, different value | ~0.3 |
| Different everything | ~0.0-0.3 |
## Capacitance Value Extraction
| MPN Pattern | Value |
|-------------|-------|
| `104` in MPN | 100nF (10×10⁴ pF) |
| `103` in MPN | 10nF (10×10³ pF) |
| `100N` | 100nF |
| `10U` | 10µF |
## Common Manufacturers & Patterns
### Murata GRM Series
```
GRM 188 R 71 H 104 K A01 D
│ │ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │ └── Packaging
│ │ │ │ │ │ │ └────── Termination
│ │ │ │ │ │ └──────── Tolerance (K=10%)
│ │ │ │ │ └──────────── Value (104=100nF)
│ │ │ │ └────────────── Voltage (H=50V)
│ │ │ └───────────────── Dielectric (71=X7R)
│ │ └──────────────────── Thickness
│ └──────────────────────── Size (188=0603)
└──────────────────────────── Series
```
### Samsung CL Series
```
CL 10 B 104 K B8 NNNC
│ │ │ │ │ │ │
│ │ │ │ │ │ └── Packaging
│ │ │ │ │ └───── Voltage (B8=25V)
│ │ │ │ └─────── Tolerance (K=10%)
│ │ │ └─────────── Value (104=100nF)
│ │ └────────────── Dielectric (B=X7R)
│ └───────────────── Size (10=0603)
└──────────────────── Series
```
### Yageo CC Series
```
CC 0603 KRX 7R 9 BB 104
│ │ │ │ │ │ │
│ │ │ │ │ │ └── Value (104=100nF)
│ │ │ │ │ └───── Voltage (BB=50V)
│ │ │ │ └─────── TCC code
│ │ │ └────────── Dielectric (7R=X7R)
│ │ └────────────── Tolerance (K=10%)
│ └─────────────────── Size (0603)
└────────────────────── Series
```
## Cross-Manufacturer Matching
```java
// Murata vs Samsung same value/size
calculator.calculateSimilarity("GRM188R71H104KA01D", "CL10B104KB8NNNC", registry);
// Returns >= 0.5 (both 100nF, 0603)
```
## Dielectric Types
| Type | Characteristics | Temp Range |
|------|-----------------|------------|
| C0G/NP0 | Stable, low loss | -55 to +125°C |
| X5R | Higher capacity | -55 to +85°C |
| X7R | General purpose | -55 to +125°C |
| Y5V | High capacity, variable | -30 to +85°C |
## Test Examples
```java
// Same Murata capacitor
calculator.calculateSimilarity("GRM188R71H104KA01D", "GRM188R71H104KA01D", registry);
// Returns ~0.8
// Same value, different package
calculator.calculateSimilarity("GRM188R71H104KA01D", "GRM21BR71H104KA01D", registry);
// Returns ~0.5-0.7
// Different values
calculator.calculateSimilarity("GRM188R71H104KA01D", "GRM188R71H103KA01D", registry);
// Returns ~0.3 (100nF vs 10nF)
// Cross-manufacturer
calculator.calculateSimilarity("GRM188R71H104KA01D", "CL10B104KB8NNNC", registry);
// Returns >= 0.5
```
---
## Learnings & Quirks
### Value Notation
- E-series notation: `104` = 10×10⁴ pF = 100nF
- Last digit is multiplier (power of 10)
- `473` = 47×10³ pF = 47nF
### Package Size Mapping
| Imperial | Metric | Murata Code |
|----------|--------|-------------|
| 0402 | 1005 | 155 |
| 0603 | 1608 | 188 |
| 0805 | 2012 | 21 |
| 1206 | 3216 | 31 |
### Voltage Code Variations
- Different manufacturers use different voltage codes
- Murata: H=50V, Samsung: B8=25V
- Always verify voltage compatibility
### Dielectric Compatibility
- X7R and X5R are often interchangeable for general use
- C0G is preferred for precision applications
### Unicode Gotcha: Micro Sign (Milestone 2, January 2026)
**Critical Bug**: The micro sign µ (U+00B5) becomes Greek capital MU Μ (U+039C) when uppercased:
```java
"0.1µF".toUpperCase() // Returns "0.1ΜF" NOT "0.1µF"!
```
**Impact**: If parseCapacitanceValue() uses toUpperCase() before checking for "µF", the check fails silently, returning null. This causes capacitance comparison to be skipped, reducing similarity from ~1.0 to ~0.33 (package match only).
**Solution**: Replace µ→u and Μ→u before normalizing:
```java
String normalized = value.replace("µ", "u").replace("Μ", "u");
normalized = normalizeValue(normalized); // Now safe to toUpperCase
if (normalized.contains("UF")) { // Matches both µF and plain UF
```
**Lesson**: Always handle Greek-origin SI prefixes (µ, Ω) carefully in string normalization logic.
<!-- Add new learnings above this line -->
GitHub에서 보기