Skip to content
Alessio Lombardi edited this page Jul 21, 2020 · 16 revisions
id Concept description Example AECdeltas naming Speckle naming 3D repo naming BHoM naming Other proposed namings Notes
1 Container for the "containers" (2) (collection of collections of objects) An entire building Project Project Project (/federation?) -
2 A series of Revisions (3), each one containing objects A Model, representing a part of a building, or a discipline specific-view of the whole building, that changes in time and whose state is recorded in a series of Revisions (3). For example, an MEP model of the plumbing of a building that will undergo change as the project evolves can be stored in here. Stream (Parent) Stream - Container, Project
3 Given state in time of the Container (2), expressed as a collection of objects A snapshot in time of a Model. Revision (Child) Stream Version, Revision, State, Snapshot, LampPost, Checkpoint
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
<style> table:nth-of-type(2) { display:table; width:200%; } </style>