May 23, 2006

Kepler: Managing Scientific workflows
-------------------------------------
Version: 1.0.0beta1
Web: http://kepler-project.org
Send feedback to: kepler-dev@ecoinformatics.org
Current bug reports: 
http://bugzilla.ecoinformatics.org/buglist.cgi?product=Kepler&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED
                                         
NOTE: The beta1 version of Kepler contains a number of changes, but perhaps the most apparent are new graphical features, including icons, menus, and background colors. (These changes first appeared in the alpha9 version, but are more complete in beta1.) These are all controlled by a properties file called 'kepler\configs\ptolemy\configs\kepler\uiSettings.properties'. The user can open this file in a text editor, change settings, and the next time Kepler is opened, the effects of the changes properties should appear. Customized actors can now be saved as 'kar' files, either locally or to a remote repository. The actor list now shows the actors organized in several ontologies, rather than a single list. Many bugs have also been fixed.

There is now a 'splash' screen that should appear while Kepler is loading. A 'Welcome to Kepler' screen will also appear. Currently, several features of that window are non-functional. Just close it and you should see an empty workflow window (rather than the list of sample workflows that appeared in earlier versions). Click on the Help/About menu item to get to the list of samples that was seen previously.

This version is based on the May 23, 2006 (~(9:30AM PST) CVS version of PtolemyII. The user should check the links on the startup page as well as numerous examples that are contained in the 'workflows' directory. 

Scientists in a variety of disciplines (e.g., biology, ecology, astronomy) need access to scientific data and flexible means for executing complex analyses on those data. Such analyses can be captured as 'scientific workflows' in which the flow of data from one analytical step to another is captured in a formal workflow language. The Kepler project's overall goal is to produce an open-source scientific workflow system that allows scientists to design scientific workflows and execute them efficiently using emerging Grid-based approaches to distributed computation.

Kepler is currently based on the Ptolemy II system for heterogeneous, concurrent modeling and design. Ptolemy II was developed by the members of the Ptolemy project at UC Berkley. Although not originally intended for scientific workflows, it provides a mature platform for building and executing workflows, and supports multiple models of computation. For more information on Ptolemy II and for detailed documentation that is applicable to Kepler, see the Ptolemy web site at http://ptolemy.eecs.berkeley.edu/.

The Kepler project is a cross-project collaboration to develop open source tools for Scientific Workflows. Currently this collaboration includes contributing members from the following projects:

    * SEEK: Science Environment for Ecological Knowledge
    * SDM Center/SPA: SDM Center/Scientific Process Automation
    * Ptolemy II: Heterogeneous Modeling and Design
    * GEON: Cyberinfrastructure for the Geosciences  
    * ROADNet: Real-time Observatories, Applications, and Data Management Network

(see http://kepler-project.org for links to each of thes projects)

Contributing members jointly determine the goals for Kepler as well as contribute to the design and implementation of the software system. We welcome contributions and encourage other people and projects to join as contributing members. 

Contributors:
              Ilkay Altintas	        SDM
              Chad Berkley	        SEEK
              Shawn Bowers              SEEK
              Christopher Brooks        Ptolemy II
              Zhengang Cheng	        SDM
              Tobin Fricke              RoadNet
              Daniel Higgins            SEEK
              Efrat Jaeger              GEON
              Matt Jones	        SEEK
              Werner Krebs	        EOL
              Edward A. Lee             Ptolemy II
              Bertram Ludaescher	SEEK, SDM, GEON
              Steve Mock	        Informnet
              Stephen Neuendorffer      Ptolemy II
              Kevin Ruland              SEEK
              Rod Spears                SEEK
              Jing Tao                  SEEK
              Mladen Vouk               SDM
              Xiaowen Xin               SDM
              Yang Zhao                 Ptolemy II 

Contributions to this work are welcome.  Please see the Kepler web site (above) for details on how to contribute. Thanks.

Documentation
-------------
See the "docs" directory for detailed documentation and installation instructions. 

Note that Kepler is built using Ptolemy II from UC Berkeley. Please check the Ptolemy web site (http://ptolemy.eecs.berkeley.edu/ptolemyII) for details and documentation. Ptolemy source code is included with this release inside the kepler.jar file, and Ptolemy documentation is inside the ptII/build/ptolemy-doc.jar. (jar files can be opened with WinZip or any other software for unzipping compressed files.)

How to Start Kepler
-------------------
If you downloaded the automatic installers for Windows or MacOSX, an icon should be placed on the desktop which will launch Kepler. On Windows, this icon launches an executable (.EXE) file; a similar file is created in the Mac installation folder. In addition, there is a file called 'kepler.bat' that can be used to launch Kepler under Windows; on the Mac or under Linux, the is a shell file called 'kepler.sh' that will start the Kepler application.

Mac Users
---------
Currently, Macintosh version of several platform specific applications do not exist (e.g. GDAL code). Thus certain workflows that call these applications will not run on the Mac. Also, the R examples may have problems with graphic displays on the Mac. You will need to start the Mac applicaton 'X11' before starting Kepler (usually X11 in found in the 'Applications/Utilities' folder). And you will need to set an environment variable DISPLAY =localhost:0.0. Note also that platform specific code support for the new Mac Intel chip based machines has not yet been added, although all of the Java-based code works fine on these new machines 


Copyrights and acknowledgements
-------------------------------
This software is copyrighted by The Regents of the University of California; see the 'copyright.txt' file for details.  Portions of this software (individual files) may be copyrighted by other organizations: see the individual source files for each copyright owner's statement.

This material is based upon work supported by the National Science Foundation under awards 0225676 for SEEK and 0225673 (AWSFL008-DS3) for GEON and by the Department of Energy under Contract No. DE-FC02-01ER25486 for SciDAC/SDM and by DARPA under Contract No. F33615-00-C-1703 for Ptolemy. Any opinions, findings and conclusions or recomendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation (NSF).

