Metadata-Version: 2.1
Name: asciimap
Version: 0.1.1
Summary: Print countries in ASCII Art based on Natural Earth shape files.
Home-page: https://github.com/MaelStor/asciimap
Author: Mael Stor
Author-email: maelstor@posteo.de
License: GPL-3.0-or-later
Description: <div align='center'>
          <a href='https://www.naturalearthdata.com/'><img src='https://github.com/MaelStor/asciimap/blob/master/res/NEV-Logo-Black.png' alt='Natural Earth'></img></a>
        </div>
        
        ----
        
        <div align='center'>
        <p><b>asciimap</b></p>
        <p>Print countries in ASCII Art based on shape files from Natural Earth project</p>
        </div>
        
        <div align='center'>
        <a href="https://github.com/ambv/black"><img alt="Code Style: Black" src="https://img.shields.io/badge/code%20style-black-black.svg?style=flat-square"></a>
        <a href="https://choosealicense.com/licenses/gpl-3.0/"><img alt="License" src="https://img.shields.io/badge/license-GPL--3.0--or--later-green.svg?style=flat-square"></a>
        <a href="https://docs.python.org/"><img alt="Python Version" src="https://img.shields.io/badge/python-3.6%20%7C%203.7-blue.svg?style=flat-square"></a>
        <a href="https://github.com/MaelStor/asciimap"><img alt="GitHub tag (latest SemVer)" src="https://img.shields.io/github/tag/MaelStor/asciimap.svg?style=flat-square"></a>
        <a href="https://travis-ci.com/MaelStor/asciimap/"><img alt="Travis (.com) branch" src="https://img.shields.io/travis/com/MaelStor/asciimap/master.svg?style=flat-square"></a>
        </div>
        
        ----
        
        <div align='center'>
        <pre>
                  *-------*                                       $-------$                     
                 /......./                                       /       /                      
                *......./                                       $       /                       
                *......*                                        $      $                        
               *........*------*                               $        $------$                
               *...............*                               $               $                
              *...............*                               $               $                 
              *...............*                               $               $                 
               \............./                                 \             /                  
                *.........../                                   $           /                   
                |..........*                                    |          $                    
                *.**........*--*                                $ $$        $--$                
                 *  *...........*                                $  $           $               
                    *...........*                                   $           $               
           *       *.............\                         $       $             \              
        *-/.\      *-*............\                     $-/ \      $-$            \             
         |...**       *--*.........\                     |   $$       $--$         \            
         |.....*          \.........*-*                  |     $          \         $-$         
        *--*../            *......*...*                 $--$  /            $          $         
            **              United Kingdom                  $$              United Kingdom      
                            *.....*....*                                    $          $        
                            *...........\                                   $           \       
                     *-----*.............*                           $-----$             $      
                    *....................*                          $                    $      
                    *.....................*-*                       $                     $-$   
                     \.......................*-*                     \                       $-$
                      *........................|                      $                        |
                    **......................../*                    $$                        /$
                  **.........................*                    $$                         $  
                   *---*.....................|                     $---$                     |  
                        *....................|                          $                    |  
                       /.....................**                        /                     $$ 
                     **..............*--*..**                        $$              $--$  $$   
                   **......*-*.*----*    **                        $$      $-$ $----$    $$     
                  /..\..../   *                                   /  \    /   $                 
                 *.** *--*                                       $ $$ $--$                      
                 **                                              $$                             
        
        </pre>
        </div>
        
        You can print any country with `asciimap` for which a Geometry exists (currently
        177 countries). In general printing is pretty fast though big countries like 
        USA, Russia, Canada etc. need some extra computation time. To circumvent loading 
        times store the results in a database or similar. Disk space isn't much for 
        normal 40x80 sized ascii maps.
        
        ## Dependencies
        
        You need the python bindings for GDAL and GDAL itself installed. I experienced 
        problems installing the python bindings into a virtualenv, so I recommend 
        installing the system packages.
        
        #### Arch
            pacman -Sy gdal python-gdal
        
        #### Debian/Ubuntu
        
            apt-get update
            apt-get install gdal-bin libgdal-dev python3-gdal
        
        ## Installation
        
        #### PyPi
        Installation with pip is straightforward:
        
            sudo pip install asciimap
        
        #### Git
        Installation with git from master branch:
        
            git clone git@github.com:MaelStor/asciimap.git
            cd asciimap
            git checkout master
        
        ###### In userspace
        Install in user space with:
        
            pip install --user .
        
        ###### System
        Install system wide with:
           
            sudo pip install .
        
        ## Usage
        <pre>
        usage: asciimap [-h] [--fill FILL] [--empty EMPTY] [--outside OUTSIDE]
                        [--height HEIGHT] [--width WIDTH] [--blur BLUR]
                        [--method {full,f,dynamic,d,height,h,width,w}]
                        [--surface SURFACE] [--negative] [--benchmark]
                        country
        
        Print countries in ASCII Art
        
        positional arguments:
          country               Select country by ISO 3166-1 alpha-2 codes. For a
                                complete list of ISA A2 codes use 'list' as argument
        
        optional arguments:
          -h, --help            show this help message and exit
          --fill FILL, -f FILL  Single character marking the edges of the land surface
          --empty EMPTY, -e EMPTY
                                The character to use for the land surface
          --outside OUTSIDE, -o OUTSIDE
                                Single character marking the outside surface
          --height HEIGHT, -i HEIGHT
                                Height of the map as integer
          --width WIDTH, -w WIDTH
                                Width of the map as integer
          --blur BLUR, -b BLUR  Add blur to radius and inflate the surface by double
                                value
          --method {full,f,dynamic,d,height,h,width,w}, -m {full,f,dynamic,d,height,h,width,w}
                                Change rendering method
          --surface SURFACE, -s SURFACE
                                Choose a surface by number or 'all'
          --negative, -n        Print the negative
          --benchmark, -t       Print execution times of methods along with the map
        
        List all countries and ISO 3166-1 alpha-2 codes with 'list'
        </pre>
        
        ## Examples
            $ asciimap it
        <pre>
                          *-*                                                           
                      *--*   \                                                          
                      /       *---*                                                     
                 *---*            |                                                     
        *    *--*               *-|                                                     
        *---*                 **  *                                                     
         |                   /                                                          
         *                  *                                                           
        *                   |                                                           
         \                  *                                                           
         *\   *---*          *                                                          
           \ /     **        *                                                          
           **        \        **                                                        
                      *         \*                                                      
                      |          \                                                      
                      *           \                                                     
                       \    Italy  \                                                    
                        \           \                                                   
                         **          \                                                  
                           \          **                                                
                            **          *--*                                            
                              *-*         \                                             
                                 **        *-*                                          
                **                 **         **                                        
              */  \                  **         \*                                      
              |    *                   \      *----*                                    
              |    *                    \    /    *-*                                   
              |   *                      \  *                                           
              |   |                       \  \                                          
              *  /*                        *  **                                        
               **                          |  /                                         
                                           | /                                          
                                           |/                                           
                                          *|                                            
                              *-*   *---* **                                            
                              |  *-*    *                                               
                              *-*      *                                                
                                 *--*  |                                                
                                     *-|                                                
                                       *                                                
        </pre>
        
            $ asciimap no
        <pre>
                               *------------*                                           
                    *-*   *---*   |-----------*                                         
                  **   *-*     \--/                                                     
                    **          /*                                                      
                      **      **    *--*                                                
                        **   /        **                                                
                          *--*                                                          
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                                                                        
                                          *--------*                                    
                                     ** **   /---\  \                                   
                                *----* /    /     *--*                                  
                          Norway  /   *-----*                                           
                            *-* **                                                      
                          *-/                                                           
                        ** /                                                            
                       /  /                                                             
                      /  /                                                              
                     /  /                                                               
                   **  /                                                                
                  /  *-*                                                                
                **  *                                                                   
              **    *                                                                   
           *-*     *                                                                    
         **        *                                                                    
        *           *                                                                   
        |           |                                                                   
        |           |                                                                   
        *           *                                                                   
         *      *--*                                                                    
         *    **                                                                        
          *--*                                                                          
        </pre>
        
        You can print a country looking like a negative with
        
            $ asciimap --surface 1 fr --negative
        
        <pre>
        ..............................**................................................
        ............................     ...............................................
        ............................        ............................................
        ...........................          ...........................................
        ...........................            .........................................
        ........................                .  .....................................
        ............ ........                        ...................................
        ............   ...                             .................................
        .............                                     ..............................
        .............                                           ........................
        ....    .....                                            .......................
        *                                                       ........................
        |                                                       ........................
        |                                                      .........................
        *                                                      .........................
        ....                                                   .........................
        ........                                           .  ..........................
        .........                                           ............................
        ...........                                       ..............................
        ............                                     ...............................
        .............                                   ................................
        ..............                                  ................................
        ...............                                    .............................
        ...............                                     ............................
        ...............                                     ............................
        ...............                                     ............................
        ...............                                      ...........................
        ...............                                     ............................
        ...............                                     ............................
        ...............                                     ............................
        ...............                                     ............................
        ...............                                      ...........................
        ..............                                         .........................
        ..............                                         .........................
        .............                                         ..........................
        .............                           ....        ............................
        ..............                      ............................................
        .................                  ............................ ................
        .....................  ..          ..........................   ................
        .......France...............*----*..........................*--*................
        </pre>
        
        or if you want the borders showed:
        
            $ asciimap --surface 1 --outside '.' fr
        
        <pre>
        ..............................**................................................
        ............................*/  \...............................................
        ............................/    *-*............................................
        ...........................*        \...........................................
        ...........................*         **.........................................
        ........................*-*            \.**.....................................
        ............*........*-*                *  **...................................
        ............*-*...*-*                        **.................................
        .............| *-*                             *-*..............................
        .............|                                    *----*........................
        ....*--*.....*                                          *.......................
        *--*    *---*                                          *........................
        |                                                      *........................
        |                                                     *.........................
        *--*                                                  |.........................
        ....*--*                                           *  *.........................
        ........\                                         *.**..........................
        .........**                                       **............................
        ...........\                                     /..............................
        ............\                                   /...............................
        .............\                                 *................................
        ..............\                                *................................
        ...............*                                *-*.............................
        ...............|                                   *............................
        ...............|                                   |............................
        ...............|                                   *............................
        ...............|                                    *...........................
        ...............|                                   *............................
        ...............|                                   |............................
        ...............|                                   |............................
        ...............|                                   *............................
        ...............*                                    \...........................
        ..............*                                      \*.........................
        ..............*                                       *.........................
        .............*                          *--*        **..........................
        .............*                      *--*....*------*............................
        ..............*-*                  /............................................
        .................*--*  **         *............................*................
        .....................**..*-*      *..........................*-|................
        .......France...............*----*..........................*--*................
        </pre>
        
        Fillings can be combined. If you want to fill the land surface with `.`,
        everything outside the land surface with `~` and corners with `^` use:
        
            $ asciimap nz --outside '~' --empty '.' --fill '^'
        
        <pre>
        ~~~~~~~~~~~~~~~~~~~~^^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~|\~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~^.^^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~\..^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~\.^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~\.^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~\|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~|\~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~^./.^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~^..^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~|...\~~~~~^^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~|....^---^.|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~|..........|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~^..........^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~/........^-^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~^/......../~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~^\.......^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~^^.....|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~^....^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~|...^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~~~^~~~~~~~^...^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~^/.\~~^~~^.../~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~~/...^-^~~^..^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~~/..New Zealand~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~^.......^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~~^....../~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~~/....../~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~~/....../~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~~~/......^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~~~^^.......|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~~~^^.......^-^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~~~^^.......^^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~^^........^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~/..........^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~^^..........^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~^............^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~^.........../~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ^.........../^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ^---^.....^^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ~~~~~^---^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        </pre>
        
        #### Advanced usage
        Some advanced usage with command-line tools. The picture in the title was produced with
        
            $ asciimap gb --height 30 --width 31 | paste - <(asciimap gb --height 30 --width 31 --fill "$") | paste - <(asciimap gb --height 30 --width 31 --fill "'")
        
        another example with 'paste' and usage of 'blur':
        
            $ asciimap -b 0 jp -i 30 -w 30 | paste - <(asciimap -b 2.0 jp -i 30 -w 30)
        
        <pre>
                                                                      
                                                                      
                                                             *        
                               *                           */ **      
                               |\                          /    *--*  
                               / **  *                    /         \ 
                              /    \-*                   /           *
                            **     /*                   *            |
                           *  *-* /                     |            |
                           *-*   *                      |            *
                                                        |           / 
                            *-*                         |         **  
                            | |                         |        /    
                            | |                         *       *     
                            * |                        /        *     
                           *  *                     *-*        *      
                           * *                     /   Japan   *      
                        Japan                  *--*           *       
                        *    *               **               |       
                     *-*    *               /                 |       
                    *       |              /                  *       
                *-* *       *            **                  *        
             *-*  \*  *----*            *                    *        
            // \ / | /                  |                 *-*         
          *-/ \ /* **                   *              *-*            
         / \  |-*                        *         *--*               
        **  * *                          |       **                   
          \/                             *      /                     
          |*                              \    /                      
          *                                *--*                       
        </pre>
        
            $ asciimap au --blur 0.1 --empty '.' --method full
        
        <pre>
                                                                 **                     
                                              *-*                /\                     
                                          *--*...*----*         *..*                    
                                         /..........|           |..*                    
                                *---*   /...........|           |...**                  
                               /.....*-*............*           *.....\*                
                              /......................*-*       *.......\                
                          *--*..........................*-*    *........*               
                          /................................*--*.........|               
                         /..............................................*               
                        /................................................**             
                   *---*...................................................*-*          
             *----*...........................................................\         
           **..................................................................\        
         */.....................................................................**      
         /........................................................................\     
        *..........................................................................**   
         *...........................................................................\  
        *.........................................Australia...........................* 
         *............................................................................| 
         *............................................................................* 
          \............................................................................*
           *...........................................................................*
           *..........................................................................* 
            \...........................*--*..........................................| 
             *...................*-----*    *---*.....................................* 
             *................*-*                \......*...........................**  
            /........*-------*                    \...** *........................./    
           *-\....*-*                              *-*  /*......................../     
              *--*                                     ** \....................../      
                                                           \....................*       
                                                            \...................|       
                                                             *-*............*---*       
                                                                *----------*            
                                                                                        
                                                                                        
                                                                      **   *-*          
                                                                       |--*..*          
                                                                       *...**           
                                                                        *-*             
        </pre>
        
        Sometimes a country has more than one land surface (or more precise: Polygons)
        defined, what scrambles the surface of interest when printing all surfaces:
        
            $ asciimap --surface all --method full ru --fill "'"
        <pre>
                                                          '          '                  
                                                                     '                  
                                                                      '                 
                                                                                        
                                                                      ''                
                                                             '      ''  '      '        
                                                            '      /    |               
                                                            '     '     '      '        
                                                               '  '      '--'  |        
                                                           '   |-'          \  '\       
                                                            \  | '           ''  \'     
                                                             \ |/                 \   ' 
                                                      ''     '-| '                 '-' '
        '                                              \'  ''  \ '                     |
        |'                                              \ /     '                      |
        '|                                             ' /                             |
         '                                             |/                              |
                                                       |                               |
                                                       |                               '
                                                       '             Russia        '  / 
                                                      '                           / ''  
                                                      |                        '-'      
                                                      |                       '    '    
                                                      |                       |    |    
                                                      '                       '    |    
                                                       '       '             '     |    
                                                    '  |      / '            '     |    
                                                       |     '  '          '  \    '    
                                                       '   ' '   \        ' '  '        
                                                        ' ' '     \ ' '   | |  '        
                                                        ' '        ' ' \ /' | '         
                                                         '         '    '   ' |         
                                                         |                   \|         
                                                         ''                   |         
                                                        / |                   |         
                                                       '  '                   '         
                                                       '-'                   '          
                                                         \'                  '          
                                                          |                             
                                                          '                             
        </pre>
        
        To overcome the bias you can just render the big land surface for example with:
        
            $ asciimap --surface 1 --method height ru --fill "'" 
        
        <pre>
                                                                                        
                                               '----'                                 ''
                                         '----'                             '--------' |
                                       '--'                             '--'           |
                                      /-'                         '----'               |
                                    '-|               '--'  '     /                    |
                                   '' |              /  \  ' '---'                     |
                                     '--'          ''    ' |                           |
                                                    \    | '                           |
         '-------'                           '---'   '   |  '                          |
          |       '--'    '-'     '---------'     '-'    '\ '                          |
          '    '-'    '   /\   '-'                      '  /                           |
           '  '   '--'  ''  '-'                         ' /                            |
           |   '      ''                                 '                             |
           |   '   '-'                                                                 |
           '    '-'                                                                    |
            '                                                                          |
           /                                                                     Russia|
         ''                                                                            |
          '                                                                            |
        '/                                                                             |
        '                                                                              |
         \                                                                             |
         '-'                                                                           |
            \                                     '----'                               |
            '\                               '---'      '-----'                        |
              \                             '                  \                       |
             '-\                  ''        |                   \                     /|
                \               ''  '-----' '                    '---'               / '
                 '--'         ''           '                          ''    '-------'   
                     \       /                                          '--'        '   
                      '     '                                                           
                      '      \                                                          
                     /        \                                                         
                    /         ''                                                        
              '----'         /                                                          
                    '-'     /                                                           
                       '---' \                                                          
                            '-'                                                         
                              '                                                         
        </pre>
        
        what cuts off the eastern part of Russia. To print the whole surface:
        
            $ asciimap --surface 1 --method width --height 20 ru --fill "'"
        
        <pre>
                                              '-'                                       
                            ''                 / '-'                                    
                       ''              '------'    \                                    
                     ''       ''    '-'             '-------'      ''                   
                      '\     ' | '-'                         '----'  '------'           
         '--'           \ ''  /' /                                           '---' '---'
         |  '-'  ' '---' '  '-' /                                                 '    |
         ' /   '' '            '                                                       |
          / '-'                                                             ' '     '--'
         /                                  Russia                      '  / \ '---'    
        '                                                          '---' ''   /         
        '\                                                       ''         '-'         
          \               '----' '                              '          ' |          
           \        '    /      ' \          '           '-'     '' '      '-'          
            ''    '' '---'         '-'   '--' '--'   '' /   \      /|                   
              '  '                    '-'         '-'  '     \ '  ' '                   
              |  '                                            ' \ '                     
           '  |   '                                             |/                      
              '--'                                            '-'                       
                  '                                                                     
        </pre> 
        
        To find the right surface you have to try around a bit. I'm working on a
        better solution.
        
        ## Performance
        
        Rendering time heavily depends on the count of Polygons and the size of the
        resulting map. Printing a common sized country with `40x80 (h x w)` usually 
        takes about `0.3 - 0.7` seconds on a 2-core system. Rendering is implemented to
        use parallel processes and drastically reduces computation time on multicore
        systems.
        
            $ asciimap de --benchmark
        
        <pre>
        parse_undefined_countries    0.0001 s
        _get_boundaries              0.0000 s
        __init__                     0.0007 s
        render_parallel              0.2032 s
        is_border                    0.0440 s
        is_vertical                  0.0034 s
        is_horizontal                0.0033 s
        is_negativ_diagonal          0.0032 s
        is_positiv_diagonal          0.0031 s
        print_map                    0.0919 s
        -------------------------------------
        Sum                          0.3529 s
        </pre>
        
        Bigger countries like USA, Russia, Canada etc. take a little more time. 
        Something between `0.7 - 1.5` seconds.
        
            $ asciimap us -t
        
        <pre>
        _get_boundaries              0.0001 s
        __init__                     0.0036 s
        render_parallel              0.6032 s
        is_border                    0.0324 s
        is_vertical                  0.0029 s
        is_horizontal                0.0028 s
        is_negativ_diagonal          0.0027 s
        is_positiv_diagonal          0.0027 s
        print_map                    0.0697 s
        -------------------------------------
        Sum                          0.7200 s
        </pre>
        
        You can run `asciimap` with `--benchmark` if you want to know execution times
        of all used methods. Times for each method add up in case a method/function is
        called multiple times.
        
Keywords: earth country print ascii art python spatial geo natural
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Education
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Classifier: Topic :: Multimedia :: Graphics :: Presentation
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
