{"id":16702423,"url":"https://github.com/ropensci/modistsp","last_synced_at":"2025-04-05T13:09:01.551Z","repository":{"id":18462406,"uuid":"21656836","full_name":"ropensci/MODIStsp","owner":"ropensci","description":"An \"R\" package for automatic download and preprocessing of MODIS Land Products Time Series","archived":false,"fork":false,"pushed_at":"2024-05-17T13:42:31.000Z","size":188349,"stargazers_count":152,"open_issues_count":4,"forks_count":50,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-05-22T12:42:49.218Z","etag":null,"topics":["gdal","modis","modis-data","modis-land-products","peer-reviewed","preprocessing","r","r-package","remote-sensing","rstats","satellite-imagery","time-series"],"latest_commit_sha":null,"homepage":"https://docs.ropensci.org/MODIStsp","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ropensci.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-07-09T15:05:34.000Z","updated_at":"2024-05-28T17:16:30.266Z","dependencies_parsed_at":"2023-10-05T04:15:59.006Z","dependency_job_id":"a2e59d6c-3590-4363-8c97-1a6606731458","html_url":"https://github.com/ropensci/MODIStsp","commit_stats":{"total_commits":1336,"total_committers":7,"mean_commits":"190.85714285714286","dds":0.2956586826347305,"last_synced_commit":"c55ca5eaf001070bcea97288b07f981436dadd6c"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2FMODIStsp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2FMODIStsp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2FMODIStsp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2FMODIStsp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci","download_url":"https://codeload.github.com/ropensci/MODIStsp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247339158,"owners_count":20923014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gdal","modis","modis-data","modis-land-products","peer-reviewed","preprocessing","r","r-package","remote-sensing","rstats","satellite-imagery","time-series"],"created_at":"2024-10-12T19:04:39.875Z","updated_at":"2025-04-05T13:09:01.519Z","avatar_url":"https://github.com/ropensci.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput:\n  github_document:\n    toc: no\n    toc_depth: 2\n---\n\n\n```{r, echo = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"README-\"\n)\n```\n# MODIStsp \u003cimg src='man/figures/logo.png' align=\"right\" height=\"139\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![](https://www.r-pkg.org/badges/version-ago/MODIStsp)](https://cran.r-project.org/package=MODIStsp)\n[![](https://cranlogs.r-pkg.org/badges/MODIStsp?color=orange)](https://cran.r-project.org/package=MODIStsp)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1972039.svg)](https://doi.org/10.5281/zenodo.1972039)\n[![Coverage Status](https://img.shields.io/codecov/c/github/ropensci/MODIStsp/master.svg)](https://app.codecov.io/github/ropensci/MODIStsp?branch=master)\n[![](https://badges.ropensci.org/184_status.svg)](https://github.com/ropensci/software-review/issues/184)\n\u003c!-- badges: end --\u003e\n\n[`{MODIStsp}`](https://docs.ropensci.org/MODIStsp/) is a `R` package devoted to\nautomatizing the creation of time series of rasters derived from MODIS Land Products\ndata.\n`{MODIStsp}` allows performing several preprocessing steps (e.g., download, mosaicing,\nreprojection and resize) on MODIS data available within a given time period. \nUsers have the ability to select which specific layers of the original MODIS HDF\nfiles they want to process. They also can select which additional Quality Indicators \nshould be extracted from the aggregated MODIS Quality Assurance layers and, in the \ncase of Surface Reflectance products, which Spectral Indexes should be computed \nfrom the original reflectance bands. For each output layer, outputs are saved as\nsingle-band raster files corresponding to each available acquisition date. \nVirtual files allowing access to the entire time series as a single file can be \nalso created. All processing parameters can be easily selected with a user-friendly\nGUI, although non-interactive execution exploiting a previously created Options \nFile is possible. Stand-alone execution outside an \"R\" environment is also possible,\nallowing to use scheduled execution of MODIStsp to automatically update time series \nrelated to a MODIS product and extent whenever a new image is available. \n\n\u003ca href=\"http://www.irea.cnr.it/en/\"\u003e \u003cimg src=\"man/figures/irea_logo.png\" height=\"40\" align=\"left\" /\u003e\u003c/a\u003e \n\n\u003cspan style='font-style:italic;font-weight:bold;'\u003e`{MODIStsp}` was developed by Lorenzo Busetto and Luigi Ranghetti, \n[Institute of Remote Sensing of Environment](http://www.irea.cnr.it/en/) - National Research Council - Italy (CNR-IREA).\n[It is dedicated to the memory of Lorenzo](https://docs.ropensci.org/MODIStsp/articles/lorenzo.html).\u003c/span\u003e\n\n## Citation\n  \nTo cite `{MODIStsp}` please use:\n\n\nL. Busetto, L. Ranghetti (2016) MODIStsp: An R package for automatic preprocessing of MODIS\n  Land Products time series, Computers \u0026 Geosciences, Volume 97, Pages\n  40-48, ISSN 0098-3004, https://doi.org/10.1016/j.cageo.2016.08.020, URL: https://github.com/ropensci/MODIStsp. \n  \n\n## Website\n\nFor more information, documentation and examples of use, __see also the `{MODIStsp}` website at [docs.ropensci.org/MODIStsp](https://docs.ropensci.org/MODIStsp/)__. \n\n\n## Important News\n\n- 29/10/2021 - `{MODIStsp}` (GitHub version 2.0.6.9000) supports products with version 061.\nVersion 006 will remain the default product version until its decommission\nwill be announced.\nVersion 061 can be specified through the argument `prod_version` of function\n`MODIStsp()` or by selecting it in the GUI.\n\n- 10/12/2020 - `{MODIStsp}` was resubmitted to CRAN after the maintainer's death.\nNow `{MODIStsp}` is dedicated to Lorenzo Busetto (https://docs.ropensci.org/MODIStsp/articles/lorenzo).\n\n- 01/09/2020 - `{MODIStsp}` 2.0.0 is out. Provides a new GUI interface based on Shiny, getting rid\nof the archived dependencies on gWidgets/gWidgetsRGtk2. Also provides much easier usage from \nthe CLI, by allowing to set all processing arguments also from the CLI. __Note:__ due to the \nintroduced changes, options files created with previous versions of `{MODIStsp}` will no \nlonger work. Also, processing scripts using `{MODIStsp}` may need to be slightly adapted.\n\n- 09/05/2020 - `{MODIStsp}` 1.4.0 is out. Switches to use of GDAL3/PROJ6 WKTs for projection representation and usage of `{sf}` for all internal work on vector data. Adds support for products MCD19A1 and MCD19A2 products.\n\n- 07/06/2019 - `{MODIStsp}` 1.3.9 is out. Fixes a bug causing crashes on MOD14A1 product, adds support for product MCD12Q2 and removes support for no longer available version 5 of some products.\n\n- 05/03/2019 - `{MODIStsp}` 1.3.8 is out. Fixes an issue causing incorrect application of scale/offset values on GDAL versions \u003e 2.3 (https://github.com/ropensci/MODIStsp/issues/163) and adds support for products MOD21A1D.006, MOD21A1N.006 and MOD21A2.006.\n\n- 29/11/2018 - We recently discovered a nasty bug in the computation of some custom spectral indices (those including additions / subtractions on reflectance values, such as in (b1_NIR+0.1) / b2_Red. See [here](https://docs.ropensci.org/MODIStsp/articles/discovered_bug.html) for further details. The bug is fixed as of version 1.3.7. \n\n- 07/08/2018 - We are glad to report that `{MODIStsp}` is now included in the \n[rOpenSci](https://ropensci.org/about/) packages ecosystem. We thank reviewers\nLeah Wasser and Jeffrey Hanson for their valuable reviews, which helped us to \nfurther improve the package.\n\n- 10/07/2018 - `{MODIStsp}` v. 1.3.6 is out (check out the [Release Notes](https://github.com/ropensci/MODIStsp/releases/tag/1.3.6) for further details).\n\n- 20/06/2018 - `{MODIStsp}` v. 1.3.5 is out (check out the [Release Notes](https://github.com/ropensci/MODIStsp/releases/tag/v1.3.5) for further details).\n\n- 11/04/2018 - Due to new NASA Policies the MODIS FTP servers were shut down \nstarting, April 2, 2018. **FTP download is therefore no longer working** and will\nbe removed in the next MODIStsp version.\n\n- 11/04/2018 - [**Decommissioning of MODIS Version 5 Land Data Products**]( https://lpdaac.usgs.gov/news/decommissioning-modis-version-51-land-cover-type-data-products-january-7-2019/). As per NASA notice above, MODIS v005 products are going to be \ndecommissioned, and will soon be no longer available for download. Support for those\nproducts will be removed in the next MODIStsp version.\n\n- 11/08/2017 - `{MODIStsp}` 1.3.3 was released today. It provides improvements in\nprocessing speed, as well as the usual bug fixes\n(thanks to all the users that signaled problems). Check the [Release Notes](https://github.com/ropensci/MODIStsp/releases/tag/v1.3.3) for further details.\n\n-   25/07/2017 - As of today, **most of the content related to `{MODIStsp}` has been\nmoved to our new website at [docs.ropensci.org/MODIStsp](https://docs.ropensci.org/MODIStsp/)\n**, which provides a much better user interface and ease of access to MODIStsp-related \ninformation. From now on, please **consult the new website for detailed and updated\ninformation on the package**. \n\n-   Also our previous FAQ page on GitHub containing info for solving common \ninstallation, downloading and processing problems and issues was discontinued\nand **migrated at [docs.ropensci.org/MODIStsp/articles/faq.html](https://docs.ropensci.org/MODIStsp/articles/faq.html)**.  \n\n## Problems and Issues\n\n- Please **report any issues** you may encounter in our [issues page on github \u003ci class=\"fa fa-github-square\" aria-hidden=\"true\"\u003e\u003c/i\u003e](https://github.com/ropensci/MODIStsp/issues).\n\n## \u003ci class=\"fa fa-desktop\" aria-hidden=\"true\"\u003e\u003c/i\u003e System Requirements \n\n`{MODIStsp}` requires [`R`](https://cran.r-project.org) v \u003e= 3.6.3.\n\n____________________________________________________________________________________\n\n# Installation Instructions\n\n## \u003ci class=\"fa fa-windows\" aria-hidden=\"true\"\u003e\u003c/i\u003e Installing on Windows\n\nYou can install the stable version of `{MODIStsp}` from CRAN: \n\n`install.packages(\"MODIStsp\")`\n\n, or the development version (containing the latest improvements and bug fixes) \nfrom GitHub:\n\n```{r, eval=FALSE, message=FALSE, warning=FALSE, include=TRUE}\ninstall.packages(\"remotes\")\nlibrary(remotes)\ninstall_github(\"ropensci/MODIStsp\")\n```\n\n## \u003ci class=\"fa fa-linux\" aria-hidden=\"true\"\u003e\u003c/i\u003e Installing on Linux Systems\n\nTo install `{MODIStsp}` on Linux, you need to be able to install the `{sf}` package, \nwhich requires several dependencies. See [here](https://github.com/r-spatial/sf#installing)\nif you have trouble installing `{sf}`. \n\nThen, you can install the stable version of MODIStsp from CRAN:\n\n```{r, eval=FALSE, message=FALSE, warning=FALSE, include=TRUE}\ninstall.packages(\"MODIStsp\")\n```\n, or the development version (containing the latest improvements and bug fixes) \nfrom GitHub:\n\n```{r, eval=FALSE, message=FALSE, warning=FALSE, include=TRUE}\nlibrary(devtools)\ninstall_github(\"ropensci/MODIStsp\")\n```\n\n## \u003ci class=\"fa fa-apple\" aria-hidden=\"true\"\u003e\u003c/i\u003e Installing on Mac\n\n\nTo install `{MODIStsp}` on Mac, you need to be able to install the `{sf}` package, \nwhich requires several dependencies. See [here](https://github.com/r-spatial/sf#installing)\nif you have trouble installing `{sf}`. \n\nThen, you can install the stable version of `{MODIStsp}` from CRAN:\n\n```{r, eval=FALSE, message=FALSE, warning=FALSE, include=TRUE}\ninstall.packages(\"MODIStsp\")\n```\n, or the development version (containing the latest improvements and bug fixes) \nfrom GitHub:\n\n```{r, eval=FALSE, message=FALSE, warning=FALSE, include=TRUE}\nlibrary(devtools)\ninstall_github(\"ropensci/MODIStsp\")\n```\n\n# Usage\n\nThe easiest way to use `{MODIStsp}` is to use its powerful GUI (Graphical User Interface)\nfor selection of processing options, and then run the processing. \n\nTo open the GUI, load the package and launch the MODIStsp function, with no parameters:\n```{r, eval=FALSE, message=FALSE, warning=FALSE, include=TRUE, caption=FALSE}\nlibrary(MODIStsp)\nMODIStsp()\n```\nThis **opens a Shiny GUI** from which processing options can be specified (and eventually \nsaved or loaded). After specifying all required parameters, clicking on \"Start\" \nwill start\nthe processing (see [here](https://docs.ropensci.org/MODIStsp/articles/interactive_execution.html) \nfor more detailed instructions).\n\n`{MODIStsp}` can also be launched in non-interactive mode within an `R` session or\nscript by setting the optional `GUI` parameter to FALSE, and the `opts_file`\nparameter to the path of a previously saved JSON Options file. This allows to \nexploit `{MODIStsp}` functionalities within generic \"R\" processing scripts.\n\n```{r, eval=FALSE}\nlibrary(MODIStsp) \n# --\u003e Specify the path to a valid options file saved in advance from MODIStsp GUI \nopts_file \u003c- \"X:/yourpath/youroptions.json\" \n  \n# --\u003e Launch the processing\nMODIStsp(gui = FALSE, opts_file = opts_file)\n```\n\nFinally, `{MODIStsp}` can be run by manually specifying all processing arguments, \nor by overwriting some of the arguments contained in a saved json file in the call \nto the package, such as in: \n\n```{r, eval=FALSE}\nlibrary(MODIStsp) \n# --\u003e Specify the path to a valid options file saved in advance from MODIStsp GUI \nopts_file \u003c- \"X:/yourpath/youroptions.json\" \n  \n# --\u003e Launch the processing\nMODIStsp(gui        = FALSE, \n         opts_file  = opts_file, \n         start_date = \"2020.05.01\", \n         end_date   = \"2020.08.01\", \n         spatmeth   = \"file\", \n         spafile    = \"X:/path_to/spatial_extent_file.gpkg\")\n```\n, where we are overwriting the options related to spatial and temporal extent\ncontained in the options file with new values. This allows easily running\nprocessing based on the same main options (e.g., product layers, output format, etc.)\nbut changing on the fly the desired ones. \n\nSee [here](https://docs.ropensci.org/MODIStsp/articles/noninteractive_execution.html) \nfor more detailed instructions and examples.\n\n\n# Code of Conduct\n\nPlease note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/). \nBy contributing to this project, you agree to abide by its terms.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fmodistsp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Fmodistsp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fmodistsp/lists"}