rename cablab to esdl

Author: hans-permana

.gitignore

@@ -59,8 +59,8 @@ target/
 # PyCharm / IDEA
 .idea
 
-# Ignored CAB-LAB (Data Cube) files
+# Ignored ESDL (Data Cube) files
 *.nc
 testcube
-cablab-config.py
+esdl-config.py
 

.travis.yml

@@ -22,14 +22,14 @@ install:
   - conda info -a
 
   - conda env create --file environment.yml
-  - source activate esdc
+  - source activate esdl
   - conda list
   - python setup.py install
 
 script:
   # For the unit-tests, disable Numba JIT, otherwise Coverage wont reach the actual Python code
   - export NUMBA_DISABLE_JIT=1
-  - py.test -v --cov=cablab test --ignore=test/providers
+  - py.test -v --cov=esdl test --ignore=test/providers
 
 after_success:
   - pip install codecov

CHANGES.md

@@ -1,3 +1,6 @@
+## version 0.3.0
+* Rename cablab to esdl
+
 ## version 0.2.3
 
 * Using `chunk_sizes` and `comp_level` from configuration when generating cubes

README.rst

@@ -1,30 +1,30 @@
-.. image:: https://travis-ci.org/CAB-LAB/cablab-core.svg?branch=master
-    :target: https://travis-ci.org/CAB-LAB/cablab-core
+.. image:: https://travis-ci.org/esa-esdl/esdl-core.svg?branch=master
+    :target: https://travis-ci.org/esa-esdl/esdl-core
 .. image:: https://ci.appveyor.com/api/projects/status/qvtsx40uv7p0e1tn?svg=true
-   :target: https://ci.appveyor.com/project/hans-permana/cablab-core
-.. image:: https://codecov.io/gh/CAB-LAB/cablab-core/branch/master/graph/badge.svg
-  :target: https://codecov.io/gh/CAB-LAB/cablab-core
+   :target: https://ci.appveyor.com/project/hans-permana/esdl-core
+.. image:: https://codecov.io/gh/esa-esdl/esdl-core/branch/master/graph/badge.svg
+  :target: https://codecov.io/gh/esa-esdl/esdl-core
 
 
-============
-CAB-LAB Core 
-============
+==========
+ESDL Core
+==========
 
 ----------
 Components
 ----------
 
-* ``cablab`` - Public CAB-LAB API
-* ``cablab.cube`` - Data Cube Generation and Access (protected, public parts expr) 
-* ``cablab.cube_cli`` - Command-line interface (protected) 
-* ``cablab.util`` - Common utility functions (protected)
+* ``esdl`` - Public ESDL API
+* ``esdl.cube`` - Data Cube Generation and Access (protected, public parts expr)
+* ``esdl.cube_cli`` - Command-line interface (protected)
+* ``esdl.util`` - Common utility functions (protected)
 
 
 -------------
 Documentation
 -------------
 
-Find the CAB-LAB documentation `here <http://cablab.readthedocs.io/en/latest/>`_.
+Find the ESDL documentation `here <http://cablab.readthedocs.io/en/latest/>`_.
 
 ---------------
 Developer Guide
@@ -55,15 +55,15 @@ Extension points and extensions
 Defined extension points
 ------------------------
 
-* ``cablab.image_providers``: *key* = *class derived from* ``cablab.ImageProvider``    
+* ``esdl.image_providers``: *key* = *class derived from* ``esdl.ImageProvider``
 
 Extensions
 ----------
 
-* ``cablab.image_providers``: 
-  * ``'burnt_area = cablab.providers.burnt_area.BurntAreaProvider'``    
+* ``esdl.image_providers``:
+  * ``'burnt_area = esdl.providers.burnt_area.BurntAreaProvider'``
 * ``console_scripts``: 
-  * ``'cablab_cli = cablab.cli:main'``, see %PYTHON_HOME%/Scripts/cablab_cli (*.exe on Windows) after installation
+  * ``'esdl_cli = esdl.cli:main'``, see %PYTHON_HOME%/Scripts/esdl_cli (*.exe on Windows) after installation
     
 
 ------------
@@ -83,7 +83,7 @@ or real installation::
 How to generate a data cube
 ---------------------------
 
-Create a file ``cablab-config.py`` in your project root directory or your current working directory and add the 
+Create a file ``esdl-config.py`` in your project root directory or your current working directory and add the
 following entry::
 
     cube_sources_root = <your local cube source directory>

appveyor.yml

@@ -1,4 +1,4 @@
-version: '0.2.2.{build}'
+version: '0.3.0.{build}'
 
 environment:
   global:
@@ -12,7 +12,7 @@ install:
 
 build_script:
   - conda env create --file environment.yml
