alfanous , blackstone release

Upload: danielle-manning

Post on 04-Jun-2018

223 views

Category:

Documents


0 download

TRANSCRIPT

  • 8/13/2019 Alfanous , Blackstone Release

    1/16

    Alfanous New API release BlackStoneWe release today the 25th of November 2013 a new release of Alfanous API based on a ne

    output system. The release s named !"la#$ stone %&'()* +,- */ and ded #ated to Pr. Amar "allar.Taha errou$ for superv s n4 the resear#h wor$ stand n4 beh nd Alfanous pro e#t.

    6nl ne use7http788www.alfanous.or48 os29o#al use7https788pyp .python.or48pyp 8alfanous80.:.01 % nstall us n4 easy; nstall /

  • 8/13/2019 Alfanous , Blackstone Release

    2/16

    Interfa#es dependen#y h erar#hy

    Application Programming Interface

    An appl #at on pro4ramm n4 nterfa#e %API/ s a proto#ol ntended to be used as an nterfa#software #omponents to #ommun #ate w th ea#h other. An API s a l brary that may n#ludespe# f #at on for rout nesG data stru#turesG ob e#t #lassesG and var ables.The powerful po nts of our API are7

    1. Free Open Libre 7 any one #an use tG any one #an #ontr bute n. That means t ta$es theadvanta4e of #ommun ty nvolvement.

    2. A Python API 7 that allows anyone to #reate ndependently a web nterfa#eG des$top nterAndro d8Iphone8W ndows phone nterfa#es G fa#eboo$8tw tter8EF appl #at ons ...an

    3. A founded base 7 The sear#h pro#ess s too fast and too stable other webs tes8appl #at onQ.Lot of features 7 The a#tual API has an mportant number of features and prepared to a##ep

    more.The neRt f 4ure represent a python sample #ode to use the API7

  • 8/13/2019 Alfanous , Blackstone Release

    3/16

    API usa4e sample #ode

    Sou #an f nd the sample #odehere

    JSON web service

    To enable the use of our API over the webG we made a web serv #e that wrap the nput8output oAPI. The reUuest ar4uments should be passed n V 9 and the output w ll be 4enerated and showO 6N format. Th s #ould be used by web nterfa#esG smart phone appsG so# al networ$ appsG browsers addons. Sou #an a##ess to the O 6N webserv #e here7http788www.alfanous.or48 os2. Thedo#umentat onhere

    https://github.com/Alfanous-team/alfanous/blob/master/src/alfanous-tests/sample.pyhttp://www.alfanous.org/jos2https://github.com/Alfanous-team/alfanous/blob/master/src/alfanous-cgi/README.rsthttp://www.alfanous.org/jos2https://github.com/Alfanous-team/alfanous/blob/master/src/alfanous-tests/sample.pyhttps://github.com/Alfanous-team/alfanous/blob/master/src/alfanous-cgi/README.rst
  • 8/13/2019 Alfanous , Blackstone Release

    4/16

    Prev ew of the O 6N web serv #e

    onsole interface

    As a test nterfa#eG we made a #onsole nterfa#e that wor$s on #ommand l ne. Th s nterfa#e used also as a wrapper to ma$e des$top nterfa#es that are developed under a pro4ramm n4 lan4ud fferent then Python. The reUuest should be passed as n l ne ar4uments n the #ommand l noutput w ll be 4enerated X shown n O 6N format. Y 4h a#t v ty des$top nterfa#esG wor$l nuR l $e platformG #an run th s nterfa#e as a Daemon serv #e on the ba#$4round.

    Prev ew of the

  • 8/13/2019 Alfanous , Blackstone Release

    5/16

    We have proposed an eRtended stru#ture for results. Th s stru#ture s eRtens ble7any new nformat on #an be n#luded eas ly w thout affe#t n4 the old stru#ture and w thout r ba#$ n#ompat b l ty. or eRampleGOson results of + ' *

    http://www.alfanous.org/jos2?action=search&unit=aya&query=%D8%A7%D9%84%D9%83%D9%88%D8%AB%D8%B1http://www.alfanous.org/jos2?action=search&unit=aya&query=%D8%A7%D9%84%D9%83%D9%88%D8%AB%D8%B1http://www.alfanous.org/jos2?action=search&unit=aya&query=%D8%A7%D9%84%D9%83%D9%88%D8%AB%D8%B1http://www.alfanous.org/jos2?action=search&unit=aya&query=%D8%A7%D9%84%D9%83%D9%88%D8%AB%D8%B1
  • 8/13/2019 Alfanous , Blackstone Release

    6/16

    We ve also ref ned the l st of reUuest fla4s to allow the reUuester to #ustom ]e h s reUu#ontrol wh #h nformat on retr eved n order to 4a n performan#e and m n m ]e the s ]e ofthe retr ev n4 runt me. A #on#ept of predef ned #onf 4urat on for reUuests s ntrodu#ed. oreUuester #an #hoose e ther a m n malG normal G fullG l n4u st #G or stat st #al v ew w tea#h fla4 value. The l st of fla4s7here

    We offered a set of error #odes n #ase of fa led sear#h Uuery. It helps n #lar fy n4 the fa lure. Th s set s eRtens bleG new error #odes #an be added eas ly.

  • 8/13/2019 Alfanous , Blackstone Release

    7/16

    3. ^rror 17 no a#t on s #hosen or a#t on undef ned _Q. ^rror 27 super o$ers are not perm tted .

    We made the API meta data ava lable for reUuest n the output system. eta data n#ludes1. API meta nformat on n#lud n4 authorsh pG l #enseG des#r pt onG vers onG and re2. ^rror messa4es_

    3. Poss ble fla4sG n add t on to the rdefault valuesG poss ble values ntervalsG andhelp messa4es_Q. Ava lable sear#h f elds %Arab # and ^n4l sh names/_5. Ava labletranslat ons andre# tat ons_c. urah values l st_:. Elobal sear#h usa4e h nts.

    #any new features

    We mplemented many new features wh #h are ava lable w th n the new O 6N output system. the features s the fu]]y sear#h feature. We ve done a bas # mplementat on that automates the sear#h to n#lude the potent al synonyms of the word and also the d fferent der vat ons.

    `u]]y sear#h eRample %fu]]y true/

    We added the poss b l ty of retr ev n4 the prev ous and neRt ayahs of ea#h ayah of the resultsne 4hbor ayahs helps the user to $now eRa#tly the ayah pos t on n ts own surah.

    how n4 ad a#ent ayahs %prev;aya trueXneRt;aya true/

    `or the ayah teRtG we offered the ab l ty to #hoose between o#al ]ed and Vnvo#al ]ed teRtG a between tandard and Vthman teRt.

    how n4 ayahs n d fferent s#r pts %vo#al ]ed trueG uthman tr

    We mplemented four su44est on operat ons7

  • 8/13/2019 Alfanous , Blackstone Release

    8/16

    u44est on eRample of o#al ]at ons G Der vat ons Gand ynonyms of g'

    We mplemented the poss b l ty of sear#h us n4 "u#$walter transl terat on and show the resul

    $eywords wr tten n the same transl terat on.

    "u#$walter translat on eRample

    $esource Importing #anager

    An mportant part was m ss n4 n the old mplementat on of the resour#e mport n4 mana4erm ss n4 part was the mport n4 of the data from the r or 4 nal sour#e. We have f Red th s mand mprove the 4lobal behav or of the resour#e mana4er. The mproved vers on #an do7

    1. %ownloading original resources 7 the reason for download n4 the resour#es rather thenn#lud n4 them w th the pro e#t s to pass by the restr #t ons on the red str but on ofresour#es. Another reason s to $eep us n4 always the last updated vers ons of the resour#another reason s avo d the opt onal resour#es w th b 4 s ]es so let the developer or the #hoose what to download. Th s s the l st of the resour#es to be downloaded7

    1. Tan] l us haf Rml f le.2. Tan] l iuran # translat ons pa#$a4ed as the e$r model.3. ^veryAyah re# tat ons l st.

    2. Parsing & Importing the data to our intermediate database" ^a#h resour#e has a spe# f #un Uue stru#ture. We need to parse ea#h resour#es then mport the data n#luded to our

    ntermed ate database. The role of ntermed ate database s to re or4an ]e the data n ama$e the ndeR n4 eas er. We made two l brar es7

    1. Py

  • 8/13/2019 Alfanous , Blackstone Release

    9/16

    Automating the API building

    The bu ld n4 of resour#es was manual and undo#umented. We #reated aa$ef le that automate nowthe bu ld n4. We f ll the ma$ef le w th the appropr ate number of #omments n order to ma$eand understandable. The role of ma$e f le s to perform the follow n4 tas$s7

    1. Auto download n4 of new vers ons of the used iuran # and l n4u st # resour#es_2. Eenerat n4 and e4enerat n4 of the ntermed ate 4enerated data f les_3. Auto bu ld n4 of the do#ument ndeRes n add t on the nverted ndeRes_Q. Auto nstall and pa#$a4 n4 of the API and d fferent related eRtens ons and nterfa#es.

    A new console interface

    We ntrodu#ed a new #onsole nterfa#e to be used by a non python des$top appl #at onG #oul ba#$4round serv #e a.$.a Daemon.

    Pac*aging system"

    We mplemented a pa#$a4 n4 system to pa#$a4e the API for d fferent operat n4 systems. n#s pure python so that ma$es t portable throu4h the d fferent platforms. Thou4hG many data res

    should be 4enerated and mported n the pa#$a4e. We d str bute the API as 71. Source +arball 7 An ar#h ve of sour#e f les #reated w th the Vn R tar ut l ty. our#e #o

    d str but ons have been pa#$a4ed as tarballs s n#e the m d 1jk0s.2. ,inary +arball 7 An ar#h ve #onta ns the bu lt and #omp led sour#e #ode.3. Python egg pac*age 7 a lo4 #al stru#ture embody n4 the release of a spe# f # vers on of a

    Python pro e#tG #ompr s n4 ts #odeG resour#esG and metadata.

    #ultiple search units

    The Appl #at on Pro4ramm n4 Interfa#e n t ally was made up to sear#h only n the ayahs. Antrodu#ed more sear#h un ts. To ntrodu#e any un tG we should 4ather the appropr ate data redef ne the sear#h f eldsG def ne the sear#h reUuest fla4sG and f nally def ne the results stru#tu

    ntrodu#ed two un ts wh #h are71. +ranslations 7 enable the sear#h for iuran # translat ons n d fferent lan4ua4es. The nfor

    n#luded are7 dent f erG teRtG lan4ua4eG author.

    Translat on as un t sear#h G iuery7 seven

    2. -ords" enable the sear#h for iuran # words and d fferent l n4u st # annotat ons n#ludword dent f ersG or 4 ns %lemmaG stemG root/G P6 G formG 4enderG personG numstate.

    https://github.com/Alfanous-team/alfanous/blob/master/Makefilehttps://github.com/Alfanous-team/alfanous/blob/master/Makefile
  • 8/13/2019 Alfanous , Blackstone Release

    10/16

  • 8/13/2019 Alfanous , Blackstone Release

    11/16

    Inte4rate the boundary annotat ons to enable the retr ev n4 of boundar es n iuran Propose a standard format for new l n4u st # and iuran # resour#es.

    2. omplete the features implementation/ lin* 0"We l st here the mplementat on state of thesear#h feautures7

  • 8/13/2019 Alfanous , Blackstone Release

    12/16

    epet t ons and Alle4or #al ayahs NoAbro4ators and Abro4ated ayahs sear#h No

    iur an # Parables Noemant # iuer es emant #ally related words Part ally

    `a#eted Themat # ear#h Part ally

    iuest ons Answer n4 %iA/ NoAutomat # vo#al ]at on No^nt ty ^Rtra#t on No

  • 8/13/2019 Alfanous , Blackstone Release

    13/16

    iur an # teRt_ "ased on modern methods of nformat on retr eval w th 4ood stab l ty and sear#h.

    We are offer n4 an 6pen Appl #at on Pro4ramm n4 Interfa#e to browse and sear#h iuran. That API s well eRtens ble and #an a#h eve more sear#h features.

    -hat is Alfanous5

    Alfanous s a fun#t onalG dynam #G #omprehens ve iur an sear#h en4 ne that has been effe#des 4ned to #arry out s mple or advan#ed iuran # sear#hes. Alfanous uses a #ontemporaryG h 4developed approa#h to retr eve v tal nformat onG enabl n4 stable eff # entG speedy sear#he#ondu#ted. Alfanous a ms to mplement add t onal features su#h as h 4hl 4htG s te su44estqet# to further mprove your sear#h eRper en#e. Alfanous understands the #ompleR nature of theArab # lan4ua4e and thus offers effe#t ve Arab # lan4ua4e pro#ess n4G allow n4 the stemm nsu##essful el m nat on of amb 4u t es. The Appl #at on Pro4ramm n4 Interfa#e #an be usedfundamental base for developers to bu ld and enhan#e nterfa#e types w th n d fferent systemsDes$top EVIG Web based VIqet#.

    -hy Alfanous5 Alfanous s ` ^^ 9I" ^ 6P^N 6V

  • 8/13/2019 Alfanous , Blackstone Release

    14/16

    6istory 7 August 89:2 7 9aun#h n4 W^" 0.:.5 alyaUoot release of the web nterfa#e7 based onTw tter

    "ootstrapG espons ve G mpleG

  • 8/13/2019 Alfanous , Blackstone Release

    15/16

    -ebsite" Alfanous.or4Feedbac*s" Alfanous 'B * '| | ' BL * *K G$a#emb2 [Ara!ic] K K | }-{ K + B| + 'B * = K K | &G#h ffra1 [Ara!ic] @ + * x+ * = &K * JB,C * g' *' * K | -{ *G #h ffra2 [indonesian] Al anous, (erdepan dalam Penelusuran (e)s dan *nformasi Ayat Al ur+an G

    fath;mult med a [indonesian] Alfanous, Da) ah Al- uran e at #earch $n%ine G f madan

    Call for ContributionSou #an help us by7

    pread n4 the word `ollow n4 and shar n4 our so# al networ$ pa4es 7`a#eboo$ Tw tter Eoo4lePlus

    har n4 a l n$ toour webs te v a your a##ounts n o# al networ$s. Po nt n4 s$ lled developers and iuran # resear#hers to the mportan#e of the pro Wr t n4 art #les about the pro e#t n blo4sG newspapers. how n4 a banner on your "lo48Webs te.

  • 8/13/2019 Alfanous , Blackstone Release

    16/16