美文网首页生信修炼
R语言代码规范

R语言代码规范

作者: LeoinUSA | 来源:发表于2018-09-27 02:05 被阅读17次

编程的代码规范目的是使我们的R代码更容易阅读、分享和验证,下述是一些约定俗成的代码规范:

1.0 文件名

对于R file名字的命名,一般采用一些有意义的名字来命名,不要有特殊字符和空格,但是要注意大小写(特别是windowws系统是不管大小写的),所以最好就小写就行了;R代码就放在.R文件中,而R数据文件则放在.RData文件中。我一般不用下划线分割文件名,而是使用大小写交替的方式

GOOD: predict_ad_revenue.R; PredictAdRevenue.R
BAD: foo.R

2.0 标识符(Identifiers)

不要使用下划线(_)或连字符(-)标识符。标识符应按照以下命名约定。变量名的首选形式都是小写字母和单词分开用点(variable.name),但也接受variableName;函数名使用首字母大写而不用点(FunctionName);

variable.name is preferred, variableName is accepted
GOOD: avg.clicks
OK: avgClicks
BAD: avg_Clicks

FunctionName
GOOD: CalculateAvgClicks
BAD: calculate_avg_clicks , calculateAvgClicks
Make function names verbs.
Exception: When creating a classed object, the function name

3.0 间距(Spacing)

当使用所有二进制运算符(如=,+,-,<,等)在两端空格。例外:当符号 = 是函数调用时的传递参数周围不用空格隔开。
不要在符号“,”前空格隔开,但需要在“,”后添加空格
good style

tab.prior <- table(df[df$days.from.opt < 0, "campaign.id"]) 
total <- sum(x[, 1]) 
total <- sum(x[1, ])123

bad style

tab.prior <- table(df[df$days.from.opt<0, "campaign.id"])  # Needs spaces around '<' 
tab.prior <- table(df[df$days.from.opt < 0,"campaign.id"])  # Needs a space after the comma
tab.prior<- table(df[df$days.from.opt < 0, "campaign.id"])  # Needs a space before <
tab.prior<-table(df[df$days.from.opt < 0, "campaign.id"])  # Needs spaces around <
total <- sum(x[,1])  # Needs a space after the comma 
total <- sum(x[ ,1])  # Needs a space after the comma, not before123456

4.0 花括号(Curly braces)

前括号永远不应该独占一行; 后括号应当总是独占一行. 在代码块只含单个语句时可省略花括号

if (is.null(ylim)) {
  ylim <- c(0, 0.06)
}

5.0 赋值

使用<-进行赋值, 不用=赋值.

6.0 注释

整行注释应以#后接一个空格开始,行内短注释应在代码后接两个空格, #, 再接一个空格。

# Create histogram of frequency of campaigns by pct budget spent.
hist(df$pct.spent,
     breaks = "scott",  # method for choosing number of buckets
     main   = "Histogram: fraction budget spent by campaignid",
     xlab   = "Fraction of budget spent",
     ylab   = "Frequency (count of campaignids)")

7.0 函数的定义和调用

函数定义应首先列出无默认值的参数, 然后再列出有默认值的参数。函数定义和函数调用中, 允许每行写多个参数; 折行只允许在赋值语句外进行。

8.0 分号

不要以分号结束一行, 也不要利用分号在同一行放多于一个命令. (分号是毫无必要的, 并且为了与其他Google编码风格指南保持一致, 此处同样略去. )(分号作为语句结束标识,虽然不规范,但是在缩短文档长度的时候我会选择使用...)

相关文章

  • R语言代码规范

    编程的代码规范目的是使我们的R代码更容易阅读、分享和验证,下述是一些约定俗成的代码规范: 1.0 文件名 对于R ...

  • 代码编写规范[转载]

    JavaScript 语言的代码编写规范,请直接看这里。--转载 其他语言的代码编写规范如下: 命名用驼峰或者下划...

  • R语言编码规范

    1.一般性规则 (1)避免使用attach。(2)写函数时尽量少的使用stop()。(3)定义S3和S4的对象不要...

  • R基础 | R代码风格规范

    摘录:Hadley Wickham在《advanced R》书中,基于Google's R style guide...

  • 【go语言学习】编程规范

    学习一门语言,首先要了解该语言的代码编程规范,以提高代码的可读性、规范性。 一、 命名规范 同其他编程语言一样,g...

  • C语言代码规范

  • R包开发之代码格式化

    为了开发R包,写出漂亮、规范的R代码,需要一些代码检查、格式化的工具。 1. styler styler allo...

  • R包代码格式化

    为了开发R包,写出漂亮、规范的R代码,需要一些代码检查、格式化的工具。 1. styler styler allo...

  • 学习小组Day4笔记--大水

    R语言基础 0.1什么是R语言? R是用于统计、绘图的语言和操作环境。R是属于GNU系统的一个自由、免费、源代码开...

  • iOS 代码规范

    iOS规范:仅适用于iOS的代码规范(使用Objective-C语言)。 一.代码应该简洁易懂,逻辑清晰 不要过分...

网友评论

    本文标题:R语言代码规范

    本文链接:https://www.haomeiwen.com/subject/zbssoftx.html