samsung_cl module#

Samsung Electro-Mechanics CL general-purpose MLCC family (parameterized).

Models Samsung’s CL series multilayer ceramic chip capacitors (the commercial/industrial “Normal” line from the Samsung MLCC catalog) as a single parameterized jitx.Component. Choose a case size, capacitance, dielectric, tolerance, and rated voltage and the component builds the matching land pattern, capacitor symbol, and Samsung part number with no parts-database or online lookup. It provides a matching SamsungCL.insert() helper.

This model scopes the family to its most common general-purpose corner: case sizes 0402/0603/0805, class-I C0G and class-II X7R dielectrics, and rated voltages 16/25/50 V. The capacitance envelopes below are deliberately coarse — they catch order-of-magnitude mistakes; whether a specific size/dielectric/voltage/capacitance combination is actually offered is confirmed against Samsung’s product search, which the catalog itself defers to for the live lineup.

Note on dimensions: the catalog specifies the normal-series cases by their standard EIA/metric size codes (05 = 0402/1005, 10 = 0603/1608, 21 = 0805/2012), so the land pattern takes JITX’s standard chip dimensions for the size — the same path as the Vishay CRCW resistor family. As there, that is a choice rather than an absence of data: the catalog’s own “Structure and Dimensions” tables are transcribed below as CL_DIMENSIONS and asserted against the standard table per size in tests/test_js1_samsung_cl.py, so a wrong default cannot pass unnoticed.

Datasheet (Samsung MLCC catalog, Dec 2025 revision; the filename is dated per revision — the newest is linked from https://product.samsungsem.com/product-catalog.do): https://product.samsungsem.com/resources/file/product-catalog/MLCC_2512.pdf

Land-pattern construction, two-pin .insert(), and value-code rounding are shared with the chip-resistor families via chip_smt.

format_capacitance_code(farads)[source]#

Encode a capacitance as Samsung’s 3-character picofarad code.

Two significant figures plus a zero-count exponent, expressed in pF (catalog “Capacitance Code”); values below 10 pF use R as the decimal point. The value is first rounded to two significant figures so decade carries propagate.

Return type:

str

Parameters:

farads (float)

>>> format_capacitance_code(100e-9)
'104'
>>> format_capacitance_code(1.5e-12)
'1R5'
>>> format_capacitance_code(10e-6)
'106'
class SamsungCL(*, capacitance: float, size: str = '0402', dielectric: str = 'X7R', tolerance: float = 0.1, voltage: int = 50, thickness_code: str | None = None, packaging: str | None = None)[source]#

Bases: Component

A Samsung CL general-purpose MLCC, built from catalog data.

Parameters:

  • capacitance (float) – Capacitance in farads (within the size/dielectric envelope).

  • size (str) – Imperial case code: "0402", "0603", or "0805".

  • dielectric (str) – "C0G" (class I) or "X7R" (class II).

  • tolerance (float) – Tolerance as a fraction. C0G offers 0.01/0.02/0.05 (F/G/J); X7R offers 0.05/0.10/0.20 (J/K/M).

  • voltage (int) – Rated voltage in V DC: 16, 25, or 50 (codes O/A/B).

  • thickness_code (str | None) – Part-number thickness field. None uses the size’s standard maximum-thickness variant (5/8/C for 0402/0603/0805).

  • packaging (str | None) – Packaging-field code. None uses "C" (paper tape, 7” reel).

datasheet: str#
case: str#
dielectric: str#
tolerance: float#
voltage: int#
symbol: Symbol#
landpattern: Landpattern#
p1: Port#
p2: Port#
insert(pin_a, pin_b, *, short_trace=False)[source]#

Place this capacitor between two pins/nets of the active circuit.

Mirrors jitxlib.parts.Capacitor.insert(); see chip_smt.insert_two_pin().

Return type:

Self

Parameters:
Device#

alias of SamsungCL