-  - call %PYTHON_LOC%\Scripts\activate.bat esdc
+  - call %PYTHON_LOC%\Scripts\activate.bat esdl
   - python setup.py install
   - conda list
   # For the unit-tests, disable Numba JIT, otherwise Coverage wont reach the actual Python code

cablab/version.py

@@ -1,22 +1,22 @@
 
-'doc' is the CAB-LAB documentation folder. Documentation is build from *.rst files using Sphinx.
+'doc' is the ESDL documentation folder. Documentation is build from *.rst files using Sphinx.
 index.rst is the main documentation page.
 
 To install Sphinx run:
 
      > pip install Sphinx
 
-To build the CAB-LAB documentation run:
+To build the ESDL documentation run:
 
-     > cd cablab-core/doc
+     > cd esdl-core/doc
      > make html
 
 or to force regeneration of docs, run:
 
-     > cd cablab-core
+     > cd esdl-core
      > sphinx-build -E -a -b html doc doc/_build/html
 
-Then find the html documentation in cablab-core/doc/_build/html
+Then find the html documentation in esdl-core/doc/_build/html
 
 More info:
     * Sphinx Tutorial: http://sphinx-doc.org/tutorial.html

doc/README.txt

@@ -4,19 +4,19 @@ Collaboration
 
 Collaboration is at the heart of science!
 
-The CAB-LAB project explicitly aims at enabling more scientists from various disciplines to not only interact
+The ESDL project explicitly aims at enabling more scientists from various disciplines to not only interact
 with Earth System data, but also with each other.
-The CAB-LAB team seeks active exchange with users of any background, data owners willing to add their data to the ESDC,
+The ESDL team seeks active exchange with users of any background, data owners willing to add their data to the ESDC,
 and developers who are interested in improving the ESDC.
 
-There are several ways to get in contact with the CAB-LAB team and other users of the ESDC:
+There are several ways to get in contact with the ESDL team and other users of the ESDC:
 
 Code Repository
 ===============
 
 The source code is currently and will be for the foreseeable future under continuous development. Since the CAB-LAB team
 takes collaboration, transparency, and reproducibility seriously, the project is open source and public from the very beginning.
-Visit `CAB-LAB's github repository <https://github.com/CAB-LAB>`_ and check out the current status of the project or even
+Visit `ESDL's github repository <https://github.com/esa-esdl>`_ and check out the current status of the project or even
 contribute!
 
 Website & Forum

doc/collaboration.rst

@@ -16,7 +16,6 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-# Include 'cablab'
 sys.path.append(os.path.abspath('..'))
 
 # packages thare are difficult to import, becuase the collide with pillow==3.0.0 requirement by rtd

doc/conf.py

@@ -5,7 +5,7 @@ DAT for Julia
 Overview
 ========
 
-The Data Analytics Toolkit (DAT) for Julia is hosted in `CABLAB's github repository <https://github.com/CAB-LAB/CABLAB.jl>`_
+The Data Analytics Toolkit (DAT) for Julia is hosted in `ESDL's github repository <https://github.com/esa-esdl/CABLAB.jl>`_
 and is developed in close interaction with the scientific community. Here we give a short overview on the capabilities
 of the Julia DAT, but we would refer to the `official documentation`_ for
 a more detailed and frequently updated software description.
@@ -47,13 +47,13 @@ Users can add custom functions to the DAT for individual sessions. This is descr
 Use Cases and Examples
 ======================
 
-Example notebooks that explore the ESDC using the Julia DAT can be found in the `cablab-shared`_ repository.
+Example notebooks that explore the ESDC using the Julia DAT can be found in the `esdl-shared`_ repository.
 
 
 
-.. _`CABLAB's github repository`: https://github.com/CAB-LAB/CABLAB.jl
-.. _`official documentation`: http://cab-lab.github.io/CABLAB.jl/latest/
-.. _Analysis: http://cab-lab.github.io/CABLAB.jl/latest/analysis.html
-.. _Plotting: http://cab-lab.github.io/CABLAB.jl/latest/plotting.html
-.. _`adding_new`: http://cab-lab.github.io/CABLAB.jl/latest/adding_new.html
-.. _`cablab-shared`: https://github.com/CAB-LAB/cablab-shared/tree/master/notebooks/Julia
+.. _`ESDL's github repository`: https://github.com/esa-esdl/CABLAB.jl
+.. _`official documentation`: http://esa-esdl.github.io/CABLAB.jl/latest/
+.. _Analysis: http://esa-esdl.github.io/CABLAB.jl/latest/analysis.html
+.. _Plotting: http://esa-esdl.github.io/CABLAB.jl/latest/plotting.html
+.. _`adding_new`: http://esa-esdl.github.io/CABLAB.jl/latest/adding_new.html
+.. _`esdl-shared`: https://github.com/esa-esdl/esdl-shared/tree/master/notebooks/Julia

