Rename "polar" to "smith" where definitely possible

Some of the other instances of the word "polar" may not be able to be
replaced automatically and we will need to move more carefully on those.
But, for example, references to local variables and within comments can
be unilaterally translated.

src/plots/smith/index.js

@@ -18,7 +18,7 @@ attributes[attr] = {
     description: [
         'Sets a reference between this trace\'s data coordinates and',
         'a smith subplot.',
-        'If *smith* (the default value), the data refer to `layout.polar`.',
+        'If *smith* (the default value), the data refer to `layout.smith`.',
         'If *smith2*, the data refer to `layout.smith2`, and so on.'
     ].join(' ')
 };

src/plots/smith/layout_attributes.js

@@ -64,7 +64,7 @@ var radialAxisAttrs = {
         description: [
             'Controls persistence of user-driven changes in axis `range`,',
             '`autorange`, `angle`, and `title` if in `editable: true` configuration.',
-            'Defaults to `polar<N>.uirevision`.'
+            'Defaults to `smith<N>.uirevision`.'
         ].join(' ')
     },
 
@@ -98,10 +98,10 @@ var angularAxisAttrs = {
         editType: 'calc',
         description: [
             'Sets that start position (in degrees) of the angular axis',
-            'By default, polar subplots with `direction` set to *counterclockwise*',
+            'By default, smith subplots with `direction` set to *counterclockwise*',
             'get a `rotation` of *0*',
             'which corresponds to due East (like what mathematicians prefer).',
-            'In turn, polar with `direction` set to *clockwise* get a rotation of *90*',
+            'In turn, smith with `direction` set to *clockwise* get a rotation of *90*',
             'which corresponds to due North (like on a compass),'
         ].join(' ')
     },
@@ -124,7 +124,7 @@ extendFlat(
     angularAxisAttrs,
 
     // N.B. angular grid lines are straight lines from circle center to outer bound
-    // the angular line is circular bounding the polar plot area.
+    // the angular line is circular bounding the smith plot area.
     axisLineGridAttr,
 
     // N.B. ticksuffix defaults to '°' for angular axes with `thetaunit: 'degrees'`
@@ -148,9 +148,9 @@ module.exports = {
         dflt: [0, 360],
         editType: 'plot',
         description: [
-            'Sets angular span of this polar subplot with two angles (in degrees).',
+            'Sets angular span of this smith subplot with two angles (in degrees).',
             'Sector are assumed to be spanned in the counterclockwise direction',
-            'with *0* corresponding to rightmost limit of the polar subplot.'
+            'with *0* corresponding to rightmost limit of the smith subplot.'
         ].join(' ')
     },
     hole: {
@@ -160,7 +160,7 @@ module.exports = {
         dflt: 0,
         editType: 'plot',
         description: [
-            'Sets the fraction of the radius to cut out of the polar subplot.'
+            'Sets the fraction of the radius to cut out of the smith subplot.'
         ].join(' ')
     },
 

src/plots/smith/layout_defaults.js

@@ -64,7 +64,7 @@ function handleDefaults(contIn, contOut, coerce, opts) {
         // as both radial and angular axes don't have a set domain.
         // Furthermore, angular axes don't have a set range.
         //
-        // Mocked domains and ranges are set by the polar subplot instances,
+        // Mocked domains and ranges are set by the smith subplot instances,
         // but Axes.findExtremes uses the sign of _m to determine which padding value
         // to use.
         //

src/plots/smith/set_convert.js

@@ -7,12 +7,12 @@ var deg2rad = Lib.deg2rad;
 var rad2deg = Lib.rad2deg;
 
 /**
- * setConvert for polar axes!
+ * setConvert for smith axes!
  *
  * @param {object} ax
  *   axis in question (works for both radial and angular axes)
- * @param {object} polarLayout
- *   full polar layout of the subplot associated with 'ax'
+ * @param {object} smithLayout
+ *   full smith layout of the subplot associated with 'ax'
  * @param {object} fullLayout
  *   full layout
  *
@@ -26,7 +26,7 @@ var rad2deg = Lib.rad2deg;
  *
  * Radial axis coordinate systems:
  * - d, c and l: same as for cartesian axes
- * - g: like calcdata but translated about `realaxis.range[0]` & `polar.hole`
+ * - g: like calcdata but translated about `realaxis.range[0]` & `smith.hole`
  *
  * Angular axis coordinate systems:
  * - d: data, in whatever form it's provided
@@ -38,25 +38,25 @@ var rad2deg = Lib.rad2deg;
  *
  * Then, 'g'eometric data is ready to be converted to (x,y).
  */
-module.exports = function setConvert(ax, polarLayout, fullLayout) {
+module.exports = function setConvert(ax, smithLayout, fullLayout) {
     setConvertCartesian(ax, fullLayout);
 
     switch(ax._id) {
         case 'x':
         case 'realaxis':
-            setConvertRadial(ax, polarLayout);
+            setConvertRadial(ax, smithLayout);
             break;
         case 'imaginaryaxis':
-            setConvertAngular(ax, polarLayout);
+            setConvertAngular(ax, smithLayout);
             break;
         case 'realaxis2':
-            setConvertReal(ax, polarLayout);
+            setConvertReal(ax, smithLayout);
             break;
     }
 };
 
-function setConvertReal(ax, polarLayout) {
-    var subplot = polarLayout._subplot;
+function setConvertReal(ax, smithLayout) {
+    var subplot = smithLayout._subplot;
     var radius = subplot.radius;
 
     ax.setGeometry = function() {
@@ -84,8 +84,8 @@ function setConvertReal(ax, polarLayout) {
     };
 }
 
-function setConvertRadial(ax, polarLayout) {
-    var subplot = polarLayout._subplot;
+function setConvertRadial(ax, smithLayout) {
+    var subplot = smithLayout._subplot;
 
     ax.setGeometry = function() {
         var rl0 = ax._rl[0];
@@ -121,7 +121,7 @@ function fromRadians(v, unit) {
     return unit === 'degrees' ? rad2deg(v) : v;
 }
 
-function setConvertAngular(ax, polarLayout) {
+function setConvertAngular(ax, smithLayout) {
     var axType = ax.type;
 
     if(axType === 'linear') {
@@ -170,7 +170,7 @@ function setConvertAngular(ax, polarLayout) {
 
     // N.B. we mock the axis 'range' here
     ax.setGeometry = function() {
-        var sector = polarLayout.sector;
+        var sector = smithLayout.sector;
         var sectorInRad = sector.map(deg2rad);
         var dir = {clockwise: -1, counterclockwise: 1}[ax.direction];
         var rot = deg2rad(ax.rotation);