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:計算並返回平方根
的
"""
內聯註釋
功能程式碼
內聯註釋
功能程式碼