找到
2
篇与
默认分类
相关的结果
-
一些好用的软件 “工欲善其事,必先利其器。”介绍几款好用的软件。OneDrive 简介: 微软开发的一款云盘软件 支持Windows、Mac、平板等 普通用户可免费使用5G云内存,购买Office 365后提升到1T;教育邮箱(以edu.com为后缀)可以免费使用1T云内存 官网:https://www.microsoft.com/zh-cn/microsoft-365/onedrive/online-cloud-storage 安装:Windows通常自带此应用,Mac可前往App Store下载安装 Visual Studio Code 简介: 微软开发的轻量型编辑器,支持绝对多数常用的编程语言,拥有众多好用的插件 支持Windows、Mac、Linux 官网:https://code.visualstudio.com/ 安装:官网下载安装即可 Typora 简介: 一款简洁好用的Markdown编辑器,无需额外的渲染窗口,所见即所得 支持Windows、Mac、Linux 官网售价89元买断,一个序列号支持三个设备,网上很容易找到破解版,建议支持下正版 官网:https://typoraio.cn/ 安装:官网下载安装即可 Zotero 简介: 一款文献管理软件,界面简洁,内置PDF阅读器,文献库主体为Bib格式,拥有众多好用的插件 支持Windows、Mac、平板等 注册账号即提供100M的免费云存储,可额外购买云存储空间。100M的云存储同步文献库主体绰绰有余,文献文件可链接至第三方云盘,如OneDrive等 官网:https://www.zotero.org/ 安装:官网下载安装即可 配置:参考博客《Zotero安装教程》 draw.io 简介: 一款开源免费的流程图绘制软件,可导出无水印的高质量流程图 支持Windows、Mac、Linux 官网:https://www.drawio.com/ 安装:官网下载安装,或者前往GitHub仓库的releases下载安装
-
程序编写规范(自用) 在日常的学习工作中,经常需要编写程序辅助计算或者画图,为了能让程序更加美观且可读性更强,按照平时的编程习惯,制作了满足自身需求的编写规范。 作为非计算机专业及行业的人,我常用的编程语言为Matlab、Python和Fortran。1 基本规范 编程过程中,我尽量满足以下规范条件: 文件夹结构 src 源代码存放目录 img 生成的图片存放目录 dat 运行过程中依赖的数据文件,主要为一些系数或者参数存放位置,应该为固定不变的文件 data 需要处理的数据,作为程序的输入,如仪器观测过程中不断生成的数据。一般为了节约本地空间,我会把需要处理的数据都放到移动硬盘里面,只有在测试过程中,会选择几个数据放进来以便测试 doc 编写过程中涉及到的文档存放目录,如编程大纲、计算公式、程序设计等 refs 存放编写过程中用到的参考文献,如期刊论文等。与doc的区别在于本文件夹下的文档是前人已经发表的论文 old 可正常运行的旧版本备份目录,子文件夹以年月日命名,如old/20221103,子文件夹下应该备份有所有的相关文件。本文件夹存在原因是,可能某个版本的代码编写完成后,后续又需要进行大规模的改动,为避免以后找不到改动前的代码,所以需要本文件夹进行备份 dist 存放打包好的可执行文件 参数定义及传递 主函数的参数输入,确保每个参数只有一个物理意义 子函数之间尽可能减少传递参数的个数,对参数进行分类传递 尽量减少无效参数的传递,保证传递的每个参数都有其价值 尽量减少使用次数很少的中间量的定义 命名规则 过短字符的名称不考虑简写,使用的简写尽量是约定俗成的 定义具有确定含义的函数中间名 定义具有确定含义的变量前缀,以方便对函数内部的变量进行管理。只有同一类的变量比较多时,为了避免和其他变量发生冲突,才需要定义前缀 命名规则可根据个人习惯自行定义,我的定义习惯后续会详细介绍2 基本框架 在定义函数(或子例程)时,我会习惯在函数名定义之前加上一段描述信息,此处以Python为例,如下所示 ''' coding: utf-8 INFO: 测试 date: 2022-11-03 Washy [institutions e-mail] func: test01 - 这是一个测试函数 ''' ##----------------------------------------------------------------------## # INFO: 这是一个测试函数 ##----------------------------------------------------------------------## # Needs: test02.m ##----------------------------------------------------------------------## # Inputs: # a - 含义 [单位] # Outputs: # b - 含义 [单位] ##----------------------------------------------------------------------## #参考文献 # [1] Kudeki, E., & Milla, M. A. (2011). Incoherent Scatter Spectral # Theories-Part I: A General Framework and Results for Small Magnetic # Aspect Angles. Ieee Transactions on Geoscience and Remote Sensing, # 49(1), 315-328. doi:10.1109/Tgrs.2010.2057252 ##----------------------------------------------------------------------## # author: Washy [institutions e-mail] # date: 2022/11/03 ##----------------------------------------------------------------------## #更新内容[Washy 2022/11/03] ##INFO: 描述信息 # 1. 更新一 # 2. 更新二 ##----------------------------------------------------------------------## # 可改进的地方: 详细内容 ##----------------------------------------------------------------------## #输入测试示例[Washy 2022/11/03] #Inputs: # a = 10 #Outputs: # b = 10 ##----------------------------------------------------------------------## def test01(a): b = a #[1] eq(1) return b ##----------------------------------------------------------------------## if __name__ == "__main__": a = 10 b = test01(a,b) print('{} = {}'.format(a,b))基本框架中从上至下的含义如下: 文件头部分 INFO 对整个程序的功能进行概述行描述 date 本程序文件创建日期及作者,中括号里面为单位名称缩写和作者的联系邮箱地址 func 本程序文件所包含的函数及其描述 函数定义前部分 INFO 函数功能描述(必要) Needs 被定义函数依赖的其他自定义函数(非必要) Inputs 函数输入变量(必要) 变量名 - 变量描述,变量如果是物理量,中括号内说明量纲 Outputs 函数输出变量(必要) 变量名 - 变量描述,变量如果是物理量,中括号内说明量纲 参考文献 函数引用的参考文献,需要编号(非必要) author 作者名,中括号里面为单位名称缩写和作者的联系邮箱地址(必要) date 函数创建及修改日期(必要) 更新内容 函数发生重大版本更新时添加本部分(非必要) 可改进的地方 函数还存在的改进点,受限于时间、精力等因素,编写软件时可能没有把完全优化(非必要) 输入测试示例 函数调用示例,描述清楚输入及对应的输出结果(非必要) 函数定义部分 参考文献引用 如果引用了参考文献中的某个公式,在该行代码后加上参考文献编号及文献内公式编号 每一行的内容,都尽量不要超过虚线的长度,虚线的长度来自Matlab编程窗口分割线的宽度。 使用其他编程语言时,只需批量替换注释符号即可。 3 命名规则 命名包含文件命名、函数命名和变量命名。命名时,我习惯使用一些关键词来增加可读性,我常用的关键词如下 前缀 名称含义名称含义re重处理set设置get获取init初始化save保存download下载示例 rename 重命名函数 set_date 日期设置函数 get_data 数据获取函数 init_paras 初始化参量 save_img 保存图片 download_data 下载数据 文件、文件夹相关 名称含义名称含义root根目录fold文件夹file文件name 名称path路径 示例 rootpath 根目录 foldpath 文件夹路径 filename 文件名 filepath 文件路径,通常由foldpath和filename拼接而成 后缀 名称含义名称含义date日期str字符串data数据main主函数 其他: 根据实际问题,以实际处理中遇到的参量名进行定义。