check-instance-locators

Purpose
Signal an error if the locators on any space-instance are inconsistent with the dimension values of the supplied unit instance.

Package   :gbbopen

Module   :gbbopen-core

Arguments and values

Description
Changes to slot values that affect a unit instance's dimension values must be indicated to GBBopen using the with-changing-dimension-values macro. Otherwise, locators for the unit instance will not be updated to reflect the new dimension values, resulting in the inability to retrieve the instance where it should be located on a space instance and removed or deleted instances incorrectly retained on a space instance due to the inconsistent locators. Check-instance-locators can be used as a debugging aid during development to check for inconsistent locators.

See also
    with-changing-dimension-values

Examples
Check the locators of all unit instances that are stored on any space instance:

  > (map-instances-on-space-instances #'check-instance-locators t t)
  nil
  >

  > (defparameter *hyp* (find-instance-by-name 419 'hyp))
  *hyp*
  > *hyp*
  #<hyp 419 (1835 4791) 0.85 [5..35]>
  >(check-instance-locators *hyp*)
  nil
  > (setf (location-of *hyp*) '(2000 2000))
  (2000 2000)
  > (check-instance-locators *hyp*)
  Error: Instance #<hyp 419 (2000 2000) 0.85 [5..35]> is missing (bucket [21,21]) 
         in #<2d-Uniform-Buckets (bb hyps) (hyp+) (x y) 8>
  >>

check-instance-locators