2024年春季Python分级指南在DS2500中,您将有一个项目、实验室、家庭作业和Python实践问题(PPP),所有这些都有助于您的成绩。对于这项工作中的一些,你的分数将完全基于正确性,而对于其他工作,你的编码/可视化风格将发挥重要作用。正确性:实验室和PPP实验室和购买力平价是自动评分的,如果自动评分器中的单元测试通过,您将获得全额积分。确保您验证了自动评分器的输出!对于这些作业,您将只根据代码的正确性而不是其风格进行评分。正确性+风格:家庭作业和项目对于项目和家庭作业,DS2500 TA将审查您的代码,您的分数将在很大程度上基于您的编码风格和可视化效果。我们的首要任务是让您的代码非常清晰,易于使用——就像在工作或合作社中的期望一样。特别是,我们将根据代码的可读性、模块性和可重用性对其进行分级。我们希望您的可视化效果,包括演示幻灯片,易于理解。您将获得优秀、令人满意、正在进行中或未达到所有这些标准的分数。下面,你会发现一个评分标准,我们将用于每个家庭作业和项目。此外,我们还为间距、变量名等特定项目提供了DS2500样式指南(它与DS2000样式指南非常相似!)编码+可视化分级准则DS2500样式指南间距变量和函数名称
串
评论
编码+可视化分级准则
类别优秀进行中的货物未达到可读性变量和函数名称清晰简洁。代码的格式是一致的,并很好地利用了水平和垂直空间。没有超过80个字符的行。打印出来的所有信息都是可读的,并使用适当的数据类型和/或舍入。变量命名、格式、打印或间距方面的小问题。至少有一个可读性方面的重大问题。
可读性方面的多个主要问题;代码极其难以遵循。模块化代码组织良好,分为多个功能,包括启动执行的主要功能。每个函数不超过30行,并且是独立的。代码不重复。在函数中适当地使用控制结构(循环、条件)。混乱或长函数的小问题,或重复代码的小问题。模块化至少有一个重大问题,如函数太少或代码混乱。除了main之外,有使用函数。可重用性代码始终有很好的文档记录,每个函数都有一个描述性的块注释。所有编写的代码都用于执行。实现是有效的。注释的小问题、额外/缺失的代码或效率低下。至少有一个可重用性的重大问题。代码无法在其他程序中重用。可视化可视化清晰、易于理解,并充分利用标签、图例、标题、尺寸和颜色。标签缺失或颜色混乱/违反直觉的小问题。所选可视化不适合数据,或根据作业要求不正确。。可视化不存在。DS2500样式指南
间距
●将相关代码分组在一起,并使用垂直空间分隔代码块
●将代码限制在80列或更少。
●在运算符周围和逗号后面加空格。执行此操作(垂直空间):
下面是描述接下来三行代码的注释,
它们都是相互关联的
代码行1
代码行2
代码行3
下面是一条注释,描述了接下来的两行
与上面的行分开
代码行4
代码行5
执行此操作(水平空间):
x=y+5
如果x==y:
result=func(18,19,“你好”)
spam=long_function_name(var_one、var_two,var_three,var_four)
a=1+2+3+4\
- 5 + 6 + 7
不是这样:
x=y+5
x=y+5
x=y+5
如果x==y:
变量和函数名称
●变量和函数名称必须简短且具有描述性。
●使用小写字母,并使用下划线分隔单词。不要使用驼色表壳。●常量的值在初始化后永远不会改变,应该是大写的
●常量可以在main中使用/引用,但不能在其他函数中使用。代 写DS2500 Python实践问题为了确保可重用性,函数应该通过参数获取所有数据,并且不假设文件中存在任何常量。常量定义在程序的顶部,在注释下方,但在所有函数上方。所有其他变量都必须是局部的,即在函数中定义。执行以下操作:年龄=44
出生年份=1978
first_name=“Laney”
defcompute_result()
FILENAME=“file.txt”
不是这样:
a=44
x=1978
variableName=“Laney”
def FunctionOne()
PI=3.1415
π+=4串
●可以使用单引号或双引号将字符串括起来。哪一个并不重要,只要你在一个程序中保持一致。●使用f字符串打印变量非常有用,尤其是当您需要特殊格式时(但ds2500不需要f字符串)。●但是,不要使用%或+运算符进行打印;它们是老式的!●字符串是不可变的,所以一旦创建字符串,我们就不能直接修改它。字符串方法通常会返回一个修改后的副本。执行以下操作:
print(“你好”,姓名)
print(f“你好{name}”)
不是这样:
打印(“你好%s”%name)
打印(“你好”+姓名)
评论
●在编写任何代码之前,请在每个程序的顶部放置一个块注释,其中包含您的姓名、课程、作业、日期和文件名。●解释代码的注释应该出现在整个程序中。
●注释位于Python语句之上,而不是旁边。
●在“#”和注释之间留一个空格。
●函数注释应该是位于函数签名下方的文档字符串。除此之外,您的函数通常不需要内联注释,除非您正在做一些需要解释的非常复杂的事情。执行以下操作:
描述我的代码的注释
python语句
交叉线后的空格
不是这样:
python语句#描述我的代码的注释
交叉线后没有空格
功能应简明扼要;最好将它们控制在30行代码以内。函数还应接受数量有限的参数;函数注释应该包括参数和返回类型,还应该描述函数的内容。您可以使用项目符号来描述或总结这些项目。执行以下操作:
def func(param):
"""
参数:非负数
返回:浮点
Do:计算并返回平方根
的
"""
功能代码
功能代码
def func(param):
"""
给定一个非负整数,计算
并返回其平方根。
"""
功能代码
功能代码
不是这样:
def func(param):
"""
参数:非负数
返回:浮点
Do:计算并返回平方根
的
"""
内联注释
功能代码
内联注释
功能代码
标签:函数,Python,代码,实践,注释,可视化,DS2500 From: https://www.cnblogs.com/gzashang/p/18119543