Number Recognition

Introduction

By the time you've completed this tutorial you'll have successfully created a handwritten number recognition tool using DeadCL, an Apache server and that's about it.

Everything shown in blue must be substituted with your own values.

Prerequisites

-	A sudo user and firewall on your server: in this example we're using Ubuntu 18.04LTS
-	Apache Web Server: DeadLetter requires a web server of some description.
-	Sub domain: this tutorial requires your web server to be configured with the sub-domain dld.yourdomain.com

Step One

Our first step is to SSH into your server, and navigate to where you'd like to place your Author Key.

            

       
 sudo [email protected]0.0.0.0
 sudo mkdir /var/www/html/dld/

Step Two

Next you'll need to copy our Author Key template.

            

       
 cd /var/www/html/dld/
 sudo curl -o AK.txt https://keys.deadletter.io/YOURDOMAIN.COM=dld=MY-AK.txt

Step Three

Jump into Nano (or your preferred text editor) and replace the filler content.

            

       
 nano AK.txt

The Author Key should look something like this, be sure to set a URL for at least one Conversation file, this will be needed later on.

            

       
 @Do-ID:NAME_YOURNAME
 $* 

  [email protected]{YOUR-AUTHOR-KEY-NAME}

 trusted_Cnvrstn//@NUMBERS_FILE

 [email protected] 

 	?bnd -- @_all
 		@ = dld.domain.com 
		domain.com =DOMAIN


?DRP -- [email protected]+Cnvrstn$

*END*

Step Four

Next we'll copy the Conversation file from Github - ensure the file is named according to your Author Key.

            

       
 sudo curl -o NUMBERS_FILE.txt https://raw.githubusercontent.com/deadletter/AK_V1/master/NUMBERS_FILE

We'll need to edit one line within the Conversation, so lets open it with Nano.

            

       
 nano NUMBERS_FILE.txt

You're only adding your Author Key deadID and that's it.

            

       
 
  dld.keyset('NAME_YOURNAME')
  *CATCH-lib -R PI_2019
  *Catch-lib -R Basic_Number_2018

  *input,
   	@IN.png

  IN;
   	X
 
  Y;
   	0, 1, 2, 3, 4, 5, 6, 7, 8, 9
 
  MM00_;
   	MATCH

  //POST { MM* }

  *END*

Step Five

Now comes the painful step, in-order for DeadLetter to be able to correctly identify handwritten words you'll need to add either our reference information (all 90 files) or generate your own.

            

       
 sudo curl -o https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/zero-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/one-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/two-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/three-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/four-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/five-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/six-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/seven-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/eight-8.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-0.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-1.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-2.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-3.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-4.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-5.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-6.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-7.png https://raw.githubusercontent.com/deadletter/AK_V1/master/nine-8.png

Step Six

Finally you'll need to submit your Author Key to DeadLetter by entering its address at: https://ak.deadletter.io

            

       
  https://dld.domain.com/dld/ak.txt

It can take up to 28 hours for an Author key to be trusted by DeadLetter; if you'd like to learn more visit our Author Key walk-through, or start a conversation on our Community Hub.

Conclusion

This example of DeadLetter enables for quick development of number recognition - with static imagery - along with a strong framework for expansion to motion picture.

Possible uses

Truth, be told, this Conversation does very little besides identifying written numbers in correlation to the Library.

That said you could expand it to;

-	Bookeeping: With an asortment of local Libraries this could be the foundation for bookeeping.

Walk throughs