Changes between Version 15 and Version 16 of NewAPI

Timestamp:

Mar 31, 2014 4:34:03 PM (11 years ago)

Author:

faber

Comment:

--

NewAPI

@@ -128 +128 @@
 === Experiments ===
 
-All of the testbed API is ultimately geared toward the creation of experiments.  An experiment is:
+All of the testbed API is ultimately geared toward the creation of experiments.  An experiment contains many aspects that define its environment and operation.  An aspect is a user-defined piece of data that is used to influence the testbed's operation.  Some aspects are understood by the base testbed, and some must be interpreted by code supplied by the user.  Initially the prototype understands only a few aspects.  These include:
 
  A description of the experimental environment::
    topology of computers and other resources in which the experiment will take place, including infrastructure necessary to carryout and gather data from the experiment
- 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::
-   the repeatable sequence of events and reaction to those events that tests a hypothesis
- A data to be collected and methods for doing so::
-   mechanisms to understand the experiment without influencing it
+   the repeatable sequence of events and reaction to those events that tests a hypothesis.  This may also contain event descriptions and actions to take based n them.
+ 
 
 Not all experiments in the sense of the API data structure will have all these elements.  Testbeds are often used to create an environment in which to try ideas out and explore ideas without intending to reproduce the experience.  The other end of the spectrum is rigorous, repeatable hypothesis testing.  The API supports both by allowing some of these aspects to be omitted for some experiments (in the API sense).