doc/dat_julia.rst

@@ -8,9 +8,9 @@
 .. _pandas: http://pandas.pydata.org/
 .. _datetime: https://docs.python.org/3/library/datetime.html
 .. _Numpy ndarrays: http://docs.scipy.org/doc/numpy/reference/arrays.ndarray.html
-.. _cablab.dat: https://github.com/CAB-LAB/cablab-core/blob/master/cablab/dat.py
-.. _E-Lab: https://cablab.earthsystemdatacube.net
-.. _Jupyter notebook: https://github.com/CAB-LAB/cablab-shared/blob/master/notebooks/Python/Python_DAT.ipynb
+.. _esdl.dat: https://github.com/esa-esdl/esdl-core/blob/master/esdl/dat.py
+.. _E-Lab: https://jupyterhub.earthsystemdatalab.net
+.. _Jupyter notebook: https://github.com/esa-esdl/esdl-shared/blob/master/notebooks/Python/Python_DAT.ipynb
 
 
 .. _Indexing and selecting data: http://xarray.pydata.org/en/stable/indexing.html
@@ -47,8 +47,8 @@ Such dataset objects are what you get when accessing the cube's data as follows:
 
 .. code-block:: python
 
-    from cablab import Cube
-    cube = Cube.open("/home/doe/esdc/cablab-datacube-0.2.4/low-res")
+    from esdl import Cube
+    cube = Cube.open("/home/doe/esdc/esdc-31d-1deg-1x180x360-1.0.1_1")
     dataset = cube.data.dataset(["precipitation", "evaporation", "ozone", "soil_moisture","air_temperature_2m"])
 
 Any geo-physical variable in the ESDC is represented by a `xarray.DataArray`_, which are Numpy_-like data arrays
@@ -64,7 +64,7 @@ The following links point into the xarray_ documentation, they provide the low-l
 * `Time series data`_
 
 Building on top of the xarray_ API the DAT offers high-level functions for ESDC-specific workflows
-in the `cablab.dat`_ module. These functions are addressing specific user requirements and
+in the `esdl.dat`_ module. These functions are addressing specific user requirements and
 the scope of the module will increase with the users of the DAT. In the following, typical use cases and examples
 provide an illustrative introduction into the usage of the DAT and thus into the exploration of the ESDC.
 
@@ -267,7 +267,7 @@ The low-level interface of the ESDC Python DAT is the `xarray API`_.
 
 The following functions provide the high-level API of the ESDC Python DAT:
 
-.. automodule:: cablab.dat
+.. automodule:: esdl.dat
     :members:
 
 

doc/dat_python.rst

@@ -12,11 +12,11 @@
 .. _xarray.DataArray: http://xarray.pydata.org/en/stable/data-structures.html#dataarray
 .. _Numpy ndarray: http://docs.scipy.org/doc/numpy/reference/arrays.ndarray.html
 
-.. _ESDC E-Laboratory: http://cablab.earthsystemdatacube.net/cablab-jupyterhub/
-.. _ESDC THREDDS server: http://www.brockmann-consult.de/cablab-thredds/catalog.html
-.. _ESDC FTP server: ftp://ftp.brockmann-consult.de/cablab02/cablab-datacube-0.2.4/
-.. _ESDC community repository: https://github.com/CAB-LAB/cablab-shared
-.. _ESDC community notebooks: https://github.com/CAB-LAB/cablab-shared/tree/master/notebooks
+.. _ESDL E-Laboratory: http://jupyterhub.earthsystemdatalab.net/
+.. _ESDL THREDDS server: http://www.brockmann-consult.de/cablab-thredds/catalog.html
+.. _ESDL FTP server: ftp://ftp.brockmann-consult.de/cablab02/esdc-31d-1deg-1x180x360-1.0.1_1/
+.. _ESDL community repository: https://github.com/esa-esdl/esdl-shared
+.. _ESDL community notebooks: https://github.com/esa-esdl/esdl-shared/tree/master/notebooks
 
 
 ===========
@@ -29,7 +29,7 @@ which can be accessed in a number of different ways which are described in this
 Download ESDC Data
 ==================
 
-The simplest approach to access the ESDC data is downloading it to you computer using the `ESDC FTP server`_.
+The simplest approach to access the ESDC data is downloading it to you computer using the `ESDL FTP server`_.
 
 Since the ESDC is basically a directory of NetCDF_ files, you can use a variety of software packages and programming
 languages to access the data. In each cube directory, you find a text file ``cube.config`` which describes the overall
@@ -42,7 +42,7 @@ by a convenient data structures. The section :ref:`data_access_py` describes how
 OPeNDAP and WCS Services
 ========================
 
