Documentation Action Items

This is version 1. It is not the current version, and thus it cannot be edited.
[Back to current version] [Restore this version]

Getting Started Guide

Kirsten

Remove Appendix 8.2 “Technical Overview of Kepler”
Change Figure 1 to an R workflow instead of addition workflow/move figure 1 up.
Redo Figure 2 with Lotka Volterra Workflow. Move figure 2 up.
Move sections 3 & 4 (installing and starting kepler) after section 1.
Redo screenshots with colors and new workflows (for graphics folks; do basic images)
Remove “Atomic” distinction (Actors and Composite Actors)
Remove references to “ontologies”; use “categorization” instead.*Clarify Nested Composite Actors/Workflows (add line diagram and explanatory paragraph to “1.2. What are Scientific Workflows” section. Note: Introduce early and move figure lower in doc
Add paragraph about who Kepler is for/advantages for different types of users (sharing workflows/advanced users; “quantitative analyst” background (run and param; follow logic of workflow).
Clarify Data Actor (“widget that supplies the data/not the data”)

Add paragraph with references to other systems (Stella; Simulink (kepler like), R, Matlab, Excel, SAS)
Feedback due by end of next week (Sept 15)
update note that most workflows require a network connection when running Kepler. Access resources that are on the network.
Create a stand-alone glossary (actor, relation, token, float, double, data type, port, channel, relations, components, etc)

Samantha

Update section 5.3 Director and Actor Icons with most recent icon categories. (design docs on wiki have out-of-date icons; 3 all-the-actors actor in workflows directory also not up-to-date; photoshop doc Matt made?)
create a list of all changes to screenshots and work with NCEAS/UCSB people on creating screenshots.

Mark

Dan

Adding appendix about R (also looping and how to choose a director (DAN), creating composite actors, how to import non-EML data tab and comma delimited) & make footnote describing ALSO: R workflows have to be present in Kepler release.

Kirsten

Create guidelines for how to write documentation for actors and Sam to place on Wiki
Must note dependencies in the actor docs

R actors need R installed
GRASS actors need GRASS installed
Matlab needs Matlab installed; command line actor depends on system-specific executables and is operating-system specific.

Web Service actor: Update copy to reflect that the actor only works for a subset of WSDL constructs. Only ones that use base types for parameters or arrays of base types. “Intended to work on any web service with certain limitations, in particular related to the types of parameters that are used as input and output to Web Service.” Define “Web Service” in first paragraph e.g., “which is a… computer program that runs on a remote host using a standardized protocol.”
Random Normal actor: this uses R norm and hist function—add note “For a full detailed desc. of how this actor works, look at R norm docs”
AddGrids actor: Revise to say that actor takes “two or more geospatial images”/less jargon-y. Update desc. about file formats—it is not generically true that all actors use ESRI ASCII file format (e.g., not true for Interpolate actor)
EOL actors (“Encyclopedia of Life”) are not active any more and will likely be removed.
Boolean Multiplexor actor: Revise to include context (used as a control flow actor/for branching) Suggested first sentence: “The Boolean Multiplexor uses a Boolean value to determine which of two input values to output.”
Boolean Switch actor. Needs more context; only works under certain directors (SDF does not work; PN does work)
Expression actor: Change to read “actor evaluates a specified expression”

Sam

send email on VariableSetter(developer to look at and clarify how this actor works)
send email to Efrat to document*TransitiveClosureDatabaseQuery
send email to Christopher to review Image Contrast actor documentation to clarify
send email to Jianting to generalize actor and redocument ENM PCP actor without reference to niche model (PCP==Parallel Coordinates Plot).

Dan

???

Create a list of common problems encountered when building workflows and types of solutions This material will be incorporated into Section 5 “Building Workflows with Existing Actors” (developers make list).

Dan

Create an R actor that takes CSV/tab delimited data files and parses them. This will be used when we talk about working with local data in Section 6 “Working with Datasets” (Dan)

Samantha

Change this section title to “”
Add information about looping, expression actor, other common workflow problems and solutions based on the list of problems/solutions/techniques compiled by the developers.
Remove all Build new actor docs and place in appendix, developer reference, or separate chapter.
5.4-5.4.6 Should go into a separate developers’ guide or an appendix. “Developing new actors with Java”
Move 5.4.8 down to 5.8.
5.5 Call section “Documenting Workflows”
5.7 & 5.8 combine “Saving and Sharing Workflows”
Save to Library (for self); Save as KAR (for someone else); Upload to the repository (for the public)
NEW section 5.5.3 Need to add “semantically annotating actors”
Remove 5.8.2. Creating Applets

need to open with general intro to data types and incorporate spatial data/other data types in addition to local/remote distinction. Basic/new structure for chapter noted below. Note that you cannot open an Excel spreadsheet directly.
6.1. Start with introduction on Handling Data Intro: overview of different kinds of data/many kinds available/easy to access/etc
6.1.1. should be “Ecological Metadata Language”
6.1.2. ADN (geon uses) Metadata; Remove Darwin Core is not metadata (it is data format);
Move 6.2 after 6.3/or interweave with 6.3. and 6.5.
New Structure:

1. Using local data (opening Comma, tab, text delimited file)
2. Opening local with EML
3. Finding and opening documented data (remote/EcoGrid)
4. Getting data external database
5. Other kinds of data (SRB, system specific actors)
6. Parsing more complex text data formats (recognition that are other formats; make suggestions for how to deal with them. General advice)

Mention: but do not note in outline: Streaming Data (sensor data ORBs; or sensor data in Oracle)

Rename section 7 “Using Remote Computing Resources”
7.1. Using Web Services
7.2. Using Computational Grids (NIMROD, Globus, Griddles) (current 7.1. moved inside this section)
Remove 7.4

Add 8.1a Expression Actor (before R chapter)
Add 8.3. MatLab subchapter
8.1.4. place the R GSG Appendix R material here.
Add: 8.3. Image data (ways to manipulate images)-- ImageJ, Rescaling, clipping, color balance, alpha value out.

Rename section 9 “Domain Specific Example Workflows”
Revise so that this section consists of an intro for each domain/then work through examples.

Go to top More info... Attach file...

This particular version was published on 12-Sep-2006 12:33:51 PDT by uid=sromanello,o=LTER.