Repository: bokeh/bokeh

Issue:
Naming for new coordinate systems
Follow on work from #10202 to finalize naming before releasing. 


Discussion:
ref https://github.com/bokeh/bokeh/pull/10202#issuecomment-646948920
Looking again more closely at the changes in #10202 I can more succinctly delineate the important facts:

* A `Frame` collects all x-scales and y-scales on one place (what all renderers may use) 
* A `CoordinateTransform` narrows things down to one particular x-scale and y-scale (what a specific render actually uses)

With a time machine, I'd say that what is currently called `Frame` might be `FrameSet` or `FrameCollection` and the single coordinate transform be on `Frame`. But, the current `CoordinateTransform` is perfectly descriptive and fine, so I don't think that needs any change. 

However, I have *never* encountered "scope" in any context remotely similar to this. So I do think that should `.scope` should change to something else. Some ideas:

* `renderer.local_frame` (a specific narrowing of the frame to one set of scales)
* `renderer.pane` (a thing "inside" a a frame, e.g. one pair of scales inside the frame)

or even just "coordinates" might make sense given how it is used:

* `renderer.coordinates.map_to_screen` 

seems very readable. 


Resolving patch:
diff --git a/examples/models/file/latex_extension.py b/examples/models/file/latex_extension.py
--- a/examples/models/file/latex_extension.py
+++ b/examples/models/file/latex_extension.py
@@ -49,8 +49,8 @@ class LatexLabel(Label):
     const panel = this.panel || this.plot_view.frame
 
     const {x, y} = this.model
-    let sx = this.model.x_units == "data" ? this.scope.x_scale.compute(x) : panel.xview.compute(x)
-    let sy = this.model.y_units == "data" ? this.scope.y_scale.compute(y) : panel.yview.compute(y)
+    let sx = this.model.x_units == "data" ? this.coordinates.x_scale.compute(x) : panel.xview.compute(x)
+    let sy = this.model.y_units == "data" ? this.coordinates.y_scale.compute(y) : panel.yview.compute(y)
 
     sx += this.model.x_offset
     sy -= this.model.y_offset
diff --git a/sphinx/source/docs/user_guide/examples/extensions_example_latex.py b/sphinx/source/docs/user_guide/examples/extensions_example_latex.py
--- a/sphinx/source/docs/user_guide/examples/extensions_example_latex.py
+++ b/sphinx/source/docs/user_guide/examples/extensions_example_latex.py
@@ -35,8 +35,8 @@
 
     const panel = this.panel != null ? this.panel : this.plot_view.frame
 
-    let sx = this.model.x_units == "data" ? this.scope.x_scale.compute(this.model.x) : panel.xview.compute(this.model.x)
-    let sy = this.model.y_units == "data" ? this.scope.y_scale.compute(this.model.y) : panel.yview.compute(this.model.y)
+    let sx = this.model.x_units == "data" ? this.coordinates.x_scale.compute(this.model.x) : panel.xview.compute(this.model.x)
+    let sy = this.model.y_units == "data" ? this.coordinates.y_scale.compute(this.model.y) : panel.yview.compute(this.model.y)
 
     sx += this.model.x_offset
     sy -= this.model.y_offset


Test patch:
diff --git a/tests/unit/bokeh/embed/latex_label/latex_label.ts b/tests/unit/bokeh/embed/latex_label/latex_label.ts
--- a/tests/unit/bokeh/embed/latex_label/latex_label.ts
+++ b/tests/unit/bokeh/embed/latex_label/latex_label.ts
@@ -27,8 +27,8 @@ export class LatexLabelView extends LabelView {
     const panel = this.panel || this.plot_view.frame
 
     const {x, y} = this.model
-    let sx = this.model.x_units == "data" ? this.scope.x_scale.compute(x) : panel.xview.compute(x)
-    let sy = this.model.y_units == "data" ? this.scope.y_scale.compute(y) : panel.yview.compute(y)
+    let sx = this.model.x_units == "data" ? this.coordinates.x_scale.compute(x) : panel.xview.compute(x)
+    let sy = this.model.y_units == "data" ? this.coordinates.y_scale.compute(y) : panel.yview.compute(y)
 
     sx += this.model.x_offset
     sy -= this.model.y_offset