Changes between Version 6 and Version 7 of NewAPI

Timestamp:

Jun 26, 2013 2:58:24 PM (11 years ago)

Author:

faber

Comment:

--

NewAPI

@@ -107 +107 @@
  A set of constraints on the resources needed for experiment validity::
    failures of nodes or software can render an experiment invalid
- A procedure to carry out
+ A procedure to carry out::
    the repeatable sequence of events and reaction to those events that tests a hypothesis
- A data to be collected and methods for doing so
+ A data to be collected and methods for doing so::
    mechanisms to understand the experiment without influencing it
 
@@ -128 +128 @@
 
 These interfaces use filtering and graph analysis to present useful views of large experiments.
+
+=== Putting It All Together ===
+
+To understand how the pieces above fit together, here is an example of a researcher using DETER.
+
+A person has an idea for research they would like to to conduct on DETER.  That researcher accesses a DETER user interface - for example teh DETER web interface - and fills out a form that gathers information about them and their proposed research.  The web interface translates this into a request to create a user and then to create a vetting project for that user.  The information about the research is routed to the DETER administration.
+
+After the DETER administration decides that the research is reasonable and meets their criteria, they authorize creation of the vetting project.  The administration sends the user e-mail telling them they can use DETER.  Additionally the testbed may add the new user to a project for new users or other projects for researchers in similar fields.
+
+When the user visits the DETER web interface, it notices that the user is a member of the new users project and presents an opportunity to take a tutorial.  In addition, the user has access to sample experiments accessible to users in the new users project.  Working from the tutorial and documentation and starting from a sample experiment, the user may create a new experiment with an environment, constraints, procedure and data collection specced out.
+
+The web interface uses the testbed API to review an experiment in the new users project, copy it to the user's vetting project and edit the new experiment to meet the user's goals.
+
+The user then realizes the experiment using the testbed API, uses the experiment control API - usually MAGI - to carry out the experiment and collect the data.  When the experiment is complete, the testbed API is used to release resources.
+
+Now the user assesses the data, and may go off to publish results or create a new experiment from this one that tests a different hypothesis or something else.