Home

USER GUIDE - eis.bris.ac.uk

Contents

1. Attribute introduced to be used as an attribute of a HTML element data deep showon Mark an element to be shown when the dynamic output dynamic output specified in the value of the attribute becomes available data deep hideon Mark an element to be hidden when the dynamic output dynamic output specified in the value of the attribute becomes available data deep only Specify the rows columns to be displayed row column names for a dynamic output data deep except Specify the rows columns to be excluded row column names when displaying a dynamic output data deep expression Specify a XPath expression for accessing XPath gt data value in dynamic output 57
2. ccccessscccceesessseceeececsesseaeseeecscseeaeseeececeeeaeseesessseseaaees 15 3 2 4 Regenerating the dynamic content with a different answer to an input question 16 3 2 5 Regenerating the dynamic content with your own dataset cccecsessececececseseaeeecececsesesaeeeeeeeseesseaees 17 3 2 6 Tabl amp of contents eter sirena aget e ue ERA 18 3 3 eBook RESOUICE VIEW i etaed a e arte vedere aoa eig rue Rupee aae desde da aaro dde ives ae eade fen 19 3 3 1 Resource Tree VIew eene p Rn bes A DX Y Ee ARR EE PE ees ERE FE IR Fo eens POR 20 3 3 2 The INFOrmation area eria ene a a o saecu t eae 21 3 3 3 Navigation in the Resource ne e eR Reda xe Nee aes ea ER ga ee ceed Eyes abre Pes ey PERPE ERATES 22 3 34 Exporting a resources ione oane eiea orien Iubet eu e Pon en i erus dee 22 3 3 5 Reversing the eBook content to a previous state sees enne nnne 23 4 ADVANCED GUIDE FOR EBOOK AUTHORS ee eeee eee e eene e eene nennen esent 27 4 1 The eBook andnside VIeW x c a oq e Re EAE lds MY ATE ee HY ge Y AYER es 27 41 1 eere res e nia pas 27 4 1 2 Organization of Resources oa od pede cr Rea eee aT 27 4 2 Preparing the tere ET u
3. At the point in the document where you want to include some dynamic content simply add a HTML div with class deep dynamic output and give the div id in the format of template bindingname output name For example if you want to show the output equations of the execution of template1 add the following div in the position you want it to appear div id templatel equations class deep dynamic output div 39 4 Advanced Guide for eBook Authors Please note that the lt template_bindingname gt is the identifier of the binding resource that links the template with the activity region It is not the name of the actual template resource So in this case it is id templatel equations rather than 1LevelMod equations The content of the div will be replaced with the dynamic output after the execution engine generates it The output name of the dynamic content varies for different execution engines and also for the different templates you used Please refer to the documentation of each execution template you want to use to find out the dynamic outputs it can generate and the name to be used in the eBook file The eBook system itself does not have the knowledge of what output will be generated it simply take what the execution engine throws out and match those with the dynamic content names you put in the eBook content Adding a template parameter input area Instead of giving a value for all
4. lt tabular gt Then in your eBook content using an attribute data deep expression you can define the path to the value you want to access and include it in your document The expression uses syntax of XPath which is a language recommended by W3C to navigate through elements and attributes in an XML document For example in the following component in an eBook This dataset has lt span class deep dynamic output data deep id datasetl summary data deep expression row row woman element col Count text gt lt span gt rows the value of data deep expression is a XPath expression that indicates the text of the element with attribute name Count in the row with attribute row equals to woman In this example when the datasetl summary output becomes available this component will be shown in the eBook reader as This dataset has 2867 rows Selecting the rows and columns to be displayed The eBook system provides two attributes data deep only and data deep except for the author to specify which rows and columns of an dynamic output to display For example inserting the previous example s datasetl summary with the following code div data deep id datasetl summary class deep dynamic output data deep only Mean Count data deep except cons gt 42 4 Advanced Guide for eBook Authors will produce the display shown in Figure 4 6 in which the Std column and the district row are not sho
5. lt div activityregion002 class deep activityregion gt div id ebookpage004 class deep gt Content of page004 div div data deep id ebookpage005 class deep page Content of page005 div lt div data deep id ebookpage006 class deep page Content of page006 div The names of the activity regions need to match the names you have defined in the N3 file but without the symbol The name of each page can be any combination of letters and numbers for the identifier as long as it is unique in this eBook Please note that the activity region wrapping is the top level marker of your content they cannot nest within each other Any content that is not wrapped in an activity region div will NOT be rendered to the eBook reader 4 4 3 Chapter and Section Headers You can add your chapter and section headers using standard HTML header markers You are free to use all available header levels h1 h6 in HTML to structure the chapter and section headers into a proper hierarchy this will then be rendered in the content outline section during the reading process You need to add the chapter and section numbers together with the header name if required as the eBook system will not number them 38 4 Advanced Guide for eBook Authors If you are making one activity region for each chapter you can allow the chapter header to be displayed at the top of all the chapter pages by
6. 3 Getting Started as eBook Reader 3 3 2 The Information area There are five tabs in the information area The content tab displays the actual content of the resource whilst the information tab shows some general descriptive information concerning it The provenance tab shows the provenance of a resource this is the information generated during the reading process regarding the resource s relationship with the reading process execution processes and other resources The export tab provide the link for the user to export the resource in certain format available Currently it supports exporting the content of resources in CSV format More detail can be found in Section 3 3 4 The authoring tab provides useful tools for eBook authors please refer to Chapter 4 for more details of this panel Content Information Provenance Authoring Export The queried object with URI urn_uuid 996c1025 82f5 11e1 ad29 00a0c6000000 RESERVED provjstype entity ebook Rsrcldentifier urn uuid 996c1025 82f5 11e1 ad29 00a0c6000000 ebook RsrcType estat ModelSpec dcterms description Model specification Content Information Provenance Authoring Export You queried for the provenance of the resource with URI urn uuid 996c1025 82f5 11e1 ad29 00a0c6000000 This resource wasDerivedFrom urn uuid dadcce30 be80 1160 a765 003048d59cdd 21LevelMod 1LevelMod type estat Template urn_uuid 99699f21 82f5 11e1 acb9 00a0c6000000 type estat Templatelnp
7. i 1 1 1 1 1 1 Figure 3 1 eBook system main page 3 Getting Started as eBook Reader 3 1 1 Importing an eBook As an eBook reader you will usually have access to one or more eBooks each in the form of a single zip file saved on your hard disk or flash drive You need to import the zip file of an eBook into the eBook system before it can be read To import an eBook file click on the button Import on the system menu black bar at the top of the eBook system main page EStat E Book reader Impor Figure 3 2 Import button A dialogue box will be opened for you to specify the location of the eBook file on your disk Currently the eBook system can only accept an eBook file saved on your hard disk flash drive or network drives Import E Book Select an E Book file Browse Figure 3 3 eBook import dialogue After selecting the correct eBook file press the green import button in the lower right corner of the dialogue box The box will then close and the system will perform a file check for the content in the eBook file A page with the result showing possible error and warning information will be displayed as soon as the checking is finished As shown in Figure 3 4 you will need to select whether to proceed with the import at this stage If you press Import the system will proceed If you press Return the system will abandon the import process and go back to the main page Please refer to
8. jtemplate1 graph_beta1 Link to export templatei graph deviance _ the resource template 1 input template 1 model template 1 modelfit E template1 output Th template1 summary e resource FToday at 12 03 64 you viewing Figure 3 23 Exporting a resource Home Insert Page Layout Formulas Dat f i ana Calibri ju A Copy Paste ER lt J Format Painter B U iE S 4A a Clipboard Font 0 Opening output csv 4 pening outpi Al amp deviance You have chosen to open B c D E G output csv deviance Ibeta1 beta 3845 056 0 012091 0 38746 3845 084 0 012775 0 38746 10 3845 084 0 012775 0 38746 which is a CSV file 2 3847 242 0 013259 0 47549 from http 127 0 0 1 8080 3 3846 759 0 013259 0 35855 What should Firefox do with this file 4 3846 759 0 013259 0 35855 5 3846 759 0 013259 0 35855 Open with Microsoft Office Excel default x BE 505 297 02091 0 3 7934 Save File 7 3845 397 0 012091 0 37934 8 9 Do this automatically for files like this from now on e 11 3845 084 0 012775 0 38746 12 3845 237 0 014748 0 39455 4 2045 227 nni4749 A Figure 3 24 Save and open the export file 3 3 5 Reversing the eBook content to a previous state In Section 3 2 we learnt how to regenerate the dynamic content multiple times by giving different answers to an input question The eBook co
9. 2 1 1 eBook System OVeEIV eW YR CRY ERR COR ERA ROS 2 1 2 Abou utthis User Guide ici edd ee d ER HAE FREE AERE EA EAR RE ARRA HEN 2 1 3 a Er LE ER E V LE a D LEER P VR LET ER 2 P exdd INSTALLATION e 4 2 1 System Installation 2 1 1 Pre installation requirements 2 2 System Conf ig ration case iode dana aded 5 GETTING STARTED AS AN EBOOK READER ee eeeee esee eese esses ss sss sanas ss sss assa essa 7 3 1 eBook System Main pagere cato t Ra P TER a oa ree EET PAR EE YR BR aa ba dens ee PETRAM R ENTER RE RRERT OPER US 7 341 Importing an eBook oce rere eee n ie Fe aenea ve areae dne de erae aea exea o eer nada 8 3 1 2 i Creating a Reading Process icc estote rere ee dee teo Pete Ree vae get ea exte e a 11 3 1 3 Resuming an Existing Reading Process csccccccssececeececeeseececeeaececeeeeeceeseeecseaaececeeaeeceeseeeceeaeesseeaaees 12 3 2 eBook Reading Interface nus i AREE ER ER ERE CR ERR AER RIEN 12 3 2 1 System MENU sene e reor En ertet t aon Debe e Pen REED CE DER eae a Ba Do Lab aeu euo eae 13 3 222 Reading Area p e e nr ada Ute n os i de ae ek eR RESERVE aera 14 3 2 3 Reading an eBook with Dynamic Content
10. 3 The Authoring Tab in Resource View s ssscccccsssssssscsecsssessnsseesecessessnsnesseceescsecanessecesessesanensececeseenes 50 5 APPENDIX eee 52 Appendix ebookdef n3 file for the example eBook described in Section 4 1 essen 52 Appendix Il An example ebookpages n3 54 Appendix III List of HTML Markers Introduced in eBook 5 5 57 User Guide Page iii 1 General Information 1 GENERAL INFORMATION 1 General Information 1 GENERAL INFORMATION 1 1eBook System Overview The purpose of the eBook system one of the many features of the Stat JR software package which is created as part of the ESRC funded e STAT project is to embed the executable software packages used by Stat JR within traditional notebooks thus producing an interactive reading experience The resulting executable books combine the narrative advantage of traditional books with the experimental and interactive advantages of software packages and provide an improved and more user friendly experience 1 2 About this User Guide This User Guide provides step by step instructions on how to import and read them whilst more advanced users interested in creating their own eBooks will find an under the bonnet description of how to author their own 1 3User Levels cBook reader An eBook reader is a user who i
11. BE activityregion001 class deep activityregion gt hl Chapter 1 title of chapter 1 hl hr lt div id ebookpage001 class deep page lt h2 gt Introduction lt h2 gt lt p gt sample text content paragraphs lt strong gt this is in bold font lt strong gt lt p gt lt div class deep static img lt img src example static image gif alt br Figure 1 example static image div lt div gt lt end of ebookpage001 gt div data deep id ebookpage002 class deep page lt h2 gt Input Model and Equations lt h2 gt lt p gt sample text content paragraphs lt p gt lt p gt There are inputs to be specified for Stat JR before model fitting please select lt strong gt cons lt strong gt and lt strong gt age lt strong gt in the list below lt p gt lt div data deep id templatel inputq class deep dynamic output deep dynamic hidden lt div gt lt p gt After you submit the input of explanatory variables you should find that Stat JR has produced below a nicely formatted mathematical description of the model in LaTeX code and a variant of the model specification language associated with the WinBUGS package lt br gt lt p gt lt div class deep textarea deep dynamic hidden lt strong gt Equation rendering lt strong gt This is the example of static text that shows with together with the dynamic content when it becomes available div
12. It is bound exclusively to one of the activity regions and can be uniquely identified by its identifier This avoids confusion and the need to make multiple copies of a given resource Example Here we describe an example eBook to illustrate the concept of an activity region and resource binding This example eBook will also be used in the other sections later in this chapter For this example we have created an eBook that describes modelling binary data with Stat JR The structure of the example eBook is shown in Figure 4 3 The eBook explains how to fit single level and multi level models highlighting the difference between them by fitting the model using two different templates 1LevelMod and 2LevelCat The same dataset Bang is used throughout We divide the eBook into two activity regions ActivityRegion001 and ActivityRegion002 that contain the resources for the two templates respectively The author can use any combination of letters and numbers for the activity region identifiers as long as they are unique in this eBook We then create the binding resources Each activity region will need to be bound to the templates that the author would like to be used within it as well as those templates input and also a dataset For each binding resource an identifier is given by the eBook author as an internal name Again the author can use any combination of letters and numbers for the identifier as long as it is u
13. Section 4 5 2 for details of the file checking function and the error warning messages 3 Getting Started as eBook Reader EStat E Book reader Main page n3 file struct error no n3 struct error n3 file struct warning no n3 struct warning HTML file checking error no HTML error HTML file checking warning no HTML warning Import Return Figure 3 4 File checking result page If you have selected to proceed in the previous step the system will import the eBook file and a message about the import result will be displayed If the eBook file has been imported successfully a green success message as shown in Figure 3 5 will be displayed EStat E Book reader Main page Success Your eBook has been Imported Return Figure 3 5 eBook import status page success An eBook file can only be imported once into the system When you attempt to import an eBook file that has already been imported in the system a blue eBook exists error message as shown in Figure 3 6 will be displayed 3 Getting Started as eBook Reader EStat E Book reader Main page eBook already exists The eBook you uploaded is already in the system please create a new reading process for the existing eBook if you would like to read it again Return Figure 3 6 eBook import status page eBook exists If the eBook file you are importing is broken or is not a valid eBook file a red failed error message will b
14. cannot be identified suggested e Attributes of the resource with type TemplateInput are not checked Checking ebookdef ttl with ebookpages html After checking the Turtle file the filechecker will proceed to check the ebookpages html file mainly aiming to identify incorrect usages of the resources defined in the ttl The filechecker only checks the ebookpages html file when there is no error found in the ebookdef ttl file warnings are allowed Syntax errors The system will not check the consistency of the html syntax relationship structure errors warnings The possible errors and warnings related to the ebookpages html file are listed as below 1 An ActivityRegion defined in Turtle not used in HTML 2 ActivityRegion used in HTML not defined in Turtle 3 resource binding name used in HTML not defined in Turtle 4 resource binding name defined in Turtle not used in HTML 5 A resource binding name is not used inside the ActivityRegion that binds with it in Turtle Integration of filechecker with eBook system Checking during eBook import 47 4 Advanced Guide for eBook Authors When the user imports an eBook file the system loads the filechecker to check the consistency and displays the error warning messages in a message page The errors are the issues identified that can cause the eBook system to malfunction while the warnings are the issues identified as not complying with the eBook general writing guidel
15. data deep id templatel equations class deep dynamic output deep dynamic hidden div div lt div id textarea model class deep textarea deep dynamic hidden lt strong gt Model lt strong gt lt div data deep id templatel model class deep dynamic output deep dynamic hidden div div lt div gt lt end of ebookpage002 gt lt div id ebookpage003 class deep page lt h2 gt Results Summary and Graphs lt h2 gt lt p gt Sample content paragraphs The outputs of a model run can be distributed on multiple pages they will be shown as long as they are all in this same activity region lt p gt lt div id dynamicarea_templsummary class deep textarea deep_dynamic_hidden gt Here are the summary statistics from running the model lt div data deep id templatel summary class deep_dynamic_output deep dynamic hidden div lt div gt lt div class deep_dynamic_hidden gt Here is a graph for deviance lt div data deep id templatel graph_ deviance class deep dynamic output deep_dynamic_hidden gt lt gt 54 5 Appendix You can put large portion of text with the dynamic content as large as you like and you can also nest multiple outputs under one hided div lt p gt lt p gt The deviance formula for a Binomial model is lt p gt You can use static image in the dynamic area as well lt br gt lt div data deep id another static image c
16. ebook hasName is there for author to specify a nick name for the file This name is not used by the system to drive any functionality except being displayed as an attribute of the file resource to the user in the information tab of resource view The type of each resource is defined by the value of its RDF type property which is presented as a in the Turtle file The type value consists of a name space which indicates whether the resource is a e Stat type or a eBook exclusive type and a type name Table 4 1 lists the RDF types used in the ebookdef ttl file 34 4 Advanced Guide for eBook Authors Type of resource RDF name space used RDF type name o ebook ActivityRegion sini ore o Execution template estat Template ELLEN 000 estat TemplateInput Table 4 1 RDF types used in the ebookdef ttl file Please note that the type names are case sensitive Currently the input value pairs are defined directly in the ebookdef ttl file as properties of the input sets Defining binding resources The declared eBook execution resources then need to be associated with corresponding activity regions For each resource association a binding resource needs to be created with a unique binding identifier as well as an ebook resource property pointing it to one of the resources already declared The activity regions are then linked to the appropriate binding resources by putting the URI of the binding resources in the value of
17. es es es es es es es es es es es es es es es es es es es es Ly ateInput out 1000 tinput tinput y use tinput Engine eSTAT tinput EstM yes tinput outdata tinput seed 1 tinput burnin tinput iterations tinput thinning 1 tinput link logit tinput n cons emplateInput lLevelMod uiltIn lLevelMod 2LevelCat 2LevelCat 5000 5000 tinput L2ID district tinput D Binomial tinput link logit tinput n cons tinput y use tinput cons cat No tinput district cat Yes tinput age cat No tinput use cat Yes tinput use4 cat Yes tinput lc cat Yes tinput urban cat Yes tinput educ cat Yes tinput hindu cat Yes tinput d lit cat No tinput d pray cat No tinput outdata out tinput Engine eSTAT tinput EstM yes tinput seed 1 tinput burnin 1000 tinput iterations tinput thinning 1 53 5 Appendix 5 Appendix Appendix Il An example ebookpages html file This is an example ebookpages html file that involves all the functionalities introduced in Chapter 4 The name of dynamic outputs and activity regions are aligned with the ebookdef ttl file in Appendix I
18. gt to specify the dynamic content that the element should appear with For example div class deep dynamic hidden data deep showon templatel inputq This text will appear when templatel inputq becomes available div div id templatel inputq class deep dynamic output deep dynamic hidden div Please note that if you put headers in the static content in the element they will also be initially hidden in the table of contents block and will appear in the table of contents only when the corresponding dynamic content becomes available Hide element when a dynamic content becomes available 43 4 Advanced Guide for eBook Authors To hide a visible element when a dynamic content becomes available simply add the element with class deep dynamic visible to make sure it is visible at the beginning Then add the property data deep hideon dynamic content name gt to specify the dynamic content that the element should disappear on it becoming available For example div class deep dynamic visible data deep hideon templatel inputq This text will disappear when templatel inputq becomes available div div id templatel inputq class deep dynamic output deep dynamic hidden div Please note that if you put headers in the static content in the element they will also be removed from the table of contents when the corresponding dynamic content becomes available Use the output data in furthe
19. menu the information area of the resource view will initially be blank and you will need to click on a resource in the resource tree view in order to view its information 19 3 3 4 Resource Tree view About Resource Static dataset1 emplate1 emplate1 input Runs at 15 41 36 I at 15 41 36 FToday at 15 56 42 dataset1 template1 template1 emplate1 equations emplate1 input Figure 3 20 The resource tree 3 Getting Started as eBook Reader The resource tree view shows the resources used in the current section of the eBook divided into two categories Static and Runs The static resources are usually those included by the eBook author to enable the executions these may include execution templates datasets and predefined input sets Under the Runs category you will find the executions that have been carried out in the current eBook section These are displayed and ordered by their start time Each of the executions can be further extended to show a sub tree of all the resources used and generated by it This allows the reader to access the resources that the author may not have shown in the eBook reading content such as the actual template and dataset used and many execution outputs that are generated but not used in the eBook reading content by the author The resource which has its information currently displayed in the resource view is highlighted in the resource tree view 20
20. or navigate within the content area 1LevelMod Template documentation Previous 1 2 3 4 5 6 7 8 EY 14 15 Next Go to page selecting cons and one other usually standirt the list below as the E book will only show diagnostics for the first two predictors explanatory variables school student normexam cons standirt girl schgend avsirt Schav vrband Submit about After you submit the input of explanatory variables you should find that Stat JR has produced below a nicely formatted mathematical description of the model in LaTeX code and a variant of the model specification language associated with the WinBUGS package Previous 1 2 3 4 5 6 8 14 15 Next Go to page Figure 3 13 The main reading area with the title and page number list blocks At the top and bottom of the reading area you will find the eBook title and also the page number list The page number list block displays a list of pages contained in the eBook with the current page highlighted in light blue You can click on a page number to jump to it or you can used the previous and next button to move to adjacent pages For long eBooks the page number list will only show a few page numbers but there is also a page number input box at the end of the list where you can enter the page number of the page that you want to jump to e g if not otherwise shown in the list 14 3 Getting Started as eBook Reader 3 2 3 Reading
21. system will load the reading interface with the content of your selected eBook If it is a new reading process i e if you are not resuming a saved one the eBook will be displayed from the first page Figure 3 11 shows the general reading interface of the eBook system 12 3 Getting Started as eBook Reader EStat E Book reader Upload Save Export B pro 1LevelMod Template documentation title menu Fiti ked IlllIIIIIIIIIlIIlIIlIIIIlIIIIIIIlIIlIIlIlIIlIIlIIIIIIlIlI l l0 ll l RS Previous 1 2 15 16 7 14 15 Next gt Gotopage number list Hy 9999999 Una ee et selecting cons and one other usually standlrt in the list below as the E book will only show diagnostics for the first two predictors EFFitting tutorial dataset using E STAT TN explanatory variables Introduction school student Example 1 tutorial dataset normexam cons St and 1 tari quations giri Algorithm for this model schgend schav Graphs vrband WinBUGS Model Equations Results Summary and Graphs Submit about After you submit the input of explanatory variables you should find that Stat JR has produced below a nicely formatted mathematical 1 ij 1 1 1 1 1 1 1 1 1 1 Results Summary and 1 1 1 1 1 1 1 1 1 1 1 1 i description of the model in LaTeX code and a variant of the model specification language associated with the
22. this procedure multiple times The dynamic content in the eBook will always be updated with results based on the last input value you submitted 16 3 Getting Started as eBook Reader EStat E Book reader Upload Save Export 1LevelMod Template documentation Finished lt Previous 1 2 3 4 5 6 7 8 iss 14 15 Next Go to page Submit lt _______ Submit a C Fitting tutorial dataset using different E STAT answer about Introduction After you submit the input of explanatory variables you should find that Stat JR has produced below a nicely formatted mathematical Example 1 tutorial dataset mr a gt 2 8 description of the model LaTeX code a variant of the model specification language associated with the WinBUGS package Input Model and Equations Equation rendering Below you will see the Equations that mathematically represent this model in a Bayesian framework Note that default flat prior distributions Algorithm for this model have been used Results Summary and Graphs io dataset using normexam N u o in yas Model and Equations Bocons girl Results Summary and Bg x1 Dynamic Graphs x1 content E dataset using are T 0 001 0 001 updated sss Model and Equations 1 i T Results Summary and about Graphs EFEittine hitarial datacat neinn Model Figure 3 16 Regenerating the dynamic content with a different answer to an input question 3 2 5 Reg
23. using the Universal Unique IDentifier UUID The author can use any tool that generates a standard UUID identifier including the UUIDURI eBook provided by default in the package and use it as the base URI at the beginning of the RDF Turtle file base urn uuid dadcce30 be80 11e0 a765 003048d59cdd 32 4 Advanced Guide for eBook Authors Note the full stop sign required by the Turtle syntax at the end of the line Namespace definition The namespaces used must be defined at the beginning of the file The namespaces used in the eBook definition are as follows prefix estat lt http purl org net statjr ns gt prefix estatinput lt http purl org net statjr input gt prefix ebook lt http purl org net deep ns gt prefix dcterms lt http purl org dc terms gt Simply copy this portion of code and put it at the beginning of the Turtle file after the base URI definition Also note the full stop sign at the end of each line Providing general information about the eBook file The author should also provide some general information about the eBook here There are four mandatory properties dcterms created dcterms creator dcterms description and dcterms title these provide the creation date author name short description and the title of the eBook respectively The definition of the example eBook described in Section 4 1 is shown below lt gt a ebook EbookFile dcterms created T
24. 2867 827 63156 Today at 12 03 54 use 2867 0 48933 Figure 4 10 Preview result of row column selection To evaluate a XPath expression simply type or paste your it into the Expression input box and click on Evaluate button the result will be displayed underneath the input area For example in the example the data in the row woman and the column Count is 2867 the result of expression row row woman element col Count and gt 1000 will be shown as 2867 while the expression row row woman element col Count and lt 1000 produces an empty result 50 4 Advanced Guide for eBook Authors About Resource Content Information Provenance Export dataset Only emplatet input Except Expression 7 Today at 11 54 39 arial an Hrow row woman Velement col Count Today at 11 54 39 Today at 11 54 46 at 12 03 33 Today at 12 03 54 Result 2867 Figure 4 11 Preview result of row column selection 51 5 Appendix 5 APPENDIX Appendix I ebookdef ttl file for the example eBook described in Section 4 1 base lt urn uuid dadcce30 be80 11e0 a765 003048d59cdd gt prefix de lt http purl org dc elements 1 1 gt prefix estat lt http purl org net statjr ns gt prefix estatinput lt http purl org net statjr input gt prefix ebook lt http purl org net deep ns gt prefix dcterms lt http purl org dc terms gt lt gt a ebook EbookFile dcterms created
25. An importable eBook is in the form of a zip file that contains all its content and resources The file structure inside the zip file is illustrated by the example shown in Figure 4 1 amp static amp html S dataset summary gif ebookpages html equation01 gif ebookdef n3 Figure 4 1 File structure inside an eBook file Currently there are two main parts e the static eBook content in the folder static html e the resource organisation definition file ebookdef ttl 4 1 2 Organization of Resources Understanding the logical organisation of resources contained in an eBook is essential to making an eBook execute correctly The basic resources contained in an eBook include e the templates the self contained objects which perform specific tasks These are written by advanced users and are usually in the form of a python module file e datasets the raw data sets consumed by the execution templates usually in the form of a STATA data file with dta extension 27 4 Advanced Guide for eBook Authors e the inputs the parameter values required by the execution templates to carry out their tasks e the eBook content the actual content that will be shown to the eBook readers including text images tables and template outputs The eBook content is further organised into multiple activity regions which can be thought of as different book chapters Figure 4 2 shows the logical organisation of these reso
26. Tue Jul 02 16 56 47 2011 dcterms creator Yang Huanjia dcterms description An example of imported eBook dcterms language en dcterms title Modelling binary responses ebook hasActivityRegion ftactivityregion001 lt activityregion002 gt lt activityregion001 gt a ebook ActivityRegion ebook hasBinding lt templatel gt lt datasetl gt lt inputl gt lt activityregion002 gt a ebook ActivityRegion ebook hasBinding lt template2 gt lt datasetl gt lt input2 gt lt templatel gt a ebook ResourceBinding ebook identifier templatel ebook resource lt 11 1 gt lt template2 gt a ebook ResourceBinding ebook identifier template2 ebook resource lt 2levelCat gt lt datasetl gt a ebook ResourceBinding ebook identifier datasetl ebook resource lt bang gt lt inputl gt a ebook ResourceBinding ebook identifier templatel input ebook resource lt input001 gt lt input2 gt a ebook ResourceBinding ebook identifier template2 input ebook resource lt input002 gt lt llevelMod gt a estat Template 52 ebook hasName ebook isB lt 2levelCat gt a estat Template ebook hasName ebook isBuiltIn lt bang gt a estat Datase ebook hasName Bang ebook isBuiltIn bang tinput001 a estat Templ j t D Binomial es es es es es es es es es es es lt input002 gt a estat T es es es
27. UsER GUIDE for the eBook system developed as part of the Stat JR software package UNIVERSITY OF Southampton School of Electronics and Computer Science University of Southampton Revision Sheet Revision Sheet v2 4 04 01 2012 Having multiple templates in the same Activity Region Adding dataset summary as a dynamic output without template run Adding template input set as a separate file Attaching resource files template dataset to eBook file Added bottom page number list Added page number input box Added reloading function in eBook reading interface for authoring Added eBook filechecker function and its integration Release No Date Revision Description v2 5 21 03 2012 Updated version based on the comments from Bill New style and linked table of contents consistent page numbering V2 6 30 03 2012 Updated based on comments and questions from Camille Updated figures and text for interface changes of menu and rsrc veiw Added hideon showon attribute Added data access in tabular type output with XPath expressions Added uploading user s own dataset Added showing only selected rows columns in tabular output Added appendix of a list of markers introduced in eBook Added authoring tab in resource view 10 04 2012 Updated based on comments from Danius V2 7 1 11 04 2012 Revised structure for section 4 4 and other minor updates User Guide Pagei USER GUIDE TABLE OF CONTENTS TGENERAL INFORMATION e
28. WinBUGS package 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 avsirt 1 1 1 1 1 1 1 1 1 1 1 1 D EFFitting tutorial dataset using D 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 iC Fitting tutorial dataset using 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 OpenBUGS eee err rr rrr rrr rrr Input Model and Equati if ef EN Readin odel and Equations previous 1 2 5 7 14 15 Ne Goto 8 Results Summary and Leer rere terete nem Page number list Table of contents Figure 3 11 eBook reading interface 3 2 1 System Menu After you enter the reading interface more options will be available on the system menu see Figure 3 12 EStat E Book reader Upload Save Export Figure 3 12 System menu of reading interface The Resources button on the right of the system menu opens a resource view with information about the current eBook executions running behind the scene Further details about the resource view will be provided in Section 3 3 Currently the Save and Export buttons are not supported 13 3 Getting Started as eBook Reader 3 2 2 Reading Area The majority of the reading interface is occupied by the reading area The contents of the eBook are displayed within this reading area You can scroll
29. _dir_path The draft eBook directory path starts with if the path is inside and is relative to the ebooktest directory For example for an eBook draft folder with name 4 located in the tests directory of the ebooktest system the command to check it is The checking result will be displayed as shown in Figure 4 9 In this example there are several warnings given regarding the ebookdef ttl file 49 4 Advanced Guide for eBook Authors Figure 4 9 File checking result in command line 4 5 3 The Authoring Tab in Resource View The eBook system provides tools in the authoring tab which locates in the resource view to preview the result of your row column selection or a XPath expression To use the tools open the resource and go the authoring panel Then select the tabular output you want to process in the resource tree on your left hand side If you have opened the resource view by clicking on the about button to the right of the tabular output then it will be selected by default To preview the tabular output result enter the row column selections in the Only and Except input boxes and click the Update button The preview will be displayed underneath the input area as shown in Figure 4 10 About Resource Content Information Provenance Export Only dataset Count Std Except Expression Today at 11 54 39 L gatasett summary Today at 11 54 39 Today at 11 54 46 Name Count std Today at 12 03 33 i woman
30. add the following dynamic output div at the position where you want the input question to appear lt div id templatel inputq class deep dynamic output div As the input question is handled as dynamic output in the eBook you can also provide default content or add static content to be displayed with it using the methods described in the previous section 40 4 Advanced Guide for eBook Authors Adding a dataset summary You can add a dynamic output that displays the summary of a dataset in the current activity region The dataset summary will be shown before the template s in the same activity region being executed To add such an output put a div with class deep dynamic output and id in the format of lt dataset_bindingname gt summary at the position where you want the data summary to appear For example to show the summary of a dataset with binding name dataset1 add the following code lt div data deep id dataseti summary class deep dynamic output deep dynamic hidden div As the dataset summary is handled as dynamic output in the eBook you can also provide default content or add static content to be displayed with it using the approaches described in the previous section Default content for dynamic output You can put static content inside the dynamic output div either as a default display or as a message to the reader before the output is generated For example the following div means that the eBo
31. age name gt lt div id ebookpage 006 1 gt lt h2 gt Results lt h2 gt You can use Latex in your content and they will be rendered lt p gt normexam_i sim N X beta Omega normexam beta_ 0i cons beta_ 1li standlrt i This is the model written in bugs model specification language lt p gt lt div data deep id template2 model class deep dynamic output deep dynamic hidden div p Some more explanation can be provided here for the model generated p lt div class deep dynamic hidden lt p gt Here is a graph for beta0 lt p gt lt div data deep id template2 graph_ beta0 class deep dynamic output deep dynamic hidden lt div gt lt p gt Some more explanation can be provided here for the graph generated lt p gt lt div gt lt div gt lt end of ebookpage_006 gt lt div gt lt end of activityregion002 gt 56 5 Appendix Appendix Ill List of HTML Markers Introduced in eBook System Class type introduced to be used as value of a HTML element s class attribute deep activityregion Mark a div as an eBook activity region deep page Mark a div as an eBook page deep dynamic output Mark an element as a dynamic output deep dynamic hidden Mark an element as invisible deep statio img Mark an image element to be displayed with format pre defined by eBook system
32. an eBook with Dynamic Content EBook contains dynamic content which are results generated by the executions defined in the eBook They are generated during eBook reading based on input given by both author and user and are inserted and rendered to the user when they become available In general the dynamic content can be categorised into two distinct groups input questions and execution results An input question can be a text box a drop list or a select box allowing you to specify certain parameter values required by the executions running behind the eBook Figure 3 14 shows an example in which an input question is displayed in the form of select boxes EStat E Book reader Upload Save Export Debug Resources 1LevelMod Template documentation Finished Border of the dynamic content lt Previous 1 2 3 4 5 6 T 8 yes 14 15 Next Go to page We have chosen normexam as the y variable and now you will need to choose the X variables and software for fitting We recommend Fitting tutorial dataset using selecting cons and one other usually standlrt in the list below as the E book will only show diagnostics for the first two predictors E STAT Introduction Example 1 tutorial dataset explanatory variables 7 cons student standirt Input Model and normexam Equations cons Algorithm for this model em Results Summary and schgend Graphs avsirt schav Fitting tutorial dataset using vrband WinBUGS mu Model and Equations Sub
33. c text can be put directly into the ebookpages html file in a similar manner to adding content in a HTML web page The eBook system will do general styling for this content It also supports any HTML inline style that you include For example you can highlight a word or a part of text by making it bold or coloured 36 4 Advanced Guide for eBook Authors Static images are also inserted in the standard HTML manner Simply put the image file in the same folder as the ebookpages html file and then in the file content add the following marker in the position you want the image to be displayed lt img src image file name a In order for the system to style it correctly we suggest that you wrap the image within an HTML block with the pre styled class deep static img An example with an image name follows div data deep id dataset_summary01 class deep static img img src dataset summary gif alt br Figure 1 lt div gt Tables can also be inserted in the form of standard HTML tags You can also insert mathematical symbols and equations in LaTeX code For the LaTeX code to be identified and rendered by the system you need to wrap it with and which makes an inline maths equation or and which produces the equation in the middle of a new line For example the following html code lt p gt This is an equation mbox normexam i sim mbox N mu_i Nsigma 2 It is an example lt
34. currently you do not need to declare the pages in the n3 lt p gt lt div class deep dynamic hidden lt p gt You are not required to give id to the dynamic divs that nest dynamic outputs with their accompanying static content but you can do so for your own convenience lt br gt Please select lt strong gt cons lt strong gt lt strong gt age lt strong gt and strong lc strong as explanatory variables below p div data deep id template2 inputq class deep dynamic output deep dynamic hidden div div div class deep dynamic hidden lt p gt lt strong gt Equation rendering lt strong gt lt p gt lt div data deep id template2 equations class deep dynamic output deep dynamic hidden div div lt p gt lt div gt lt end of ebookpage_005 gt lt div data deep id I am an ebook page name class deep page gt lt h2 gt Model run summary lt h2 gt The system does not care what you give as the id of the page divs it generates page number by counting the pages you defined for example you can set the id of a page as template2 resultpage if that makes more sense to you lt p gt Once the model has run as well as noting the change in the coefficient of age we see that the DIC is considerably smaller lt p gt lt div data deep id template2 summary class deep_dynamic_output deep dynamic hidden lt gt lt div gt lt end of am an ebook p
35. d ER ende Eee EM eden e Bro doe 30 42 1 Template and Dataset reae ee eae ene peteret een eene peur oen 30 4 2 2 Templatenput rt RR TEE UR EE ERR RBS ERATES GE TR 30 4 2 3 Resource File EoCatlOT ier E e eger eie x ipe cease idisse tuse 31 4 3 ebookdef n3 Defining the Resource Organisation 31 4 4 ebookpages html Writing the 36 4 4 1 Adding Static Content Text Images and LaTeX ccccesccccecsssssseceeececeesesaeceeeesceeseeaeseseesceeseeasaeeeeseeeees 36 User Guide Page ii 4 4 2 Making Chapters and Pages esee ite edere De e eee Reed eR 37 44 3 Chapterand SectioniHeaders err eerte ta ene nee oe eva enean rd eee Pe FR GaU pns 38 AAA Adding Dynamic Content ine cec RERBA EUREN TERRIER EE RARE SLE ERHEBEN REOR 39 4 4 5 Accessing and configuring dynamic 41 4 4 6 Show Hide static element with dynamic content 43 4 5 Authoring neri see todo ad ete E e e bre a o dere dee 44 451 eBook Reloading To0l terere eerte deren PUn teen eee eu e Pea eer pev even PEL oen 44 4 5 2 TheeBookfFilechecker 5 esee hedecnedasvninehbsvnctaesgGocdebbededaesssbainebbdencbvetebacbenbededeengeasebente 46 4 5
36. e displayed as shown in Figure 3 7 EStat E Book reader Main page Import failed The file you uploaded is not an eBook Return Figure 3 7 eBook import status page failed After the import status message has been displayed press the return button to go back to the system main page If your eBook file has been imported successfully its title should now appear in the Your E Books list located on the left of eBook management area If you now click on the eBook s title in this list the author creation date and a short description will be displayed on the right hand side EStat E Book reader Impor Your E Books About Modelling binary responses Author Created at Tue Ju 16 56 47 2011 An example of imported he content is from given by and Bill of Bristol Description th Ricl Universit Figure 3 8 Selecting an imported eBook 10 3 Getting Started as eBook Reader 3 1 2 Creating a Reading Process An eBook can be read for multiple times by different users For each eBook the system deems the procedure and the inputs of a reader s reading as a reading process By doing this it allows each user to save and resume their own reading Start a new reading Start reading Figure 3 9 Creating a new reading process To read an eBook you must first specify a reading process You can do this by either creating a new reading process or by selecting an existing one For selecting an
37. enerating the dynamic content with your own dataset After reading the dynamic content you can regenerate them with your own dataset You will need to upload the dataset and the eBook will regenerate dynamic content with it To do this go to the System Menu of the reading interface and click on the upload button The system will open a dataset uploading dialogue as shown in Figure 3 17 File Upload Select a file to upload ew Browse Upload Figure 3 17 Dataset uploading dialogue Choose the dataset file on your computer with the Browse button and specify the corresponding binding name for it The binding name tells the system which template it should use with the new dataset 17 3 Getting Started as eBook Reader to regenerate the content It should be in the format of lt templatebindingname gt dataset To find out the binding name of the template you want you can use the resource view tools that will be introduced in Section 3 3 After uploading your dataset the eBook will then regenerate and update all the related dynamic content automatically 3 2 6 Table of contents A table of contents is located to the left of the reading interface It is rendered in a tree view The current section you are reading is highlighted in bold and this is automatically updated as you navigate the content in the reading area by scrolling or changing page You can also use it to navigate around the content of the eBook simp
38. existing one please refer to the next section To create a reading process for a particular eBook click and select the eBook you want to read in the eBook select box on the main page as shown in Figure 3 9 Then go to the Start a new reading area located towards the lower right of the page provide a name and if you want a brief description of the new reading process and press the green Start reading button to start reading your eBook as shown in Figure 3 9 Since you might want to read an eBook multiple times you can create as many reading processes as you like for each eBook in the system 11 3 Getting Started as eBook Reader 3 1 3 Resuming an Existing Reading Process EStat E Book reader Impor Your E Books Continue reading Figure 3 10 Resuming an existing reading process The status of your reading is automatically recorded by the system during your reading process You can always close leave the system or go back to the main page in the middle of your reading and come back later to resume the reading process from where you stopped To resume a reading process click and select the eBook the title of the existing reading processes for the eBook you have selected will then be displayed in the select box below Select the reading process you want to resume and press the green Start button to start reading again 3 2eBook Reading Interface After you create and start a new reading process the eBook
39. ey will be executed in a queue when the eBook reader enters the activity region However currently only one dataset can be bound in each activity region to be used by the templates contained The system does allow the user to upload their own dataset during reading to perform executions with those templates please refer to Section 3 2 5 for more details 4 4 ebookpages html Writing the Content After providing general information in the Turtle file the execution resources and their organisation are then defined The author can now edit the content 1 e the information the eBook readers will be able to see in the ebookpages html file In the eBook system the content is written in standard HTML Although there are extensive choices of HTML editor available some basic knowledge in reading and writing raw HTML would be helpful for eBook authors to organise an eBook quickly and correctly The system defines several HTML markers that the author can use to make pages and activity regions to specify when content should be hidden or shown and to mark the positions at which specific dynamic content will be inserted The author does not need to add any HTML headers or styles the eBook system will add these automatically before rendering the content to the eBook readers The ebookpages html file of the example eBook described in Section 4 1 can be found in Appendix II 4 4 1 Adding Static Content Text Images and LaTeX Stati
40. h use emplate1 input P use i dbin p i cons il logit p i lt cons i beta0 age i betal Today at 11 11 49 Today at 11 11 49 Priors SF Today at 11 11 55 beta0 dflat betal dflat Figure 3 19 The resource view Some readers may be interested in information beyond that shown in the reading area and the eBook resource view has therefore been developed to provide further details about the executions behind the content The resource view contains the structure of the resources used in the current part of the eBook and reveals more information about each resource by allowing the reader to see the content meta information and provenance of it It also allows the reader to export certain resources to be reused in other applications Figure 3 18 shows the resource view interface this consists of a large dialogue box with a resource tree view on the left hand side and an information area which displays further information about a particular resource in five tabbed panels There are two ways to access the resource view either via the Resource button in the system menu the black bar at the top or by clicking the About button on the lower right hand side of any dynamic output in the eBook reading area If you open the resource view by clicking an About button the resource view will be opened with the information relating to that dynamic resource displayed If you instead access it from the system
41. idth 114 gt lt p align right gt 2590 91 lt p gt lt td gt lt td valign top width 114 gt lt p align right gt 1 03 lt p gt lt td gt lt td valign top width 137 gt lt p align right gt 2592 96 lt p gt lt td gt lt tr gt lt tbody gt lt table gt lt p gt lt p gt And more you can have headers in the content that goes with the dynamic content They will be added into the table of contents as well when the dynamic content becomes available and the whole div becomes visible lt p gt lt h3 gt Graph beta 1 lt h3 gt lt div data deep id templatel graph betal class deep dynamic output deep dynamic hidden lt h3 gt Graph beta 0 lt h3 gt lt p gt And here is the lt strong gt beta 0 lt strong gt graph result lt p gt lt div data deep id templatel graph beta0 class deep dynamic output deep dynamic hidden div div lt div gt l end of ebookpage003 gt lt div gt lt end of activityregion001 gt lt Just duplicate the activity region div and change the content when you want to have more of them you can have as many activity regions as you want don t forget the declare them in the n3 file gt lt div id activityregion002 class deep activityregion gt hl Chapter 2 header of chapter 2 lt h1 gt lt div id ebookpage 005 class deep gt lt h2 gt Introduction input and model lt h2 gt lt p gt 55 5 Appendix
42. ines but are not harmful to the system itself The background colour indicates the state of the checking result If the colour is green it means there is no warning or error If you get warning but no error the colour will be orange which means the system can still proceed and the eBook can be read but with content or definition that is identified as suspicious the eBook may not read in the way that the author expects it to A red background message indicates that there is error in the eBook file and it is not recommended to proceed as the eBook will not be opened or read correctly At this stage the author will be asked whether to continue to import the eBook The options are provided by two buttons as shown in Figure 4 7 If you press Import the system will proceed If you press Return the system will abandon the import process and go back to the main page EStat E Book reader Main page n3 file struct error no n3 struct error n3 file struct warning The ResourceBinding urn uuid dadcce30 be80 11e0 a765 003048d59cdd dataset1 is associated with multiple ActivityRegions urn uuid dadcce30 be80 11e0 a765 003048d59cdd activityregion001 urn uuid dadcce30 be80 116e0 a765 003048d59cddsactivityregion002 HTML file checking error no HTML error HTML file checking warning no HTML warning Import Return Figure 4 7 File checking result displayed during eBook import Checking during eBook reloading When the user re
43. ivity region by defining its RDF type as an ebook ActivityRegion Declaring the eBook execution resources The resources used in the eBook need to be declared These include the templates datasets and input sets The resource declarations of the example eBook described in Section 4 1 are shown below lt llevelMod gt a estat Template ebook hasName 11 1 estat isBuiltlIn lLevelMod lt 2levelCat gt a estat Template ebook hasName 2LevelCat estat isBuiltIn 2LevelCat lt bang gt a estat Dataset ebook hasName Bang ebook hasFilename static bang py tinput001 a estat TemplateInput ebook hasName Input001 ebook hasFilename input001 py lt input002 gt a estat TemplateInput exscenabaoxu gIbZ1 D elenco P estatinput D Binomial Sete iajowic 3 Vogts Again note that a is put in front of the resource names to turn them into URIs under the base URI defined at the beginning of this section For each of these resources the author needs to give a name with attribute ebook hasName and point it to the file name of the physical resource with attribute ebook hasFilename or estat isBuiltin The difference is that ebook hasFilename is used to specify the name of the physical file saved in the disk or attached with the eBook and estat isBuiltIn is used to refer to a resource that comes with the StatJR system by default As the file name does not always specify what is contained the
44. lass deep static_img gt img src example static image2 gif alt div lt p gt you can use standard HTML table like this lt p gt lt p gt lt table class deep static table border 1 cellspacing 0 cellpadding 0 gt lt tbody gt lt tr gt lt td style text align center valign top width 136 gt lt td gt lt td style text align center valign top width 114 gt lt span style text decoration overline gt D lt span gt lt td gt lt td style text align center valign top width 114 gt D lt span style text decoration overline gt amp theta lt span gt lt td gt lt td valign top width 114 gt lt p align center gt lt em gt p lt sub gt D lt sub gt lt em gt lt p gt lt td gt lt td valign top width 137 gt lt p align center gt DIC lt p gt lt td gt lt tr gt lt tr gt lt td valign top width 136 gt Model with age lt td gt lt td valign top width 114 gt lt p align right gt 2591 37 lt p gt lt td gt lt td valign top width 114 gt lt p align right gt 2589 29 lt p gt lt td gt lt td valign top width 114 gt lt p align right gt 2 07 lt p gt lt td gt lt td valign top width 137 gt lt p align right gt 2593 44 lt p gt lt td gt ftr tr td valign top width 136 gt Model without age lt td gt lt td valign top width 114 gt lt p align right gt 2591 94 lt p gt lt td gt lt td valign top w
45. loads an eBook the system loads the filechecker to check the consistency and displays the result the system will then ask the author to decide whether to continue reloading The options provided by the buttons are shown in Figure 4 8 If Continue Reloading is selected the system will reload the eBook file If Cancel Reloading is selected the system will abandon the reloading process and go back to the previous reading interface 48 4 Advanced Guide for eBook Authors EStat E Book reader eBook authoring guide Previous 1 2 6 7 8 9 10 14 15 Next Go to page g Filechecker result n3 struct checking result Errors No error Warnings No waming HTML checking result Errors The resource binding name 0 used in the html is not defined in the n3 file Continue Reloading Cancel Reloading wunvene ur payeuus 3 7 Defining binding VES lt div id ebookpage006 class estat_ebook_page gt Content of 006 4 ebookpages html lt div gt Writing the Content lt div gt 4 1 Adding Static Figure 4 8 File checking result displayed during eBook reloading Calling checking from the command line The user can also call the filechecker from the command line for debugging purposes The location of the eBook draft s folder will be given as the parameter To execute the filechecker in the command line from within the ebooktest directory type python filechecker py d draft_ebook
46. ly clicking on a section name to go to the beginning of that section hapter 1 1 level model ntroduction Input Model and Equations esults Summary and Graphs bene beta 1 Graph beta 0 hapter 2 Multi level models ntroduction input and model odel run summary esults Figure 3 18 The table of contents view By default the tree view of the table of contents is fully extended but you can click on the or sign to the left of the corresponding higher level section name to extend or collapse its sub content As mentioned earlier eBooks usually contain dynamic content and this can be inserted or replaced during your reading with the table of contents automatically updating itself to reflect any such changes For example if we compare Figure 3 14 and 3 15 you will notice that Graph beta 1 and Graph beta 0 have appeared in the table of contents in the latter figure as the result of the user submitting their parameter selection even though the reading process has not reached that particular position in the eBook yet 18 3 Getting Started as eBook Reader 3 3eBook Resource View EStat E Book reader Modelling binary responses Previous 1 2 3 4 5 6 Next Go to page PROT UCU E vi IRA vuv yn CURA LUZ CUE unu u vunn VI UR er E unyuuyy uvvvviuwu v the WinRUGS nackaae About Resource ontent Information Provenance Authoring Export dataset1 emplate1 model ht for i in l lengt
47. mit Results Summary and Graphs about Fitting tutorial dataset using OpenBUGS After you submit the input of explanatory variables you should find that Stat JR has produced below a nicely formatted mathematical description of the model in LaTeX code and a variant of the model specification language associated with the WinBUGS package mou Model and Equations Results Summary and Graphs Previous 1 2 3 4 5 6 7 8 m 14 15 Next Go to page Figure 3 14 An input question in the form of a select box The execution results could be graphs tables texts mathematical equations and codes They do not usually consist of interactive elements and are simply inserted when they become available Figure 3 14 shows an example where dynamic content in the form of an equation is displayed after the reader has responded to the parameter request in Figure 3 14 if the reader had provided different input in this case different explanatory variables then the dynamic content would be different 15 3 Getting Started as eBook Reader EStat E Book reader Upload Save Finished Fitting tutorial dataset using E STAT Introduction Example 1 tutorial dataset Input Model and Equations Algorithm for this model 1LevelMod Template documentation Previous 1 2 3 4 5 6 7 8 p 14 15 Next Go to page about After you submit the input of explanatory variables you should find that Stat JR has produced below a nicel
48. n uuid 42d39151 7cb2 11e1 a45f 003048d59cdd type estat Questions urn uuid 42cf2482 7cb2 11e1 ab4f 003048d59cdd type estat ModelSpec urn uuid 3e7da4b2 7cb2 11e1 87bc 003048d59cdd type estat Questions urn uuid 42d1e3a3 7cb2 11e1 b6d0 003048d59cdd type estat Maths wasDerivedFrom this resource you queried Figure 3 22 Navigate within the resource view You can navigate around different resources by clicking on them in the resource tree the information in all tabbed panels will then be updated as you do so Alternatively you can click on a resource in the information area if it is available as a link The information in all tabbed panels will then be updated and the resource you clicked on will be highlighted in the resource tree view 3 3 4 Exporting a resource You can export the resource you are viewing through the link in the Export tab shown in Figure 3 22 After you click on the link your browser will ask you to save the export file in a popup window In the example shown in Figure 3 23 and 3 24 the resource exported is a data output resource that is exported as a CSV file Currently this is the only resource type you can export More resource types will be supported in future updates 22 3 Getting Started as eBook Reader About Resource Content Information Provenance Authoring Export template1 formula beta CSV template 1 formula beta1 template1 formula deviance template1 graph beta
49. nd the html file File checking is automatically triggered when the author imports a new eBook draft or selects to reload an eBook during reading It can also be called in the command line Errors Warnings that the file checker can identify in ttl file Syntax errors An ebookdef ttl file with any syntax error cannot be parsed by the system As the system cannot continue with parsing the Turtle file after reaching the first syntax error it will only indicate the position and type of the first syntax error even if there are many syntax errors in the Turtle file In such case the author will have to try checking the Turtle file several times with the system to identify and correct all of them The system cannot proceed to perform structure and relationship checking until all syntax errors are corrected Relationship structure errors warnings After the Turtle file is cleared of any syntax errors the system should be able to parse the ebookdef ttl file The system will then check for structural and relationship related errors or warnings to ensure all the constraints introduced by the eBook system are satisfied The possible errors warnings that will be identified by the filechecker are listed as follows 1 NoEbookFile is defined resource related Ebookfile type Error 2 than one EbookFile is defined resource related Ebookfile type Error 3 No ActivityRegions defined an eBook needs at least one resource related Activi
50. nique in this eBook The binding resources for the dataset in both activity regions point to the same dataset resource but with different identifiers 29 4 Advanced Guide for eBook Authors asActivityRegion iny Binding name hasB Binding name Ai resource Figure 4 3 Example of the organisation of eBook resources 4 2 Preparing the Resources 4 2 1 Template and Dataset File The template files are written by users who are usually specialists in building algorithms in certain fields and disseminating them as new templates The STAT JR software also provided many templates including the two used in the previous example that have been developed by the team of programmers behind STAT JR The dataset files can easily be assembled by any user in the form of a STATA dta file This User Guide focuses on the resources that are used exclusively in the eBook system For details of how to produce templates and dta files please refer to the corresponding documentation concerning Stat JR 4 2 2 Template Input File The inputs for a template can be given either in the ebookdef ttl file or in a separate input file If you want to define an input set as part of the ebookdef ttl file please refer to Section 4 3 In the case of a separate input file the eBook system can read inputs in two formats Python and JSON 30 4 Advanced Guide for eBook Authors Input file as a Python module To provide the inp
51. ntent will always be updated with the latest dynamic content based on your last answer However with the resource tree view you can reverse the content in the current section of the eBook to a previous state that was displayed at the end of a specific execution in your reading history 23 3 Getting Started as eBook Reader EStat E Book reader Modelling binary responses bd About Resource content Information Provenance Authoring Export 6 dataset Lemplate1 mplate 1 1 Whee The latest Today at 101907 execution Tew at 101936 Today at 14 55 40 js at 1511 13 B Today at 15 31 52 use Binomial cons mi logit r Bacons 2 urban 3o x1 5i x 1 about Model eBook with the latest dynamic E content ME betat a EStat E Book reader Modelling binary responses 1 2 bd About Resource Information Provenance Authoring Export dataset1 template input bg 5 Click PToday at 10 1907 previous E Today at 10 19 36 Today a 5540 execution imt 151 13 Today at 15 31 52 use Binomial cons 7 logit x Sgcons 8 age x 1 8i x1 about Dynamic content replaced with the results of the execution clicked model b Figure 3 25 Reversing eBook content to a previous state To do this simply click in the resource tree view on the execution you want to reverse to and the dynamic content in the current section will be replaced with that generated b
52. ok will display a line of text reading The summary will be displayed here after the model fitting in the position of the summary of templatel before it is actually generated lt div id templatel summary class deep dynamic output The summary will be displayed here after the model fitting div You can put in any type of static content but please note that after the corresponding dynamic output is generated it will replace all the static content inside the div so do not include any content that should always be shown inside the dynamic output divs 4 4 5 Accessing and configuring dynamic output Accessing the data in dynamic output Name Mean Std Count woman 1434 00000 827 63156 2867 district 29 25323 17 86300 2867 use 0 39728 0 48933 2867 use4 3 19847 1 08548 2867 lc 1 66864 1 24069 2867 41 4 Advanced Guide for eBook Authors Figure 4 5 Example of a dataset summary output The eBook system renders the output in a simple XML format For example for a dataset summary output in Figure 4 5 the XML format looks like lt tabular gt lt heading gt lt element gt Name lt element gt lt element gt Mean lt element gt lt element gt Std lt element gt lt element gt Count lt element gt lt heading gt lt rows gt lt row row woman gt lt element col Mean gt 1434 00000 lt element gt lt element col Std gt 827 63156 lt element gt lt element col Count gt 2867 lt element gt row
53. ollowing Python accompanying package s is are required by the Core Middleware module e Web py Python accompanying package for Resource management module The following Python accompanying package s is are required by the Core Middleware module e rdflib e rdfextras NET framework for Stat JR module Microsoft NET framework is required if you want to use the execution engine Stat JR which currently has some modules implemented in VB NET This requirement may be removed after the tool is migrated to Python 3 Getting Started as eBook Reader 2 2System Configuration You need to correctly configure the paths of various execution engines in the setting cfg file which is found in the root directory of the eBook system folder The content of the setting cfg file is as follows Global data_pathe datasets MLwiN executable C Program Files x86 MLwiN v2 22 mlwin exe Demo executable C StatJR Demo bin Demo exe working_directory C StatJR Demo bin WinBUGS executable C WinBUGS14 WinBUGS14 exe working_directory C WinBUGS14 STATA executable C Program Files x86 Stata11 StataMP 64 exe R executable C Program Files R R 2 12 0 bin R exe Do not change the path under the Global category For all the other categories change the value of the executable to the correct path i e where the corresponding software package executable is installed if it differs on your machine Note that a
54. p gt produces This is an equation normexamy N j 07 It is an example While the following code lt p gt This is an equation mbox normexam i sim mbox N mu_i NVsigma 2 M It is an example lt p gt produces This is an equation a It is an example 4 4 2 Making Chapters and Pages The content needs to be divided into activity regions as defined previously in the N3 file The author needs to use the HTML div syntax with class deep activityregion to wrap the content in each activity region If the content in an activity region is long then it can be divided into different pages Please note that pages must be fully contained in one activity region and they cannot nest other activity regions or pages To do this simply wrap the content of each page into HTML divs with class 37 4 Advanced Guide for eBook Authors deep page as the following example illustrates the eBook system will then render your content page by page during a reading process WEM activityregion00i class deep activityregion gt lt div id ebookpage001 class deep page gt Content of page001 lt div class deep static img img src example static image gif alt br Figure 1 div div lt div data deep id ebookpage002 class deep gt Content of page002 div div data deep id ebookpage003 class deep gt Content of page003 div div
55. property ebook hasBinding The value of binding resource property ebook identifier is the unique identifier of that binding resource in the eBook It will be later used in Section 4 4 as the prefix of the dynamic output names in the eBook content The binding resource declarations of the example eBook described in Section 4 1 are shown below lt activityregion001 gt a ebook ActivityRegion ebook hasBinding lt templatel gt lt datasetl gt lt inputl gt lt activityregion002 gt a ebook ActivityRegion ebook hasBinding lt template2 gt lt datasetl gt lt input2 gt lt templatel gt a ebook ResourceBinding ebook identifier templatel ebook resource lt 1llevelMod gt lt template2 gt a ebook ResourceBinding ebook identifier template2 ebook resource lt 2levelCat gt lt datasetl gt a ebook ResourceBinding ebook identifier datasetl ebook resource lt bang gt 35 4 Advanced Guide for eBook Authors lt inputl gt a ebook ResourceBinding ebook identifier templatel input ebook resource lt input001 gt lt input2 gt a ebook ResourceBinding ebook identifier template2 input ebook resource lt input002 gt Note e Ifa property value is a URI it should be wrapped by angle brackets rather than double quotes When there are multiple values for a property use commas to separate the values e Youcan bind multiple templates with an activity region Th
56. putting the header outside page divs at the beginning of the activity region The following illustrates the content of the example eBook described in Section 4 1 with each activity region containing one and only one chapter For means of illustration the headers added are highlighted here by a grey background lt div ad activityregion0QUI class deep asctivityregion lt hl gt Chapter 1 1 level model lt h1 gt lt hr gt lt div id ebookpage001 class deep page gt lt h2 gt Introduction lt h2 gt Content of page001 lt div Glass deeo statio img img src example static image gif alt br Figure 1 div div div data deep id ebookpage002 class deep page gt lt h2 gt Input Model and Equations lt h2 gt Content of page002 div lt div data deep id ebookpage003 class deep gt lt h2 gt Results Summary and Graphs lt h2 gt Content of page003 div div HAM activityregion002 class deep activityregion gt hl Chapter 2 Multi level models lt h1i gt div id ebookpage004 class deep page lt h2 gt Introduction input and model lt h2 gt Content of page004 div lt div data deep id ebookpage005 class deep gt lt h2 gt Model run summary lt h2 gt Content of page005 div div data deep id ebookpage006 class deep gt lt h2 gt Results lt h2 gt Content of page006 div div 4 4 4 Adding Dynamic Content
57. r conditions for Showon Hideon You can specify conditions for showon hideon an element based on the value you accessed for example in the following component in an eBook lt p class deep dynamic hidden data deep showon datasetl summary data deep expression row row woman element col Count and 2 1000 gt Dataset has more than 1000 rows lt p gt lt p class deep dynamic hidden data deep showon datasetl summary data deep expression row row woman element col Count and not 1000 7 gt Dataset has no more than 1000 rows lt p gt the XPath expression is as the previous example except it returns the result of a conditional statement instead of the text This result is used by the eBook system to decide whether to perform the data deep showon or a data deep hideon action or not In this example as the count is 2867 which is larger than 1000 this component will be shown in the eBook reader as Dataset has more than 1000 rows 4 5 Authoring Tools 4 5 1 eBook Reloading Tool While authoring an eBook most authors want to be able to check the result of their latest changes by constantly viewing their eBook draft in the eBook system However this is not straight forward with the system s reading interface When an eBook file is imported the eBook system decompresses it puts the content in a folder named by the key of the eBook in the system and puts it in the 44 4 Advanced G
58. reload the information in the ebookdef ttl file of an eBook into the system database during reading The function can be accessed from the debug menu of the eBook system s reading interface With this function after editing the ttl file of the eBook in the var ebooks folder the author can simply press reload eBook in the menu to view the result of the latest changes Note e ensure system consistency the reloading function will also erase the reading history related to the current reading process The eBook reading will be redirected to the first page of the eBook after reloading All dynamic outputs and execution history of the current eBook will be lost e There is now an additional step after pressing reload eBook The system will check the eBook file that is about to be reloaded and show possible errors and warnings in a pop up box At this stage the authors will need to select whether they want to proceed with the reloading If Continue Reloading is selected the system will reload the eBook file If Cancel Reloading is selected the system will abandon the reloading process and go back to the previous reading interface Please refer to Section 4 5 2 for details of the Filechecker and the error warning messages 45 4 Advanced Guide for eBook Authors 4 5 2 The eBook Filechecker The eBook system comes with a file checker that checks for possible issues in an eBook file It checks the consistency in both the ttl file a
59. s interested in browsing the content of certain eBooks eBook readers use the system to import and read eBook files Note that reading refers to a process which is a bit more interactive than implied by the common use of the word For example as a user reads through an eBook he or she will change its content by making choices when prompted to do so for instance by selecting particular variables to analyse eBook author An eBook author is an advanced user who is an expert or specialist in a field and would like to share his her knowledge via eBooks They understand the internal structure of eBooks and can use proper tools to create and edit an eBook file 2 System Summary 2 SYSTEM INSTALLATION 3 Getting Started as eBook Reader 2 SYSTEM INSTALLATION 2 1System Installation This section is for users who want to install the Stat JR software package manually If you have an all in one version of Stat JR software please refer to the guide attached with it 2 1 1 Pre installation requirements Python 2 7 Most parts of the eBook system are developed with Python Thus the Python interpreter is the essential software required to run the eBook system Python accompanying packages for Stat JR Several Python accompanying packages are required by the Stat JR module e NumPy e SciPy e Numexpr e Matplotlib e Setuptools e Mako 0 4 2 or later e datetime Python accompanying packages for Core Middleware module The f
60. t the moment the algebra system executable for the StatJR engine is placed under the category Demo 3 Getting Started as eBook Reader 3 GETTING STARTED AS AN EBOOK READER 3 Getting Started as eBook Reader 3 GETTING STARTED AS AN EBOOK READER This section provides a guide for eBook users on how to perform general eBook reading using the eBook system interface and widgets provided 3 1 eBook System Main page The first page shown when the eBook system is loaded is the main system page where users can choose an eBook to be read The system allows an eBook to be read multiple times and the information associated with each reading is called a reading process On the main page users can choose the reading process with which they would like to start Currently the following functionality is supported on the main page Import an eBook Display general information about an eBook e Create a reading process for an eBook e Resume an existing eBook reading process EStat E Book reader Impor i Your E Books About i ystem i binary responses Author fang Huanjia 1 H menu Created at Tue Jul 02 16 56 47 2011 1 i 1 1 1 1 Description Aiea 1 i management area 1 1 1 Ua ge a a 1 Continue reading OR Start a new reading 11111 New reading process name 1 1 1 1 Brief d ir Reading Process i T management
61. template input parameters you can leave some of them to be defined by the reader during their reading This enables the reader to try out different parameter values for the same template execution and then compare results The eBook system uses the dynamic output mechanism described in Section 4 4 4 to acquire inputs from the reader When an eBook execution triggered behind the scenes does not have all the parameter inputs for the template it uses the execution generates a dynamic output with type inputq and terminates The actual content of the inputq output is basically some HTML code rendered to the reader as an input question The input question could be in the form of a text box a select box or a drop down box and this depends on the type of input parameter you have asked the reader to enter The content of the inputq output also contains a submit button that triggers a new execution after the user enters the parameter value required To let the reader enter some of the input parameters for a specific template in the eBook simply remove the line in the ebookdef n3 file or the input file that defines that parameter and add a dynamic output area with id template bindingname inputq in the ebookpages html file For example to let the reader enter the value of parameter x for templatel during reading remove the line that defines the value for input x in the ebookdef n3 file or input file and
62. ttp example com ebook Namespaces 8 prefix dcterms http purl org dc terms lt gt vae cp inq EUIS Property name URI references of the dumm UR Rae HRR E Note that an a means RDF resource being defined dcterms creator Yang Huanjia type d dcterms description An ex le of imported eBook lt gt represents the base amp P Property value URI dcterms language en Separated from the property A URI reference starting dcterms title Modelling binary responses Une bya space ebook hasActivityRegion factivityregion001 i with means it s j relative to the base URI lt f activityregion002 gt me Property can have i values separated by lt i ctivityregion001 a ebook ActivityRegion Properties are separated by ahoak haaBiniiag The last property ends with Resource lt dataseti gt Definitions lt inputi gt Figure 4 4 Example of an eBook definition file in Turtle format Figure 4 4 shows the beginning of an example ebookdef ttl file which contains all the Turtle syntax we use in the eBook system There are three parts to the eBook Turtle file the base URI which is a string of characters used to uniquely identify the eBook over the Web the namespaces and the resource definitions Base URI The eBook file identifier The eBook file needs to be identified uniquely this is achieved via an URI defined
63. tyRegion type Error 4 An ActivityRegion is defined but not used EbookFile resource related ActivityRegion EbookFile type Warning 5 An ActivityRegion 15 used by Ebookfile but not defined resource related ActivityRegion EbookFile type Error 6 Missing required attribute s resource related All type Error 7 Required attribute s has ve no value resource related All type Error 8 Optional attribute s has ve no value resource related All type Warning 9 Naming URI Identifier conflict resource related All type Error 10 A binding resource points to a non existing resource resource related Resourcebinding type Error 46 4 Advanced Guide for eBook Authors 11 A resource that is not associated with any binding resource resource related Resource type Warning 12 A binding resource not used by any activity region resource related Resourcebinding type Warning 13 A binding resource used by multiple activity regions resource related Resourcebinding Activity Region type Warning 14 Missing or invalid base URI 15 Unrecognized resource types are suggested as warnings 16 A binding resource used by an ActivityRegion does not exist 17 A binding resource used by an ActivityRegion is not with type ResourceBinding 18 A resource used by a BindingResource is of not valid type has to be a Template a Dataset or a TemplateInput Note e ActivityRegion URI conflicts
64. ue Jul 02 16 56 47 2011 dcterms creator Yang Huanjia dcterms description An example of imported eBook dcterms language en dcterms title Modelling binary responses Please use a space to separate the name and value of each property The value of each property should be wrapped by double quote signs Use a full stop sign at the end of the line of the last property and a semicolon for the others Declaring the activity regions The activity regions should be declared with the property ebook hasActivityRegion Each activity region should be given a unique name in the eBook As before the author can use any combination of letters and numbers for the identifier as long as it is unique in this eBook The activity region declarations of the example eBook described in Section 4 1 are shown below lt gt a ebook EbookFile dcterms created Tue Jul 02 16 56 47 2011 dcterms creator Yang Huanjia dcterms description An example of imported eBook dcterms language en dcterms title Modelling binary responses ebook hasActivityRegion factivityregion001 5 lt activityregion002 gt 33 4 Advanced Guide for eBook Authors lt activityregion001 gt a ebook ActivityRegion lt activityregion002 gt a ebook ActivityRegion Note a sign is put in front of the activity region names to turn them into URIs under the base URI defined at the beginning of this section The name is then declared as an act
65. uide for eBook Authors var ebooks directory Generally authors create their new eBooks by modifying an authoring template or an existing eBook file In order to view the eBook with the latest changes we suggest that the most convenient way is to import an authoring template or an eBook that you would like to modify and then edit the content directly in the folder in the var ebooks directory In this case for changes made in the ebookpages html file you will be able to see the result after re entering the reading process However the information contained in the ebookdef ttl file of an eBook is loaded into the eBook system database when the eBook file is imported After that the system uses only the information in the database and does not access the ttl file any more This is to ensure the speed and consistency of the system But for eBook authors who are editing the ebookdef ttl file this mechanism makes it difficult to view the result of their latest changes to the eBook in the system Each time the n3 file is changed the author will have to compress the folder into an eBook file delete the folder in the var ebooks directory and import the new eBook file This can be time consuming and frustrating especially when the author is trying to make many small changes to the ttl file or to compare some different ideas values in it In order to address this issue the system provides an eBook reloading function that allows the author to
66. urces hasActivityRegion hasBinding Figure 4 2 Logical Organisation of eBook resources The activity regions There is no limit to how long large an eBook can be nor a limit on how many resources can be contained within it So in theory the author could make an eBook that has hundreds of pages and contains as many resources such as template and dataset files as he or she likes However for most of the time during the eBook reading process only a small part of the content is shown while only the resources that are related to that part of content are being used it is not efficient for the system to always load up all the resources contained in an eBook while only using a small selection of them at any given time As a result the concept of an activity region has been developed to separate the eBook content into multiple sections Each resource such as templates datasets and input sets are then associated with the activity region in which they are used 28 4 Advanced Guide for eBook Authors Resource bindings Rather than linking a resource directly with an activity region though we implement the association through a binding resource This allows for a particular resource to be used in several different activity regions but with different binding names A binding resource represents a ternary relationship that attaches a unique binding name that is given by the author to the resource activityregion relation
67. ut urn_uuid dadcce30 be80 11e0 a765 003048d59cdd bang name Bang type estat Dataset This resource wasGeneratedBy urn_uuid 99699f25 82f5 11e1 975d 00a0c6000000 type ebook EbookExecution Figure 3 21 The information and provenance panel 21 3 Getting Started as eBook Reader 3 3 3 Navigation in the Resource View Content Information Authoring Export You queried for the provenance of the resource with URI urn uuid 42d1e3a3 7cb2 11e1 b6d0 003048d59cdd This resource wasDerivedFrom urn uuid dadcce30 be80 1160 a765 003048d59cdd amp bang Bang type estat Dataset urn uuid dadcce30 be80 11e0 a765 003048d59cdd amp 1LevelMod name 1LevelMod type estat Template urn uuid 42cb05cf 7cb2 11e1 8301 003048d59cdd type estat Templatelnput This resource wasGeneratedBy urn uuid 42cd9dde 7cb2 11e1 b 29 003048d59cdd type ebook EbookExecution About Resource dataset template template 1 input BFToday at 11 54 39 EFToday at 11 54 39 dataset template emplate1 input emplate1 inputq FToday at 11 54 46 Content Information Provenance Authoring Export You queried for the provenance of the resource with URI urn uuid dadcce30 be80 11e0 a765 003048d59cdd 1LevelMod The following resource urn uuid 3e7d0870 7cb2 11e1 a0ba 003048d59cdd type ebook EbookExecution urn uuid 42cd9dde 7cb2 11e1 bf29 003048d59cdd type ebook EbookExecution used this resource you queried The following resource ur
68. uts in a python module write your input set in the form of a Python dictionary and save it as a py file A Python dictionary is a container type that consists of pairs called items of keys and their corresponding values Each key is separated from its value by a colon the items are separated by commas and the whole container is enclosed in curly braces To write your input set as a Python dictionary put each input name as an item key and the corresponding input value as the associated item value Both the input name and value should be given as a Python string which means they must be wrapped by either single quotes or double quotes An example of an input set in Python dictionary format is as follows y normexam Engine OpenBUGS EstM yes outdata out seed nj m burnimn s S000 iterations 1250 Input file as JSON JSON JavaScript Object Notation is a lightweight data interchange format that is designed to be easy for people to read and write It is a text format that is completely language independent but uses conventions that are familiar to programmers of the C family of languages In practice an input set in the form of a JSON collection of key value pairs looks exactly the same as a Python dictionary except it is saved as a json file 4 2 3 Resource File Location When you use a template or a dataset that comes with the STAT JR system you do not need to
69. wn Name Mean Count woman 1434 00000 2867 use 0 39728 2867 use4 3 19847 2867 lc 1 66864 2867 age 0 32787 2867 Figure 4 6 Selecting rows and columns to be shown in an tabular output 4 4 6 Show Hide static element with dynamic content You can show or hide some static content when a specific dynamic content becomes available in the same activity region In the previous section we have introduced the way of using the deep dynamic hidden class to show or to remove some default content when a dynamic content becomes available However you can do only one of them either show or hide and the content you are showing hiding has to be in an HTML element that nests the dynamic content If when a dynamic content becomes available you would like to hide some parts of content and show some other parts at the same time or if the content associated with the dynamic content is not adjacent to it then you will need to use the showon hideon mechanism in this section Those two attributes are also useful if you want to show hide an dynamic content only when another dynamic content becomes available Show element when a dynamic content becomes available If a hidden element is not a parent of a dynamic content but you want to show the element when the dynamic content becomes available simply add the element with class Heep dynamic hidden so that it is visible beginning Then the property data deep showon dynamic content name
70. worry about its location as it s already in the default directory of the STAT JR system For more information on the default templates and datasets please refer to the Stat JR documentation To provide your own template dataset or input files save the files in the top level directory of your eBook If you are starting from an eBook authoring template the top level directory is the level where the ebookdef ttl file is located 4 3 ebookdef ttl Defining the Resource Organisation The author should provide the following information in the ebookdef ttl file 31 4 Advanced Guide for eBook Authors General information concerning the eBook file Activity regions Resources for eBook execution templates datasets and input sets Binding resources We will use the example eBook described in Section 4 1 to explain how to make an eBook definition file The Turtle format The resource organisation of an eBook is defined in the format of RDF N3 in the ebookdef ttl file The Turtle is a serialisation of Resource Description Framework models is much more compact and readable than XML RDF notation More information about the N3 format can be found at http www w3 org TR turtle Base URI base urn uuid dadcce30 be80 11e0 a765 003048d59cdd prefix dc http purl org dc elements 1 1 Gprefix estat http example com estat prefix estatinput http example com estat input prefix ebook h
71. y formatted mathematical description of the model in LaTeX code and a variant of the model specification language associated with the WinBUGS package Equation rendering Below you will see the Equations that mathematically represent this model in a Bayesian framework Note that default flat prior distributions have been used Results Summary and Graphs n normexam N i 0 Fitting tutorial dataset using WinBUGS Bocons 8 standlrt Model and Equations Bo xl Results Summary and Ay Graphs By x1 EFFitting tutorial dataset using TI 0 001 0 001 OpenBUGS 1 Model and Equations Results Summary and Penna about Newly inserted ee dynamic content Figure 3 15 An equation inserted as dynamic content 3 2 4 Regenerating the dynamic content with a different answer to an input question After reading the dynamic content you can specify a different parameter value and the eBook will regenerate dynamic content to reflect your new input To do this go back to the input question select or enter a different value and then click Submit The eBook will then regenerate and update all the related dynamic content For example if we were to go back in the page select vrband instead of standlrt see Figure 3 15 as an explanatory variable still keeping cons and then press submit the dynamic content will be updated based on this new input as shown in Figure 3 16 You can repeat
72. y this execution Figure 3 25 shows an example of state reversing In a prior execution we selected cons and age as inputs which triggered an execution labelled Today at 15 11 13 After reading the results of our initial selections we then selected urban instead of age and this triggered the last execution which generated the dynamic content displayed in Figure 3 25 a labelled Today 15 31 52 To reverse the eBook state we simply 24 3 Getting Started as eBook Reader click on the execution Today at 15 11 13 in the resource tree As shown in Figure 3 25 b the eBook replaces the dynamic content with the results of the earlier execution 25 4 Advanced Guide for eBook Authors 4 ADVANCED GUIDE FOR EBOOK AUTHORS 26 4 Advanced Guide for eBook Authors 4 ADVANCED GUIDE FOR EBOOK AUTHORS This chapter describes how to author an eBook and is organised as follows Section 4 1 reveals the structure inside an eBook file and how the resources contained in an eBook are organised and bundled together Section 4 2 describes the types and formats of the resources that can be contained in an eBook finally Sections 4 3 and 4 4 provide a step by step guide to authoring an eBook by describing the two key files the ebookdef ttl file that defines the resource organisation and the ebookpages html file that contains the content of the eBook together with its format 4 1 The eBook an inside view 4 1 1 File Structure

Download Pdf Manuals

Related Search

Related Contents

Unit-Öl-Blaubrenner    Manual de usuario 000690675.02  Invacare ® Kite SERVICE MANUAL  Pattex Power Tape Crystal    プレスリリース_アラヤ札幌本格始動  Onkyo TX-SR333 Product Sheet    Samsung RS20CRPS Benutzerhandbuch  

Copyright © All rights reserved. Failed to retrieve file