ADS软件应用技巧(1)— help帮助文档

但凡有一定软件开发经验的人都知道，文档在软件开发的过程中占据非常重要的地位，甚至可以说软件开发几乎就是编写各类文档的过程。优秀的设计文档与项目的成功之间有着密切的联系，越是大型、流行的商业软件，其各类文档越丰富和完善。在这些文档中，帮助文档与用户关系最为密切。帮助文档既可能是软件安装后自带的*.chm或*.html文件，也可能是官网的帮助网页，让用户很容易找到。一个对用户友好的软件帮助文档有如下特点\citeup{web_about_help}：

□ 对于初次接触软件的用户，帮助文档可以让其快速入门。

□ 对于长时间使用软件的用户，帮助文档提示小技巧帮助其提高工作效率。

□ 对于遇到问题的用户，帮助文档第一时间提供解决方案。

因此，帮助文档的意义在于协助用户使用软件完成工作，并减少用户解决软件使用问题的时间。 

作者对帮助文档的以上几个特点深有体会，几乎本人上手的所有专业软件，例如MATLAB、ADS、ANSYS、Visual Studio等，都是通过查阅help文档自学的。可以说help能够解决软件使用的绝大部分问题，很多工具书、软件教程的内容即便不是是从软件的help文档中摘抄翻译过来的，至少也是重要参考。所以作者建议读者：{有问题先看help，而不是先叫help！}

而查阅help文档的习惯得从MATLAB说起：大学期间开设了MATLAB实验课，熟悉MATLAB的人都知道它的函数库成千上万，每个函数可能有多个输入或者输出参数，还可以有多种用法，因此课程老师也经常建议随时使用help命令（MATLAB可以输入help {function}来察看某个{function}的帮助信息，新版MATLAB支持F1浮动显示帮助信息）或者直接在help窗口中进行查找。虽然这门课程仅介绍了MATLAB的一些最基本的入门知识和常用函数，但得益于查阅help文档习惯的养成，后期的学习工作中通过MATLAB进行各种数据采集、数据处理、图表绘制等工作都可以通过help文档自学完成，GUI编程、远程控制仪器自动测试（图\ref{fig:matlab_visibility}~图\ref{fig:matlab_gui2}）等也都可以轻易上手。

作者认为：MATLAB的help内容丰富、阐述详尽、条理清晰，当仁不让是本人用过的体验最好的帮助文档，其次才是ADS；相比之下，ANSYS和Cadence的帮助文档则不太友好，不过这可能也跟个人习惯有关。

\section{用好ADS的help}

ADS的help也是非常详尽完善的，以下从个人的习惯出发，介绍如何利用好其帮助文档。

\subsection{快捷帮助}

大部分软件的启动帮助文档的快捷键都是F1，ADS也一样，鼠标指针未聚焦特定对象时按F1键打开帮助文档Home页面，如~图\ref{fig:ads_help_home}~。

当鼠标指向ADS元件面板的内建元件库（Built-in Library）的元件时按F1键，跳转到该器件对应的help文档页面，如~图\ref{fig:ads_help_f1}~。图\ref{fig:ads_help_tfr}~为TLines-Microstrip内建元件库中TFR的帮助页面，详细介绍了元件参数含义、默认取值和取值范围等信息。

对于非ADS内建元件库，取决于PDK厂商的设置，察看帮助会有三种结果：

□ 跳转到该元件对应的html帮助网页，如~图\ref{fig:ads_f1_to_html}~；

□ 跳转到pdf/word或者其他格式的说明文档，如~图\ref{fig:ads_f1_to_pdf}~；

□ 元件没有关联任何帮助信息，跳转到默认提示网页，如~图\ref{fig:ads_f1_to_default}~。

对于Schematic或者Layout中的任何元件、仿真控件，双击弹出参数编辑窗口后，右下角都有一个【Help】按钮，如~图\ref{fig:ads_help_button}~，单击该按钮同样可以打开对应的帮助页面。除元件参数编辑窗口外，任何有【Help】按钮的地方都可以打开跟当前对象相关的帮助页面。

\subsection{搜索帮助}

