Metadata-Version: 1.1
Name: numtxt
Version: 1.2.0
Summary: gives full and approximate written forms of numbers
Home-page: http://github.com/Electrostatus/numtxt
Author: Philip Herd
Author-email: UNKNOWN
License: GPLv3
Description: numtxt
        ======
        A pure Python module that gives both full and approximate names for numbers
        
        Contains functions that give the cardinal name (one, two, three, ...), the ordinal name (first, second, third, ...), the precedence (primary, secondary, tertiary, ...) as well as approximations (23.3458e45 -> '23.346 quattuordecillion') and prefixes. Has four different naming methods for powers and three different suffix styles. Additionally contains an SI prefix naming function.
        
        Suffix Styles
        -------------
        - **short** 
          - Assigns 'illion' to names. This is the default style.
        
          - 10^6 = million, 10^9 = billion, 10^12 = trillion, ...
        - **long**
          - Assigns 'illion' or 'illiard' to names depending on power.
        
          - 10^6 = million, 10^9 = milliard, 10^12 = billion, ...
        - **british**
          - Assigns 'illion' and adds 'thousand' in front of names depending on power.
        
          - 10^6 = million, 10^9 = thousand million, 10^12 = billion, ...
        
        
        Naming Methods
        --------------
        - **conway-wechsler**
          - This system extends the normal Latin naming method indefinitely and follows Latin syntax closely. Can use long, short or British suffix styles (examples below are short style). This is the default method.
        
          - 10^6 = 1 million
          - 10^12 = 1 trillion
          - 10^51 = 1 sedecillion
          - 10^342 =  1 tredecicentillion
        - **noll**
          - This system extends the normal Latin naming method indefinitely. Can use long, short or British suffix styles (examples below are short style).
        
          - 10^6 = 1 million
          - 10^12 = 1 trillion
          - 10^51 = 1 sexdecillion
          - 10^342 = 1 centredecillion
        - **rowlett**
          - This system uses Greek prefixes for names. Introduced to prevent confusion the suffix styles can cause and therefore does not use any such styles. Currently valid up to 10^2999.
        
          - 10^6 = 1 million
          - 10^12 = 1 gillion
          - 10^51 = 1 heptadekillion
          - 10^342 = 1 hecatodekatetrillion
        - **knuth**
          - Radically different naming method introduced to prevent confusion the suffix styles can cause and thus does not use any styles. Inherits conway-wechsler system to extend naming scheme indefinitely (original paper stopped at 10^4194304).
        
          - 10^6 = 100 myriad
          - 10^12 = 10 myllion
          - 10^51 = 1000 byllion tryllion
          - 10^342 = 100 myriad byllion quadryllion sextyllion
        
        
        Version History
        ---------------
        - **1.2.0** 
          August 2nd, 2020
        
          - added formatting option to approx function
          - Fixed si handling of zero
          - table, gen10_dict and gen1k_dict functions added in previous version made public
        
        - **1.1.1** 
          January 10th, 2020
        
          - Added si prefix function
          - Minor adjustments
        - **1.1.0** 
          August 18th, 2019
        
          - Added precedence function (primary, secondary, tertiary, ...)
          - Added prefix function
          - Log function can now be overridden by third-party modules (gmpy2, mpmath) to allow compatibility
          - Added (t)uple function (single, double, triple, ...)
          - Added cardinal function call; identical to name function
          - Added version history to README
        - **1.0.2** 
          November 29th, 2017
        
          - Fixed approx handling of zero & removed approx handling of small values
        - **1.0.1** 
          January 20th, 2017
        
          - Modified readme/setup.py for correct pip installation
        - **1.0.0** 
          January 20th, 2017
        
          - Initial release
        
Keywords: approximation written word number name numeral si prefix cardinal ordinal precedence
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Natural Language :: English
