{"Package":"RStata","Title":"A Bit of Glue Between R and Stata","Version":"1.1.2","Authors@R":"person(\"Luca\", \"Braglia\", email = \"lbraglia@gmail.com\", role = c(\"aut\", \"cre\"))","Author":"Luca Braglia [aut, cre]","Maintainer":"Luca Braglia ","Description":"A simple R -> Stata interface allowing the user to\nexecute Stata commands (both inline and from a .do file)\nfrom R.","URL":"https://github.com/lbraglia/RStata","BugReports":"https://github.com/lbraglia/RStata/issues","Imports":"foreign, tools, utils","License":"GPL-3","RoxygenNote":"7.3.2","Encoding":"UTF-8","NeedsCompilation":"no","Packaged":"2025-03-25 07:06:35 UTC; l","Repository":"CRAN","Date/Publication":"2025-03-25 07:20:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/RStata_1.1.2.tar.gz","jsonAuthors":[{"name":"Luca Braglia","email":"lbraglia@gmail.com","maintainer":true}],"readme":"# RStata\n\nA simple `R -> Stata` interface allowing the user to:\n- execute Stata commands (both inline and from a `.do` file) from R;\n- pass a `data.frame` to Stata;\n- return a `data.frame` to R;\n- include Stata 'chunks' in knitr documents (however each chunk is\n independent from the others; feature tested with LaTeX/Linux).\n\n## Install\n```\ninstall.packages('RStata')\n```\n\n## Setup\nIn order to use this package you need to setup two `options`:\n```\noptions(\"RStata.StataPath\")\noptions(\"RStata.StataVersion\")\n```\nOnce done, the main function in the package is `stata` (see Examples below).\n\n\n### RStata.StataPath\n`RStata.StataPath` contains the path to Stata executable (Windows\nuser have to delete the extension `.exe` from the path ).\n\nYou can use\n\n```\nchooseStataBin()\n```\n\nto set this option the first time:\n- in Linux it searches for the 4 (cli) Stata binaries (`stata-mp`,\n `stata-se`, `stata`, `stata-sm`) in the search path and prompt a menu to\n choose one;\n- in Windows does a `file.choose` (and a bit of manipulation, \n in Windows, to obtain a valid path).\n- other system are not handled by `chooseStataBin` (mainly because of\n my ignorance regarding both the system itself and Stata installation\n on it, but contributions are welcome).\n\n **Mac users** are a notable group: at this stage they should set the\n path for the *command line* executable (not the GUI app). Eg for a\n Stata13 SE installation in El Capitain (with default options) the\n path is `'/Applications/Stata/StataSE.app/Contents/MacOS/stata-se'`. In\n other cases (Stata licenses, installation path and so on) the path\n could be slightly different (BTW, i've found the path 'exploring'\n the filesystem with a terminal, not the graphics explorer since it\n 'stops' at 'StataSE.app').\n \n\n`chooseStataBin` set up `RStata.StataPath` accordingly to user advice and\nreturn the path; but you may consider to put the path returned in\n`.Rprofile` options for the next time you start R.\n\n### RStata.StataVersion\n`RStata.StataVersion` is needed for right management of data export/import\nto/from Stata. Eg, for Stata 13:\n```\noptions(\"RStata.StataVersion\" = 13)\n```\n\nAs above, you may consider to put this statement in your `.Rprofile`.\n\n### Other options\nSee `?stata`.\n\n## Troubleshooting\n\n### set more off, permanently\n\nIn some setup the package seems to freeze even with the simplest\nexample (eg `stata('set obs 10')`).\nThis is likely dued to Stata `more` option, which has to be set\nto off:\n\n```\nset more off, permanently\n```\n\n### avoid cd in `profile.do`\n\nSee [issue 6](https://github.com/lbraglia/RStata/issues/6).\n\n## Examples\n\n### One inline command\n```\n> stata(\"help regress\") #<- this won't work in Windows dued to needed\n # batch mode\n\n. help regress\n\nTitle\n-----\n\n [R] regress -- Linear regression\n\n\nSyntax\n------\n\n regress depvar [indepvars] [if] [in] [weight] [, options]\n\n[...]\n```\n\n### Many inline commands\nYou can do this (eg.):\n```\n> stata_src <- \"\n\nversion 10\nsysuse auto\nreg mpg weight\n\n\"\n> stata(stata_src)\n\n[...]\n```\n\n### External .do file sourceing\n```\n> stata(\"foo.do\")\n```\n\n### Data input to Stata\n```\n> x <- data.frame(a = rnorm(3), b = letters[1:3])\n> stata(\"sum a\", data.in = x)\n\n. sum a\n\n Variable | Obs Mean Std. Dev. Min Max\n------------+--------------------------------------------------------\n a | 3 -.5603985 .3000552 -.7720861 -.2170166\n```\n\n### Data output from Stata\nEg in order to obtain `auto` dataset\n```\n> auto <- stata(\"sysuse auto\", data.out = TRUE)\n\n. sysuse auto\n(1978 Automobile Data)\n \n> head(auto)\n make price mpg rep78 headroom trunk weight length turn displacement\n1 AMC Concord 4099 22 3 2.5 11 2930 186 40 121\n2 AMC Pacer 4749 17 3 3.0 11 3350 173 40 258\n3 AMC Spirit 3799 22 NA 3.0 12 2640 168 35 121\n4 Buick Century 4816 20 3 4.5 16 3250 196 40 196\n5 Buick Electra 7827 15 4 4.0 20 4080 222 43 350\n6 Buick LeSabre 5788 18 3 4.0 21 3670 218 43 231\n gear_ratio foreign\n1 3.58 Domestic\n2 2.53 Domestic\n3 3.08 Domestic\n4 2.93 Domestic\n5 2.41 Domestic\n6 2.73 Domestic\n```\n\n### Data input/output\n```\n> x <- data.frame(a = rnorm(3), b = letters[1:3])\n> (y <- stata(\"replace a = 2\", data.in = x, data.out = TRUE))\n\n. replace a = 2\n(3 real changes made)\n\n a b\n1 2 a\n2 2 b\n3 2 c\n```\n\n## Contribute\nYou are welcome to:\n* submit suggestions and bug-reports at: \n* fork and send a pull request on: \n* send an e-mail to: ","jobInfo":{"package":"RStata","version":"1.1.2","parsingStatus":"success","parserVersion":2,"parsedAt":"2025-03-25T08:30:03+0000"}}

Description

Usage

Arguments