Stata：作为研究生，傻傻分不清help、findit、search、ssc、net、hsearch的具体应用

以下内容将更全面地涵盖这些命令的语法、选项、应用实例及其在实际工作中的具体应用，帮助您更深入地理解和高效使用Stata的外部命令。

1. help

概述

help 是Stata中最基本的帮助系统，用于查找内置命令、函数、语法和相关文档。对于每个命令，Stata提供详细的帮助文件，包括语法、选项、示例和相关引用。

使用方法

help <command>

示例

help regress

上述命令将打开关于 regress 命令的帮助文件，介绍其语法、选项和示例。

应用

• 查找命令用法：快速了解命令的语法和选项。
• 获取示例代码：学习如何在实际分析中应用命令。
• 参考文献：了解命令背后的理论和方法。

2. findit

概述

findit 是一个强大的搜索工具，可以在Stata的用户贡献资源中查找命令、教程、文档和示例。它利用Stata的在线资源，包括SSC、官方Stata网页以及用户的个人网站。

使用方法

findit <keyword>

示例

findit panel data

上述命令将打开一个浏览器窗口，展示与“panel data”相关的命令、文章和资源。

应用

• 发现新命令：找到未安装的用户贡献命令。
• 获取教程和文档：查找与特定主题相关的教学材料。
• 扩展知识：探索与当前研究相关的最新方法和工具。

3. search

概述

search 是Stata中用于在本地帮助文件和在线资源中搜索关键字的命令。与 findit 类似，但 search 更侧重于快速查找本地和在线帮助文件。

使用方法

search <keyword>

示例

search time series

上述命令将在Stata的帮助文件和在线资源中搜索与“time series”相关的信息。

应用

• 快速查找：在本地和在线帮助文件中寻找相关命令和资源。
• 探索主题：通过关键字了解某一主题的相关命令和方法。

4. ssc

概述

ssc 命令用于从 Statistical Software Components (SSC) 存档中安装、管理和卸载用户贡献的包。SSC 是由波士顿学院维护的一个广泛使用的Stata命令和包的存储库，提供了大量的社区贡献资源。

语法

ssc <subcommand> <arguments> [, options]

常用子命令

• 查看最近新增或更新的包

  ssc new [, saving(filename[, replace]) type]
  