对于没有快捷跳转方式的帮助信息，可以打开先help的主页，从左侧目录按主题类别展开查找，这种方式适合于有比较明确分类的场合，如~图\ref{fig:ads_help_design_flow}~图\ref{fig:ads_help_mmic_overview}。

绝大多数情况下，并不清楚遇到问题归属于哪类主题，因此最常用的方式是直接输入关键词进行搜索，再快速浏览搜索到的主题列表，打开可能相关的主题看其内容是否命中需求，否则更换关键词重新搜索。图\ref{fig:ads_help_mmic_examples}~是利用关键词“mmic”搜索到的MMIC相关的设计示例，点击示例名称的超链接可以跳转到具体说明页面。

再比如要了解dBm()函数的详细用法，搜索关键词“dBm”，候选列表中看到dBm() Measurement和dBm() Expresssion，后者的帮助内容如~图\ref{fig:ads_help_search_dbm}~，详细阐述了该函数的供能、参数列表、应用举例等。顺便一提，其实这两个函数功能是相同的，但ADS根据表达式的应用场合对函数进行了分类，不同分类下允许有同名的函数，即便功能相同或相近，但其实质上是独立实现的，其功能和参数都仍然可能有差异，这些信息也都在help文档里有详细描述，建议感兴趣的读者搜索关键词“expression”。

\subsection{搜索技巧}

要想更好地利用ADS的帮助搜索功能从而快速检索到期望的帮助信息，有必要了解一些其基本特点和搜索技巧。以下内容完全参考自ADS的帮助文档\citeup{ads_help_search_tips}。

\subsubsection{基础搜索}

ADS的help搜索功能是不区分大小写的，基础搜索框支持以下几种搜索方式：

□ {单个关键词}

•  

{simulation}

搜索所有包含关键词{simulation}的页面。

□ {两个或多个关键词}

•  

{simulation manager}

搜索所有同时包含关键词{simulation}和{manager}的页面，但不限制各个关键词出现的顺序，也允许关键词被其他字词分隔开。

•  

{ads simulation manager}

搜索所有同时包含关键词{ads}、{simulation}和{manager}的页面，但不限制各个关键词出现的顺序，也允许关键词被其他字词分隔开。

□ {短语}

•  

{"simulation manager"}

搜索所有包含短语{"simulation manager"}的页面，短语必须加上英文的双引号（" "），且短语不可分割、严格限制顺序。

•  

{"manager simulation"}

搜索所有包含短语{"manager simulation"}的页面，短语必须加上英文的双引号（" "），且短语不可分割、严格限制顺序。本例与{"simulation manager"}结果不同。

□ {通配符（* , ?）}\footnote{不允许使用通配符作为任何关键词或者短语的第一个字符}

•  

{simu*}

搜索所有包含以{simu}开头词语的页面，星号（*）代表任意多个字符，例如包含{simu}link、{simu}lation、{simu}lation manager之类关键词的页面。

•  

{te*t}

搜索所有包含形如{te}{s}{t}、{te}{x}{t}、{te}{travalen}{t}、{te}{ne}{t}之类词语的页面，星号（*）代表任意多个字符。

•  

{simu?}

搜索所有包含以{simu}开头后边最多仅跟一个字母结尾的词语的页面，问号（?）代表任意一个字符，例如包含{simu}、{simu}l、{simu}2、{simu}s 之类关键词的页面。

•  

{te?t}

搜索所有包含形如{te}{s}{t}、{te}{x}{t}之类词语的页面，问号（?）代表任意一个字符。

□ {排除关键词}

•  

{simulation -manager}

搜索所有包含关键词{simulation}且不包含关键词{manager}的页面，减号（-）代表排除右侧关键词。

\subsubsection{高级搜索}

当基础搜索结果不满意时可以考虑使用高级搜索来进行复杂查找，点击基础搜索框下方的加号（+）按钮即可展开高级搜索框，高级搜索框支持以下类型的搜索操作：

□ 形如某个关键词

□ 不包含某些关键词

□ 包含某个特定的短语

□ 同时包含多个关键词

□ 至少包含多个关键词中的一个

以上选项依次对应~图\ref{fig:ads_help_search_tips}~的搜索框。