Skip to content

QTH1225/LaTeX-in-ICM-MCM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 

Repository files navigation

$\LaTeX$-in-ICM&MCM:简单全面的美赛LaTeX模板

Version License LaTeX MCM/ICM Stars Downloads

一个专为美国大学生数学建模竞赛(MCM/ICM)设计的LaTeX模板库,基于EasyMCM模板进行了深度优化和功能增强,提供完整的论文写作解决方案。本项目在我的博客同步进行发布。

模板预览1 模板预览2 模板预览3
模板功能1 模板功能2 模板功能3
模板功能4 模板功能5 模板功能6

在使用本模板前,你至少应该对LaTeX有一定的了解而不是仅仅为了参加美赛而突然放弃Word,你所应该了解的包括但不限于:

  • 基本的LaTeX语法
  • 常用的LaTeX宏包(如amsmath, graphicx, hyperref等)
  • 如何编译LaTeX文档(如使用pdflatex, xelatex, lualatex等) 如果你没有LaTeX环境,建议使用Overleaf等在线平台进行编译。

另外你需要了解如何处理出现的报错,一般来说可以使用以下几种方法:

  • Ask The Fucking...riendly Web(ATFW,问友好的网络)
  • Read The Fucking...ine Manual(RTFM,读好的的手册)
  • Ask The Fucking...oolish AI(ATFAI,问智能的AI)

📁 项目结构

LaTeX-in-ICM-MCM/
├── temple/                    # 主模板目录(推荐使用)
│   ├── main.tex              # 主文档入口
│   ├── part_1_pre.tex        # 问题分析部分(引言、假设、符号说明)
│   ├── part_2_model.tex      # 模型建立部分(模型构建、求解)
│   ├── part_3_conclusion.tex # 结论部分(结果分析、总结)
│   ├── part_4_Appendix.tex   # 附录部分(代码、数据)
│   ├── new_command.tex       # 自定义命令和宏定义
│   ├── easymcm.sty           # EasyMCM宏包核心文件
│   ├── img/                  # 图片资源文件夹
│   └── _minted-main/         # 代码高亮缓存目录
├── Memos/                     # 备忘录和信件模板
│   ├── Letter/               # 官方信件模板
│   └── XJTLU-Poster-Template-main/  # 海报模板
└── README.md                  # 项目说明文档

✨ 模板特色功能

🎯 美赛专用功能

  • 自动控制号设置:通过\usepackage[1234567]{easymcm}自动设置队伍控制号
  • 规范摘要格式:符合MCM/ICM官方要求的Summary格式和排版规范
  • 专业字体支持:提供Times、Palatino等学术论文专用字体选项
  • 智能页眉页脚:自动显示队伍编号、页码和章节信息

📊 专业排版特性

  • 数学公式支持:完整的AMS-LaTeX数学符号库,支持复杂公式排版
  • 高级表格系统
    • 三线表格式(toprule/midrule/bottomrule)
    • 跨页长表格(longtable环境)
    • 多行多列表格(multirow/multicolumn)
    • 自适应宽度调整(resizebox和extracolsep)
  • 算法排版:使用algorithm2e包支持伪代码排版
  • 智能交叉引用hyperrefcleveref联合使用,实现智能引用

🎨 代码高亮支持

  • MATLAB代码盒子:使用matlab-prettifier包,支持语法高亮和行号显示
  • Python代码盒子:与MATLAB统一配色方案,支持语法高亮
  • 自动换行功能:超长代码和注释自动换行,避免溢出问题
  • 统一配色方案
    • 行号颜色:darkgray
    • 关键字颜色:darkblue(加粗)
    • 注释颜色:darkgreen
    • 字符串颜色:red!60(Python特有)

📁 模块化设计

  • 分章节管理:将论文分为引言、模型、结论、附录四个独立文件
  • 自定义命令:通过new_command.tex集中管理自定义宏命令
  • 图片资源管理:统一的img/文件夹管理所有图片资源
  • 缓存管理:自动生成_minted-main/目录缓存代码高亮结果

🚀 快速开始

1. 环境要求

  • LaTeX发行版:推荐TeX Live 2023+ 或 MiKTeX 22.0+
  • 编译引擎:必须使用XeLaTeX(支持中文和Unicode)
  • 额外依赖:需要安装minted包(用于代码高亮)