• 查看最受欢迎的包

  ssc hot [, n(#) author(name)]
  

• 描述指定的包

  ssc describe { pkgname | letter } [, saving(filename[, replace])]
  

• 安装指定的包

  ssc install pkgname [, all replace]
  

• 卸载已安装的包

  ssc uninstall pkgname
  

• 查看SSC上的特定文件

  ssc type filename [, asis]
  

• 将SSC上的特定文件复制到本地

  ssc copy filename [, plus personal replace public binary]
  

选项详解

ssc new

• **saving(filename[, replace])**：将“最新”摘要保存到指定文件。若未指定文件名，默认保存为 ssc_result.smcl。
• type：将结果显示在Results窗口，而非Viewer窗口。

ssc hot

• **n(#)**：指定要列出的包数量，默认为10。使用 n(.) 列出所有包。
• **author(name)**：按指定作者列出最受欢迎的包。

ssc describe

• **saving(filename[, replace])**：除了在屏幕上显示描述外，还将其保存到指定文件。默认保存为SMCL文件，若指定 .log 扩展名，则保存为文本文件。

ssc install

• all：下载包的所有相关文件，包括数据集和示例文件。
• replace：替换已存在的文件。

ssc type

• asis：以原始形式显示文件内容，不解释SMCL指令。

ssc copy

• plus：将文件复制到PLUS目录。
• personal：将文件复制到PERSONAL目录。
• replace：替换已存在的文件。
• public：使新文件对所有人可读。
• binary：按二进制方式复制文件。

应用

• 安装包：从SSC存储库安装用户贡献的命令和包。
• 管理包：查看、描述、卸载已安装的包。
• 获取特定文件：查看或复制SSC上的特定文件。

示例

• 查看最近新增或更新的包

  ssc new
  

• 查看最受欢迎的包

  ssc hot
  

• 描述包 oaxaca

  ssc describe oaxaca
  

• 安装包 oaxaca

  ssc install oaxaca
  

• 卸载包 oaxaca

  ssc uninstall oaxaca
  

• 查看SSC上的文件 whitetst.hlp

  ssc type whitetst.hlp
  

• 将文件 whitetst.ado 复制到本地

  ssc copy whitetst.ado
  

注意事项

• 包名不区分大小写：如 Oaxaca、ESTOUT 和 egenmore 都是有效的包名。
• 依赖性管理：某些包可能依赖其他包，安装时请确保所有依赖包也已安装。
• 更新包：使用 ado update 来自动更新已安装的包。

5. net

概述

net 命令用于从互联网或物理介质下载和安装Stata的社区贡献附加组件。这些附加组件可以是新的命令（ado-files）、帮助文件，甚至是数据集。net 提供了一套全面的工具来管理这些包，包括安装、描述、卸载和更新等功能。

语法

net <subcommand> <arguments> [, options]

常用子命令

• 设置当前安装位置

  net from directory_or_url
  

• 更改当前net目录

  net cd path_or_url
  

• 更改net站点链接

  net link linkname
  

• 搜索已安装的包

  net search
  

• 报告当前net位置

  net
  

• 描述一个包

  net describe pkgname [, from(directory_or_url)]
  

• 设置包安装目录

  net set ado dirname
  

• 设置辅助文件安装目录

  net set other dirname
  

• 查询net设置

  net query
  

• 安装包

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

• 获取包的辅助文件

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

• 访问Stata Journal (SJ) net站点

  net sj vol-issue [insert]
  

• 访问Stata Technical Bulletin (STB) net站点

  net stb issue [insert]
  

• 列出已安装的包

  ado
  ado dir [pkgid] [, find(string) from(dirname)]
  

• 描述已安装的包

  ado describe [pkgid] [, find(string) from(dirname)]
  

• 更新已安装的包

  ado update
  

• 卸载已安装的包

  ado uninstall pkgid [, from(dirname)]
  

选项详解

net install 和 net get

• all：与 net install 或 net get 一起使用时，等同于先执行 net install，再执行 net get。
• replace：替换已存在的文件。
• force：即使Stata认为文件相同，也强制替换。force 隐含 replace。
• **from(directory_or_url)**：指定安装包的目录或URL，覆盖当前设置的安装源。

ado 子命令选项

• **find(string)**：搜索已安装包的描述中包含指定字符串的包。
• **from(dirname)**：指定包的安装位置，默认为 PLUS 目录。

应用

• 安装包：从指定的网络存储库安装新命令和包。
• 管理包：查看、描述、卸载已安装的包。
• 访问特定资源：如Stata Journal和Stata Technical Bulletin上的资源。
• 设置和查询安装位置：灵活管理包的安装目录和来源。

示例

• 查看主要的Stata net下载内容页

  net from https://www.stata.com
  

• 访问Stata Journal的特定卷和期

  net sj vol-issue
  net sj vol-issue insert
  

• 描述包 st0109

  net describe st0109
  

• 安装包 st0109

  net install st0109
  

• 获取包 st0109 的辅助文件

  net get st0109
  

• 列出已安装的所有包

  ado
  

• 描述已安装的包 st0109

  ado describe st0109
  

• 查找描述中包含 "partial" 的包

  ado, find("partial")
  

• 卸载包 st0109

  ado uninstall st0109
  

注意事项

• 默认安装目录：net set ado 默认为 PLUS 目录，使用 sysdir 命令可查看具体路径。
• 访问权限：使用 replace 和 force 选项时需谨慎，以避免意外覆盖重要文件。
• 包依赖性：安装包时，若包依赖其他包，请确保这些依赖包也已安装。

6. hsearch

概述

hsearch 是一个由StataCorp提供的扩展命令，旨在增强Stata的搜索功能。尽管 hsearch 在Stata 12之后不再是Stata的官方组成部分，但它仍然可以继续使用。hsearch 提供更灵活和强大的搜索选项，尤其适合查找用户贡献的命令和资源。

语法

hsearch word(s)
hsearch word(s), build
hsearch, build

描述

• **hsearch word(s)**：搜索帮助文件中包含指定单词的内容，并在Viewer中呈现可点击的列表。
• **hsearch word(s), build**：同上，但在搜索前重新构建索引。
• **hsearch, build**：仅重新构建索引，不进行搜索。

7. GitHub

概述

GitHub 是一个广泛使用的代码托管平台，许多Stata用户和开发者将他们的命令和包发布在GitHub上。通过GitHub，用户可以访问最新的开发版本、报告问题、提交贡献以及获取详细的文档和示例。

使用方法

• 浏览和下载：访问相关的GitHub仓库，手动下载和安装命令。
• 使用 net 或 github 命令：某些包支持通过特定命令直接从GitHub安装。

示例

假设有一个名为 mypackage 的包托管在GitHub上，可以通过以下方式安装：

net from https://github.com/username/mypackage
net install mypackage

或者使用专门的 github 命令（如果已安装相应工具）：

github install username/mypackage

应用

• 获取最新版本：直接从开发者获取最新的命令版本。
• 参与开发：提交问题、贡献代码或建议改进。
• 访问文档：查看详细的文档、示例和使用指南。

8. 综合应用示例

假设您需要在Stata中使用一个新的命令 xtexample，可以按照以下步骤利用上述工具和命令来查找、安装和使用它：

1. 搜索命令

   findit xtexample
   

   这将打开浏览器并显示相关资源，包括可能的安装源。

2. 安装命令

• 如果

  xtexample
  

  存在于SSC，可以直接使用：

  ssc install xtexample
  

• 或者，如果它托管在GitHub，可以使用：

  github install username/xtexample
  

help xtexample

xtexample var1 var2, options

adoupdate

示例流程

假设您要安装并使用 xtabond2 包：

1. 搜索 xtabond2

   findit xtabond2
   

   浏览相关资源，确认安装源。

2. 通过SSC安装

   ssc install xtabond2
   

3. 查看帮助

   help xtabond2
   

4. 使用 xtabond2 进行动态面板数据分析

   xtabond2 depvar indepvars, options
   

5. 更新 xtabond2 包

   adoupdate