Link

Definitions (Glossary)

The following table debunks some of the terminology used within the research documents.

id Concept description Example AECdeltas naming Speckle naming 3D Repo naming BHoM naming Other proposed namings Notes
1 Container for the objects Part of a building (e.g. a portal frame; mep pipes) Stream Stream Model - Container, Project  
2 Given state in time of the Container (1)   Revision (Parent) Stream     Version, Revision, State, Snapshot, LampPost, Checkpoint  
3 Container for the “containers” (1) (collection of collections of objects) An entire building Project Project Project (/federation?) -    
4 Upload on the online “container” (3)   Upload     Push POST, PUT  
5 Download from the online “container” (3)   Download     Pull GET  
6 Delta: Objects added in the UI E.g. an user creates a new object; that object will then be pushed online on the container OnlyA     ToBeCreated New, Created, OnlySetA, AOnly In BHoM, the point of view for the object status is looking from the external software. E.g. Created = it’s been added in the external software
7 Delta: Objects deleted from UI   OnlyB     ToDelete Old, Deleted, OnlySetB, BOnly  
8 Delta: Objects modified in UI   Modified     ToModify Modified, Intersection-Modified  
9 Delta: Objects not changed in UI   Unmodified     - Unchanged, NotModified, Intersection-NotModified  
10 User choice in front of a conflict status emerged from his upload action User pushed some change, but server responds with an error, e.g. because the user did not pull the lastest changes in a while Conflict resolution       Conflict resolution, Pick&Choose, Modify, Merging  
11 Id of an object; this id does not change when the object changes (it’s maintained between different revisions)   Persistent ID          
12 Id of an object; this id changes when the object changes (it’s always unique at any point in time)   Unique ID         Is it an GUID or a hash? Does not matter
13 Delta message, used to transfer the information. Should be as stripped down as possible, minimum amount of information needed           DeltaMessage, DeltaPayload,  
14 Delta as result of the collection level diffing           Delta, DeltaDiff  
15 Delta as result of the property level diffing   DeltaStream       DeltaStream, HistoricalDelta, DeltaHistory, DeltaTracked