2. 使用步骤

  1. 获取模板:克隆或下载本仓库到本地
  2. 进入模板目录cd temple
  3. 配置基本信息:编辑main.tex文件:
    \usepackage[1234567]{easymcm}  % 将1234567替换为你的队伍控制号
    \problem{A}                   % 将A替换为你的题号(A/B/C/D/E/F)
  4. 编写内容:分别在四个章节文件中编写内容:
    • part_1_pre.tex:问题分析、假设、符号说明
    • part_2_model.tex:模型建立、求解过程
    • part_3_conclusion.tex:结果分析、结论总结
    • part_4_Appendix.tex:代码、数据等附录内容
  5. 编译文档
    xelatex main.tex
    xelatex main.tex  # 编译两次确保交叉引用正确

3. 常用功能示例

插入表格(支持跨页长表格):

\begin{longtable}{@{\extracolsep{\fill}}ccccc@{}}
\caption{参数分析表}\\ \toprule[2pt]
\multicolumn{1}{m{2.5cm}}{\centering \textbf{参数}} & \multicolumn{1}{m{2cm}}{\centering \textbf{类型}} & \multicolumn{1}{m{3cm}}{\centering \textbf{范围}} & \multicolumn{1}{m{2.5cm}}{\centering \textbf{默认值}} & \multicolumn{1}{m{2cm}}{\centering \textbf{敏感度}} \\
\midrule
$\\alpha$ & Continuous & [0, 1] & 0.5 & High \\
\end{longtable}

插入代码(支持MATLAB和Python):

% MATLAB代码
\begin{matlab}{MATLAB代码标题}{matlab:label}
% 你的MATLAB代码
A = [1, 2, 3; 4, 5, 6; 7, 8, 9];
result = sum(A, 2);
\end{matlab}

% Python代码
\begin{python}{Python代码标题}{python:label}
# 你的Python代码
def calculate_sum(matrix):
    return [sum(row) for row in matrix]
\end{python}

⚙️ 配置选项

字体选择

模板支持多种专业字体,在main.tex中取消注释相应行:

  • \usepackage{mathptmx} - Times字体(中规中矩)
  • \usepackage{palatino} - Palatino字体(官方推荐)

代码样式定制

main.tex中修改代码盒子定义来自定义:

  • 行号样式:numberstyle
  • 关键字样式:keywordstyle
  • 注释样式:commentstyle
  • 字符串样式:stringstyle

⚠️ 注意事项

编译要求

  1. 必须使用XeLaTeX:不支持pdfLaTeX或LuaLaTeX
  2. 编译两次:确保交叉引用和目录正确生成

文件管理

  1. 图片路径:所有图片应放在img/文件夹中
  2. 章节分离:各章节内容在对应的.tex文件中编写
  3. 自定义命令:新增命令应在new_command.tex中定义

排版规范

  1. 表格宽度:使用resizeboxextracolsep控制表格宽度
  2. 代码长度:长代码建议放在附录部分
  3. 参考文献:使用BibTeX管理,格式应符合美赛要求

🔧 问题解决

常见问题

  1. 编译错误:检查是否使用XeLaTeX,是否编译两次
  2. 代码显示异常:检查代码中是否有特殊字符需要转义
  3. 表格排版问题:合理设置列宽,避免使用过大的resizebox

其他资源(必看)

🎨 绘图与可视化工具

图表制作工具

  • Draw.io - 免费在线图表工具,支持流程图、UML图等
  • 迅捷画图 - 在线流程图和思维导图工具,支持团队协作
  • 书图网 - 在线图表制作平台,支持多种图表类型
  • ECharts - 百度开源的可视化库,功能强大的图表组件
  • RawGraphs -开源数据可视化工具,支持多种图表类型
  • Inkscape - 免费开源的矢量图形编辑器,支持创建和编辑矢量图形
  • ImageGP - 生物信息学图像处理平台,提供专业绘图工具
  • Color Hex - 颜色代码查询工具,提供丰富的配色方案

地图与数据可视化

图标与图片资源

  • Iconfont - 阿里巴巴矢量图标库,中文图标资源丰富
  • The Noun Project - 海量图标资源库,提供高质量的矢量图标
  • Freepik - 免费矢量图库,提供高质量的插画和图片资源

📝 LaTeX与学术写作工具

