MATLAB气候数据存储工具箱（高分项目）.zip

# Climate Data Store Toolbox for MATLAB [](https://www.mathworks.com/matlabcentral/fileexchange/104550-climate-data-store-toolbox-for-matlab) [](https://matlab.mathworks.com/) [](https://github.com/mathworks/climatedatastore/actions/workflows/main.yml) [](https://github.com/mathworks/climatedatastore/issues?q=is%3Aissue+is%3Aopen+label%3Abug)  [](https://app.codecov.io/gh/mathworks/climatedatastore)   MATLAB® Tools to access [The Climate Data Store](https://cds.climate.copernicus.eu/). It is a wealth of information about the Earth's past, present and future climate. There are hundreds of data sets associated with climate change. This toolbox allows you to easily access data and download it for analysis in MATLAB. Please report bugs and suggest enhancements by [creating a new issue on GitHub](https://github.com/mathworks/climatedatastore/issues). More info on installing and using the toolbox [below](#using-the-climate-data-store-toolbox). ## Collaborating on the Climate Data Store Toolbox We're always excited to have people make improvements large and small to Climate Data Store Toolbox. **Contributions do not have to be code!** If you see a way to explain things more clearly or a great example of how to use something, please contribute it (or a link to your content). Please [create issues](https://github.com/mathworks/climatedatastore/issues) even if you don't code the solution. We also welcome pull requests to resolve issues that we haven't gotten to yet! See [CONTRIBUTING.MD](CONTRIBUTING.MD) for more information. ### How to get started improving the toolbox: 1. **Clone the repository:** using MATLAB: 1. In MATLAB, switch to the directory where you want the project created. 1. Right click in the current folder browser, and choose *Source Control/Manage Files...* 1. Set the repository path to `https://github.com/mathworks/climatedatastore.git`, and set Sandbox to the directory you want created. 1. Click (Retrieve). Files will be cloned locally. 1. Open the `climatedatastore.prj` -- You're ready to make edits! 1. When you're done, run the test suite. 1. Create a pull request. **Looking for ideas?** Fix a ["good first" issue!](https://github.com/mathworks/climatedatastore/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) ### MATLAB Features Used This demonstrates a number of MATLAB features, including: * [Calling Python From MATLAB](https://www.mathworks.com/help/matlab/call-python-libraries.html) * [Toolbox Packaging](https://www.mathworks.com/help/matlab/matlab_prog/create-and-share-custom-matlab-toolboxes.html) * [MATLAB Projects](https://www.mathworks.com/help/matlab/projects.html) * [Argument validation](https://www.mathworks.com/help/matlab/matlab_prog/function-argument-validation-1.html) * Code Issue detection using [Code Analyzer](https://www.mathworks.com/help/matlab/matlab_prog/check-code-for-errors-and-warnings.html) and [Code Issues](https://www.mathworks.com/help/matlab/ref/codeissues.html) * [Unit Tests](https://www.mathworks.com/help/matlab/matlab-unit-test-framework.html) * [Code Coverage using Cobertura report format](https://www.mathworks.com/help/matlab/ref/matlab.unittest.plugins.codecoverage.coberturaformat-class.html) and [CodeCov](https://app.codecov.io/gh/mathworks/climatedatastore) * [Mocking Framework](https://www.mathworks.com/help/matlab/mocking-framework.html) * [Parameters in Unit Tests](https://www.mathworks.com/help/matlab/matlab_prog/use-parameters-in-class-based-tests.html) * [MATLAB Classes](https://www.mathworks.com/help/matlab/object-oriented-programming.html) * [Static Methods](https://www.mathworks.com/help/matlab/matlab_oop/static-methods.html) * [Property Access Methods](https://www.mathworks.com/help/matlab/matlab_oop/property-set-methods.html) * [`buildtool`](https://www.mathworks.com/help/matlab/matlab_prog/overview-of-matlab-build-tool.html) to run automated checks and tests * [GitHub Actions](https://github.com/matlab-actions/overview) * [Action to setup MATLAB](https://github.com/matlab-actions/overview#setup-matlab) Configure a MATLAB session * Multi-release testing: Run tests across a number of MATLAB releases [(see yaml)](https://github.com/mathworks/climatedatastore/blob/main/.github/workflows/release.yml) * [Action to run MATLAB Build](https://github.com/matlab-actions/overview#run-matlab-build) Run automated checks and tests when new code is pushed to repo [(see yaml)](https://github.com/mathworks/climatedatastore/blob/main/.github/workflows/main.yml) * [Action to run MATLAB Code](https://github.com/matlab-actions/overview#run-matlab-command) Run automated tests and release a new version when a new tag is created. [(see yaml)](https://github.com/mathworks/climatedatastore/blob/main/.github/workflows/release.yml) ## Using the Climate Data Store Toolbox *This is just a quick overview -- install and look at `GettingStarted.mlx` for more information on using the Toolbox.* ### Functions | Function | Description | | ------ | ------ | | `climateDataStoreDownload` | Get data from Copernicus Climate Data Store | | `climateDataStoreDownloadAsync` | Queue a request data from Copernicus Climate Data Store and continue working in MATLAB. | ### Usage 1. See the notes below for information on first time install 2. type `help climateDataStoreDownload` or `help climateDataStoreDownloadAsync` for help on using the functions 3. Find your dataset at [Climate Data Store](https://cds.climate.copernicus.eu/#!/home) and click on the "download data" tab. Make your selections for the subset of data you want. Click "show API request" at the bottom. 4. Use `climateDataStoreDownload` to get the data. The first parameter is the name of the data set to retrieve. The second parameter is a MATLAB version of the python structure that selects what subset of the data to download. `climateDataStoreDownload` downloads the files, and returns a list of files that were downloaded. Note that downloading the files can take some time, depending on how large they are. If you have really large files, `climateDataStoreDownloadAsync` can be helpful. You can check on the status of your request by visiting [the CDS request status page](https://cds.climate.copernicus.eu/cdsapp#!/yourrequests). Typically, files returned are: | File Type | Extension | MATLAB Functions | |-----------|-----------|------------------| | NetCDF | `.nu` | [`ncinfo`](https://www.mathworks.com/help/matlab/ref/ncinfo.html) , [`ncread`](https://www.mathworks.com/help/matlab/ref/ncread.html) | | GRIB | `.grib` | [`ncinfo`](https://www.mathworks.com/help/matlab/ref/ncinfo.html) , [`ncread`](https://www.mathworks.com/help/matlab/ref/ncread.html) | | text | `.txt` , `.csv` | [`readtable`](https://www.mathworks.com/help/matlab/ref/readtable.html) ### First time Install * Requires MATLAB release R2020a or later * Install the toolbox by using the Add-on explorer in MATLAB, or by downloading the `climatedatastore.mltb