R statistics - Revision history

Veroandreo at 19:58, 19 April 2023

2023-04-19T19:58:20Z

← Older revision		Revision as of 19:58, 19 April 2023
Line 45:		Line 45:

	<source lang="rsplus">		<source lang="rsplus">
	library("rgrass")		library(rgrass)
	</source>		</source>

Veroandreo: fix function names, add relevant links and general clean-up

2023-04-19T19:11:26Z

fix function names, add relevant links and general clean-up

← Older revision		Revision as of 19:11, 19 April 2023
Line 7:		Line 7:
	R can be used in combination with GRASS GIS in different ways:		R can be used in combination with GRASS GIS in different ways:

	* ''Running R 'on top of' GRASS'': which involves transferring GRASS data to R to run statistical functions on the imported data, and possibly write the results back to GRASS. GRASS raster and vector data can be imported in R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/~~read_VECT~~.html read_VECT()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/~~read_RAST~~.html read_RAST()] functions provided by [http://cran.r-project.org/web/packages/rgrass/ rgrass]. Similarly, results can be written back using the [https://search.r-project.org/CRAN/refmans/rgrass/html/~~read_RAST~~.html write_RAST()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/~~read_VECT~~.html write_VECT()] functions. When we read GRASS maps into R, they become R objects stored in memory, more specifically terra objects, i.e., SpatRaster and SpatVector objects that can then be coerced to other types of R spatial objects.		* ''Running R 'on top of' GRASS'': which involves transferring GRASS data to R to run statistical functions on the imported data, and possibly write the results back to GRASS. GRASS raster and vector data can be imported in R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/readVECT.html read_VECT()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/readRAST.html read_RAST()] functions provided by [http://cran.r-project.org/web/packages/rgrass/ rgrass]. Similarly, results can be written back using the [https://search.r-project.org/CRAN/refmans/rgrass/html/readRAST.html write_RAST()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/readVECT.html write_VECT()] functions. When we read GRASS maps into R, they become R objects stored in memory, more specifically terra objects, i.e., SpatRaster and SpatVector objects that can then be coerced to other types of R spatial objects.
	* ''Using R as a scripting language in GRASS''. GRASS functions can be run from R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/execGRASS.html execGRASS()] function in the ''rgrass'' package. R scripting tools, such as powerful string-processing tools, can be used to 'glue' different functions and tools together.		* ''Using R as a scripting language in GRASS'': GRASS functions can be run from R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/execGRASS.html execGRASS()] function in the ''rgrass'' package. R scripting tools, such as powerful string-processing tools, can be used to 'glue' different functions and tools together.
	* ''Using GRASS GIS as a geospatial library in R''. GRASS GIS can be used to extend the geospatial capabilities of R by: (1) offering an extensive and robust set of geospatial tools, and (2) providing a way to work with very large (larger-than-memory) spatial data sets. See Using 'GRASS GIS functionality within an R session' below for more information.		* ''Using GRASS GIS as a geospatial library in R'': GRASS GIS can be used to extend the geospatial capabilities of R by: (1) offering an extensive and robust set of geospatial tools, and (2) providing a way to work with very large (larger-than-memory) spatial data sets. See Using 'GRASS GIS functionality within an R session' below for more information.

	In practice, one will often combine different approaches, with scripts running GRASS functions, reading resulting maps into R for further analysis, modeling and visualization, and creating new layers in R that are imported back into GRASS.		In practice, one will often combine different approaches, with scripts running GRASS functions, reading resulting maps into R for further analysis, modeling and visualization, and creating new layers in R that are imported back into GRASS.
Line 51:		Line 51:

	=== How to use ===		=== How to use ===

	~~You can use R with GRASS GIS in two different ways: (1) run R within a GRASS GIS session, and (2) run GRASS GIS within an R session.~~

	==== Using R within a GRASS GIS session ====		==== Using R within a GRASS GIS session ====
