Move old content to archive directory

.pre-commit-config.yaml

@@ -7,14 +7,8 @@ repos:
       -   id: end-of-file-fixer
       -   id: check-docstring-first
       -   id: check-yaml
-      -   id: double-quote-string-fixer
 
   -   repo: https://github.com/ambv/black
       rev: 19.3b0
       hooks:
       - id: black
-
-  -   repo: https://github.com/pre-commit/pre-commit-hooks
-      rev: v2.3.0
-      hooks:
-      - id: flake8

Makefile → archive/old-contents/Makefile

@@ -173,4 +173,4 @@ xml:
 pseudoxml:
 	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
 	@echo
-	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."

environments/docs.yml → archive/old-contents/environments/docs.yml

@@ -14,4 +14,3 @@ dependencies:
   - numpy
   - pip:
     - sphinx_copybutton
-

environments/env-analysis.yml → archive/old-contents/environments/env-analysis.yml

@@ -10,7 +10,7 @@ dependencies:
 - bottleneck
 - dask
 - dask-mpi
-- dask-jobqueue 
+- dask-jobqueue
 - distributed
 - eofs
 - metpy
@@ -93,4 +93,4 @@ dependencies:
   - ncar-jobqueue
   - seawater
   - watermark
-  - sparse 
+  - sparse

index.rst → archive/old-contents/index.rst

@@ -15,10 +15,10 @@ please open an issue at the GitHub `main repository <http://github.com/NCAR/NCAR
 .. toctree::
    :maxdepth: 1
    :caption: Getting Started with Python
-   
+
    setup
    notebooks/python/00-python-guide-for-people-in-a-hurry
-   
+
 
 .. toctree::
    :maxdepth: 1
@@ -29,8 +29,8 @@ please open an issue at the GitHub `main repository <http://github.com/NCAR/NCAR
 
 .. toctree::
    :maxdepth: 1
-   :caption: Xarray 
-   
+   :caption: Xarray
+
    notebooks/xarray/01-xarray-introduction
    notebooks/xarray/02-xarray-advanced-plotting
 

readthedocs.yml → archive/old-contents/readthedocs.yml

@@ -8,4 +8,4 @@ conda:
 
 python:
   version: 3.7
-  system_packages: true
+  system_packages: true

archive/old-contents/scripts/download_cartopy_assets.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python
+# (C) British Crown Copyright 2011 - 2016, Met Office
+#
+# This file is part of cartopy.
+#
+# cartopy is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# cartopy is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with cartopy.  If not, see <https://www.gnu.org/licenses/>.
+
+"""
+This module provides a command-line tool for triggering the download of
+the data used by various Feature instances.
+
+For detail on how to use this tool, execute it with the `-h` option:
+
+    python download.py -h
+
+"""
+from __future__ import absolute_import, division, print_function
+
+import argparse
+
+from cartopy import config
+from cartopy.feature import Feature, GSHHSFeature, NaturalEarthFeature
+from cartopy.io import Downloader
+
+
+ALL_SCALES = ("110m", "50m", "10m")
+
+
+FEATURE_DEFN_GROUPS = {
+    # Only need one GSHHS resolution because they *all* get downloaded
+    # from one file.
+    "gshhs": GSHHSFeature(scale="f"),
+    "physical": (
+        ("physical", "coastline", ALL_SCALES),
+        ("physical", "land", ALL_SCALES),
+        ("physical", "ocean", ALL_SCALES),
+        ("physical", "rivers_lake_centerlines", ALL_SCALES),
+        ("physical", "lakes", ALL_SCALES),
+        ("physical", "geography_regions_polys", ALL_SCALES),
+        ("physical", "geography_regions_points", ALL_SCALES),
+        ("physical", "geography_marine_polys", ALL_SCALES),
+        ("physical", "glaciated_areas", ALL_SCALES),
+    ),
+    "cultural": (
+        ("cultural", "admin_0_countries", ALL_SCALES),
+        ("cultural", "admin_0_countries_lakes", ALL_SCALES),
+        ("cultural", "admin_0_sovereignty", ALL_SCALES),
+        ("cultural", "admin_0_boundary_lines_land", ALL_SCALES),
+        ("cultural", "urban_areas", ("50m", "10m")),
+        ("cultural", "roads", "10m"),
+        ("cultural", "roads_north_america", "10m"),
+        ("cultural", "railroads", "10m"),
+        ("cultural", "railroads_north_america", "10m"),
+    ),
+    "cultural-extra": (
+        ("cultural", "admin_0_map_units", "110m"),
+        ("cultural", "admin_0_scale_rank", "110m"),
+        ("cultural", "admin_0_tiny_countries", "110m"),
+        ("cultural", "admin_0_pacific_groupings", "110m"),
+        ("cultural", "admin_1_states_provinces_shp", "110m"),
+        ("cultural", "admin_1_states_provinces_lines", "110m"),
+    ),
+}
+
+
+def download_features(group_names, dry_run=True):
+    for group_name in group_names:
+        feature_defns = FEATURE_DEFN_GROUPS[group_name]
+        if isinstance(feature_defns, Feature):
+            feature = feature_defns
+            level = list(feature._levels)[0]
+            downloader = Downloader.from_config(
+                ("shapefiles", "gshhs", feature._scale, level)
+            )
+            format_dict = {"config": config, "scale": feature._scale, "level": level}
+            if dry_run:
+                print("URL: {}".format(downloader.url(format_dict)))
+            else:
+                downloader.path(format_dict)
+                geoms = list(feature.geometries())
+                print("Feature {} length: {}".format(feature, len(geoms)))
+        else:
+            for category, name, scales in feature_defns:
+                if not isinstance(scales, tuple):
+                    scales = (scales,)
+                for scale in scales:
+                    downloader = Downloader.from_config(
+                        ("shapefiles", "natural_earth", scale, category, name)
+                    )
+                    feature = NaturalEarthFeature(category, name, scale)
+                    format_dict = {
+                        "config": config,
+                        "category": category,
+                        "name": name,
+                        "resolution": scale,
+                    }
+                    if dry_run:
+                        print("URL: {}".format(downloader.url(format_dict)))
+                    else:
+                        downloader.path(format_dict)
+                        geoms = list(feature.geometries())
+                        print(
+                            "Feature {}, {}, {} length: {}"
+                            "".format(category, name, scale, len(geoms))
+                        )
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Download feature datasets.")
+    parser.add_argument(
+        "group_names",
+        nargs="+",
+        choices=FEATURE_DEFN_GROUPS,
+        metavar="GROUP_NAME",
+        help="Feature group name: %(choices)s",
+    )
+    parser.add_argument(
+        "--output",
+        "-o",
+        help="save datasets in the specified directory "
+        "(default: user cache directory)",
+    )
+    parser.add_argument(
+        "--dry-run", help="just print the URLs to download", action="store_true"
+    )
+    parser.add_argument(
+        "--ignore-repo-data",
+        action="store_true",
+        help="ignore existing repo data when downloading",
+    )
+    args = parser.parse_args()
+
+    if args.output:
+        config["pre_existing_data_dir"] = args.output
+        config["data_dir"] = args.output
+    if args.ignore_repo_data:
+        config["repo_data_dir"] = config["data_dir"]
+    download_features(args.group_names, dry_run=args.dry_run)

archive/old-contents/setup.rst

@@ -0,0 +1 @@
+.. include:: ./README.rst