المجموع

Sequential sum-reduce expression: المجموع من <tensor> عند [i] ثابت s { أعد <term> }.

Syntax: المجموع من <source> عند [coords] ثابت <binder> { أعد <term> }

Category#

collection

Related#

• prima
• ultima
• قائمة

Examples#

radix/corpus/lista/methodi-functionales.fab (canonical · existing-home)#

Returns the sum of numeric list elements.

# =============================================================================
# المجموع — Returns the sum of numeric list elements.
# =============================================================================
#
# What this teaches:
#   • higher-order intrinsics for lists — `filtrata` (filter), `mappata` (map), `اختزل` (fold), `cumulata` (cumulate)
#   • closure syntax with `∴` — inline anonymous functions for collection operations
#
# Common mistakes:
#   • Omitting the initial accumulator value in اختزل/cumulata — both require an explicit seed argument.
#
# See also: prima, ultima, قائمة
# =============================================================================

# قائمة<T> higher-order intrinsics
#
# res.filter(T x ∴ <pred>)                        -- filter
# res.map(T x ∴ <expr>)                         -- map
# res.reduce((acc, x) ∴ <expr>, init)              -- fold
# res.cumulata((acc, x) ∴ <expr>, init)             -- cumulate (serial prefix scan)
#
# GRAMMAR:
#   listMethod :← expr '.' ('filtrata' | 'mappata' | 'اختزل' | 'cumulata') '(' closure ')'
#
# EXPECTED OUTPUT:
#   [2, 4]
#   [2, 4, 6, 8, 10]
#   15
#   [1, 3, 6, 10, 15]
#
# BACKEND: Go e2e whitelist — قائمة intrinsic methods not yet lowered for Go
# (whitelist: قائمة/methodi-functionales.fab).

main {
    const list<int> res ← [1, 2, 3, 4, 5] ∷ list<int>
    const list<int> pares ← res.filter(int x ∴ x % 2 ≡ 0)
    const list<int> duplicata ← res.map(int x ∴ x * 2)
    const int المجموع ← res.reduce((int collectus, int x) ∴ collectus + x, 0)
    const list<int> cumulata ← res.cumulate((int collectus, int x) ∴ collectus + x, 0)
    print pares
    print duplicata
    print المجموع
    print cumulata
}

Expected output:

[2, 4]
[2, 4, 6, 8, 10]
15
[1, 3, 6, 10, 15]

radix/corpus/summa/summa.fab (canonical · concept)#

Sequential sum-reduce expression: المجموع من <tensor> عند [i] ثابت s { أعد <term> }.

# =============================================================================
# المجموع — one-expression sequential sum-reduce over a موتر
# =============================================================================
#
# What this teaches:
#   • Sequential fold — `المجموع من` lowers to a MIR fold over the موتر's
#     عند iteration arm: a `+` accumulator seeded at zero, one term per
#     element, `أعد` inside the body yields the term value.
#   • Identity term — `أعد s` is the sequential spelling of `a.summa()`;
#     the printed pair matches under the numeric tolerance contract.
#   • Transformed term — the body may compute any numeric scalar term from
#     the bound element (here `s + 1.0` per مسار).
#
# Common mistakes:
#   • non-scalar terms — the term must be a numeric scalar (كسر/numerus)
#   • the distributed `خيط` spelling is admitted only inside `@ نواة`
#     kernels (v1)
#
# See also: موتر, عند, خيط
# =============================================================================

دالة identity(موتر<f32, [8]> a) → f32 {
    أعد المجموع من a عند [i] ثابت s {
        أعد s
    }
}

دالة shifted(موتر<f32, [8]> a) → f32 {
    أعد المجموع من a عند [i] ثابت s {
        متغير f32 t ← s
        t ← t + 1.0
        أعد t
    }
}

بداية {
    ثابت قائمة<f32> flat ← [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0]
    ثابت tf32[] seed ← فارغ
    ثابت tf32[8] a ← seed.ابن_من_مسطح(flat, [8])
    ثابت f32 per_summam ← a.المجموع()
    ثابت f32 plicatum ← identity(a)
    ثابت f32 summam_totam ← shifted(a)
    اعرض per_summam
    اعرض plicatum
    اعرض summam_totam
}

Expected output:

36.0
36.0
44.0

radix/corpus/summa/summa-combine-refusal.fab (supporting · reject)#

General-combine refusal: المجموع admits no identity/combine clause — the combine is sum only, pinned by a parse reject.

# =============================================================================
# المجموع general-combine refusal — no identity/combine clause exists.
# =============================================================================
#
# Decline row (reject reason in the comment):
#   1. general combine — the اختزل ruling bars overloading `المجموع` with a
#      general combiner; there is no identity or combine clause in the
#      grammar. An attempted `coniunge` tail after the binder fails at
#      parse: the production expects the term block, never an operator
#
# Common mistakes:
#   • expecting `المجموع` to spell product/min/max reduces — the combine is
#     sum only; general reduce/scan heads belong to the rejection-review
#     sketch, and `اختزل`/`cumulata` own the intrinsic family
#
# See also: المجموع, خيط, عند, موتر
# =============================================================================

# 1. general combine — a combine-operator tail is not grammar; parse reject
دالة product(موتر<f32, [8]> a) → f32 {
    أعد المجموع من a عند [i] ثابت sconiunge '*' { أعد s }
}

Expected: compilation rejects this example.

radix/corpus/summa/summa-decline.fab (supporting · reject)#

المجموع decline rows: خيط placement outside @ نواة, K % 32 ≠ 0 tails, and non-scalar terms fail closed.

# =============================================================================
# المجموع decline — placement, tail alignment, and scalar terms fail closed.
# =============================================================================
#
# Decline rows (reject reason in each comment):
#   1. placement — `خيط` admits only inside an `@ نواة` kernel;
#      this host function declines: SEM010 summa_filum_requires_nucleum_kernel
#   2. tail — K = 8 is not a multiple of the 32-lane width; the v1 tail
#      gate fails closed at admission:
#      SEM010 summa_tail_not_aligned
#   3. non-scalar term — the term body returns a مصفوفة row (a موتر),
#      not a numeric scalar: SEM010 summa_term_type_non_scalar
#
# Common mistakes:
#   • expecting a partial-lane خيط fold — K % W ≠ 0 is an admission
#     error, never a tail loop
#   • expecting list/tensor terms to combine element-wise — the term type
#     must be a scalar of the element family
#
# See also: المجموع, خيط, نواة, عند, موتر
# =============================================================================

# 1. placement — خيط outside @ نواة declines
دالة placement(موتر<f32, [32]> a) → f32 {
    أعد المجموع من a عند [i] خيط f ثابت s { أعد s }
}

# 2. tail — K = 8 not aligned to the 32-lane width declines
@ نواة
@ عام
دالة tail(موتر<f32, [8]> a, tf32[1] out) → فراغ {
    ثابت f32 total ← المجموع من a عند [i] خيط f ثابت s { أعد s }
    out[0] ← total
}

# 3. non-scalar term — a نص element is not a numeric scalar
دالة non_scalar(موتر<نص, [8]> t) → نص {
    أعد المجموع من t عند [i] ثابت s { أعد s }
}

Expected: compilation rejects this example.