Line 60:		Line 58:
	==== Using GRASS GIS functionality within an R session ====		==== Using GRASS GIS functionality within an R session ====

	If you are primarily an R user who wants to take advantage of the ~~advanced~~ geospatial functions in GRASS, you probably want to use GRASS GIS within an R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS user, you may want to check out the information for [https://grass.osgeo.org/learn/newcomers/ first time users].		If you are primarily an R user who wants to take advantage of the geospatial functions in GRASS, you probably want to use GRASS GIS within an R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS user, you may want to check out the information for [https://grass.osgeo.org/learn/newcomers/ first time users].

	=== Examples ===		=== Examples ===
Line 73:		Line 71:

	==== Manual pages ====		==== Manual pages ====
	If you are in R and have loaded the rgrass package, you can get ~~the~~ help ~~page of ''rgrass''~~ by typing:		If you are in R and have loaded the rgrass package, you can get help by typing:

	<source lang="rsplus">		<source lang="rsplus">
Line 79:		Line 77:
	</source>		</source>

	Similarly, to get help for a specific function, e.g., for the function ''~~readRAST~~()'', you type:		Similarly, to get help for a specific function, e.g., for the function ''read_RAST()'', you type:

	<source lang="rsplus">		<source lang="rsplus">
	?~~readRAST~~		?read_RAST
	</source>		</source>

Line 101:		Line 99:
	==== R ====		==== R ====

	* [https://r-spatial.org/ R][https://r-spatial.org/ -spatial main web page]		* [https://r-spatial.org/ R][https://r-spatial.org/ r-spatial main web page]
	* [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data]		* [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data]
	* [https://cengel.github.io/rspatial/2_spDataTypes.nb.html Introduction to Spatial Data Types in R]		* [https://cengel.github.io/rspatial/2_spDataTypes.nb.html Introduction to Spatial Data Types in R]
	* [https://github.com/edzer/sp R Classes and Methods for Spatial Data] - <code>sp</code> package
	* [https://github.com/r-spatial/sf Simple Features for R] - <code>sf</code> package.
	* [https://blog.dominodatalab.com/applied-spatial-data-science-with-r/ Applied Spatial Data Science with R] (blog post with examples)		* [https://blog.dominodatalab.com/applied-spatial-data-science-with-r/ Applied Spatial Data Science with R] (blog post with examples)
			* [https://rsbivand.github.io/rgrass/articles/coerce.html Coercion between object formats] (rgrass vignette)
			* [https://rsbivand.github.io/rgrass/articles/use.html Use of GRASS interface] (rgrass vignette)
			* [https://rsbivand.github.io/foss4g_2022/modernizing_220822.html Modernizing the R-GRASS interface: confronting barn-raised OSGeo libraries and the evolving R.*spatial package ecosystem] (Workshop at FOSS4G 2022, Florence)

	==== Related ====		==== Related ====

Veroandreo: fix function names and clean-up

2023-04-19T18:55:53Z

fix function names and clean-up

← Older revision		Revision as of 18:55, 19 April 2023
Line 3:		Line 3:
	=== Overview ===		=== Overview ===

	High quality ~~statistic analysis~~ in GRASS GIS is possible thanks to an interface to one of the most powerful ~~statistics~~ analysis ~~package~~ around: '''''R''''' ([http://www.r-project.org/ https://www.r-project.org]). This R ←→ GRASS GIS interface is provided by the [https://cran.r-project.org/package=rgrass rgrass] ''R'' ~~addon~~ package. The possibility to directly interact with R strongly increases the statistical and geospatial analysis capabilities of GRASS. See [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data] for an overview of the R packages and functions that can be used for reading, visualizing, and analyzing spatial data.		High quality statistical analyses in GRASS GIS are possible thanks to an interface to one of the most powerful statistical analysis packages around: '''''R''''' ([http://www.r-project.org/ https://www.r-project.org]). This R ←→ GRASS GIS interface is provided by the [https://cran.r-project.org/package=rgrass rgrass] ''R'' package. The possibility to directly interact with R strongly increases the statistical and geospatial analysis capabilities of GRASS GIS. See [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data] for an overview of the R packages and functions that can be used for reading, visualizing, and analyzing spatial data.

	R can be used in ~~conjunction~~ with GRASS GIS in different ways:		R can be used in combination with GRASS GIS in different ways:

	* ''Running R 'on top of' GRASS'', transferring GRASS data to R to run statistical functions on the imported data ~~as R objects in memory~~, and possibly ~~transfer~~ the results back to GRASS. GRASS raster and vector data can be imported in R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/~~readVECT~~.html ~~readVECT~~()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/~~readRAST~~.html ~~readRAST~~()] ~~function~~ provided by [http://cran.r-project.org/web/packages/rgrass/ rgrass]. Similarly, results can be written back using the [https://search.r-project.org/CRAN/refmans/rgrass/html/~~readRAST~~.html ~~writeRAST~~()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/~~readVECT~~.html ~~writeVECT~~()] functions.		* ''Running R 'on top of' GRASS'': which involves transferring GRASS data to R to run statistical functions on the imported data, and possibly write the results back to GRASS. GRASS raster and vector data can be imported in R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/read_VECT.html read_VECT()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/read_RAST.html read_RAST()] functions provided by [http://cran.r-project.org/web/packages/rgrass/ rgrass]. Similarly, results can be written back using the [https://search.r-project.org/CRAN/refmans/rgrass/html/read_RAST.html write_RAST()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/read_VECT.html write_VECT()] functions. When we read GRASS maps into R, they become R objects stored in memory, more specifically terra objects, i.e., SpatRaster and SpatVector objects that can then be coerced to other types of R spatial objects.
	* ''Using R as a scripting language in GRASS''. GRASS functions can be run from R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/execGRASS.html execGRASS()] function in the ''rgrass'' package. R scripting tools, such as powerful string-processing tools ~~and functions for manipulating file names~~, can be used to 'glue' different functions and tools together.		* ''Using R as a scripting language in GRASS''. GRASS functions can be run from R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/execGRASS.html execGRASS()] function in the ''rgrass'' package. R scripting tools, such as powerful string-processing tools, can be used to 'glue' different functions and tools together.
	* ''Using GRASS GIS as a geospatial library in R''. GRASS GIS can be used to ~~extent~~ the geospatial ~~capability~~ of R by: (1) offering an extensive and robust set of geospatial tools, and (2) ~~provides~~ a way to work with very large (larger-than-memory) spatial data sets. See Using 'GRASS GIS functionality within a R session' below for more information.		* ''Using GRASS GIS as a geospatial library in R''. GRASS GIS can be used to extend the geospatial capabilities of R by: (1) offering an extensive and robust set of geospatial tools, and (2) providing a way to work with very large (larger-than-memory) spatial data sets. See Using 'GRASS GIS functionality within an R session' below for more information.

	In practice, one will often combine different approaches, with scripts running GRASS functions, ~~importing~~ resulting ~~layers in~~ R for further analysis and visualization, and creating new layers in R that are imported back in GRASS.		In practice, one will often combine different approaches, with scripts running GRASS functions, reading resulting maps into R for further analysis, modeling and visualization, and creating new layers in R that are imported back into GRASS.

	=== Current State ===		=== Current State ===
Line 26:		Line 26:

	Fedora:		Fedora:
	sudo dnf install R~~-core~~		sudo dnf install R
	# further packages needed in order to locally compile "rgrass"		# further packages needed in order to locally compile "rgrass"
	sudo dnf install proj-devel proj-data gdal-devel sqlite-devel xml2 libxml2~~-devel R-core~~-devel udunits2-devel		sudo dnf install proj-devel proj-data gdal-devel sqlite-devel xml2 libxml2-devel udunits2-devel

	Ubuntu:		Ubuntu:
Line 48:		Line 48:
	</source>		</source>

	If you are using Rstudio, you can install the rgrass package in the usual way (tool → packages). For further instructions and for ~~trouble shooting~~, see [[R_statistics/Installation]]		If you are using Rstudio, you can install the rgrass package in the usual way (tool → packages). For further instructions and for troubleshooting, see [[R_statistics/Installation]].

	=== How to use ===		=== How to use ===

	You can use ~~Using~~ R ~~in conjunction~~ with GRASS GIS in two different ways: (1) run R within a GRASS GIS session, and (2) run GRASS GIS within a R session.		You can use R with GRASS GIS in two different ways: (1) run R within a GRASS GIS session, and (2) run GRASS GIS within an R session.

	==== Using R within a GRASS GIS session ====		==== Using R within a GRASS GIS session ====
Line 58:		Line 58:
	If you are primarily a GIS user who wants to run e.g., some statistical tests not available in GRASS, you probably want to run R from within a GRASS GIS session. To do so, first start GRASS GIS and then start R (or RStudio) from the GRASS GIS command line. For more information and examples, see [[R_statistics/rgrass]].		If you are primarily a GIS user who wants to run e.g., some statistical tests not available in GRASS, you probably want to run R from within a GRASS GIS session. To do so, first start GRASS GIS and then start R (or RStudio) from the GRASS GIS command line. For more information and examples, see [[R_statistics/rgrass]].

	==== Using GRASS GIS functionality within a R session ====		==== Using GRASS GIS functionality within an R session ====

	If you are primarily a R user, who wants to take advantage of the advanced geospatial functions in GRASS, you probably want to use GRASS GIS within a R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS ~~User~~, you may want to check out the information for [https://grass.osgeo.org/learn/newcomers/ first time users].		If you are primarily an R user who wants to take advantage of the advanced geospatial functions in GRASS, you probably want to use GRASS GIS within an R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS user, you may want to check out the information for [https://grass.osgeo.org/learn/newcomers/ first time users].

	=== Examples ===		=== Examples ===
Line 68:		Line 68:
	* [https://tutorials.ecodiv.earth/toc/grass-import-glcf.html Importing GLCF MODIS woody plant cover] in a GRASS GIS database using an R script.		* [https://tutorials.ecodiv.earth/toc/grass-import-glcf.html Importing GLCF MODIS woody plant cover] in a GRASS GIS database using an R script.
	* [https://tutorials.ecodiv.earth/toc/grass-r-gbif.html Use R to obtain gbif data] and import it in a GRASS GIS database.		* [https://tutorials.ecodiv.earth/toc/grass-r-gbif.html Use R to obtain gbif data] and import it in a GRASS GIS database.
			* [https://veroandreo.github.io/grass_ncsu_2023/studio_index.html Using Satellite Data for Species Distribution Modeling with GRASS GIS and R]: Workshop at NCSU, April 2023.

	=== Getting help ===		=== Getting help ===

Neteler: Selected updates; more needed!

2022-10-22T14:29:22Z

Selected updates; more needed!

← Older revision		Revision as of 14:29, 22 October 2022
Line 3:		Line 3:
	=== Overview ===		=== Overview ===

	High quality statistic analysis in GRASS GIS is possible thanks to an interface to one of the most powerful statistics analysis package around: '''''R''''' ([http://www.r-project.org/ ~~http~~://www.r-project.org]). This R ←→ GRASS GIS interface is provided by the [https://cran.r-project.org/package=rgrass rgrass] ''R'' addon package. The possibility to directly interact with R strongly increases the statistical and geospatial analysis capabilities of GRASS. See [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data] for an overview of the R packages and functions that can be used for reading, visualizing, and analyzing spatial data.		High quality statistic analysis in GRASS GIS is possible thanks to an interface to one of the most powerful statistics analysis package around: '''''R''''' ([http://www.r-project.org/ https://www.r-project.org]). This R ←→ GRASS GIS interface is provided by the [https://cran.r-project.org/package=rgrass rgrass] ''R'' addon package. The possibility to directly interact with R strongly increases the statistical and geospatial analysis capabilities of GRASS. See [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data] for an overview of the R packages and functions that can be used for reading, visualizing, and analyzing spatial data.

	R can be used in conjunction with GRASS GIS in different ways:		R can be used in conjunction with GRASS GIS in different ways:
Line 28:		Line 28:
	sudo dnf install R-core		sudo dnf install R-core
	# further packages needed in order to locally compile "rgrass"		# further packages needed in order to locally compile "rgrass"
	~~# F29~~		sudo dnf install proj-devel proj-data gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel
	~~sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel~~
	~~# F33+~~
	sudo dnf install proj-devel proj-~~datumgrid proj-datumgrid-europe proj-datumgrid-north-america proj-datumgrid-world proj-datumgrid-oceania~~ gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel

	Ubuntu:		Ubuntu:
Line 63:		Line 60:
	==== Using GRASS GIS functionality within a R session ====		==== Using GRASS GIS functionality within a R session ====

	If you are primarily a R user, who wants to take advantage of the advanced geospatial functions in GRASS, you probably want to use GRASS GIS within a R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS User, you may want to check out the information for [https://grass.osgeo.org/~~grass7~~/ first time users] ~~first~~.		If you are primarily a R user, who wants to take advantage of the advanced geospatial functions in GRASS, you probably want to use GRASS GIS within a R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS User, you may want to check out the information for [https://grass.osgeo.org/learn/newcomers/ first time users].

	=== Examples ===		=== Examples ===
Line 97:		Line 94:
	==== Support from the community ====		==== Support from the community ====

	Primary support for ''R'' + GRASS and the ''rgrass'' package is through the [~~http~~://lists.osgeo.org/mailman/listinfo/grass-stats grass-stats] mailing list.		Primary support for ''R'' + GRASS and the ''rgrass'' package is through the [https://lists.osgeo.org/mailman/listinfo/grass-stats grass-stats] mailing list.

	=== Useful links ===		=== Useful links ===
Line 103:		Line 100:
	==== R ====		==== R ====

	* [~~http~~://r-spatial.org/ R][~~http~~://r-spatial.org/ -spatial main web page]		* [https://r-spatial.org/ R][https://r-spatial.org/ -spatial main web page]
	* [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data]		* [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data]
	* [https://cengel.github.io/rspatial/2_spDataTypes.nb.html Introduction to Spatial Data Types in R]		* [https://cengel.github.io/rspatial/2_spDataTypes.nb.html Introduction to Spatial Data Types in R]
Line 118:		Line 115:
	* Neural Networks with GRASS and R [https://dx.doi.org/10.1016/j.ecolmodel.2006.03.015 DOI: 10.1016/j.ecolmodel.2006.03.015]		* Neural Networks with GRASS and R [https://dx.doi.org/10.1016/j.ecolmodel.2006.03.015 DOI: 10.1016/j.ecolmodel.2006.03.015]
	* [http://www.asdar-book.org/ Applied Spatial Data Analysis with R]. Roger S. Bivand, Edzer Pebesma and V. Gómez-Rubio. UseR! Series, Springer. 2nd ed. 2013, xviii+405 pp., Softcover. ISBN: 978-1-4614-7617-7		* [http://www.asdar-book.org/ Applied Spatial Data Analysis with R]. Roger S. Bivand, Edzer Pebesma and V. Gómez-Rubio. UseR! Series, Springer. 2nd ed. 2013, xviii+405 pp., Softcover. ISBN: 978-1-4614-7617-7
	* [~~http~~://www.grassbook.org/ GRASS Book], see last chapter		* [https://www.grassbook.org/ GRASS Book], see last chapter
	* [~~http~~://www.osgeo.org/journal OSGeo Journal] vol. 1 May 2007 (R. Bivand. Using the R— GRASS interface. ''OSGeo Journal'', 1:31-33, May 2007. ISSN 1614-8746).		* [https://www.osgeo.org/journal OSGeo Journal] vol. 1 May 2007 (R. Bivand. Using the R— GRASS interface. ''OSGeo Journal'', 1:31-33, May 2007. ISSN 1614-8746).
	* [~~http~~://grass.osgeo.org/newsletter/grassnews3.html GRASS News vol.3], June 2005 (R. Bivand. Interfacing GRASS 6 and R. ''GRASS Newsletter'', 3:11-16, June 2005. ISSN 1614-8746)		* [https://grass.osgeo.org/newsletter/grassnews3.html GRASS News vol.3], June 2005 (R. Bivand. Interfacing GRASS 6 and R. ''GRASS Newsletter'', 3:11-16, June 2005. ISSN 1614-8746)

	==== Older (but still useful) links ====		==== Older (but still useful) links ====
Line 128:		Line 125:
	* R. Bivand, 2007: [http://spatial.nhh.no/R/etc/FBK07 Interfacing R and OSGeo projects: status and perspectives]: Presentation with slides and scripts.		* R. Bivand, 2007: [http://spatial.nhh.no/R/etc/FBK07 Interfacing R and OSGeo projects: status and perspectives]: Presentation with slides and scripts.
	* M. Neteler and M. Metz, 2011: ''Introduction to GRASS GIS''. GEOSTAT 2011 Landau. [http://geostat-course.org/Topic_NetelerMetz_2011 Download workshop material] (includes a R session)		* M. Neteler and M. Metz, 2011: ''Introduction to GRASS GIS''. GEOSTAT 2011 Landau. [http://geostat-course.org/Topic_NetelerMetz_2011 Download workshop material] (includes a R session)

	~~=== Note for users of the legacy GRASS GIS 6 ===~~

	If you are still using GRASS GIS 6, see [[R_statistics/spgrass6]] for instructions and examples of using GRASS GIS in conjunction with R. However, you are strongly encouraged to upgrade to GRASS GIS 7. Not only does it offer many improvements and new functionalities (see this [https://trac.osgeo.org/grass/wiki/Grass7/NewFeatures overview of New features]), it also provides a smoother R-GRASS integration on the Windows platform.

	About using R and GRASS with cygwin: It is possible to use Rterm inside the GRASS shell in cygwin, just as in Unix/Linux or OSX. You should not, however, start Rterm from a cygwin xterm, because Rterm is not expecting to be run in a xterm under Windows, and loses its input. If you use the regular cygwin bash shell, but need to start display windows, start X from within GRASS with startx &, and then start Rterm in the same cygwin shell, not in the xterm.

	[[Category:Installation]]		[[Category:Installation]]

Neteler: rgrass7 --> rgrass

2022-10-22T07:22:49Z

rgrass7 --> rgrass

← Older revision		Revision as of 07:22, 22 October 2022
Line 3:		Line 3:
	=== Overview ===		=== Overview ===

	High quality statistic analysis in GRASS GIS is possible thanks to an interface to one of the most powerful statistics analysis package around: '''''R''''' ([http://www.r-project.org/ http://www.r-project.org]). This R ←→ GRASS GIS interface is provided by the [https://cran.r-project.org/package=~~rgrass7 rgrass7~~] ''R'' addon package. The possibility to directly interact with R strongly increases the statistical and geospatial analysis capabilities of GRASS. See [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data] for an overview of the R packages and functions that can be used for reading, visualizing, and analyzing spatial data.		High quality statistic analysis in GRASS GIS is possible thanks to an interface to one of the most powerful statistics analysis package around: '''''R''''' ([http://www.r-project.org/ http://www.r-project.org]). This R ←→ GRASS GIS interface is provided by the [https://cran.r-project.org/package=rgrass rgrass] ''R'' addon package. The possibility to directly interact with R strongly increases the statistical and geospatial analysis capabilities of GRASS. See [https://cran.r-project.org/web/views/Spatial.html CRAN Task View: Analysis of Spatial Data] for an overview of the R packages and functions that can be used for reading, visualizing, and analyzing spatial data.

	R can be used in conjunction with GRASS GIS in different ways:		R can be used in conjunction with GRASS GIS in different ways:

	* ''Running R 'on top of' GRASS'', transferring GRASS data to R to run statistical functions on the imported data as R objects in memory, and possibly transfer the results back to GRASS. GRASS raster and vector data can be imported in R using the [https://~~rdrr~~.io/~~rforge~~/~~rgrass7~~/~~man~~/readVECT.html readVECT()] and [https://~~rdrr~~.io/~~rforge~~/~~rgrass7~~/~~man~~/readRAST.html readRAST()] function provided by [http://cran.r-project.org/web/packages/~~rgrass7~~/ ~~rgrass7~~]. Similarly, results can be written back using the [https://~~rdrr~~.io/~~rforge~~/~~rgrass7~~/~~man~~/readRAST.html writeRAST()] and [https://~~rdrr~~.io/~~rforge~~/~~rgrass7~~/~~man~~/readVECT.html writeVECT()] functions.		* ''Running R 'on top of' GRASS'', transferring GRASS data to R to run statistical functions on the imported data as R objects in memory, and possibly transfer the results back to GRASS. GRASS raster and vector data can be imported in R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/readVECT.html readVECT()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/readRAST.html readRAST()] function provided by [http://cran.r-project.org/web/packages/rgrass/ rgrass]. Similarly, results can be written back using the [https://search.r-project.org/CRAN/refmans/rgrass/html/readRAST.html writeRAST()] and [https://search.r-project.org/CRAN/refmans/rgrass/html/readVECT.html writeVECT()] functions.
	* ''Using R as a scripting language in GRASS''. GRASS functions can be run from R using the [https://~~rdrr~~.io/~~rforge~~/~~rgrass7~~/~~man~~/execGRASS.html execGRASS()] function in the ''~~rgrass7~~'' package. R scripting tools, such as powerful string-processing tools and functions for manipulating file names, can be used to 'glue' different functions and tools together.		* ''Using R as a scripting language in GRASS''. GRASS functions can be run from R using the [https://search.r-project.org/CRAN/refmans/rgrass/html/execGRASS.html execGRASS()] function in the ''rgrass'' package. R scripting tools, such as powerful string-processing tools and functions for manipulating file names, can be used to 'glue' different functions and tools together.
	* ''Using GRASS GIS as a geospatial library in R''. GRASS GIS can be used to extent the geospatial capability of R by: (1) offering an extensive and robust set of geospatial tools, and (2) provides a way to work with very large (larger-than-memory) spatial data sets. See Using 'GRASS GIS functionality within a R session' below for more information.		* ''Using GRASS GIS as a geospatial library in R''. GRASS GIS can be used to extent the geospatial capability of R by: (1) offering an extensive and robust set of geospatial tools, and (2) provides a way to work with very large (larger-than-memory) spatial data sets. See Using 'GRASS GIS functionality within a R session' below for more information.

Line 23:		Line 23:
	(see also [[R statistics/Installation]])		(see also [[R statistics/Installation]])

	''Note: the ...-devel packages are needed if you want to install extra packages incl. '''~~rgrass7~~''' on your computer.''		''Note: the ...-devel packages are needed if you want to install extra packages incl. '''rgrass''' on your computer.''

	Fedora:		Fedora:
	sudo dnf install R-core		sudo dnf install R-core
	# further packages needed in order to locally compile "~~rgrass7~~"		# further packages needed in order to locally compile "rgrass"
	# F29		# F29
	sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel		sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel
Line 35:		Line 35:
	Ubuntu:		Ubuntu:
	sudo apt-get install r-base		sudo apt-get install r-base
	# further packages needed in order to locally compile "~~rgrass7~~"		# further packages needed in order to locally compile "rgrass"
	sudo apt-get install proj-bin proj-data libproj-dev libgdal-dev libsqlite3-dev libxml2-dev r-base-dev		sudo apt-get install proj-bin proj-data libproj-dev libgdal-dev libsqlite3-dev libxml2-dev r-base-dev

	==== Installation of the ~~rgrass7~~ package ====		==== Installation of the rgrass package ====
	To install the R package '''~~rgrass7~~''' on newer versions of R, you simply start R and install the package directly with:		To install the R package '''rgrass''' on newer versions of R, you simply start R and install the package directly with:

	<source lang="rsplus">		<source lang="rsplus">
	install.packages("~~rgrass7~~", dependencies = TRUE)		install.packages("rgrass", dependencies = TRUE)
	</source>		</source>

	This will install '''''~~rgrass7~~''''' and all its dependencies. To use the package, you first need to load it:		This will install '''''rgrass''''' and all its dependencies. To use the package, you first need to load it:

	<source lang="rsplus">		<source lang="rsplus">
	library("~~rgrass7~~")		library("rgrass")
	</source>		</source>

	If you are using Rstudio, you can install the ~~rgrass7~~ package in the usual way (tool → packages). For further instructions and for trouble shooting, see [[R_statistics/Installation]]		If you are using Rstudio, you can install the rgrass package in the usual way (tool → packages). For further instructions and for trouble shooting, see [[R_statistics/Installation]]

	=== How to use ===		=== How to use ===
Line 59:		Line 59:
	==== Using R within a GRASS GIS session ====		==== Using R within a GRASS GIS session ====

	If you are primarily a GIS user who wants to run e.g., some statistical tests not available in GRASS, you probably want to run R from within a GRASS GIS session. To do so, first start GRASS GIS and then start R (or RStudio) from the GRASS GIS command line. For more information and examples, see [[R_statistics/~~rgrass7~~]].		If you are primarily a GIS user who wants to run e.g., some statistical tests not available in GRASS, you probably want to run R from within a GRASS GIS session. To do so, first start GRASS GIS and then start R (or RStudio) from the GRASS GIS command line. For more information and examples, see [[R_statistics/rgrass]].

	==== Using GRASS GIS functionality within a R session ====		==== Using GRASS GIS functionality within a R session ====

	If you are primarily a R user, who wants to take advantage of the advanced geospatial functions in GRASS, you probably want to use GRASS GIS within a R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/~~rgrass7~~]]. If you are a first time GRASS GIS User, you may want to check out the information for [https://grass.osgeo.org/grass7/ first time users] first.		If you are primarily a R user, who wants to take advantage of the advanced geospatial functions in GRASS, you probably want to use GRASS GIS within a R session. To connect to a GRASS GIS database from within R (or Rstudio), see the instructions on [[R_statistics/rgrass]]. If you are a first time GRASS GIS User, you may want to check out the information for [https://grass.osgeo.org/grass7/ first time users] first.

	=== Examples ===		=== Examples ===
Line 75:		Line 75:

	==== Manual pages ====		==== Manual pages ====
	If you are in R and have loaded the ~~rgrass7~~ package, you can get the help page of ''~~rgrass7~~'' by typing:		If you are in R and have loaded the rgrass package, you can get the help page of ''rgrass'' by typing:

	<source lang="rsplus">		<source lang="rsplus">
	?~~rgrass7~~		?rgrass
	</source>		</source>

Line 93:		Line 93:
	</source>		</source>

	Now, to get the information about the package, select the '''Packages''' entry and then '''~~rgrass7~~'''.		Now, to get the information about the package, select the '''Packages''' entry and then '''rgrass'''.

	==== Support from the community ====		==== Support from the community ====

	Primary support for ''R'' + GRASS and the ''~~rgrass7~~'' package is through the [http://lists.osgeo.org/mailman/listinfo/grass-stats grass-stats] mailing list.		Primary support for ''R'' + GRASS and the ''rgrass'' package is through the [http://lists.osgeo.org/mailman/listinfo/grass-stats grass-stats] mailing list.

	=== Useful links ===		=== Useful links ===

Neteler: updated to F33+

2021-05-24T14:16:31Z

updated to F33+

← Older revision		Revision as of 14:16, 24 May 2021
Line 28:		Line 28:
	sudo dnf install R-core		sudo dnf install R-core
	# further packages needed in order to locally compile "rgrass7"		# further packages needed in order to locally compile "rgrass7"
			# F29
	sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel		sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel
			# F33+
			sudo dnf install proj-devel proj-datumgrid proj-datumgrid-europe proj-datumgrid-north-america proj-datumgrid-world proj-datumgrid-oceania gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel

	Ubuntu:		Ubuntu:

Neteler: /* Installation */ refer to R statistics/Installation

2020-08-09T15:42:56Z

Installation: refer to R statistics/Installation

← Older revision		Revision as of 15:42, 9 August 2020
Line 20:		Line 20:

	==== Installation of R core software ====		==== Installation of R core software ====

			(see also [[R statistics/Installation]])

	''Note: the ...-devel packages are needed if you want to install extra packages incl. '''rgrass7''' on your computer.''		''Note: the ...-devel packages are needed if you want to install extra packages incl. '''rgrass7''' on your computer.''

⚠️Rkrug: Added statement concerning current state of the R packages and compiled tools needed

2020-06-08T06:59:44Z

Added statement concerning current state of the R packages and compiled tools needed

← Older revision		Revision as of 06:59, 8 June 2020
Line 12:		Line 12:

	In practice, one will often combine different approaches, with scripts running GRASS functions, importing resulting layers in R for further analysis and visualization, and creating new layers in R that are imported back in GRASS.		In practice, one will often combine different approaches, with scripts running GRASS functions, importing resulting layers in R for further analysis and visualization, and creating new layers in R that are imported back in GRASS.

			=== Current State ===

			R Windows binary packages distributed by the Comprehensive R Archive Network (CRAN) using OSGeo software (chiefly PROJ, GDAL and GEOS) use custom built binaries compatible with the build train used by R and are static linked; at present both 32-bit and 64-bit binaries are deployed. CRAN packages for macOS are also static linked to custom built binaries, again using the build train used by R. Static linkage is used to avoid having to deploy a package manager for external software on which R packages depend, since CRAN as a package manager already supports over 15000 packages with three binary versions (devel, release, old release) for Windows and macOS.

	=== Installation ===		=== Installation ===

Neteler: Fedora: udunits2-devel package needed for rgrass7 installation

2020-01-07T14:55:17Z

Fedora: udunits2-devel package needed for rgrass7 installation

← Older revision		Revision as of 14:55, 7 January 2020
Line 22:		Line 22:
	sudo dnf install R-core		sudo dnf install R-core
	# further packages needed in order to locally compile "rgrass7"		# further packages needed in order to locally compile "rgrass7"
	sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel		sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel udunits2-devel

	Ubuntu:		Ubuntu:

Neteler: /* Installation of R core software */

2018-02-13T14:31:31Z

Installation of R core software

← Older revision		Revision as of 14:31, 13 February 2018
Line 17:		Line 17:
	==== Installation of R core software ====		==== Installation of R core software ====

	''Note: the ...-devel ~~package is~~ needed if you want to install extra packages incl. '''rgrass7''' on your computer.''		''Note: the ...-devel packages are needed if you want to install extra packages incl. '''rgrass7''' on your computer.''

	Fedora:		Fedora:
	sudo dnf install R-core R-core-devel		sudo dnf install R-core
			# further packages needed in order to locally compile "rgrass7"
			sudo dnf install proj-epsg proj-nad proj-devel gdal-devel sqlite-devel xml2 libxml2-devel R-core-devel

	Ubuntu:		Ubuntu:
	sudo apt-get install r-base r-base-~~devel~~		sudo apt-get install r-base
			# further packages needed in order to locally compile "rgrass7"
			sudo apt-get install proj-bin proj-data libproj-dev libgdal-dev libsqlite3-dev libxml2-dev r-base-dev

	==== Installation of the rgrass7 package ====		==== Installation of the rgrass7 package ====