asciiporn 2009.05.01

Description:

asciiporn 2009.05.01

################################################################################
originally an ascii art graphics library for ssh terminal,
but expanded to include scientific visualization.

this package has 2 main files:
asciiporn/__init__.py ## initialize custom import hook to load main.py
asciiporn/main.py ## contains EVERYTHING

how to enable 256 color in putty: http://www.emacswiki.org/emacs/PuTTY#toc2
how to enable 256 color in xterm: http://www.frexx.de/xterm-256-notes/
how to enable 256 color in screen: http://www.frexx.de/xterm-256-notes/

~ L_ '_-s+ _ ?}@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
' `{' _~ ` 't` 7~-- ` ^ f@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@M@@@@@@@@@@@@@@@@@@@@
_,-),?j{WY+=+j ` ^7^ ` ` H@@@@@@@@@@@@@@@@@@@@@@@MQk9ZIV7=?IM@@@@@@@@@@@@@@@
t' ~``nvi;f*o7L? `L~ ` &#M@M$@@@@@@@@@@@@@@@@@P`/r`,_S^?`>^JT@{M@@@@@@@@@@
rr| + _` _^^LFFLW#W5| > '__`{PRyy@WfN)i'fRM@@@@MM$r`^]g@`{~]{{rg>!'`}@@@@@@@@@
*' '`^!_ ^@&My;r,'p&#MV` 'ujmr)` `Lr( {_`R?@r= `_^'MPM#&Bf1Bp=‘−]@@@@@@@@−r,r9‘‘‘J]3@[`P`AVN- -=yE ` _i ` ^`Li~i !YL `kj`'@MNMg@#Wggp{#@@@@@@@@
'` i' l|' F _]I]/#P )vAL >pqA}&_` !J x?g1>LV'i~l+ _ ?Vu__|V@@@@@$${1@@@@@@@@
` '`` '-hMisplaced &Misplaced &w])#R[X/NF^>-t,r-=`/hTW=~x!'!^`+gg@@&M#&W@@@@Mu#M@@@@@@@@
` _' jg@@@@@M@@@@Mwm@p`#gj/c^ `' 9` v `` _Vg@M@@@@@@M@@M@@@gD{kM@@@@@@
` _ _3H##&@Mg#@@@@@@p#N4@Wu9Mx`` _ `!1 !`| (&@@@W@@@@@@@@Extra close brace or missing open braceExtra close brace or missing open brace&p@@@WWM@Wb)/‘s−+c‘s′g@@@M@@@@@@@M@@MM@Misplaced &Misplaced &@@@@@@$W@@@@#&#@@@W=(MMM
``, + F'c{^)(@@@@@@@@@@M@=]I7=w])Missing open brace for subscriptMissing open brace for subscript@@@@@M&g@@@@@#&&&&&&&&@W$$K]J^V
_>!{z-L7Ji_HLYE={[@@@$$&=jA][b^^VJ=++v=l_`-Cu@@@&M@MM@@M@MMYou can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math mode==]1scY[ {|){7i!=(q@@EE@@M@M&AMM#@@MMN$$Misplaced &Misplaced &MWG@WEg]jyy]{gg]YI?)l{A#@@e _`
`` !tl^ ` ` '?A@@#@Ewy'`^[=kEi}^ !^`v_ dQ=]jw###M@&$@@@M&mgp1}g]&# +
? ' ` ^#Wg&wa{8Vh=r_VJ,?_` ]i_g@@@@M@@@@W@#@@@#MM@@@@@@R (WRT
' ` ` ' ' ?@#d3^``e~,V(-`! r`g&@M@F5``' `^^`ff@M@@@@@@@M_ a}i
_ , ``~ ` {` ``, ^_,i-+2 7)_pMF^ ' 's_^ ``` '`>=EM&g[g[A
_ j `>`' { icx_T^'| VV]?/ ` gy`J*|gypPgp ! ` '__ ,_w&&$$N@Mm
_ j ]>' _ ` T/|nr_' '_*wj? `(`-'_g&&@@M#@Nu!‘′‘‘!XW@@@#bdMissing open brace for superscriptMissing open brace for superscript@M@hc ^^ T=f3~-({GW$@@@@M@&M
' ' M'j{>vL { ]^R{(! ,Lc]Age}Lv+^]I{$F}][L^jjRCn!x_ `i_wgW{y/=[@@@M@@@@@^
+ ' 9[M0P{,,_V/dQL+rVi-wdYou can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math mode}yAn@'` _V>'^s')~^W@[c9yCnM&&$$QQ_J@@W@@@&You can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math mode`
gEPVCc>]=&M@Wg&Y^kV]@@{#{'`` )NwEe+#Vy]You can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math modeW@W&*T` sZ=m@csX8&NM@@&@#E@AW@@@p{_'
' J{^i+`L`|iLXC _>|^_' >` I@6BW@K j#&ELoll=mEILVM@M&&M%M@MMW@@@$ojL
'izzzv>!|_^(`}+J'YY` '3X@MM@@FS@@WN@B_!{#e@E[ggg@@@&MM]#@@@@@B@g
!_=[j>_[z{p{o_^J=XS;/1__}&MgpWgpj#mgpp{GY sQq#&wMW@@@BYou can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math modeA@@M@M@@&@M@C '=YWV[Q[FMisplaced &Misplaced &FEMA@VYou can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math mode@@@@@@@@
'&[ Y['(v^^ J` _``*J^dYVe]_={y$=@>=[L'wVI&Ae _{=NgZ(ccg##=WWMM@@@@#MWP
' |]!@WR }u{cc!L '{>{|`7^ iJC}}JM+xY^Y9'`^_`YzYVA1{@X@@M==^IXe@W@@@M@@@@@l=
,__wkV'L'#M_`JYC(i'C_Y+cj '` ``o]=!V^|-^jjxCr^(`M'T'&Aq#MW@bk@a8&@#@Missing open brace for subscriptMissing open brace for subscript#Misplaced &Misplaced &A8#q&M@#Wl+'-{A
@$4=a])=VJ'L>>^+ '-C-ir{i__ >~>'`t`)r^>(i-J7_?~ ,i}z==VY=&]e49@#@@A&@@l^(^_?}^T
WGiY/[kzt'=^r_` _ (}__ C ` {`>rLx' ~=(n~`'Y'_r_Jc`,'(`wVC7^Y0M$VJ !'-x_^^Y +
&J|-~vVr^'{ '|| >L Ji`' _ l^ ^ i'''vT ' _~` ! ` ^~7W[V^ J__' i`|`7>>ju^C-
=[`+T+! `'`_!{x_?+'` L _J ^i~iJ` `V~']=(sCY+> '~ s(1]@-Ll' _>`!| ` l, L^!VF
L-~'| - 'Jt!!t-^`` t{J'^` `t`'c!C^`V'^ VkLL/r' >''i]+' |';V'_-`Y^s!L{+ ,tTi{rr
X2!^` {V(_?*/C~`|'Y ```>'~'`~`l'`{?|+7tVliiiJ{ - c ^)' r `-`'YV Lit+{Tv+!!r_
`})>i -S^==l[i-` Y~ i_~ o^?-!x'^Ltr*VL?S=) ~7 V``' L `|` C` ` _ `^!`i!vs)^)-r
~_( ^`zzzL1|`Yv^`!! ~(`t+t!|l t`^ ov-+t~!Y^` `,_``(!_ `'~ `` 'Y' |- ^^ s|F(`?k
`_=V'?oL*v ` ~ ?t`'_ ^)- V _|rJc{ L>)_^]v;{`|`> )`x _ x_s= ' ' `- ``iT)s7i-r
LL]iCinji ^ ,`'- ``vX_C+l` -Yr>r2#&M-}=]?J={`|~ '' ''~ > `- ~{_`, `+''^!?,`X
j-}vVL+ ^`_ !)v>_L(~r| ^'` vL`xc&@WM//o{Y_MM^'`T -'' x''x _ C)!(^v` `_(i ` tJ!
>c[/|`' ^ VL|J'+f|^VLL!)Yt^Vi'J-t@##jVVVJ?Vfl '> r`xV'J,`|` V>>ii`^- '_ `)^ '
`~^_(! c_JL(CiJ?xiTv`!s{^ L,`_Y $MKt_]]^~(V + g` `L ++ ! ?~ `( JV> _
` T}=`{=- 7ut,^u^LL=iir_ i_`_Li' @8_f~[!{uS__ ``` #@& 7'TC_^o t_ *``'`{' >-
Y)~:->vrx-YYtcoYJJx''?_)_tj^ viu{c3|/]-n`'' V'i &]NC J>^_ ` ^!`/{` J' ^V `{?
' tt-v{ lT !|+{-Lii )^L)`*oviYJJ-o{zY{{'L!>`V&&g _ @&Akv V^)vYx!' ` ^`_ ` +L>
(lr=-r)J+u| x^i ?`_+`C;ni,vVVt7S|)/lT~|` dM@Mp UAN&E s ~^i`_ i (_'' > _ )
>x>t+__>~`r?`^~(`) -`'+uLfcc{jj-}-|^(+=->Vs@@b@$&@*-`_ ``` `v` ^ -`(L- _` {
V _]>r`~` ! ``( ~(-lrTx{7{tVVLwgp{yvV|![|^=M@W&BmWW Ci^``| {|l^``' _V _ >pp (gM@K` ` '' t`'- {-t+zz_=iyb&@@M@MNF]?V'~%#@#@@M@&/^agpp ^ ` |'!i! ''_~ C`
NWagMMisplaced &Misplaced &&AMisplaced &Misplaced &@M@@Misplaced &Misplaced &''LMMj^`si V>>zV=^jF=-^'cT#@@@@B@M##WVTJ&#@M@MgM&You can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math mode#P```i^?=7Vt^V*V===sy$&@M@M&@WM@^`VW@@M@@@@MgIb}ZW > ' ' { '_ _ ^,
@Me' m#M@#A _f=[k^_?V{JJ{`}8^@WN@@M#MM@n+tq@@W$$$M@@MM@W&^^ `{~ ~ _ C``'{
#M ` {ZA@WW@c?=j=-{ifYV^rYV=)rFV@&Z#M#WExtra close brace or missing open braceExtra close brace or missing open braceMMMM_ ^ ``''^ r` s''L(
} `'' @MM@$@=_bvrt(^^i-}-_jt=-jz('FMM@{zJTs_?@P3@$#M@Bb7^` -`T `` ^)iJ_J >L^J;
W _`nB#@M#T_V+tSc{L >Vrr]+=|*jSi=L* oAr^bi o]s_w3K@{@~` '_ ` `^ ' ` ``|)~r
^` r^x@Li=]{)!^>cVxJ>(V~t^J3i^=}!>[zr,7ztt{_ ^#XFwu9#]yj^ ' `l `7' ~s !t`7^
x ^kT` '{i{! jNT~>^-'-jb-{TTVr|!'*r-xcVt ! `))]W[_g9d&>` ` ``v`t|| ' _ 7tc+
[ J/C`~{Yt!y+)`xJ))))J=L!ri)=V=LJn-i-^f7X7 _!r]@mMQ@@AAv _` J'i`l't_{`i!_iCJ
W^_Jk=v`|,LwT>_^rr||||VL3__=r=i^ _ Y'xtXj`^_ _-^Z#sMU&j2{ ^ J |'t7v 'i!n)
zL''?^`_?YLr^ sr|TV-+?!'+|[Y]'CY]jY^?i+iuL> ^ --Tsja]kIgL, `_ ~i` _ '- >`'-jLu
!C ` `w3Y^ `~(-+--3~sJ71l^i^^L>|?{+^``L - ` ^ ^>7cmQdkzC & '_`'`L' ```(?_' ~ll
r r`+vvr~ xJ__==={f=Ls_L7iVr V?T3`l`-]'t|^_ ' Y`=u}l^ s ]` -' ' `,|_i`t`t~,Lr
-+7 !_^+(----'VSVc>zzl?`L=~ioV'x`^)*>T` x+>77'^ %$` !!^~'` !x``'{`Y[-
``V{ ` Vrr-)?///?VC~l?>zx|_st{-oJ!xf+>!{=r! _ _ #$` ! `| `J,`` `!`!~
L`+_Jvi7++^='r?+n^T?[c!_,S?{{iF~( !^FL~ 'Y ` ' -NNMY ! { >, _,` `i+[
ci ` _`x_rr>_|'r>>`jY( (_kk|`{J)s_^L|V--+ ` ` - !'>)kkMeT s^|T {>L C''^'!-~r

SIDEVIEW Y: Z 0 to 2 Y -0.99983900113 to 1.0 T 0.0 to 7.0 MIN MAX
l?*~_-----_>cC}lTl{7Tx_--------------------------------------------_+*Tll'*+_---
| T, ,r',*l '_ ), .( `-_
| a_ / )_ \_ ,* ,(
| ,C ~C `. , ) )
| ) > \ \ \ / / (
| / / \ '_ ^ ' _^ '
| ( ' '_ `_ ) ' ' ,'
|r _' `c '_ ,' ,' ,
( ' _ c ` , ,' ,
| ' `c c `_ , , .
|' `c _ ` , ,' +
----------------`---------------L-`-------------- --.--------------,'-+--------
| _ c `_ . ,' +
| _ `C ` . ,' +
| c . . ,
| `C , c , , )
| , . ?c ) ) /
| x t . / < /
| \ \ \ ( / _*
| '_ '_ ;C ,' ,'
| x (%) x x _x
| '< _>' ?x_'C >'_r'
|------------------------------`*<____>r------`*<{jy_yj1+*'---------------------

TOPVIEW Z: Z 0.0 to 0.25 (top to bottom) Y -0.9999 to 0.9999 T 0.0 to 7.0
DOGKz1(7Lx\:,-'` `._~>r?;tfVne6H MQpZaV}oTY?+(,!'` `'-_>+|/Cc[]KPRg 8REnVSt7
DOGKX3(7/vi:_-` `-_~iv/YcS{aZqm &8qI4yzts7r~i'-` `-'i~r7stjy4Iq8& dqEa{jtYL
DAG5X3cY/vi~_.` `'-,:|xJT=3y4U9 Wm0EXnFTY?\(_!.` `'!,:\l^)Fn3U9mN m%Za{j=Y?x
DAZ5{jcY?r>~_.` `''!(+lsCf}neR8 $gRI4yz=slx*i'.' `'-_(+rYT2[]GO6D D9U5X3=T?r*
DAZa{jt;?r>!'.` `._~i|/YcoV5GOd BH9GXnF)Y?\:_-'` `.!i~vLstj{3PhbN HqE][fCsx*i
DAZa{jt;l|(!'.` `._~irL7=j{4U9 @D6OK][oT7r*>'.' `'-_(\|Y)FnXGqd# bAZa[ft;l+(~
mqEaVoCsl|(,-' '.,:\vJ)2}yeR8 &bhP3{jts?\:,-'` `.'i*r7Jo[VawmW OG5XSc;?r>!_
mqEnVoCs^+:,-' `'-!(+^;tSkuGOd WmAeV[oTYr*>'.` `'!,(vL^)fy4PhQ 8U4z1cY?ri!'.
mqEnkS)Jx*:_-' `'-~>|l7(j{50h gRZK{jtsl\:,!'` '-'>*|YT2k3U9H Hqwy}27/v\:'.'
mqeukS)Lx*~_.` `.'~|r/)F1ywqH Extra close brace or missing open braceExtra close brace or missing open brace python setup.py dev --quicktest
render color image in shell terminal & plot scientific functions as well



>>> from asciiporn import *

>>> print( img2txt("filename") )
display color image from gif, jpg, bmp, ... to screen.
only works if u have Python Imaging Library installed

>>> help(img2txt.load)
display img2txt options



>>> plot(ft = lambda t: cos(t), tmin = 0, tmax = 16)
plot cos(t) for t = [0, 16]

>>> plot(ft = [cos, sin], tmin = 0, tmax = 16)
plot 2 functions, cos & sin

>>> plot( y = [1.5, 2.5, 3.5], t = [0, 1, 2] )
plot datapoints (y, t) = (1.5, 0), (2.5, 1), (3.5, 2)

>>> f = lambda t, z: sin( t*(2*pi + z) ) * (0.5 + z) - z
>>> plot3d(ftz = ftz, tmin = 0, tmax = 16, zmin = 0, zmax = 1)
plot f in 3d using specified ranges for t & z

>>> help(plot.__call__)
>>> help(dataZYT.__new__)
display plot options



>>> fitpoly2d.test()
test asciiporn's polynomial fitting routine
peruse fitpoly.test in asciiporn/main.py for usage

>>> fft2d.test()
test asciiporn's cosine fitting routine
peruse fft2d.test in asciiporn/main.py for usage

################################################################################
RECENT CHANGELOG:
20090407
fixed installation bugs
added retro-gif feature
20090328
removed py3to2 requirement
update documentation
20090103
rewrote 3d plotter
fixed more 64bit issues
20081123
fixed bug where 64bit gets truncated to 32 on 32bit machine
256 color support
20081119
fixed bugs in setup.py