@zushah/chalkboard 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -1,6 +1,70 @@
 # Chalkboard changelog
 All notable changes of every update of the Chalkboard library are recorded in this file.
 
+## [v2.3.0 Boole](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.3.0) - 04/14/2025
+The thirteenth release of the Chalkboard library.
+Commits: [`v2.2.0...v2.3.0`](https://www.github.com/Zushah/Chalkboard/compare/v2.2.0...v2.3.0)
+- Added `I` which calculates the number i
+- Added boolean algebra functionalities with the new `bool` category containing 23 commands, which are mentioned below
+- Added `bool.AND`, `bool.OR`, `bool.XOR`, `bool.COND`, `bool.CONV`, `bool.BICOND`, `bool.NOT`, `bool.NAND`, `bool.NOR`, `bool.NCOND`, `bool.NCONV`, and `bool.NBICOND` which are boolean operations that act on two or more values
+- Added `bool.parse` which evaluates or simplifies a boolean expression, `bool.minimize` which minimizes a boolean expression, and `bool.isEqual` which checks if two boolean expressions are logically equivalent
+- Added `bool.truthTable` which calculates the truth table for one or more boolean operators
+- Added `bool.Karnaugh` which defines the Karnaugh map (or K-map) for a boolean expression and `bool.mapping` which defines a function that maps inputs to outputs based on truth tables
+- Added `bool.primeImplicants` which calculates the prime implicants of a boolean expression using its Karnaugh map
+- Added `bool.toCNF` which converts a boolean expression to conjunctive normal form and `bool.toDNF` which converts a boolean expression to disjunctive normal form
+- Added `bool.modeConfig` which can change the mode of the `bool` commands to output either `1`/`0` (which is `"binary"` mode) or `true`/`false` (which is `"boolean"` mode)
+- Added `numb.toBinary`, `numb.toHexadecimal`, and `numb.toOctal` which convert numbers from decimal representation to binary, hexadecimal, or octal representations
+- Added `numb.toDecimal` which converts a number from another representation back to decimal representation
+- Added `real.absolute`, `real.add`, `real.compose`, `real.div`, `real.mul`, `real.negate`, `real.pow` `real.reciprocate`, `real.scl`, `real.sub`, and `real.translate` which calculate the absolute value of a function, the addition of two functions, the composition of two functions, the division of two functions, the multiplication of two functions, the negation of a function, the exponentation of a function, the reciprocation of a function, the scalar multiplication of a function, the subtraction of two functions, and the translation of a function, respectively
+- Added `real.polynomial` which defines a polynomial function based on inputted coefficients, and added `real.randomPolynomial` which defines a polynomial of a specified degree with random coefficients
+- Changed `real.define` to be written more efficiently
+- Changed `stat.random` to have its first parameter be the length of the array instead of the last
+- Fixed `comp.pow`, `matr.norm`, `matr.normsq`, `plot.definition`, and `stat.regression` which were throwing type errors because of the updated `real.pow` function which can now handle not only numbers but also functions
+- Fixed `comp.zero`, `quat.zero`, and `vect.zero` which were unnecessarily using erasing operations
+
+## [v2.2.0 Galois](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.2.0) - 04/07/2025
+The twelfth release of the Chalkboard library.
+Commits: [`v2.1.0...v2.2.0`](https://www.github.com/Zushah/Chalkboard/compare/v2.1.0...v2.2.0)
+- Added abstract algebra functionalities with the new `abal` category containing 76 commands, so only a few notable ones are mentioned below
+- Added `abal.set` which defines a mathematical set, as well as `abal.Z` which defines the set of integers or the set of integers modulo n, `abal.Q` which defines the set of rational numbers, `abal.R` which defines the set of real numbers, and `abal.C` which defines the set of complex numbers or the set of nth roots of unity
+- Added `abal.union`, `abal.intersection`, `abal.complement`, `abal.difference`, `abal.symmetricDifference`, `abal.Cartesian`, `abal.powerSet`, `abal.isSubset`, and `abal.isSuperset` which respectively calculate the union of two sets, the intersection of two sets, the complement of a set, the difference of two sets, the symmetric difference of two sets, the Cartesian product of two sets, the power set of a set, whether or not a set is a subset of another set, and whether or not a set is a superset of another set
+- Added `abal.group`, `abal.ring`, and `abal.field` which define the algebraic structures known as groups, rings, and fields
+- Added `abal.direct` which calculates the direct sum or direct product of two algebraic structures
+- Added `abal.cosets` and `abal.quotient` which respectively calculate the cosets or quotient structure of two inputted algebraic structures
+- Added `abal.homomorphism`, `abal.endomorphism`, `abal.isomorphism`, `abal.automorphism`, `abal.idmorphism`, and `abal.invmorphism` which define various types of morphisms between one or two algebraic structures
+- Added `abal.compose` which calculates the composition morphism of two given morphisms
+- Added `abal.image`, `abal.preimage`, and `abal.kernel` which respectively calculate the image, preimage, or kernel of a given morphism
+- Added `abal.cardinality` which calculates the cardinality of a set or the set of a structure
+- Added `abal.isEqual` which checks if two sets, structures, or morphisms are equal
+- Added `abal.copy` which creates a copy of a set, structure, or morphism
+- Added `abal.toArray`, `abal.toMatrix`, `abal.toObject`, `abal.toString`, `abal.toTensor`, and `abal.toVector` which convert sets or structures to arrays, matricies, objects, strings, tensors, or vectors, and `abal.print` prints a set or structure in the console
+- Added `stat.Bayes` which calculates the posterior probability given prior probabilities
+- Added `stat.expected` which calculates the expected value of an array given the probabilities of its elements
+- Added `stat.normal` and `stat.inormal` which respectively calculate the values of the standard normal distribution and cumulative distribution function of the standard normal distribution
+- Added `stat.resampling` which resamples an array either by the bootstrap or jackknife methods
+- Added `stat.interpolate` which linearly or quadratically interpolates missing elements in an array
+- Added `stat.absolute` which takes the absolute value of the elements of an array, `stat.negate` which negates the elements of an array, `stat.add` which adds the elements of two arrays, `stat.sub` which subtracts the elements of two arrays, `stat.dot` which calculates the dot product of two arrays, `stat.scl` which scales the elements of an array by a given number, `stat.sum` which calculates the sum of the elements of an array, `stat.mul` which calculates the product of the elements of an array, and `stat.reverse` which reverses the elements of an array
+- Added `stat.cumsum`, `stat.cummul`, `stat.cummax`, and `stat.cummin` which respectively calculate the cumululative sum, product, maximum, and minimum of an array
+- Added `stat.meanMoving` and `stat.meanWeighted` which respectively calculate the moving and weighted averages of an array
+- Added `stat.covariance` which calculates the covariance of two arrays and `stat.correlationCoefficient` which calculates the correlation coefficient of two arrays
+- Added `stat.interquartileRange` which calculates the interquartile range of an array
+- Added `stat.zscored` which standardizes the elements of an array by their mean and standard deviation
+- Added `stat.pad` which pads an array by a given element to a given length
+- Added `stat.unique` which deduplicates an array of numbers, arrays, objects, etc.
+- Added `matr.toSet`, `stat.toSet` and `tens.toSet` to convert matrices, arrays, and tensors to sets
+- Added `numb.toFraction` to convert decimals to fractions and `numb.isRational` to check if a number is rational
+- Changed `APPLY` to work for sets and algebraic structures introduced in the `abal` category
+- Changed `stat.change` and `stat.chiSquared` to be written more succinctly
+- Changed `stat.confidenceInterval` to use an adjustable confidence level
+- Changed `stat.toMatrix` to be able to use only one parameter for the size of the matrix instead of requiring two
+- Changed `matr.rotator` to be faster
+- Changed `comp.toString` to output 1, i, -1, or -i when 1+0i, 0+1i, -1+0i, or 0-1i are inputted
+- Fixed `comp.div` which was broken for who knows how long because it was using the wrong formula for some reason
+- Fixed `matr.resize` which was always returning zero matrices
+- Fixed `matr.zero` which was unnecessarily using erasing operations
+- Fixed `tens.init` which had an expression assigned to itself
+- Fixed `geom.rectangularprismA` thanks to @gyang0's contribution [here](https://github.com/Zushah/Chalkboard/pull/5)
+
 ## [v2.1.0 Seki](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.1.0) - 01/22/2024
 The eleventh release of the Chalkboard library.
 Commits: [`v2.0.0...v2.1.0`](https://www.github.com/Zushah/Chalkboard/compare/v2.0.0...v2.1.0)
@@ -42,7 +106,7 @@ Commits: [`v1.7.0...v2.0.0`](https://www.github.com/Zushah/Chalkboard/compare/v1
 - Changed `real.function` to be renamed as `real.define`, `comp.function` to be renamed as `comp.define`, and `plot.function` to be renamed as `plot.definition`
 - Changed `LOGO` to draw the logo as a circle instead of a square
 - Changed `matr.mulvec` to be renamed as `matr.mulVector`
-- Fixed `matr.mulVector`` which didn't work when the rows of the matrix equaled the dimension of the vector
+- Fixed `matr.mulVector` which didn't work when the rows of the matrix equaled the dimension of the vector
 - Discontinued the Processsing.js edition of the library, meaning it will no longer be updated and it will only be available on the Khan Academy release (it will no longer be available on GitHub)
 
 ## [v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0) - 01/01/2024
@@ -206,4 +270,4 @@ Commits: [`v1.0.0...v1.1.0`](https://www.github.com/Zushah/Chalkboard/compare/v1
 
 ## [v1.0.0 Euclid](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.0.0) - 11/06/2023
 The first release of the Chalkboard library.
-Commits: [`v1.0.0...main`](https://www.github.com/Zushah/Chalkboard/compare/v1.0.0...main)
+Commits: [`v1.0.0...main`](https://www.github.com/Zushah/Chalkboard/compare/v1.0.0...main)

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2024 Zushah
+Copyright (c) 2023-2025 Zushah
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,11 +1,11 @@
 <p align="center"><a href="https://www.github.com/Zushah/Chalkboard"><img src="https://raw.githubusercontent.com/Zushah/Chalkboard/main/assets/Chalkboard-logo.png" width="50%"></a></p>
 <p align="center">
-    <a href="https://www.github.com/Zushah/Chalkboard/releases/tag/v2.1.0"><img src="https://img.shields.io/badge/release-v2.1.0_Seki-blueviolet?logo=github&logoColor=white" alt="Latest release"></a>
-    <a href="https://www.codefactor.io/repository/github/zushah/chalkboard"><img src="https://img.shields.io/codefactor/grade/github/Zushah/Chalkboard?color=blue&logo=codefactor&logoColor=white" alt="CodeFactor grade"></a>
-    <a href="https://bundlephobia.com/package/@zushah/chalkboard@2.1.0"><img src="https://img.shields.io/bundlephobia/min/%40zushah/chalkboard?color=darkgreen&logo=files&logoColor=white" alt="Minified size"></a>
+    <a href="https://www.github.com/Zushah/Chalkboard/releases/tag/v2.3.0"><img src="https://img.shields.io/badge/release-v2.3.0_Boole-blueviolet?logo=github&logoColor=white" alt="Latest release"></a>
+    <a href="https://www.github.com/microsoft/TypeScript"><img src="https://img.shields.io/github/languages/top/Zushah/Chalkboard?color=blue&logo=typescript&logoColor=white" alt="Written in TypeScript"></a>
+    <a href="https://www.codefactor.io/repository/github/zushah/chalkboard"><img src="https://img.shields.io/codefactor/grade/github/Zushah/Chalkboard?color=darkgreen&logo=codefactor&logoColor=white" alt="CodeFactor grade"></a>
     <a href="https://www.npmjs.com/package/@zushah/chalkboard"><img src="https://img.shields.io/npm/dm/%40zushah/chalkboard?logo=npm&logoColor=white" alt="npm downloads"></a>
     <a href="https://www.github.com/Zushah/Chalkboard/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/Zushah/Chalkboard?color=yellow&logo=opensourceinitiative&logoColor=white" alt="MIT License"></a>
-    <a href="https://en.wikipedia.org/wiki/TypeScript"><img src="https://img.shields.io/github/languages/top/Zushah/Chalkboard?color=orange&logo=typescript&logoColor=white" alt="Written in TypeScript"></a>
+    <a href="https://bundlephobia.com/package/@zushah/chalkboard@2.3.0"><img src="https://img.shields.io/bundlephobia/min/%40zushah/chalkboard?color=orange&logo=files&logoColor=white" alt="Minified size"></a>
     <a href="https://www.jsdelivr.com/package/gh/Zushah/Chalkboard"><img src="https://img.shields.io/jsdelivr/gh/hm/Zushah/Chalkboard?color=crimson&logo=jsdelivr&logoColor=white" alt="jsDelivr requests"></a> 
     <br>
     <a href="https://zushah.github.io/Chalkboard">https://zushah.github.io/Chalkboard</a>
@@ -23,28 +23,30 @@
 </ol>
 
 # About
-The Chalkboard library is a JavaScript namespace that provides a plethora of both practical and abstract mathematical functionalities for its user. It was developed by [Zushah](https://www.github.com/Zushah) during 2022 and 2023 and then [released](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.0.0) on November 6, 2023. As per the latest release of [v2.1.0 Seki](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.1.0), Chalkboard has 455 different commands. The library is available for regular JavaScript on both the client-side and the server-side as well as [Proccesing.js](https://www.processing.org/) (fully compatible with [Khan Academy](https://www.khanacademy.org/cs/chalkboard/6708642430369792)). Chalkboard's website can be visited [here](https://zushah.github.io/Chalkboard).
+The Chalkboard library is a JavaScript namespace that provides a plethora of both practical and abstract mathematical functionalities for its user. It was developed by [Zushah](https://www.github.com/Zushah) during 2022 and 2023 and then [released](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.0.0) on November 6, 2023. As per the latest release of [v2.3.0 Boole](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.3.0), Chalkboard has 605 unique commands. The library is available for regular JavaScript on both the client-side and the server-side as well as [Proccesing.js](https://www.processing.org/) (fully compatible with [Khan Academy](https://www.khanacademy.org/cs/chalkboard/6708642430369792)). Chalkboard's website can be visited [here](https://zushah.github.io/Chalkboard).
 
 # Installation
 If your JavaScript project is being run on the client-side within a webpage, you can install Chalkboard with this HTML tag:
 ```html
-<script src="https://cdn.jsdelivr.net/gh/Zushah/Chalkboard@2.1.0/dist/Chalkboard.min.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/Zushah/Chalkboard@2.3.0/dist/Chalkboard.min.js"></script>
 ```
 If your JavaScript project is being run on the server-side within the [Node.js](https://nodejs.org/en) environment, you can install Chalkboard with this console command:
 ```bash
 npm install @zushah/chalkboard
 ```
-Alternatively, you can simply download the [latest release](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.1.0) and put the relevant files in your project's directory.
+Alternatively, you can simply download the [latest release](https://www.github.com/Zushah/Chalkboard/releases/tag/v2.3.0) and put the relevant files in your project's directory.
 
 Chalkboard can also be downloaded on [Khan Academy](https://www.khanacademy.org) from the code in the corresponding [release](https://www.khanacademy.org/cs/chalkboard/6708642430369792).
 
 # Documentation
-Chalkboard has twelve categories of commands:
+Chalkboard has fourteen categories of commands:
+- `abal` - Abstract algebra definitions, sets, operations, structures, and morphisms
+- `bool` - Boolean algebra operations
 - `calc` - Single/multi-variable real/complex-valued calculus operations
 - `comp` - Complex number and complex function operations
 - `geom` - Geometric operations
 - `matr` - Multidimensional matrix operations
-- `numb` - Number-theory-related operations
+- `numb` - Number-theoretic operations
 - `plot` - Plotting real and complex functions, complex numbers, vectors, matrices, and statistical graphs
 - `quat` - Quaternion operations
 - `real` - Real number and real function operations
@@ -53,10 +55,11 @@ Chalkboard has twelve categories of commands:
 - `trig` - Trigonometric function operations
 - `vect` - Two-, three-, and four-dimensional vector and vector field operations
 
-There are also eight "global" commands and constants, which are:
+There are also nine "global" commands and constants, which are:
 - `APPLY` - Applies a callback function in an element-wise manner on a Chalkboard object
 - `CONTEXT` - The JavaScript canvas rendering context to use for plotting
 - `E()` - Computes the number e
+- `I()` - Computes the number i
 - `LOGO()` - Draws the Chalkboard logo
 - `PARSEPREFIX` - Used for adding custom functions to the Chalkboard parser
 - `PI()` - Computes the number π
@@ -64,11 +67,15 @@ There are also eight "global" commands and constants, which are:
 - `VERSION` - The installed version of Chalkboard
 - `VERSIONALIAS` - The alias of the installed version of Chalkboard
 
-Lastly, Chalkboard has seven data types (also known as Chalkboard objects):
+Lastly, Chalkboard has eleven data types (also known as Chalkboard objects):
 - `ChalkboardComplex` - Complex numbers
 - `ChalkboardFunction` - Mathematical functions
 - `ChalkboardMatrix` - Matrices
+- `ChalkboardMorphism` - Morphisms
 - `ChalkboardQuaternion` - Quaternions
+- `ChalkboardSet` - Sets
+- `ChalkboardStructure` - Algebraic structures
+- `ChalkboardStructureExtension` - Algebraic structure extensions
 - `ChalkboardTensor` - Tensors
 - `ChalkboardVector` - Vectors
 - `ChalkboardVectorField` - Vector fields
@@ -83,51 +90,49 @@ Chalkboard.category.command(parameters);
 Here is some code that shows off only a few features of Chalkboard:
 ```js
 const cb = Chalkboard; // Initialize in a browser
-// or
 const cb = require("@zushah/chalkboard"); // Initialize in Node with CommonJS
-// or
 import cb from "@zushah/chalkboard"; // Initiialize in Node with ES Modules
 
-let f = cb.real.define("Math.cos(2 * x)"); // f(x) = cos(2x)
-let dfdx = cb.calc.dfdx(f, 2); // Derivative of f at x = 0
-let fxdx = cb.calc.fxdx(f, 0, 2); // Antiderivative of f from x = 0 to x = 2
-let fourier = cb.calc.Fourier(f, 2); // Fourier transform of f at x = 2
+const f = cb.real.define("Math.cos(2 * x)"); // f(x) = cos(2x)
+const dfdx = cb.calc.dfdx(f, 2); // Derivative of f at x = 0
+const fxdx = cb.calc.fxdx(f, 0, 2); // Antiderivative of f from x = 0 to x = 2
+const fourier = cb.calc.Fourier(f, 2); // Fourier transform of f at x = 2
 
-let f = cb.vect.field("x", "y", "z"); // f(x, y, z) = (x, y, z)
-let r = cb.real.define(["Math.cos(s) * Math.cos(t)", "Math.sin(s) * Math.cos(t)", "Math.sin(t)"], "surf"); // r(s, t) = (cos(s)cos(t), sin(s)cos(t), sin(t))
-let fnds = cb.calc.fnds(f, r, cb.PI(-1/2), cb.PI(1/2), 0, cb.PI(2)); // Flux of the radial vector field through the unit sphere
+const f = cb.vect.field("x", "y", "z"); // f(x, y, z) = (x, y, z)
+const r = cb.real.define(["Math.cos(s) * Math.cos(t)", "Math.sin(s) * Math.cos(t)", "Math.sin(t)"], "surf"); // r(s, t) = (cos(s)cos(t), sin(s)cos(t), sin(t))
+const fnds = cb.calc.fnds(f, r, cb.PI(-1/2), cb.PI(1/2), 0, cb.PI(2)); // Flux of the radial vector field through the unit sphere
 
-let primes = cb.numb.primeArr(0, 100); // Array of prime numbers between 0 and 100
-let midPrime = cb.stat.median(primes); // Median number in the primes array
+const primes = cb.numb.primeArr(0, 100); // Array of prime numbers between 0 and 100
+const midPrime = cb.stat.median(primes); // Median number in the primes array
 cb.plot.barplot(primes, cb.stat.array(0, 100, 11), {size: 5, strokeStyle: "black", fillStyle: "blue"}); // Barplot of the primes array with a bin size of 10, a scale of 2, a stroke color of black, and a fill color of blue
 
-let z = cb.comp.init(1, 1); // z = 1 + i
-let zsqsqrt = cb.comp.sqrt(cb.comp.sq(z)); // The square root of z squared equals z
-let f = cb.comp.define("a*a - b*b + 1", "2*a*b"); // f(z) = z^2 + 1
+const z = cb.comp.init(1, 1); // z = 1 + i
+const zsqsqrt = cb.comp.sqrt(cb.comp.sq(z)); // The square root of z squared equals z
+const f = cb.comp.define("a*a - b*b + 1", "2*a*b"); // f(z) = z^2 + 1
 cb.plot.definition(f); // Plots the domain coloring of f
 
-let r = cb.real.define(["Math.cos(t)", "Math.sin(t)"], "curv"); // r(t) = (cos(t), sin(t))
+const r = cb.real.define(["Math.cos(t)", "Math.sin(t)"], "curv"); // r(t) = (cos(t), sin(t))
 cb.plot.xyplane({size: 2}); // Draws the Cartesian coordinate plane scaled by 2
 cb.plot.definition(r, {size: 2, strokeStyle: "rgb(255, 100, 100)", domain: [0, cb.PI(2)]}); // Plots r(t) scaled by 2 colored light red from t = 0 to t = π/2
 
-let a = cb.vect.init(1, 2, 3); // Vector a = (1, 2, 3)
-let b = cb.vect.init(4, 5, 6); // Vector b = (4, 5, 6)
-let c = cb.vect.init(7, 8, 9); // Vector c = (7, 8, 9)
-let axbxc = cb.vect.vectorTriple(a, b, c); // Triple cross product between a, b, and c
+const a = cb.vect.init(1, 2, 3); // Vector a = (1, 2, 3)
+const b = cb.vect.init(4, 5, 6); // Vector b = (4, 5, 6)
+const c = cb.vect.init(7, 8, 9); // Vector c = (7, 8, 9)
+const axbxc = cb.vect.vectorTriple(a, b, c); // Triple cross product between a, b, and c
 cb.vect.print(axbxc); // Prints axbxc in the console
 
-let m = cb.matr.init( // m is a 5x5 matrix
+const m = cb.matr.init( // m is a 5x5 matrix
     [0, 1, 1, 1, 1],
     [1, 0, 1, 1, 1],
     [1, 1, 0, 1, 1],
     [1, 1, 1, 0, 1],
     [1, 1, 1, 1, 0]
 );
-let mi = cb.matr.invert(m); // mi is the inverse of m
-let mmi = cb.matr.mul(m, mi); // mmi is the product of m and mi
+const mi = cb.matr.invert(m); // mi is the inverse of m
+const mmi = cb.matr.mul(m, mi); // mmi is the product of m and mi
 cb.matr.print(mmi); // Prints mmi in the console
 
-let t = cb.tens.init( // t is a 2x2x2 rank-3 tensor
+const t = cb.tens.init( // t is a 2x2x2 rank-3 tensor
     [
         [1, 2],
         [3, 4]
@@ -137,21 +142,23 @@ let t = cb.tens.init( // t is a 2x2x2 rank-3 tensor
         [7, 8]
     ]
 );
-let tt = cb.tens.mul(t, t); // tt is a 2x2x2x2x2x2 rank-6 tensor
-let ttm = cb.tens.resize(tt, 8, 8); // ttm is an 8x8 matrix (or rank-2 tensor)
+const tt = cb.tens.mul(t, t); // tt is a 2x2x2x2x2x2 rank-6 tensor
+const ttm = cb.tens.resize(tt, 8, 8); // ttm is an 8x8 matrix (or rank-2 tensor)
 cb.tens.print(tt); // Prints tt in the console just to see what it looks like for fun
+const factorialt = cb.APPLY(t, (x) => cb.numb.factorial(x)); // Calculates the factorial of each element of t
 
-// Calculates the factorial of each element of t
-let factorialt = cb.APPLY(t, (x) => {
-    return cb.numb.factorial(x);
-});
+const Z4 = cb.abal.Z(4); // The set of integers modulo 4 is the set {0, 1, 2, 3}
+const C4 = cb.abal.C(4); // The set of fourth roots of unity is the set {1, i, -1, -i}
+const G = cb.abal.group(Z4, (a, b) => (a + b) % 4); // The group G is the set Z₄ with mod 4 addition
+const H = cb.abal.group(C4, (z, w) => cb.comp.mul(z, w)); // The group H is the set C₄ with complex multiplication
+const F = cb.abal.isomorphism(G, H, (n) => cb.comp.round(cb.comp.pow(cb.comp.init(0, 1), n))); // The isomorphism F: G → H is defined by F(n) = iⁿ for all n in Z₄
 ```
-More examples that are more interesting can be seen [here](https://zushah.github.io/Chalkboard/examples/index.html) with their source code [here](https://www.github.com/Zushah/Chalkboard/tree/main/examples).
+Several examples that are rather interesting can be seen [here](https://zushah.github.io/Chalkboard/examples/index.html), and their source code is [here](https://www.github.com/Zushah/Chalkboard/tree/main/examples).
 
 # Contributing
 <ol>
     <li>Fork Chalkboard's GitHub repository. Make sure the fork is based on the main branch.</li>
-    <li>Clone the repository, download the dependencies with `npm install`, and then make your contributions to your fork.</li>
+    <li>Clone the repository, download the dev dependencies with `npm install`, and then make your contributions to your fork.</li>
     <li>When you're done, commit the changes to your fork with a detailed description.</li>
     <li>Open a pull request. It will be reviewed soon and then merged to the main branch.</li>
 </ol>
@@ -163,9 +170,9 @@ The changelog can be read [here](https://www.github.com/Zushah/Chalkboard/blob/m
 The Chalkboard library is available under the [MIT License](https://www.github.com/Zushah/Chalkboard/blob/main/LICENSE.md).
 
 # Acknowledgments
-Thanks to [@bhavjitChauhan](https://www.github.com/bhavjitChauhan) for his [contribution](https://www.github.com/Zushah/Chalkboard/pull/1) to [v1.3.0 Heaviside](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.0).\
-Thanks to [@gyang0](https://www.github.com/gyang0) for his [contribution](https://www.github.com/Zushah/zushah.github.io/pull/1) to the [documentation](https://www.github.com/Zushah/zushah.github.io/tree/main/Chalkboard).\
-Thanks to [@JentGent](https://www.github.com/JentGent) for his [implementation](https://www.github.com/JentGent/linalg/blob/main/linalg.js#L519) for calculating QR decomposition which was [adapted](https://www.github.com/Zushah/Chalkboard/commit/1dce0dbac82b38f9a550dd496bc878c402a92442) into [v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0).
+Thanks to [@bhavjitChauhan](https://www.github.com/bhavjitChauhan) for his contribution ([here](https://www.github.com/Zushah/Chalkboard/pull/1)) to [v1.3.0 Heaviside](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.0).\
+Thanks to [@gyang0](https://www.github.com/gyang0) for his contributions ([here](https://www.github.com/Zushah/zushah.github.io/pull/1) and [here](https://github.com/Zushah/Chalkboard/pull/5)) to the [documentation](https://www.github.com/Zushah/zushah.github.io/tree/main/Chalkboard).\
+Thanks to [@JentGent](https://www.github.com/JentGent) for his implementation ([here](https://www.github.com/JentGent/linalg/blob/main/linalg.js#L519)) for calculating QR decomposition which was [adapted](https://www.github.com/Zushah/Chalkboard/commit/1dce0dbac82b38f9a550dd496bc878c402a92442) into [v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0).
 
 # Contact
 [GitHub](https://www.github.com/Zushah)\