stata连享会

Stata: 外部命令的搜索、安装与使用

2018-11-06  本文已影响513人  stata连享会

作者：游万海 || 连玉君 || (知乎 | 简书 | 码云)

Stata连享会 精彩推文1 || 精彩推文2

Stata外部命令一览-连享会

Stata 软件的一大特点是其开放性。用户可以修改 Stata 官方提供的命令 (其实就是一些以 .ado 为后缀的文本文件)，为己所用。同时，全球的 Stata 用户也在日夜耕耘，共享他们编写的新命令——外部命令，比如大家熟悉的 outreg2 (Roy Wada)，estout (Ben Jann) 和 winsor2 (Lian Yu-jun ) 等热门命令。

遗憾的是，这些外部命令分散在互联网的各个角落，我们需要一些海纳百川的本领。这就是本文地主要目的：大家介绍外部命令的搜索、安装及使用方法。

大家在演示教材中的例子时，经常发现为何相同的命令，教材可以得到结果，而自己运行却出现错误，如最常见是扎眼的红色信息 command fuzzydid is unrecognized

常用的外部命令来源：

一些最热门的命令：

输入 ssc hot, n(10) 可以查看 SSC 上最热门的 10 个命令：

SSC 上最热门的 10 个 Stata 外部命令

输入 github hot, number(5) 可以查看 Github 上最热门的 5 个命令。

Github 上最热门的 5 个 Stata 外部命令

1. 路径设置

为了方便命令的管理，下面先介绍一些基本的设置。

下载的外部命令通常为 .ado 格式，为了将下载的命令与自编的命令放在不同的路径下，找到 Stata 的安装路径，可以看到一个 【ado 】文件夹。里面有【base】 文件、【plus】 文件及 【personal】 文件（后两个文件夹不一定有自带，可以自己手动创建）。

为了达到这一目的，需要对系统默认路径进行一些简单的设置。在 Stata 的安装路径下（如：【D:\stata15】）新建一个 profile.do 文件，将如下命令放到此文件中：

