Skip to content

Commit 58ac24d

Browse files
authored
docs(science): sync bilingual merged/unreleased calculus status (#88)
* docs(science): accurately distinguish merged kernels from proposed cumulative integration * docs(science): accurately distinguish merged kernels from proposed cumulative integration
1 parent fea1f68 commit 58ac24d

2 files changed

Lines changed: 23 additions & 12 deletions

File tree

‎docs/hi/project/scientific-computing.md‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,10 @@ stable `softmax`, score ranking और विशेष loss-gradient kernels ह
1616
सामान्य native compiler, GPU tensors और पूरा automatic differentiation
1717
framework अभी नहीं बने हैं।
1818

19-
## नया विकास: sampled calculus
19+
## Source में उपलब्ध sampled calculus (अभी रिलीज़ नहीं हुआ)
2020

2121
[Compiler PR #153](https://github.com/scarp-lang/scarp/pull/153)
22-
में दो नए, typed और pure functions का प्रस्ताव एवं implementation है:
22+
प्रकाशित alpha.3 के बाद **main में merge हो चुका है**। इसमें दो typed और pure functions जोड़े गए:
2323

2424
| प्रस्तावित फ़ंक्शन | नतीजा | कार्य |
2525
| --- | --- | --- |
@@ -29,13 +29,19 @@ framework अभी नहीं बने हैं।
2929
**ये फ़ंक्शन प्रकाशित alpha.3 में उपलब्ध नहीं हैं।**
3030
किसी नए compatible compiler build के परीक्षण और आधिकारिक प्रकाशन
3131
के बाद ही इन्हें released APIs मानना चाहिए।
32-
[असली compiler branch का तकनीकी विवरण](https://github.com/scarp-lang/scarp/pull/153/files)
32+
[merged compiler के code और tests](https://github.com/scarp-lang/scarp/pull/153/files)
3333
देख सकते हैं।
3434

3535
दोनों inputs की लंबाई बराबर और कम-से-कम 2 होनी चाहिए। Coordinates
3636
strictly increasing होने चाहिए। ये numerical estimates हैं, symbolic
3737
differentiation या बिल्कुल सही गणितीय integration का दावा नहीं करते।
3838

39+
[Compiler PR #155](https://github.com/scarp-lang/scarp/pull/155) में
40+
`sample_cumulative_area(x, y) -> vector` पर काम हो रहा है। यह हर sample
41+
तक जमा हुआ integral देगा: पहला परिणाम शून्य और आख़िरी कुल integral होगा
42+
(जब परिणाम finite और representable हों)। **यह अभी विकास के चरण में है,
43+
प्रकाशित alpha.3 में उपलब्ध नहीं है।**
44+
3945
## आगे काम का सही क्रम
4046

4147
1. **सही गणित:** numerical errors, precision, resource budgets, regression tests और benchmarks।

‎docs/project/scientific-computing.md‎

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -13,26 +13,31 @@ Rust-hosted scalar subset; this is **not** general native executable compilation
1313
There is no GPU tensor backend, automatic differentiation engine or neural
1414
network training framework.
1515

16-
## Work in progress: sampled calculus
16+
## Source-only sampled calculus (unreleased)
1717

1818
[Compiler PR #153](https://github.com/scarp-lang/scarp/pull/153)
19-
proposes two typed pure kernels:
19+
was **merged into main** after the published alpha.3 release. It adds two typed pure kernels:
2020

2121
| Proposed call | Result | Purpose |
2222
| --- | --- | --- |
2323
| `sample_area(x, y)` | `float` | Integrate measurements using the composite trapezoidal rule |
2424
| `sample_slopes(x, y)` | `vector` | Estimate a secant derivative for each adjacent interval |
2525

26-
This PR is **not part of alpha.3**. Do not copy its examples into projects
27-
built against the published compiler until a verified compatible release
28-
is identified. The [compiler's detailed implementation and tests](https://github.com/scarp-lang/scarp/pull/153/files)
29-
are reviewable, but the development branch can change.
26+
These calls are **not part of the published alpha.3 artifacts**. Do not
27+
copy them into projects built against that published compiler until a newer,
28+
compatible release is verified. Source code and tests are available in the
29+
[merged compiler PR](https://github.com/scarp-lang/scarp/pull/153/files).
3030

3131
Both functions require equal-length finite-vector inputs with at least two
3232
entries and strictly increasing coordinates. They are not symbolic
33-
differentiation, spline fitting or exact integration. The branch checks
34-
numerical overflow, enforces bounded work and numerical output allocation,
35-
and uses finite binary64 arithmetic.
33+
differentiation, spline fitting or exact integration. The merged code checks numerical overflow, enforces bounded work and
34+
numerical output allocation, and uses finite binary64 arithmetic.
35+
36+
[Compiler PR #155](https://github.com/scarp-lang/scarp/pull/155) additionally
37+
proposes `sample_cumulative_area(x, y) -> vector`, a time-series prefix
38+
integration kernel with one result per input coordinate. Its first value is
39+
zero and its final value matches the full sampled integral for representable
40+
results. **PR #155 is development work, not an alpha.3 feature.**
3641

3742
## Architecture and dependency order
3843

0 commit comments

Comments
 (0)