# votetz/numcore-java architecture

> Architecture diagram of the GitHub repository votetz/numcore-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/votetz/numcore-java
- Repository: https://github.com/votetz/numcore-java

## Overview

This is a small Java numerical-computing toolkit with three runnable workflows: approximation/error analysis, cosine power-series evaluation, and tolerance-based number-series summation. Each app accepts or defines inputs, delegates calculations to its numeric implementation, and prints results. The series implementations expose interfaces; the cosine specialization supplies term-generation functions to a reusable functional-series evaluator. The graph reflects the supplied excerpts and index; no external services or persistent state are shown.

Main entry points: [`src/main/java/com/numcore/numeric/approxcomputations/App.java`](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/App.java) (Approximation App), [`src/main/java/com/numcore/numeric/approxcomputations/ApproximateComputation.java`](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/ApproximateComputation.java) (Approximation Contract), [`src/main/java/com/numcore/numeric/approxcomputations/RoundingEvaluator.java`](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/RoundingEvaluator.java) (Rounding Evaluator), [`src/main/java/com/numcore/numeric/approxcomputations/ErrorDerivation.java`](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/ErrorDerivation.java) (Error Derivation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_approx["Approximation Analysis"]
  node_approx_app["Approximation App<br/>[App.java]"]
  node_approx_contract["Approximation Contract"]
  node_rounding["Rounding Evaluator"]
  node_error["Error Derivation"]
  node_measurement["Measurement Comparator"]
  node_digits["Significant Digit Analyzer"]
end

subgraph group_power["Power Series"]
  node_cos_app["Cosine Series App<br/>[CosSeriesApp.java]"]
  node_cos_series["Cosine Series"]
  node_functional_impl["Functional Series Evaluator"]
  node_functional_contract["Functional Series Contract"]
end

subgraph group_sum["Series Summation"]
  node_sum_app["Series Sum App<br/>[SeriesSumApp.java]"]
  node_number_series_impl["Number Series Evaluator"]
  node_number_series_contract["Number Series Contract<br/>[NumberSeries.java]"]
end

node_user(("User"))

node_user -->|"runs"| node_approx_app
node_approx_app -->|"rounds and compares"| node_rounding
node_approx_app -->|"derives error"| node_error
node_approx_app -->|"compares measurements"| node_measurement
node_approx_app -->|"counts digits"| node_digits
node_rounding -->|"implements"| node_approx_contract
node_error -->|"implements"| node_approx_contract
node_measurement -->|"implements"| node_approx_contract
node_digits -->|"implements"| node_approx_contract
node_user -->|"provides inputs"| node_cos_app
node_cos_app -->|"evaluates cosine"| node_cos_series
node_cos_series -->|"extends"| node_functional_impl
node_functional_impl -->|"implements"| node_functional_contract
node_user -->|"provides tolerance"| node_sum_app
node_sum_app -->|"computes sum"| node_number_series_impl
node_number_series_impl -->|"implements"| node_number_series_contract

click node_approx_app "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/App.java"
click node_approx_contract "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/ApproximateComputation.java"
click node_rounding "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/RoundingEvaluator.java"
click node_error "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/ErrorDerivation.java"
click node_measurement "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/MeasurementComparator.java"
click node_digits "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/SignificantDigitAnalyzer.java"
click node_cos_app "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/CosSeriesApp.java"
click node_cos_series "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/CosFunctionalSeries.java"
click node_functional_impl "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/DefaultFunctionalSeries.java"
click node_functional_contract "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/FunctionalSeries.java"
click node_sum_app "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/series_sum/SeriesSumApp.java"
click node_number_series_impl "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/series_sum/DefaultNumberSeries.java"
click node_number_series_contract "https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/series_sum/NumberSeries.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_approx_app,node_approx_contract,node_rounding,node_error,node_measurement,node_digits,node_user toneBlue
class node_cos_app,node_cos_series,node_functional_impl,node_functional_contract toneAmber
class node_sum_app,node_number_series_impl,node_number_series_contract toneMint
```

## Components

### Approximation Analysis

- [Approximation App](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/App.java): `src/main/java/com/numcore/numeric/approxcomputations/App.java`
- [Approximation Contract](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/ApproximateComputation.java): `src/main/java/com/numcore/numeric/approxcomputations/ApproximateComputation.java`
- [Rounding Evaluator](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/RoundingEvaluator.java): `src/main/java/com/numcore/numeric/approxcomputations/RoundingEvaluator.java`
- [Error Derivation](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/ErrorDerivation.java): `src/main/java/com/numcore/numeric/approxcomputations/ErrorDerivation.java`
- [Measurement Comparator](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/MeasurementComparator.java): `src/main/java/com/numcore/numeric/approxcomputations/MeasurementComparator.java`
- [Significant Digit Analyzer](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/approxcomputations/SignificantDigitAnalyzer.java): `src/main/java/com/numcore/numeric/approxcomputations/SignificantDigitAnalyzer.java`

### Power Series

- [Cosine Series App](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/CosSeriesApp.java): `src/main/java/com/numcore/numeric/power_series/CosSeriesApp.java`
- [Cosine Series](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/CosFunctionalSeries.java): `src/main/java/com/numcore/numeric/power_series/CosFunctionalSeries.java`
- [Functional Series Evaluator](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/DefaultFunctionalSeries.java): `src/main/java/com/numcore/numeric/power_series/DefaultFunctionalSeries.java`
- [Functional Series Contract](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/power_series/FunctionalSeries.java): `src/main/java/com/numcore/numeric/power_series/FunctionalSeries.java`

### Series Summation

- [Series Sum App](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/series_sum/SeriesSumApp.java): `src/main/java/com/numcore/numeric/series_sum/SeriesSumApp.java`
- [Number Series Evaluator](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/series_sum/DefaultNumberSeries.java): `src/main/java/com/numcore/numeric/series_sum/DefaultNumberSeries.java`
- [Number Series Contract](https://github.com/votetz/numcore-java/blob/master/src/main/java/com/numcore/numeric/series_sum/NumberSeries.java): `src/main/java/com/numcore/numeric/series_sum/NumberSeries.java`

### Other components

- **User**

## Connections

- User → Approximation App: runs (evidence: `src/main/java/com/numcore/numeric/approxcomputations/App.java`)
- Approximation App → Rounding Evaluator: rounds and compares (evidence: `src/main/java/com/numcore/numeric/approxcomputations/App.java`)
- Approximation App → Error Derivation: derives error (evidence: `src/main/java/com/numcore/numeric/approxcomputations/App.java`)
- Approximation App → Measurement Comparator: compares measurements (evidence: `src/main/java/com/numcore/numeric/approxcomputations/App.java`)
- Approximation App → Significant Digit Analyzer: counts digits (evidence: `src/main/java/com/numcore/numeric/approxcomputations/App.java`)
- Rounding Evaluator → Approximation Contract: implements (evidence: `src/main/java/com/numcore/numeric/approxcomputations/RoundingEvaluator.java`)
- Error Derivation → Approximation Contract: implements (evidence: `src/main/java/com/numcore/numeric/approxcomputations/ErrorDerivation.java`)
- Measurement Comparator → Approximation Contract: implements (evidence: `src/main/java/com/numcore/numeric/approxcomputations/MeasurementComparator.java`)
- Significant Digit Analyzer → Approximation Contract: implements (evidence: `src/main/java/com/numcore/numeric/approxcomputations/SignificantDigitAnalyzer.java`)
- User → Cosine Series App: provides inputs (evidence: `src/main/java/com/numcore/numeric/power_series/CosSeriesApp.java`)
- Cosine Series App → Cosine Series: evaluates cosine (evidence: `src/main/java/com/numcore/numeric/power_series/CosSeriesApp.java`)
- Cosine Series → Functional Series Evaluator: extends (evidence: `src/main/java/com/numcore/numeric/power_series/CosFunctionalSeries.java`)
- Functional Series Evaluator → Functional Series Contract: implements (evidence: `src/main/java/com/numcore/numeric/power_series/DefaultFunctionalSeries.java`)
- User → Series Sum App: provides tolerance (evidence: `src/main/java/com/numcore/numeric/series_sum/SeriesSumApp.java`)
- Series Sum App → Number Series Evaluator: computes sum (evidence: `src/main/java/com/numcore/numeric/series_sum/SeriesSumApp.java`)
- Number Series Evaluator → Number Series Contract: implements (evidence: `src/main/java/com/numcore/numeric/series_sum/DefaultNumberSeries.java`)
