NumClass – a Python CLI classifying integers into 200 number-theory properties
github.com
github.com
For the past few months I’ve been building a personal project called NumClass: a Python CLI tool that analyzes an integer and classifies it into a large set of number-theory properties.
The idea started as a small experiment inspired by the YouTube channel Numberphile, but it quickly got out of hand and now supports 200+ classifiers.
Examples of things it can detect:
• perfect / abundant / weird numbers • Mersenne primes and primorial numbers • amicable, sociable and aspiring numbers (aliquot sequences) • Carmichael numbers and other pseudoprimes • narcissistic, Kaprekar and happy numbers • palindromic and truncatable primes • taxicab numbers (Hardy–Ramanujan style cube sums) • Fibonacci, Lucas, Pell and Padovan numbers • triangular, pentagonal and other figurate numbers • strange curiosities like Belphegor’s prime, vampire numbers and Munchausen numbers
The current version contains 205 atomic classifiers plus 27 intersections (232 properties in total).
Example output: [screenshot]
Some features:
• 200+ classifiers • extensible plugin-like architecture • configurable profiles (fast vs heavy computations) • OEIS sequence integration • support for very large integers (100000 digits by default) • explanations for each classification
The project is open source:
https://github.com/c788630/Numclass
I’m now looking for people who would like to test it, especially:
• mathematicians • Python developers • people interested in number theory • anyone who likes exploring interesting integer properties
If you decide to try it out, I would really appreciate feedback on:
• usability of the CLI • additional number-theory properties to implement • performance for very large numbers • any issues or bugs you encounter
There are also a few small Easter eggs hidden in the program (including Klingon number input), so feel free to explore
Installation instructions and documentation are available in the repository (docs folder).