adopath + "D:\stata15\ado\plus"
sysdir set PLUS "D:\stata15\ado\plus"          // 外部命令的存放位置
sysdir set PERSONAL "D:\stata15\ado\personal"  // 个人文件夹位置
cd `c(sysdir_personal)'

（Note: 连老师在这里-连玉君的 profile.do 文档 分享了他的 profile.do 文档。https://gitee.com/arlionn/StataProfile ）

2. 外部命令的下载

根据外部命令的来源不同，所使用的命令也不尽一致，这里主要介绍 ssc ， search，net ，findit 和 github 等命令。

2.1 ssc 命令

ssc 是 Statistical Software Components (http://www.repec.org) 的缩写，用于操作存放在该网站上的外部命令，包括安装 ( ssc install)、移除 ( ssc uninstall )、描述 ( ssc describe)、显示最近更新 ( ssc new )、显示最热门 ( ssc hot )。例如：

. ado dir  //显示已安装ado文件
[1] package outreg2 from http://fmwww.bc.edu/repec/bocode/o
      'OUTREG2': module to arrange regression outputs into an illustrative table
[2] package estout from http://fmwww.bc.edu/repec/bocode/e
      'ESTOUT': module to make regression tables

. ssc install winsor2, all replace   //安装winsor2，基本用法：ssc install newprogramname
checking winsor2 consistency and verifying not already installed...
installing into D:\stata15\ado\plus\...
installation complete.

若要查看某一具体命令是否安装，可以利用

. ado, find(winsor2)

[3] package winsor2 from http://fmwww.bc.edu/repec/bocode/w
      'WINSOR2': module to winsorize data

要查看 ssc 上最热门的命令，可以通过

. ssc hot, n(10)  //显示排名前10的命令
Top 10 packages at SSC
        Aug 2018   
  Rank   # hits    Package       Author(s)
  ----------------------------------------------------------------------
     1  331271.0    findname      Nicholas J. Cox                         
     2  19504.6    outreg2       Roy Wada                                
     3  18223.6    estout        Ben Jann                                
     4  11066.7    distinct      Gary Longton, Nicholas J. Cox           
     5   7746.3    winsor        Nicholas J. Cox                         
     6   6881.7    winsor2       Lian Yu-jun                             
     7   6598.7    ivreg2        Mark E Schaffer, Steven Stillman,  Christopher F Baum                      
     8   6579.3    ivreg210      Mark E Schaffer, Steven Stillman, Christopher F Baum                      
     9   6571.1    ivreg28       Mark E Schaffer, Steven Stillman,  Christopher F Baum                      
    10   6561.8    ivreg29       Christopher F Baum, Mark E Schaffer, Steven Stillman                         
  ----------------------------------------------------------------------
  (Click on package name for description)

从上面结果可以看出，连老师编写的 winsor2 也榜上有名 (^^此处应有掌声)。另外，还有 ssc new , ssc describe , ssc type 和 ssc copy 等用法，具体可以通过 help ssc 查看相关例子。

2.2 search 命令

与 ssc命令相比，search 搜索的范围更广，该命令语法如下：

.search word [word ...] [, search_options]

word 表示待搜索的关键词，比如想了解面板数据模型的相关命令，可以 search panel data model。对于怎么取关键词，可以 help searchadvice。可以看出，搜索结果中既有 Stata 手册中的命令，也有外部命令，甚至还包括 Stata 官方的培训、书籍、视频和 FAQ 等信息。

Stata 中的 search 命令-Stata连享会

search 命令的选项 search_options 主要包括：all，net，faq，manual，sj 等，对应上文提到的各种类型的信息，以便于我们实现精准搜索。

. search linear regression, all
. search linear regression, net
. search linear regression, sj
. search linear regression, faq
. search linear regression, manual

2.3 net 命令

net 命令的用法与 search 相似，功能也较多，详细可以 help net 查看。本文主要介绍以下几种：

. net install pkgname [, all replace force from(directory_or_url)]

该命令可以用于从特定的网站安装外部 ado 文件，比如

.net install github, from("https://haghish.github.io/github/")

运行上述命令得到

. net install github, from("https://haghish.github.io/github/")
checking github consistency and verifying not already installed...
installing into D:\stata15\ado\plus\...
installation complete.

使用 ado describe 命令可以查看已安装命令详情：

. ado describe github

--------------------------------------------------------
[4] package github from https://haghish.github.io/github
--------------------------------------------------------

TITLE
      'GITHUB': search, install, and uninstall Stata packages with a particular    {break}

DESCRIPTION/AUTHOR(S)
      version (release) as well as their dependencies from
      {browse "http://www.github.com/haghish/github":GitHub} website
      Distribution-Date: 20161214
INSTALLATION FILES
      f\findall.ado
      f\findall.sthlp
      g\github.ado
      g\github.dlg
      g\github.sthlp
      g\githubcheck.ado
      g\githubconfirm.ado
      g\githubdependency.ado
      g\githublist.ado
      g\githubmake.ado
      g\githuboutput.ado
      g\githubquery.ado
      g\githubsearch.ado
      g\githubsearchsteps.ado
      m\make.ado
      m\make.dlg

INSTALLED ON
      1 Nov 2018
--------------------------------------------------------

. net sj 18-3

这等价于

. net from "http://www.stata-journal.com/software/sj18-3"

2.4 findit 命令

findit + keyword 等价于 search keyword [keyword ...], all

可以搜索的资料包括： 系统文件 the system help, the FAQs, the Stata Journal, and all Stata-related Internet sources including user-written additions. 如我们想了解 Stata 中有关面板单位根检验方面命令与资料，可以执行如下命令：

. findit panel unit root
Stata 中的 findit 命令-Stata连享会

2.5 github命令

gitHub 是一个面向开源及私有软件项目的托管平台，因为只支持 git 作为唯一的版本库格式进行托管，故名 gitHub。在 GitHub 中，用户可以十分轻易地找到海量的开源代码。

目前，越来越多学者将程序托管到该平台，包括 Python，R 和 Stata 等各种软件。为了更方便地安装托管在github 上的命令，E. F. Haghish 开发了 github 命令。github 可以实现搜索、安装、移除等功能。

为了使用这一外部命令，首先要通过以下命令进行安装

. net install github, from("https://haghish.github.io/github/")

完成 github 安装，通过 help github，可以发现其语法如下

. github [ subcommand ] [ keyword | username/repository ] [, options]

这里主要介绍 github search 和 github install：

. github search panel data model, in(all)
github search 命令 - Stata连享会

根据上面返回的结果，点击相应蓝色部分的命令可以在 github 上查看相应的项目，包括：仓库、作者主页等，点击 Install 可以在线安装该命令的相关文件。

. github search dynamic report, in(all)
image
此时，点击 Install 会自动安装最新版本，若想安装此前的某个版本，则可以使用 github install 命令的 version() 选项加以控制： 
. github install haghish/MarkDoc , version("3.8.0")

之后在界面上可以看到

. github install haghish/MarkDoc , version("3.8.0")
checking markdoc consistency and verifying not already installed...
installing into D:\stata15\ado\plus\...
installation complete.

Checking package dipendencies
markdoc package has no dependency

这也是发布于 github 上的命令区别于 SSC 上的命令的主要区别：Github 可以非常高效地进行版本控制。

3. 总结

可将本部分内容归结为两点：

关于我们

联系我们

往期精彩推文

Stata连享会推文集锦-StataChina
欢迎加入Stata连享会(公众号: StataChina)
上一篇下一篇

猜你喜欢

热点阅读