懒作:可重复的实证研究"How to Make A Pie" reviews


重点:code,software 和 OS version

  • 理念的转变:从研究本身的质量向研究过程的质量转变
  • the economic literature focuses on the related problem of transparency and selection bias in methods and results in academic journals

关于组织工作(organized your work)

One mandatory principle for achieving reproducible research is thus to organize the whole process and, specifically, to organize all the tasks needed and involved in the process leading to publication. These ingredients need to be properly organized if the pie is to be cooked again. It should be precisely known at which steps of the recipe (phase and task of the project)which ingredients (e.g., data, methods) and what recipe are used (e.g., codes, documentation) and what are the interactions and relationships between each element to the resulting pie(e.g., project results). This process involves addressing related topics: task and documentation writing, file organization, workflow management and file manipulation. Many organizational forms can be considered: Some are relevant for individual research projects, while others are better suited for projects involving many researchers or a team.
翻译:实现可重复性研究的一个强制性原则是:必须时刻通盘考虑整个过程,特别是组织好所有需要和参与的过程,直到最终出版。如果馅饼要重新烹调,这些原料就需要适当地组织起来。它应该确切地知道每种配方所在的步骤(项目的阶段和任务)不同配方需要不同的成分(例如,数据,方法)使用什么样的配方(例如,代码,文档)导致的各种成分相互作用后所产生可能的不同的结果(例如,项目结果)。这个过程涉及到以下主题:组织任务和文档编写、文件夹管理、时刻关注整体工作流程与进度和文件操作。许多组织形式可以被考虑:一些是与个人研究项目相关的,而另一些则更适合于涉及许团队的项目

step1:Plan
step2:Organize
step3:Compute
step4:Document

组织任务与文档编写 Organizing tasks and documentation

  • 从粘贴到任务管理系统

  • 从评论到任务文档

Information that cannot be explained within the task (documents relating to a specific ingredient such as the code) should also be documented at the task level: general choices about the project (hypothesis and decisions such as the type of modelization, the population under study, and abandoned tested directions) and technical specifications that can have an impact on the results.在任务中无法解释的信息(与特定的成分有关的文件,如代码)也应在任务级别上记录,包括:关于项目的一般选择(假设和决定,如:模型化的类型、参与研究的人员、和已经放弃的研究方向,避免重复)以及技术规范会对结果产生影响。例如,可以包括如下:包含/排除观测值的标准;为最优化选择的随机化方法、随机种子、初始值和参数稳健性的检验;呈现结果所使用的算法(插值、平滑等)

文件夹管理 Organizing file

集中在:目录结构和命名约定(directory structure and naming convention)

  • 目录结构:

首先,在建构每个项目的目录结构时候,必须保证是一致的(consistency)。其次,对项目的输入和项目的产出间(input and output),必须清楚划分。

  • 文档命名:

修正、改进、增添、评论、新想法—————每个研究者的日常。

时刻关注整体工作流程与进度 Keeping track of the workflow

  • 图形的方式
图形的方式
  • 文件夹命名的方式
文件夹命名的方式
  • 个人采用
个人采用

处理文件夹 Handling files

  • 文档分享:Google Drive、OneDrive
  • 版本控制:Github、Gitee
  • 写作环境:Latex、WS
  • 文献管理:NoteExpress(中文)、Endnote(英文)

为他人编程 Code for others (including your future self)

  • 使用通用的编程方式
STATA与R
R的有效性输入
  • 记录代码


    代码记录

尽量自动化 Automate as much as you can

  • 可以自动生成文件的代码

    能够生成文件的代码
  • BAT文件做独立分区块运行——本人还不懂!

    Batch 或者 Makefile

    区块化能够保持独立性
  • 跨语言支持
    推荐:Jupyter Notebool


    Figer-201807234

一些有价值的参考

  • STATA图表与代码

    STATA图表与代码

    STATA图表与代码
  • 可参考文献及代码来源

    可参考文献及代码来源
    可参考文献及代码来源
  • 软件细节

    软件细节
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,384评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,845评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,148评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,640评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,731评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,712评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,703评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,473评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,915评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,227评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,384评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,063评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,706评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,302评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,531评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,321评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,248评论 2 352

推荐阅读更多精彩内容

  • 今晚和儿子通电话,他说妈妈我的假期功课有12篇,其中竟然有7篇是古文耶,对呀,我说,早就跟你说过升中以后古文古诗会...
    玉嫲阅读 131评论 0 0
  • 活动地址:http://www.jianshu.com/p/579b7c69dd09
    叶语星冰阅读 153评论 2 1
  • 西西教练阅读 263评论 0 2
  • 感恩是一种善行,我们要感恩一切善待自己的人,感恩世间万物,并且要知恩图报,感恩是一种生活态度,是一种品德,更是一种...
    幸运星_aa9c阅读 402评论 0 0
  • 说把“星期”“礼拜”这个概念忘了,真的马上就记不得了,今天是什么日子? 我蹲在厕所里,退学的日子里不用写作业,所以...
    十八杉阅读 262评论 0 1