-The ESDC' data variables can also be accessed via a dedicated `ESDC THREDDS server`_.
+The ESDC' data variables can also be accessed via a dedicated `ESDL THREDDS server`_.
 
 The server supports the `OPeNDAP`_ and OGC-compliant `Web Coverage Service (WCS)`_ data access protocols.
 You can use it for accessing subsets of the ESDC's data variables and also for visual exploration of the data,
@@ -56,15 +56,15 @@ the aforementioned ESDC Python/Julia data access packages.
 E-Laboratory
 ============
 
-A dedicated `ESDC E-Laboratory`_ has been developed to access the ESDC data via distributed
+A dedicated `ESDL E-Laboratory`_ has been developed to access the ESDC data via distributed
 `Jupyter`_ `Notebooks`_ for Julia and Python. This is the most resource efficient and convenient
 way of exploring the ESDC.
 
 These notebooks have direct access to the ESDC data so there is no need to download it.
 In addition they provide the ESDC Python and Julia APIs comprising
 the Data Access API and the Data Analytics Toolkit.
 
-The E-Laboratory provides some example notebooks in the shared `ESDC community repository`_.
+The E-Laboratory provides some example notebooks in the shared `ESDL community repository`_.
 
 The E-Laboratory is based on the JupyterHub_ platform and currently comprises three 16-core computers
 running in a Cloud environment.
@@ -92,17 +92,17 @@ the user has to download and install the cube library when working on a local co
 The ESDC Python package has been developed against latest Anaconda_ / Miniconda_ distributions and uses their
 Conda_ package manager.
 
-To get started on your local computer with Python, clone the `cablab-core`
-repository from `<https://github.com/CAB-LAB>`_:
+To get started on your local computer with Python, clone the `esdl-core`
+repository from `<https://github.com/esa-esdl>`_:
 
 .. code-block:: bash
 
-    git clone https://github.com/CAB-LAB/cablab-core
+    git clone https://github.com/esa-esdl/esdl-core
 
-The following command will create a new Python 3.5 environment named ``esdc`` with all required dependencies, namely
+The following command will create a new Python 3.5 environment named ``esdl`` with all required dependencies, namely
 
     * dask >= 0.14
-    * gridtools >= 0.1 (from Conda channel ``forman``)
+    * gridtools >= 0.1 (from Conda channel ``cablab``)
     * h5netcdf >= 0.3
     * h5py >= 2.7
     * netcdf4 >= 1.2
@@ -127,14 +127,14 @@ on Windows:
 
     > activate esdc
 
-Now change into new folder ``cablab-core`` and install the ``cablab`` Python package using the ``develop`` target:
+Now change into new folder ``esdl-core`` and install the ``esdl`` Python package using the ``develop`` target:
 
 .. code-block:: bash
 
-    $ cd cablab-core
+    $ cd esdl-core
     $ python setup.py develop
 
-You can now easily change source code in ``cablab-core`` without reinstalling it.
+You can now easily change source code in ``esdl-core`` without reinstalling it.
 When you do not plan to add or modify any code (e.g. add a new source data provider), you can also permanently
 install the sources using
 
@@ -159,7 +159,7 @@ data chunks of different sizes for further analysis.
 
 .. code:: python
 
-    from cablab import Cube
+    from esdl import Cube
     from datetime import datetime
     import numpy as np
 
@@ -297,7 +297,7 @@ If you no longer require access to the cube, it should be closed to release file
 
     cube.close()
 
-Some more demonstrations are included in the `ESDC community notebooks`_.
+Some more demonstrations are included in the `ESDL community notebooks`_.
 
 Using Julia
 ===========

doc/esdc_access.rst

@@ -42,7 +42,7 @@ The **time span** currently covered is 2001-2011. We are dedicated to expand thi
 Format and Structure
 ====================
 
-The binary data format for the Earth System Data Cube (ESDC) in the CAB-LAB project is **netCDF 4 classic**, where the term classic stands for an
+The binary data format for the Earth System Data Cube (ESDC) in the ESDL project is **netCDF 4 classic**, where the term classic stands for an
 underlying HDF-5 format accessed by a netCDF 4 API.
 
 The netCDF file's content and structure follows the `CF-conventions <http://cfconventions.org/cf-conventions/v1.6.0/cf-conventions.html>`_.
@@ -147,7 +147,7 @@ Gap-Filling Approach
 --------------------
 
 The current version (version 0.1, Feb 2016) of the ESDC does not explicitly fill gaps. However, some
-gap-filling occurs during temporal aggregation as described below. The CAB-LAB team may provide
+gap-filling occurs during temporal aggregation as described below. The ESDL team may provide
 gap-filled ESDC versions at a later point in time of the project. Gap-filling is part of the *Data Analytics
 Toolkit* and is thus not tackled during Data Cube generation to retain the information on the original data coverage
 as much as possible.