Changes between Version 12 and Version 13 of LayoutAspect


Ignore:
Timestamp:
Jul 8, 2014 6:00:57 PM (8 years ago)
Author:
faber
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • LayoutAspect

    v12 v13  
    171171=== Topology Calls to the Experiment API ===
    172172
    173 Researchers interested inworking with experiment topologies can make the following calls on the Experiment API.
     173Researchers interested in working with experiment topologies manipulate the topology aspect of an experiment.  It is possible to have multiple topology definitions for an experiment that are divided into regions differently, as long as they all are isomorphic.
    174174
    175  * getViews(ExperimentName)
     175When a topology aspect is added, the testbed generates aspects of type topology and the following subtypes.  This happens whether the topology aspect is added using `experimentCreate()` or `addExperimentAspect()`.
    176176
    177 ExperimentName is a string returned from viewExperiments. Returns a list of string pairs, the first being the name of a topology view and the second being a short description of the view.
     177 full_topology::
     178  The topology with all regions expanded.  The name is the topology aspect with "/full_topology" appended.
     179 minimal_topology::
     180  The topology with no regions expanded and no fragments or namemaps attached.  This is the quickest and dirtiest topology available for visualization.  The name is the topology aspect with "/minimal_topology" appended.
     181 fragment::
     182  A fragment of the given topology.  The name is the aspect name with "/" and the name of the fragment appended.  These are used to incrementally expand a minimal_topology
     183 namemap::
     184  A namemap from the topology expansion.  The name is the aspect name with the namemap pathname appended. These are used to incrementally expand a minimal_topology
    178185
    179  * getTopology(ExperimentName, ViewName)
    180 
    181 ExperimentName is a string from viewExperiments, and ViewName is a string from getViews. Returns a topdl v2 file containing the initial topology.
    182 
    183  * getFragment(ExperimentName, ViewName, FragmentName)
    184 
    185 ExperimentName is a string from viewExperiments, and ViewName is a string from getViews.  Returns a topdl v2 file without elements or substrates, but with at least the requested fragment. It may also include other fragments and name maps.
    186 
    187  * addView(ExperimentName, ViewName, topdl)
    188 
    189 ExperimentName is the name of an existing experiment, from viewExperiments, and topdl is a new view of that experiment.  If the testbed can determine that the view describes the same topology as the experiment currently has, the new view will be added with viewName as the name.  If the topology does not match, or the testbed cannot determine that it does so, an error will be returned.  Topdl is a the new view encoded in topdl.  There will be a version of this that can retrieve the topdl from a URL as well.
    190 
    191  * removeView(ExperimentName, ViewName)
    192 
    193 ExperimentName is a string from viewExperiments, and ViewName is a string from getViews. Remove the given view from the experiment.  Will fail if the view is the last one.
    194 
     186A new version of the topology can be added at any time using `addExperimentAspect()`, but the call will fail topologies that are not isomorphic to the experiment's current topology aspect.  Adding a topology to an experiment without a topology aspect always succeeds.
     187