교육 분야에서 정보 기술의 활용이 보편화되면서, 학생 성적 보고서를 자동으로 생성하고 관리하는 것은 교육 기관에 필수적인 과제가 되었습니다. 파이썬은 강력하면서도 배우기 쉬운 프로그래밍 언어로서 이러한 데이터 처리 및 보고서 생성 작업에 매우 적합합니다. 이 글에서는 파이썬을 활용하여 성적 보고서를 생성하는 방법을 이론적 배경과 함께 실제 코드 예시를 통해 상세히 설명합니다.
1. 이론적 배경
1.1. 데이터 저장 및 처리
성적 보고서 생성의 첫 단계는 학생 성적 데이터를 저장하고 처리하는 것입니다. 주로 CSV 파일, 엑셀 파일, 데이터베이스 등의 형태를 사용합니다. 여기서는 가장 단순하며 읽고 쓰기 쉬운 CSV 파일을 데이터 저장 형식으로 선택하여 다룰 것입니다.
1.2. 데이터 분석 및 통계
보고서를 만들기 전에 성적 데이터에 대한 기본적인 분석과 통계 계산이 필요합니다. 예를 들어, 평균 점수, 최고 점수, 최저 점수 등을 산출합니다. 이러한 통계치는 교사들이 학생들의 전반적인 학습 성과를 파악하는 데 도움을 주고, 학생들에게는 개별적인 피드백을 제공하는 기초 자료가 됩니다.
1.3. 보고서 생성 및 형식 지정
분석된 결과를 정리하여 가독성 높은 보고서 형태로 출력하는 것이 마지막 단계입니다. 이는 주로 텍스트와 표 형태의 데이터를 결합하여 명확하고 이해하기 쉬운 보고서를 만드는 작업을 포함합니다. 파이썬은 pandas, csv, reportlab과 같은 다양한 라이브러리를 제공하여 이 목표를 달성할 수 있도록 돕습니다.
2. 실습 코드 예제
다음은 CSV 파일에서 학생 성적 데이터를 읽어 통계 정보를 계산하고, 이를 기반으로 형식화된 성적 보고서를 생성하는 파이썬 코드 예제입니다.
2.1. 개발 환경 준비
시작하기 전에 파이썬 환경에 아래 라이브러리들이 설치되어 있는지 확인하십시오:
pandas: 데이터 처리 및 분석에 사용됩니다.reportlab: PDF 형식의 성적 보고서를 생성하는 데 사용됩니다.
이 라이브러리들은 다음 명령어를 통해 설치할 수 있습니다:
pip install pandas reportlab
2.2. 샘플 데이터 준비
grades.csv라는 이름의 CSV 파일이 다음과 같은 내용으로 준비되어 있다고 가정합니다. (참고: 한글이 포함된 PDF 생성을 위해 '맑은 고딕' (MalgunGothic.ttf) 폰트 파일이 필요할 수 있습니다. 해당 폰트 파일이 스크립트와 동일한 디렉토리에 있거나 시스템 폰트 경로에 설정되어 있어야 합니다.)
학생이름,국어,영어,수학,과학
김민준,88,92,75,85
이서연,95,89,90,80
박지훈,79,85,70,78
2.3. 코드 구현
다음은 grades.csv 파일을 읽어 성적 통계 정보를 계산하고, PDF 형식의 성적 보고서를 생성하는 전체 파이썬 코드입니다.
import pandas as pd
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.pdfbase import pdfmetrics
import os
# 한글 폰트 등록 (필수)
# 'MalgunGothic.ttf' 파일이 스크립트와 같은 디렉토리에 있어야 합니다.
# 다른 폰트를 사용하려면 해당 폰트 파일명으로 변경하세요.
font_path = 'MalgunGothic.ttf'
if os.path.exists(font_path):
pdfmetrics.registerFont(TTFont('MalgunGothic', font_path))
else:
print(f"경고: 한글 폰트 파일 '{font_path}'을(를) 찾을 수 없습니다. PDF에 한글이 올바르게 표시되지 않을 수 있습니다.")
print("맑은 고딕 폰트 파일을 스크립트와 같은 디렉토리에 두거나, 다른 시스템 폰트 경로를 지정하십시오.")
# 대체 폰트 설정 (영문만 지원)
pdfmetrics.registerFont(TTFont('Helvetica', 'Helvetica.ttf'))
# 성적 데이터 로드
def load_grade_data(file_path):
"""CSV 파일에서 학생 성적 데이터를 불러옵니다."""
try:
data_frame = pd.read_csv(file_path)
return data_frame
except FileNotFoundError:
print(f"오류: '{file_path}' 파일을 찾을 수 없습니다.")
return None
# 과목별 성적 통계 분석
def analyze_subject_grades(data_frame):
"""DataFrame에서 과목별 통계 정보를 계산합니다 (평균, 최고, 최저, 표준편차)."""
if data_frame is None or data_frame.empty:
print("경고: 분석할 데이터가 없습니다.")
return {}
analysis_results = {}
# 첫 번째 열 (학생이름)을 제외한 나머지 열을 과목으로 간주
for subject_col in data_frame.columns[1:]:
# 숫자가 아닌 값이 있을 경우를 대비해 to_numeric으로 변환 시도
numeric_grades = pd.to_numeric(data_frame[subject_col], errors='coerce').dropna()
if not numeric_grades.empty:
subject_stats = numeric_grades.describe()
analysis_results[subject_col] = {
'평균': subject_stats['mean'],
'최고점': subject_stats['max'],
'최저점': subject_stats['min'],
'표준편차': subject_stats['std']
}
else:
print(f"경고: '{subject_col}' 과목에 유효한 숫자 성적이 없습니다. 통계를 계산하지 않습니다.")
return analysis_results
# PDF 성적 보고서 생성
def create_grade_pdf(data_frame, stats_data, output_pdf_path):
"""학생 성적 데이터와 통계 데이터를 기반으로 PDF 보고서를 생성합니다."""
if data_frame is None or data_frame.empty:
print("오류: 유효한 데이터프레임이 없어 PDF 보고서를 생성할 수 없습니다.")
return
pdf_canvas = canvas.Canvas(output_pdf_path, pagesize=letter)
page_width, page_height = letter
# 기본 폰트 설정 (한글 지원을 위해 등록된 폰트 사용)
selected_font = 'MalgunGothic' if os.path.exists(font_path) else 'Helvetica'
pdf_canvas.setFont(selected_font, 12)
# 보고서 제목 추가
pdf_canvas.drawString(100, page_height - 70, "학생 성적 상세 보고서")
pdf_canvas.line(72, page_height - 80, page_width - 72, page_height - 80)
# 학생 성적 테이블 헤더 추가
table_headers = ["이름"] + list(data_frame.columns[1:])
pdf_canvas.setFont(selected_font, 10)
col_widths_px = [100] + [70] * (len(table_headers) - 1) # 열 너비 조정
current_y = page_height - 110
x_offset = 72
for i, header_text in enumerate(table_headers):
pdf_canvas.drawString(x_offset, current_y, header_text)
x_offset += col_widths_px[i]
# 학생 성적 데이터 추가
pdf_canvas.setFont(selected_font, 10)
current_y -= 20
for _, student_row in data_frame.iterrows():
x_offset = 72
for i, cell_value in enumerate(student_row):
display_text = str(cell_value)
if i > 0: # 점수 형식 맞추기
try:
display_text = f"{float(cell_value):.2f}"
except ValueError:
display_text = str(cell_value) # 숫자로 변환할 수 없으면 원본 문자열 사용
pdf_canvas.drawString(x_offset, current_y, display_text)
x_offset += col_widths_px[i]
current_y -= 15
if current_y < 100: # 페이지 하단에 도달하면 새 페이지
pdf_canvas.showPage()
pdf_canvas.setFont(selected_font, 10)
current_y = page_height - 70 # 새 페이지 시작 Y 좌표
# 통계 정보 섹션 추가
current_y -= 30
if current_y < 100: # 통계 정보 섹션 시작 전 새 페이지 확인
pdf_canvas.showPage()
pdf_canvas.setFont(selected_font, 10)
current_y = page_height - 70
pdf_canvas.line(72, current_y, page_width - 72, current_y)
current_y -= 20
pdf_canvas.drawString(100, current_y, "과목별 성적 통계 요약")
current_y -= 20
pdf_canvas.setFont(selected_font, 10)
for subject_name, statistics_values in stats_data.items():
pdf_canvas.drawString(72, current_y, f"{subject_name} 평균: {statistics_values['평균']:.2f}")
current_y -= 15
pdf_canvas.drawString(72, current_y, f"{subject_name} 최고점: {statistics_values['최고점']:.2f}")
current_y -= 15
pdf_canvas.drawString(72, current_y, f"{subject_name} 최저점: {statistics_values['최저점']:.2f}")
current_y -= 15
pdf_canvas.drawString(72, current_y, f"{subject_name} 표준편차: {statistics_values['표준편차']:.2f}")
current_y -= 20
if current_y < 50: # 페이지 하단에 도달하면 새 페이지
pdf_canvas.showPage()
pdf_canvas.setFont(selected_font, 10)
current_y = page_height - 70 # 새 페이지 시작 Y 좌표
# PDF 저장
pdf_canvas.save()
# 메인 실행 함수
def main_process():
"""주요 로직을 실행하여 성적 보고서를 생성합니다."""
input_file = "grades.csv"
output_report_file = "student_grade_report.pdf"
grades_df = load_grade_data(input_file)
if grades_df is None:
return
subject_statistics = analyze_subject_grades(grades_df)
create_grade_pdf(grades_df, subject_statistics, output_report_file)
print(f"성적 보고서가 성공적으로 생성되어 '{output_report_file}'(으)로 저장되었습니다.")
if __name__ == "__main__":
main_process()
2.4. 코드 해설
제공된 파이썬 코드는 다음 주요 단계로 구성됩니다.
- 한글 폰트 설정:
reportlab에서 한글을 올바르게 표시하기 위해 'MalgunGothic.ttf' 폰트 파일을 등록합니다. 폰트 파일이 없을 경우 경고 메시지를 출력하고 영문 폰트로 대체됩니다.
load_grade_data함수:pandas.read_csv함수를 사용하여 지정된 경로의 CSV 파일을 읽고, 이를DataFrame객체로 반환합니다.- 파일이 존재하지 않을 경우
FileNotFoundError를 처리합니다.
analyze_subject_grades함수:DataFrame의 첫 번째 열(학생 이름)을 제외한 모든 과목 열을 순회합니다.- 각 과목에 대해
pd.to_numeric을 사용하여 데이터를 숫자로 변환하고,describe()메서드를 호출하여 평균, 최고점, 최저점, 표준편차와 같은 통계 정보를 계산합니다. - 계산된 통계치는 딕셔너리 형태로 저장되어 반환됩니다. 유효한 숫자 성적이 없는 과목은 통계 계산에서 제외됩니다.
create_grade_pdf함수:reportlab.pdfgen.canvas.Canvas클래스를 이용하여 PDF 문서 생성을 위한 캔버스 객체를 초기화합니다.- 페이지 제목, 학생 성적 표 헤더 및 실제 성적 데이터를 PDF 캔버스에 그립니다. 이때 등록된 한글 폰트를 사용하여 한글이 올바르게 표시되도록 합니다.
- 각 과목의 평균, 최고점, 최저점, 표준편차 등 계산된 통계 정보를 별도의 섹션으로 추가합니다.
- 내용이 길어질 경우 자동으로 새 페이지를 추가하는 로직을 포함하여 보고서가 페이지를 넘어가지 않도록 관리합니다.
- 최종적으로 생성된 PDF 파일을 지정된 경로에 저장합니다.
main_process함수:- 입력 CSV 파일과 출력 PDF 파일의 경로를 정의합니다.
load_grade_data,analyze_subject_grades,create_grade_pdf함수들을 순차적으로 호출하여 전체 보고서 생성 과정을 실행합니다.- 보고서 생성 완료 메시지를 사용자에게 출력합니다.