Re-introduce Cynthia Brewer palettes.

docs/iris/src/userguide/plotting_a_cube.rst

@@ -12,6 +12,29 @@ extended within Iris to facilitate easy visualisation of a cube's data.
 Matplotlib's pyplot has been modelled on the MATLAB framework, therefore users of MATLAB may find a degree of 
 familiarity with the interface.
 
+.. note::
+   Iris includes colour specifications and designs developed by `Cynthia Brewer <http://colorbrewer.org/>`_.
+   These colour schemes are freely available under the following licence::
+
+      Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+  
+      Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+  
+      Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+      You may obtain a copy of the License at
+  
+      http://www.apache.org/licenses/LICENSE-2.0
+  
+      Unless required by applicable law or agreed to in writing, software distributed
+      under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+      CONDITIONS OF ANY KIND, either express or implied. See the License for the
+      specific language governing permissions and limitations under the License.
+
+   Citations to Cynthia Brewer can be easily added to plots using the :func:`iris.plot.citation` function.
+
+   To include a reference in a journal article or report please refer to `section 5 <http://www.personal.psu.edu/cab38/ColorBrewer/ColorBrewer_updates.html>`_
+   in the citation guidance provided by Cynthia Brewer.
+
 
 ***************************
 Matplotlib's pyplot basics

lib/iris/etc/palette/diverging/BrBG_03.txt

@@ -0,0 +1,24 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_03
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.847059 0.701961 0.396078
+   0.960784 0.960784 0.960784
+   0.352941 0.705882 0.674510

lib/iris/etc/palette/diverging/BrBG_04.txt

@@ -0,0 +1,25 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_04
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.650980 0.380392 0.101961
+   0.874510 0.760784 0.490196
+   0.501961 0.803922 0.756863
+   0.003922 0.521569 0.443137

lib/iris/etc/palette/diverging/BrBG_05.txt

@@ -0,0 +1,26 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_05
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.650980 0.380392 0.101961
+   0.874510 0.760784 0.490196
+   0.960784 0.960784 0.960784
+   0.501961 0.803922 0.756863
+   0.003922 0.521569 0.443137

lib/iris/etc/palette/diverging/BrBG_06.txt

@@ -0,0 +1,27 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_06
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.549020 0.317647 0.039216
+   0.847059 0.701961 0.396078
+   0.964706 0.909804 0.764706
+   0.780392 0.917647 0.898039
+   0.352941 0.705882 0.674510
+   0.003922 0.400000 0.368627

lib/iris/etc/palette/diverging/BrBG_07.txt

@@ -0,0 +1,28 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_07
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.549020 0.317647 0.039216
+   0.847059 0.701961 0.396078
+   0.964706 0.909804 0.764706
+   0.960784 0.960784 0.960784
+   0.780392 0.917647 0.898039
+   0.352941 0.705882 0.674510
+   0.003922 0.400000 0.368627

lib/iris/etc/palette/diverging/BrBG_08.txt

@@ -0,0 +1,29 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_08
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.549020 0.317647 0.039216
+   0.749020 0.505882 0.176471
+   0.874510 0.760784 0.490196
+   0.964706 0.909804 0.764706
+   0.780392 0.917647 0.898039
+   0.501961 0.803922 0.756863
+   0.207843 0.592157 0.560784
+   0.003922 0.400000 0.368627

lib/iris/etc/palette/diverging/BrBG_09.txt

@@ -0,0 +1,30 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_09
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.549020 0.317647 0.039216
+   0.749020 0.505882 0.176471
+   0.874510 0.760784 0.490196
+   0.964706 0.909804 0.764706
+   0.960784 0.960784 0.960784
+   0.780392 0.917647 0.898039
+   0.501961 0.803922 0.756863
+   0.207843 0.592157 0.560784
+   0.003922 0.400000 0.368627

lib/iris/etc/palette/diverging/BrBG_10.txt

@@ -0,0 +1,31 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_10
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.329412 0.188235 0.019608
+   0.549020 0.317647 0.039216
+   0.749020 0.505882 0.176471
+   0.874510 0.760784 0.490196
+   0.964706 0.909804 0.764706
+   0.780392 0.917647 0.898039
+   0.501961 0.803922 0.756863
+   0.207843 0.592157 0.560784
+   0.003922 0.400000 0.368627
+   0.000000 0.235294 0.188235

lib/iris/etc/palette/diverging/BrBG_11.txt

@@ -0,0 +1,32 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         BrBG_11
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.329412 0.188235 0.019608
+   0.549020 0.317647 0.039216
+   0.749020 0.505882 0.176471
+   0.874510 0.760784 0.490196
+   0.964706 0.909804 0.764706
+   0.960784 0.960784 0.960784
+   0.780392 0.917647 0.898039
+   0.501961 0.803922 0.756863
+   0.207843 0.592157 0.560784
+   0.003922 0.400000 0.368627
+   0.000000 0.235294 0.188235

lib/iris/etc/palette/diverging/PRGn_03.txt

@@ -0,0 +1,24 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         PRGn_03
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.686275 0.552941 0.764706
+   0.968627 0.968627 0.968627
+   0.498039 0.749020 0.482353

lib/iris/etc/palette/diverging/PRGn_04.txt

@@ -0,0 +1,25 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         PRGn_04
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.482353 0.196078 0.580392
+   0.760784 0.647059 0.811765
+   0.650980 0.858824 0.627451
+   0.000000 0.533333 0.215686

lib/iris/etc/palette/diverging/PRGn_05.txt

@@ -0,0 +1,26 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         PRGn_05
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.482353 0.196078 0.580392
+   0.760784 0.647059 0.811765
+   0.968627 0.968627 0.968627
+   0.650980 0.858824 0.627451
+   0.000000 0.533333 0.215686

lib/iris/etc/palette/diverging/PRGn_06.txt

@@ -0,0 +1,27 @@
+# Apache-Style Software License for ColorBrewer software and ColorBrewer Color Schemes
+# 
+# Copyright (c) 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+# 
+# name:         PRGn_06
+# scheme:       diverging
+# keyword:      anomaly
+# interpolate:  off
+# source:       http://colorbrewer.org/
+# type:         RGB
+#
+   0.462745 0.164706 0.513726
+   0.686275 0.552941 0.764706
+   0.905882 0.831373 0.909804
+   0.850980 0.941176 0.827451
+   0.498039 0.749020 0.482353
+   0.105882 0.470588 0.215686