排版工具

  • Overleaf - 在线LaTeX编辑器,支持实时协作和版本控制
  • Typst - 现代排版系统,提供简洁的文档编写体验
  • LoongTeX - 中文LaTeX编译网站,提供模板和教程

公式与符号工具

  • LaTeX Live Editor - 在线LaTeX公式编辑器,实时预览数学公式
  • Detexify - LaTeX符号识别工具,手绘识别数学符号
  • Tables Generator - 在线表格生成器,支持LaTeX表格代码生成

写作辅助工具

  • 写作猫 - AI写作助手,支持文档润色和语法检查
  • Ludwig - 英文写作助手,提供句子结构和词汇建议
  • 曼彻斯特学术短语库 - 学术写作短语库,提供专业表达方式
  • Panda985 - 学术写作工具,提供论文模板和写作指导
  • Deepl - 中文翻译工具,支持多语言翻译
  • 百度翻译API - 百度翻译开放接口,支持多语言翻译
  • Rewordify - 文本简化工具,帮助理解复杂英文文本

代码处理

LaTeX学习资源

📊 数据处理与分析工具

统计分析工具

  • SPSSPRO - 在线统计分析平台,提供专业的统计分析功能
  • BioLadder - 生物信息学工具集,提供多种数据分析工具

数据资源与知识库

🤖 AI与智能工具

AI编程助手

  • Trae AI - 智能代码助手,提供AI编程支持
  • Cursor编辑器 - AI驱动的代码编辑器,智能代码补全
  • GPTGod在线 - AI对话平台,支持多种AI模型
  • Grok AI - xAI开发的AI助手,提供实时信息查询
  • Gemini AI - Google开发的AI助手应用,支持多模态交互和智能对话

AI工具配置

  • ZCF项目 - 一键式配置Claude Code,无需复杂设置
  • Metaso - AI搜索工具,智能信息检索和整理
  • Labnana - 扩展图或者文生图的模型,需要签到赚取积分
  • Banana Prompt Quicker - 提示词优化工具,提升AI对话效果

学习资源

📄 Word与办公工具

  • Zotero中文社区 - 文献管理工具Zotero的中文支持社区,提供使用教程和插件
  • Amyxun - Axmath与AxGlyph介绍网址
  • WordTeX - 如何在Word上以假乱真的模仿LaTeX文档

特别感谢

🤝 贡献指南

欢迎提交Issue和Pull Request来改进模板,或者添加你的美赛资源,但是我可能更新速度比较慢。

  1. Bug报告:详细描述问题现象和复现步骤
  2. 功能建议:说明需求背景和预期效果
  3. 代码贡献:遵循现有代码风格和文档规范
  4. 添加美赛资源:如果有相关的美赛资源(如模板、代码示例等),欢迎添加

📄 许可证

本项目采用 LaTeX Project Public License 1.3c (LPPL 1.3c)。

LPPL许可证的主要特点:

  • 修改自由 — 允许用户修改和分发修改后的版本
  • 维护状态 — 要求修改后的作品必须明确标识其与原始作品的关系
  • 文件完整性 — 确保LaTeX文件的完整性,避免不兼容的修改
  • 版本控制 — 支持版本管理,便于维护和更新

主要条款:

  • 您可以自由使用、修改和分发本模板
  • 修改后的版本必须使用不同的文件名或版本号
  • 必须保留原始许可证声明和版权信息
  • 修改后的版本不能声称是原始作品的官方版本

基于EasyMCM v5.1模板开发,遵循相应开源协议。

作者寄语

作者从大一开始作为论文手参与数模竞赛,在四年时间中论文类比赛参加了十几场,累计写过的字数约有15w左右。在2022、2023年参加了3次美赛全是S奖,但是我也一直没有放弃学习,所以美赛的经验也为我后来其他竞赛提供了不少帮助。

我想说的是,一直致力于打数模竞赛很好,打一两次觉得不适合自己放弃了也没事。最重要的是不能因为打数模竞赛的结果而放弃学习,放弃接受新知识。

凌晨在学院楼写完论文所拍摄

凌晨在学院楼写完论文所拍摄

Star History

如果您觉得本项目对您有帮助,欢迎给我一个star⭐,谢谢!

Star History Chart

About

基于EasyMCM全面且专业的美赛模板,支持多种排版样式

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages