Add matrix module: addition, multiplication, transpose, spiral and rotation programs, dry-run traces, operation counts, seeded law checks, six pitfalls (10 tests)
Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_017ic4b4pD5LRLNWAecBNsj9
This commit is contained in:
co-authored by
Claude Sonnet 5.5
parent
26ece9cc9b
commit
35ef0872de
@@ -0,0 +1,58 @@
|
||||
# matrix
|
||||
|
||||
Companion code for the ankurm.com article **Matrix Programs in Java: Addition, Multiplication, Transpose, Spiral and Rotation**.
|
||||
|
||||
The five classic lab programs on `int[][]`, each cross-checked with algebraic laws on seeded random
|
||||
matrices. Every figure and console line in the article is quoted from a file in `output/`, which the JUnit
|
||||
tests write while asserting the same numbers. There is no `docs/` folder: the explanations live in the
|
||||
article itself.
|
||||
|
||||
## Versions
|
||||
|
||||
| Component | Version | Verified against |
|
||||
|---|---|---|
|
||||
| JDK | Temurin 25.0.5+8 (LTS) | `java -version` |
|
||||
| JUnit | 6.1.3 | `junit-bom` `maven-metadata.xml` on Maven Central (latest GA) |
|
||||
| Maven | 3.9.x | `mvn -version` |
|
||||
|
||||
## Quickstart
|
||||
|
||||
```bash
|
||||
cd matrix
|
||||
export JAVA_HOME=/path/to/jdk-25 PATH="$JAVA_HOME/bin:$PATH"
|
||||
./scripts/run-all.sh # runs the tests and regenerates output/*.txt
|
||||
```
|
||||
|
||||
The first Maven run must be online so the plugins land in the local cache.
|
||||
|
||||
## Source layout
|
||||
|
||||
```
|
||||
matrix/
|
||||
├── pom.xml
|
||||
├── scripts/run-all.sh
|
||||
├── src/main/java/com/ankurm/interviewlab/matrix/
|
||||
│ ├── MatrixBasics.java add, subtract, multiply (i-j-k and i-k-j), multiplyExact, identity, copyOf, format
|
||||
│ ├── Transpose.java transpose (any shape), transposeInPlace (square), isSymmetric
|
||||
│ ├── Spiral.java spiralOrder, spiralMatrix
|
||||
│ ├── Rotation.java clockwise, counter-clockwise, 180, in-place (transpose + reverse, layer swaps)
|
||||
│ ├── DryRuns.java instrumented copies that record every step
|
||||
│ ├── Complexity.java operation counters (counted, not timed)
|
||||
│ └── Pitfalls.java six plausible-looking wrong versions
|
||||
├── src/test/java/.../ SolutionsTest, DryRunTest, ComplexityTest, RandomAgreementTest, PitfallsTest
|
||||
└── output/*.txt captured real output
|
||||
```
|
||||
|
||||
## Captured output
|
||||
|
||||
| File | What it shows |
|
||||
|---|---|
|
||||
| `01-addition-and-multiplication.txt` | sum, product, shape-mismatch and jagged-row errors |
|
||||
| `02-multiply-dry-run.txt` | the four steps that build one cell of a product |
|
||||
| `03-transpose.txt` | rectangular transpose, in-place square transpose, symmetric check |
|
||||
| `04-spiral-trace.txt`, `04a-spiral-results.txt` | boundary trace of a 3x4 spiral, edge shapes, `spiralMatrix(4)` |
|
||||
| `05-rotation.txt` | clockwise, counter-clockwise, 180, both in-place methods, a rectangular rotation |
|
||||
| `06-layer-rotation-trace.txt` | each four-cell move of the layer rotation on 3x3 |
|
||||
| `07-random-agreement.txt` | nine laws, 2,000 seeded trials each |
|
||||
| `08-operation-counts.txt` | multiplications, swaps, moves and visits |
|
||||
| `09-pitfalls.txt` | six classic mistakes reproduced |
|
||||
Reference in New Issue
Block a user