Initial commit for scientific-writing

This commit is contained in:
dfty
2026-01-29 22:15:09 +08:00
commit ce92fdf680
10 changed files with 6791 additions and 0 deletions

View File

@@ -0,0 +1,574 @@
# Scientific Report Formatting Guide
Quick reference for using the `scientific_report.sty` style package.
## Overview
The `scientific_report.sty` package provides professional formatting for scientific reports, technical documents, and white papers. It features:
- **Helvetica font family** for a clean, modern appearance
- **Professional color scheme** with blues, greens, and accent colors
- **Colored box environments** for organizing different types of content
- **Attractive tables** with alternating row colors and professional headers
- **Scientific notation commands** for p-values, effect sizes, and statistics
- **Professional headers and footers** with automatic section titles
---
## Color Palette
### Primary Colors (Blues)
| Color Name | RGB | Hex | Usage |
|------------|-----|-----|-------|
| `primaryblue` | (0, 51, 102) | `#003366` | Headers, titles, primary elements |
| `secondaryblue` | (74, 144, 226) | `#4A90E2` | Subsections, secondary headings |
| `lightblue` | (220, 235, 252) | `#DCEBFC` | Key findings box backgrounds |
| `accentblue` | (0, 120, 215) | `#0078D7` | Accent highlights, hypothesis boxes |
### Scientific Colors (Greens)
| Color Name | RGB | Hex | Usage |
|------------|-----|-----|-------|
| `sciencegreen` | (0, 168, 150) | `#00A896` | Methodology boxes, positive findings |
| `lightgreen` | (220, 245, 240) | `#DCF5F0` | Methodology box backgrounds |
| `darkgreen` | (0, 128, 96) | `#008060` | Results boxes, strong evidence |
### Warning Colors (Orange/Red)
| Color Name | RGB | Hex | Usage |
|------------|-----|-----|-------|
| `cautionorange` | (255, 140, 66) | `#FF8C42` | Limitations, warnings, cautions |
| `lightorange` | (255, 243, 224) | `#FFF3E0` | Limitations box backgrounds |
| `criticalred` | (198, 40, 40) | `#C62828` | Critical notices, alerts |
| `lightred` | (255, 235, 238) | `#FFEBEE` | Critical notice backgrounds |
### Recommendation Colors
| Color Name | RGB | Hex | Usage |
|------------|-----|-----|-------|
| `recommendpurple` | (103, 58, 183) | `#673AB7` | Recommendations boxes |
| `lightpurple` | (237, 231, 246) | `#EDE7F6` | Recommendations box backgrounds |
### Neutral Colors
| Color Name | RGB | Hex | Usage |
|------------|-----|-----|-------|
| `darkgray` | (66, 66, 66) | `#424242` | Body text |
| `mediumgray` | (117, 117, 117) | `#757575` | Secondary text, definitions |
| `lightgray` | (245, 245, 245) | `#F5F5F5` | Backgrounds, definition boxes |
| `tablealt` | (248, 250, 252) | `#F8FAFC` | Alternating table rows |
---
## Box Environments
### Key Findings Box (Blue)
For major findings, discoveries, and important results.
```latex
\begin{keyfindings}[Custom Title]
This study found that treatment A significantly outperformed
treatment B (\pvalue{0.001}, \effectsize{d}{0.75}).
\end{keyfindings}
```
### Methodology Box (Green)
For methods, procedures, and study design highlights.
```latex
\begin{methodology}[Study Design]
This randomized controlled trial employed a 2×2 factorial design
with pre-post measurements and 6-month follow-up.
\end{methodology}
```
### Results Box (Blue-Green)
For highlighting specific results and statistical findings.
```latex
\begin{resultsbox}[Primary Outcome]
Analysis revealed a significant main effect, F(2, 147) = 12.45,
\psig{< 0.001}, $\eta^2$ = 0.145.
\end{resultsbox}
```
### Recommendations Box (Purple)
For recommendations, implications, and action items.
```latex
\begin{recommendations}[Clinical Implications]
\begin{enumerate}
\item Implement screening protocol for high-risk patients
\item Adjust treatment dosage based on biomarker levels
\item Monitor patients at 3-month intervals
\end{enumerate}
\end{recommendations}
```
### Limitations Box (Orange)
For limitations, cautions, and caveats.
```latex
\begin{limitations}[Study Limitations]
\begin{itemize}
\item Sample limited to urban populations
\item Cross-sectional design precludes causal inference
\item Self-report measures may introduce bias
\end{itemize}
\end{limitations}
```
### Critical Notice Box (Red)
For critical warnings, important notices, or safety information.
```latex
\begin{criticalnotice}[Safety Warning]
Patients with contraindication X should not receive this treatment.
Consult specialist before proceeding.
\end{criticalnotice}
```
### Definition Box (Gray)
For definitions, notes, and supplementary information.
```latex
\begin{definition}[Key Term]
\textbf{Effect size} refers to a quantitative measure of the
magnitude of a phenomenon, independent of sample size.
\end{definition}
```
### Executive Summary Box (Special)
For executive summaries with enhanced styling and shadow effect.
```latex
\begin{executivesummary}[Report Overview]
This report presents findings from a comprehensive analysis
of [topic]. Key findings indicate that...
\end{executivesummary}
```
### Hypothesis Box (Light Blue)
For stating research hypotheses.
```latex
\begin{hypothesis}[Primary Hypothesis]
We hypothesize that intervention X will significantly improve
outcome Y compared to control conditions.
\end{hypothesis}
```
---
## Pull Quotes
For highlighting important quotes or statements.
```latex
\begin{pullquote}
"These findings represent a paradigm shift in our understanding
of the underlying mechanisms."
\end{pullquote}
```
---
## Statistic Boxes
For highlighting key statistics (use in rows of 3).
```latex
\begin{center}
\statbox{n = 500}{Participants}
\statbox{p < 0.001}{Significance}
\statbox{d = 0.75}{Effect Size}
\end{center}
```
---
## Scientific Notation Commands
### P-Values
```latex
\pvalue{0.023} % Outputs: p = 0.023
\psig{< 0.001} % Outputs: p = < 0.001 (bold for significant)
```
### Confidence Intervals
```latex
\CI{0.45}{0.72} % Outputs: 95% CI [0.45, 0.72]
```
### Effect Sizes
```latex
\effectsize{d}{0.75} % Outputs: d = 0.75
\effectsize{r}{0.42} % Outputs: r = 0.42
\effectsize{F(2, 97)}{12.45} % Outputs: F(2, 97) = 12.45
```
### Sample Size
```latex
\samplesize{250} % Outputs: n = 250
```
### Mean with Standard Deviation
```latex
\meansd{42.5}{8.3} % Outputs: 42.5 ± 8.3
```
### Significance Indicators (for tables)
```latex
Result\sigone % * for p < 0.05
Result\sigtwo % ** for p < 0.01
Result\sigthree % *** for p < 0.001
Result\signs % ns for not significant
% Legend for table footnotes:
\siglegend % Outputs: *p < 0.05; **p < 0.01; ***p < 0.001; ns not significant
```
### Quality/Evidence Indicators
```latex
\qualityhigh % HIGH (green)
\qualitymedium % MEDIUM (orange)
\qualitylow % LOW (red)
\evidencestrong % Strong (green)
\evidencemoderate % Moderate (orange)
\evidenceweak % Weak (red)
```
### Trend Indicators
```latex
\trendup % Green up triangle ▲
\trenddown % Red down triangle ▼
\trendflat % Gray right arrow →
```
### Text Highlighting
```latex
\highlight{important text} % Blue bold text
```
---
## Table Formatting
### Standard Table with Alternating Rows
```latex
\begin{table}[htbp]
\centering
\caption{Descriptive Statistics by Group}
\label{tab:descriptives}
\begin{tabular}{@{}lccc@{}}
\toprule
\textbf{Variable} & \textbf{Group A} & \textbf{Group B} & \textbf{p} \\
\midrule
Age (years) & \meansd{42.5}{8.3} & \meansd{43.1}{7.9} & .58 \\
\rowcolor{tablealt} Score 1 & \meansd{15.2}{3.4} & \meansd{18.7}{4.1} & <.001\sigthree \\
Score 2 & \meansd{22.8}{5.1} & \meansd{23.4}{4.8} & .42 \\
\rowcolor{tablealt} Score 3 & \meansd{8.9}{2.2} & \meansd{7.2}{2.5} & .003\sigtwo \\
\bottomrule
\end{tabular}
\vspace{0.5em}
{\small \siglegend}
\end{table}
```
### Table with Quality Indicators
```latex
\begin{tabular}{@{}llcc@{}}
\toprule
\textbf{Study} & \textbf{Design} & \textbf{Quality} & \textbf{Evidence} \\
\midrule
Smith et al. (2023) & RCT & \qualityhigh & \evidencestrong \\
\rowcolor{tablealt} Jones et al. (2022) & Cohort & \qualitymedium & \evidencemoderate \\
Lee et al. (2021) & Cross-sectional & \qualitylow & \evidenceweak \\
\bottomrule
\end{tabular}
```
### Table with Trend Indicators
```latex
\begin{tabular}{@{}lrrl@{}}
\toprule
\textbf{Metric} & \textbf{Baseline} & \textbf{Follow-up} & \textbf{Change} \\
\midrule
Score A & 42.5 & 58.3 & \trendup +37\% \\
\rowcolor{tablealt} Score B & 18.2 & 15.1 & \trenddown -17\% \\
Score C & 7.8 & 7.9 & \trendflat +1\% \\
\bottomrule
\end{tabular}
```
---
## Figure Formatting
### Standard Figure
```latex
\begin{figure}[htbp]
\centering
\includegraphics[width=0.9\textwidth]{../figures/results_chart.png}
\caption{Comparison of Outcome Scores Across Treatment Conditions}
\label{fig:results}
\end{figure}
```
### Figure with Source Attribution
```latex
\begin{figure}[htbp]
\centering
\includegraphics[width=0.85\textwidth]{../figures/data_visualization.png}
\caption{Distribution of Participant Responses by Category}
\figuresource{Study data, collected January-March 2024}
\label{fig:distribution}
\end{figure}
```
### Figure with Note
```latex
\begin{figure}[htbp]
\centering
\includegraphics[width=0.8\textwidth]{../figures/model_diagram.png}
\caption{Conceptual Model of Proposed Relationships}
\figurenote{Solid arrows indicate direct effects; dashed arrows indicate moderated effects.}
\label{fig:model}
\end{figure}
```
---
## Title Page
### Standard Title Page
```latex
\makereporttitle
{Research Report Title} % Title
{A Comprehensive Analysis} % Subtitle
{Author Name, PhD} % Author(s)
{Research Institution} % Institution
{January 2025} % Date
```
### Title Page with Cover Image
```latex
\makereporttitlewithimage
{Research Report Title} % Title
{A Comprehensive Analysis} % Subtitle
{../figures/cover_image.png} % Image path
{Author Name, PhD} % Author(s)
{Research Institution} % Institution
{January 2025} % Date
```
---
## List Formatting
Lists automatically use blue bullets/numbers.
### Bullet Lists
```latex
\begin{itemize}
\item First item with automatic blue bullet
\item Second item
\item Third item
\end{itemize}
```
### Numbered Lists
```latex
\begin{enumerate}
\item First item with blue number
\item Second item
\item Third item
\end{enumerate}
```
---
## Appendix Sections
```latex
\appendix
\chapter{Supplementary Materials}
\appendixsection{Additional Tables}
% Content appears in table of contents
\appendixsection{Instruments}
% Additional appendix content
```
---
## Compilation
Compile with XeLaTeX or LuaLaTeX for best font rendering:
```bash
# Using XeLaTeX
xelatex report.tex
bibtex report # If using BibTeX
xelatex report.tex
xelatex report.tex
# Using latexmk (recommended)
latexmk -xelatex report.tex
# Using LuaLaTeX
lualatex report.tex
```
---
## Common Patterns
### Results Section Example
```latex
\section{Primary Outcomes}
\begin{resultsbox}[Main Finding]
The intervention group showed significantly higher scores than
the control group, \effectsize{t(98)}{3.45}, \psig{< 0.001},
\effectsize{d}{0.69}, \CI{0.42}{0.96}.
\end{resultsbox}
Table~\ref{tab:outcomes} presents the complete results for all
outcome measures.
\begin{table}[htbp]
\centering
\caption{Outcome Measures by Treatment Condition}
\label{tab:outcomes}
\begin{tabular}{@{}lcccc@{}}
\toprule
\textbf{Measure} & \textbf{Control} & \textbf{Treatment} & \textbf{d} & \textbf{p} \\
\midrule
Primary & \meansd{42.1}{8.2} & \meansd{51.3}{9.1} & 0.69\sigthree & <.001 \\
\rowcolor{tablealt} Secondary & \meansd{3.2}{1.1} & \meansd{4.1}{1.3} & 0.52\sigtwo & .004 \\
Tertiary & \meansd{18.5}{4.2} & \meansd{19.2}{4.5} & 0.16\signs & .328 \\
\bottomrule
\end{tabular}
\end{table}
```
### Discussion Section Example
```latex
\section{Interpretation of Findings}
\begin{keyfindings}[Summary]
\begin{enumerate}
\item Primary hypothesis \highlight{supported} with large effect
\item Secondary hypothesis partially supported
\item Evidence quality: \evidencestrong
\end{enumerate}
\end{keyfindings}
\begin{limitations}
This study has several limitations that should be considered...
\end{limitations}
\begin{recommendations}[Future Research]
Future studies should address the following:
\begin{enumerate}
\item Replicate findings in diverse populations
\item Extend follow-up period to assess long-term effects
\item Investigate moderating variables
\end{enumerate}
\end{recommendations}
```
---
## Troubleshooting
### Box Overflow
If box content overflows the page:
```latex
\newpage
\begin{keyfindings}[Continued...]
```
### Figure Placement
Use `[htbp]` for flexible placement, or `[H]` (requires `float` package) for exact:
```latex
\usepackage{float}
\begin{figure}[H]
```
### Table Too Wide
Use `\resizebox` or reduce font size:
```latex
\resizebox{\textwidth}{!}{
\begin{tabular}{...}
...
\end{tabular}
}
```
### Font Issues
If Helvetica isn't rendering, ensure you're using XeLaTeX or LuaLaTeX:
```bash
xelatex report.tex # NOT pdflatex
```
---
## Quick Reference Card
| Purpose | Command/Environment |
|---------|---------------------|
| Major finding | `\begin{keyfindings}...\end{keyfindings}` |
| Methods | `\begin{methodology}...\end{methodology}` |
| Results | `\begin{resultsbox}...\end{resultsbox}` |
| Recommendation | `\begin{recommendations}...\end{recommendations}` |
| Limitation | `\begin{limitations}...\end{limitations}` |
| Warning | `\begin{criticalnotice}...\end{criticalnotice}` |
| Definition | `\begin{definition}...\end{definition}` |
| Executive summary | `\begin{executivesummary}...\end{executivesummary}` |
| Hypothesis | `\begin{hypothesis}...\end{hypothesis}` |
| P-value | `\pvalue{0.05}` or `\psig{< 0.001}` |
| Effect size | `\effectsize{d}{0.75}` |
| Sample size | `\samplesize{250}` |
| Mean ± SD | `\meansd{42.5}{8.3}` |
| CI | `\CI{0.38}{0.72}` |
| Highlight | `\highlight{text}` |
| Alt row | `\rowcolor{tablealt}` |
| Significance | `\sigone`, `\sigtwo`, `\sigthree`, `\signs` |

View File

@@ -0,0 +1,606 @@
% scientific_report.sty - Professional Scientific Report Styling
% For use with XeLaTeX or LuaLaTeX
% Designed for research reports, technical reports, white papers, and similar documents
% NOT for journal manuscripts (use venue-templates for those)
\ProvidesPackage{scientific_report}[2024/01/01 Scientific Report Style]
% ============================================================================
% REQUIRED PACKAGES
% ============================================================================
% Page layout and geometry
\RequirePackage[margin=1in, headheight=14pt]{geometry}
\RequirePackage{setspace}
% Typography - Helvetica font family
\RequirePackage[utf8]{inputenc}
\RequirePackage[T1]{fontenc}
\RequirePackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
% Colors and graphics
\RequirePackage{xcolor}
\RequirePackage{graphicx}
\RequirePackage{tikz}
% Tables
\RequirePackage{longtable}
\RequirePackage{booktabs}
\RequirePackage{multirow}
\RequirePackage{array}
\RequirePackage{colortbl}
\RequirePackage{tabularx}
% Lists and formatting
\RequirePackage{enumitem}
\RequirePackage{parskip}
% Boxes and callouts
\RequirePackage[most]{tcolorbox}
% Headers and footers
\RequirePackage{fancyhdr}
\RequirePackage{titlesec}
% Hyperlinks and references
\RequirePackage{hyperref}
\RequirePackage[numbers,sort&compress]{natbib}
% Math and scientific notation
\RequirePackage{amsmath}
\RequirePackage{amssymb}
\RequirePackage{siunitx}
% Captions
\RequirePackage{caption}
\RequirePackage{subcaption}
% ============================================================================
% COLOR DEFINITIONS - PROFESSIONAL SCIENTIFIC PALETTE
% ============================================================================
% Primary colors (professional blue palette)
\definecolor{primaryblue}{RGB}{0, 51, 102} % Deep navy blue - headers, titles
\definecolor{secondaryblue}{RGB}{74, 144, 226} % Medium blue - subsections
\definecolor{lightblue}{RGB}{220, 235, 252} % Light blue for backgrounds
\definecolor{accentblue}{RGB}{0, 120, 215} % Bright accent blue
% Scientific accent colors
\definecolor{sciencegreen}{RGB}{0, 168, 150} % Teal green - positive findings
\definecolor{lightgreen}{RGB}{220, 245, 240} % Light green background
\definecolor{darkgreen}{RGB}{0, 128, 96} % Dark green for emphasis
% Warning and caution colors
\definecolor{cautionorange}{RGB}{255, 140, 66} % Orange for warnings/limitations
\definecolor{lightorange}{RGB}{255, 243, 224} % Light orange background
\definecolor{criticalred}{RGB}{198, 40, 40} % Red for critical items
\definecolor{lightred}{RGB}{255, 235, 238} % Light red background
% Recommendation and action colors
\definecolor{recommendpurple}{RGB}{103, 58, 183} % Purple for recommendations
\definecolor{lightpurple}{RGB}{237, 231, 246} % Light purple background
% Neutral colors
\definecolor{darkgray}{RGB}{66, 66, 66} % Dark gray for body text
\definecolor{mediumgray}{RGB}{117, 117, 117} % Medium gray for secondary text
\definecolor{lightgray}{RGB}{245, 245, 245} % Light gray backgrounds
\definecolor{tablealt}{RGB}{248, 250, 252} % Alternating table row color
\definecolor{tableborder}{RGB}{200, 200, 200} % Table border color
% ============================================================================
% HYPERLINK CONFIGURATION
% ============================================================================
\hypersetup{
colorlinks=true,
linkcolor=primaryblue,
filecolor=primaryblue,
urlcolor=accentblue,
citecolor=secondaryblue,
pdftitle={Scientific Report},
pdfauthor={},
pdfsubject={Scientific Research},
}
% ============================================================================
% CHAPTER AND SECTION FORMATTING
% ============================================================================
% Chapter formatting - large number with colored title
\titleformat{\chapter}[display]
{\normalfont\huge\bfseries\color{primaryblue}}
{\chaptertitlename\ \thechapter}{20pt}{\Huge}
\titlespacing*{\chapter}{0pt}{-20pt}{40pt}
% Section formatting
\titleformat{\section}
{\normalfont\Large\bfseries\color{primaryblue}}
{\thesection}{1em}{}
\titlespacing*{\section}{0pt}{3.5ex plus 1ex minus .2ex}{2.3ex plus .2ex}
% Subsection formatting
\titleformat{\subsection}
{\normalfont\large\bfseries\color{secondaryblue}}
{\thesubsection}{1em}{}
% Subsubsection formatting
\titleformat{\subsubsection}
{\normalfont\normalsize\bfseries\color{darkgray}}
{\thesubsubsection}{1em}{}
% Paragraph formatting
\titleformat{\paragraph}[runin]
{\normalfont\normalsize\bfseries\color{darkgray}}
{\theparagraph}{1em}{}
% ============================================================================
% HEADER AND FOOTER CONFIGURATION
% ============================================================================
\pagestyle{fancy}
\fancyhf{}
\fancyhead[L]{\small\textit{\leftmark}}
\fancyhead[R]{\small\textit{Scientific Report}}
\fancyfoot[C]{\thepage}
\renewcommand{\headrulewidth}{0.4pt}
\renewcommand{\footrulewidth}{0.4pt}
\renewcommand{\headrule}{\hbox to\headwidth{\color{primaryblue}\leaders\hrule height \headrulewidth\hfill}}
\renewcommand{\footrule}{\hbox to\headwidth{\color{lightgray}\leaders\hrule height \footrulewidth\hfill}}
% Plain page style for chapter pages
\fancypagestyle{plain}{
\fancyhf{}
\fancyfoot[C]{\thepage}
\renewcommand{\headrulewidth}{0pt}
\renewcommand{\footrulewidth}{0.4pt}
}
% ============================================================================
% BOX ENVIRONMENTS - SCIENTIFIC CONTENT ORGANIZATION
% ============================================================================
% Key Findings Box (Blue) - For major findings and discoveries
\newtcolorbox{keyfindings}[1][Key Findings]{
colback=lightblue,
colframe=primaryblue,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=primaryblue,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Methodology Box (Green) - For methods and procedures
\newtcolorbox{methodology}[1][Methodology]{
colback=lightgreen,
colframe=sciencegreen,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=sciencegreen,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Results Box (Blue-Green) - For highlighting key results
\newtcolorbox{resultsbox}[1][Results Highlight]{
colback=lightblue!50!lightgreen!50,
colframe=darkgreen,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=darkgreen,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Recommendations Box (Purple) - For recommendations and implications
\newtcolorbox{recommendations}[1][Recommendations]{
colback=lightpurple,
colframe=recommendpurple,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=recommendpurple,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Warning/Limitations Box (Orange) - For limitations, cautions, caveats
\newtcolorbox{limitations}[1][Limitations]{
colback=lightorange,
colframe=cautionorange,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=cautionorange,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Critical Notice Box (Red) - For critical warnings or important notices
\newtcolorbox{criticalnotice}[1][Critical Notice]{
colback=lightred,
colframe=criticalred,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=criticalred,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Definition Box (Gray) - For definitions, notes, supplementary info
\newtcolorbox{definition}[1][Definition]{
colback=lightgray,
colframe=mediumgray,
fonttitle=\bfseries\color{darkgray},
title=#1,
coltitle=darkgray,
colbacktitle=lightgray,
boxrule=0.5pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% Executive Summary Box (Special styling with shadow)
\newtcolorbox{executivesummary}[1][Executive Summary]{
enhanced,
colback=white,
colframe=primaryblue,
fonttitle=\Large\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=primaryblue,
boxrule=2pt,
arc=5pt,
left=15pt,
right=15pt,
top=12pt,
bottom=12pt,
before skip=15pt,
after skip=15pt,
shadow={2mm}{-2mm}{0mm}{black!20},
}
% Hypothesis Box (Light blue with border) - For stating hypotheses
\newtcolorbox{hypothesis}[1][Hypothesis]{
enhanced,
colback=lightblue!50,
colframe=accentblue,
fonttitle=\bfseries\color{white},
title=#1,
coltitle=white,
colbacktitle=accentblue,
boxrule=1pt,
arc=3pt,
left=10pt,
right=10pt,
top=8pt,
bottom=8pt,
before skip=12pt,
after skip=12pt,
}
% ============================================================================
% PULL QUOTE ENVIRONMENT
% ============================================================================
\newtcolorbox{pullquote}{
enhanced,
colback=lightgray,
colframe=lightgray,
boxrule=0pt,
borderline west={4pt}{0pt}{primaryblue},
arc=0pt,
left=15pt,
right=15pt,
top=10pt,
bottom=10pt,
before skip=15pt,
after skip=15pt,
fontupper=\large\itshape\color{darkgray},
}
% ============================================================================
% STATISTIC HIGHLIGHT BOX
% ============================================================================
\newcommand{\statbox}[2]{%
\begin{tcolorbox}[
colback=primaryblue,
colframe=primaryblue,
coltext=white,
arc=5pt,
boxrule=0pt,
width=0.3\textwidth,
halign=center,
valign=center,
before skip=10pt,
after skip=10pt,
]
{\Huge\bfseries #1}\\[5pt]
{\small #2}
\end{tcolorbox}
}
% ============================================================================
% TABLE STYLING
% ============================================================================
% Alternating row colors command
\newcommand{\tablerowcolor}{\rowcolor{tablealt}}
% Table header styling
\newcommand{\tableheader}[1]{\textbf{\color{white}#1}}
\newcommand{\tableheaderrow}{\rowcolor{primaryblue}}
% Professional table environment
\newenvironment{sciencetable}[2][htbp]{%
\begin{table}[#1]
\centering
\caption{#2}
\small
}{%
\end{table}
}
% ============================================================================
% FIGURE STYLING
% ============================================================================
% Caption formatting
\captionsetup{
font=small,
labelfont={bf,color=primaryblue},
textfont={color=darkgray},
justification=centering,
margin=20pt,
}
% Figure with source attribution
\newcommand{\figuresource}[1]{%
\par\vspace{-8pt}
{\small\textit{Source: #1}}
}
% Figure note
\newcommand{\figurenote}[1]{%
\par\vspace{-8pt}
{\small\textit{Note: #1}}
}
% ============================================================================
% LIST STYLING
% ============================================================================
% Bullet list styling with blue bullets
\setlist[itemize]{
leftmargin=*,
label=\textcolor{primaryblue}{\textbullet},
topsep=5pt,
itemsep=3pt,
}
% Numbered list styling with blue numbers
\setlist[enumerate]{
leftmargin=*,
label=\textcolor{primaryblue}{\arabic*.},
topsep=5pt,
itemsep=3pt,
}
% ============================================================================
% SCIENTIFIC NOTATION COMMANDS
% ============================================================================
% Highlight important text
\newcommand{\highlight}[1]{\textbf{\textcolor{primaryblue}{#1}}}
% P-value formatting (with significance indicators)
\newcommand{\pvalue}[1]{%
\textit{p}~=~#1%
}
% Significant p-value (bold)
\newcommand{\psig}[1]{%
\textbf{\textit{p}~=~#1}%
}
% Confidence interval
\newcommand{\CI}[2]{%
95\% CI [#1, #2]%
}
% Effect size formatting
\newcommand{\effectsize}[2]{%
#1~=~#2%
}
% Sample size
\newcommand{\samplesize}[1]{%
\textit{n}~=~#1%
}
% Mean with SD
\newcommand{\meansd}[2]{%
#1~$\pm$~#2%
}
% Significance indicators
\newcommand{\sigone}{\textsuperscript{*}} % p < 0.05
\newcommand{\sigtwo}{\textsuperscript{**}} % p < 0.01
\newcommand{\sigthree}{\textsuperscript{***}} % p < 0.001
\newcommand{\signs}{\textsuperscript{ns}} % not significant
% Significance legend (for table footnotes)
\newcommand{\siglegend}{%
\textsuperscript{*}\textit{p}~<~0.05;
\textsuperscript{**}\textit{p}~<~0.01;
\textsuperscript{***}\textit{p}~<~0.001;
\textsuperscript{ns}not significant%
}
% ============================================================================
% STATUS INDICATORS
% ============================================================================
% Trend indicators
\newcommand{\trendup}{\textcolor{darkgreen}{$\blacktriangle$}}
\newcommand{\trenddown}{\textcolor{criticalred}{$\blacktriangledown$}}
\newcommand{\trendflat}{\textcolor{mediumgray}{$\rightarrow$}}
% Quality/Rating indicators
\newcommand{\qualityhigh}{\textbf{\textcolor{darkgreen}{HIGH}}}
\newcommand{\qualitymedium}{\textbf{\textcolor{cautionorange}{MEDIUM}}}
\newcommand{\qualitylow}{\textbf{\textcolor{criticalred}{LOW}}}
% Evidence strength
\newcommand{\evidencestrong}{\textbf{\textcolor{darkgreen}{Strong}}}
\newcommand{\evidencemoderate}{\textbf{\textcolor{cautionorange}{Moderate}}}
\newcommand{\evidenceweak}{\textbf{\textcolor{criticalred}{Weak}}}
% ============================================================================
% TITLE PAGE COMMAND
% ============================================================================
\newcommand{\makereporttitle}[5]{%
% #1 = Report Title
% #2 = Subtitle
% #3 = Author(s)
% #4 = Institution/Organization
% #5 = Date
\begin{titlepage}
\centering
\vspace*{2cm}
{\Huge\bfseries\color{primaryblue} #1\\[0.5cm]}
{\LARGE #2\\[2cm]}
\vspace{2cm}
{\Large\bfseries #3\\[0.5cm]}
{\large #4\\[2cm]}
{\large\bfseries Date: #5\\[0.3cm]}
\vfill
\begin{tikzpicture}
\fill[primaryblue] (0,0) rectangle (\textwidth,0.5);
\end{tikzpicture}
\end{titlepage}
}
% Alternative title page with image
\newcommand{\makereporttitlewithimage}[6]{%
% #1 = Report Title
% #2 = Subtitle
% #3 = Hero Image Path
% #4 = Author(s)
% #5 = Institution/Organization
% #6 = Date
\begin{titlepage}
\centering
\vspace*{1cm}
{\Huge\bfseries\color{primaryblue} #1\\[0.5cm]}
{\LARGE #2\\[1.5cm]}
\ifx&#3&
\vspace{4cm}
\else
\includegraphics[width=0.8\textwidth]{#3}\\[1.5cm]
\fi
{\Large\bfseries #4\\[0.5cm]}
{\large #5\\[1.5cm]}
{\large\bfseries Date: #6}
\vfill
\begin{tikzpicture}
\fill[primaryblue] (0,0) rectangle (\textwidth,0.5);
\end{tikzpicture}
\end{titlepage}
}
% ============================================================================
% APPENDIX SECTION COMMAND
% ============================================================================
\newcommand{\appendixsection}[1]{%
\section*{#1}
\addcontentsline{toc}{section}{#1}
}
% ============================================================================
% PAGE LAYOUT ADJUSTMENTS
% ============================================================================
% Spacing
\setstretch{1.15}
\setlength{\parskip}{0.5em}
% Prevent orphans and widows
\clubpenalty=10000
\widowpenalty=10000
% Float placement
\renewcommand{\topfraction}{0.9}
\renewcommand{\bottomfraction}{0.8}
\renewcommand{\textfraction}{0.07}
\renewcommand{\floatpagefraction}{0.7}
% ============================================================================
% END OF STYLE FILE
% ============================================================================
\endinput

View File

@@ -0,0 +1,449 @@
% Scientific Report Template
% Uses scientific_report.sty for professional formatting
% Compile with: xelatex or lualatex
%
% This template demonstrates the full capabilities of the scientific_report.sty
% style package for creating professional research reports, technical reports,
% and white papers.
\documentclass[11pt,letterpaper]{report}
% Load the scientific report style package
\usepackage{scientific_report}
% Additional packages (optional, add as needed)
\usepackage{lipsum} % For placeholder text - remove in actual documents
% ============================================================================
% DOCUMENT METADATA
% ============================================================================
\hypersetup{
pdftitle={Research Report Title},
pdfauthor={Author Name},
pdfsubject={Research Subject},
pdfkeywords={keyword1, keyword2, keyword3}
}
% ============================================================================
% DOCUMENT BEGIN
% ============================================================================
\begin{document}
% ----------------------------------------------------------------------------
% TITLE PAGE
% ----------------------------------------------------------------------------
\makereporttitle
{Research Report Title} % Title
{A Comprehensive Analysis of [Topic]} % Subtitle
{Author Name, PhD} % Author(s)
{Research Institution / Organization} % Institution
{January 2025} % Date
% Alternative: Title page with cover image
% \makereporttitlewithimage
% {Research Report Title}
% {A Comprehensive Analysis of [Topic]}
% {../figures/cover_image.png}
% {Author Name, PhD}
% {Research Institution / Organization}
% {January 2025}
% ----------------------------------------------------------------------------
% FRONT MATTER
% ----------------------------------------------------------------------------
\pagenumbering{roman}
% Table of Contents
\tableofcontents
\newpage
% List of Figures
\listoffigures
\newpage
% List of Tables
\listoftables
\newpage
% ----------------------------------------------------------------------------
% EXECUTIVE SUMMARY
% ----------------------------------------------------------------------------
\chapter*{Executive Summary}
\addcontentsline{toc}{chapter}{Executive Summary}
\begin{executivesummary}[Report Overview]
This report presents a comprehensive analysis of [topic]. Our investigation reveals significant findings that have implications for [field/application]. The research was conducted using [methodology] and involved [sample/data description].
\end{executivesummary}
\subsection*{Key Findings}
\begin{keyfindings}
\begin{enumerate}
\item \textbf{Finding 1:} Description of the first major finding with supporting data (\pvalue{0.001}, \samplesize{250}).
\item \textbf{Finding 2:} Description of the second major finding with effect size (\effectsize{d}{0.75}).
\item \textbf{Finding 3:} Description of the third major finding (\meansd{42.5}{8.3}).
\end{enumerate}
\end{keyfindings}
\subsection*{Recommendations}
\begin{recommendations}
\begin{enumerate}
\item Implement [specific action] to address [issue].
\item Allocate resources for [specific initiative].
\item Conduct follow-up research on [topic].
\end{enumerate}
\end{recommendations}
\newpage
\pagenumbering{arabic}
% ----------------------------------------------------------------------------
% CHAPTER 1: INTRODUCTION
% ----------------------------------------------------------------------------
\chapter{Introduction}
\section{Background}
This section provides context for the research. Include relevant background information, the current state of knowledge, and the rationale for the study.
\begin{definition}[Key Term]
A \textbf{key term} is defined as [definition]. This concept is fundamental to understanding the research presented in this report.
\end{definition}
\section{Research Objectives}
The primary objectives of this research are:
\begin{enumerate}
\item To investigate [objective 1]
\item To analyze [objective 2]
\item To evaluate [objective 3]
\end{enumerate}
\section{Hypotheses}
\begin{hypothesis}[Primary Hypothesis]
We hypothesize that [independent variable] will have a significant effect on [dependent variable], such that [expected direction of effect].
\end{hypothesis}
\section{Scope and Limitations}
\begin{limitations}[Study Scope]
This research focuses on [specific scope]. The following limitations should be considered when interpreting the results:
\begin{itemize}
\item Geographic limitation: [description]
\item Temporal limitation: [description]
\item Sample limitation: [description]
\end{itemize}
\end{limitations}
% ----------------------------------------------------------------------------
% CHAPTER 2: METHODOLOGY
% ----------------------------------------------------------------------------
\chapter{Methodology}
\section{Study Design}
\begin{methodology}[Research Design Overview]
This study employed a [type] design to investigate [research question]. The methodology was selected based on [rationale] and follows established guidelines for [type of research].
\end{methodology}
\section{Participants}
A total of \samplesize{500} participants were recruited from [population]. Table~\ref{tab:demographics} presents the demographic characteristics of the sample.
\begin{table}[htbp]
\centering
\caption{Participant Demographics}
\label{tab:demographics}
\begin{tabular}{@{}lcc@{}}
\toprule
\tableheader{Characteristic} & \tableheader{n} & \tableheader{\%} \\
\midrule
\textbf{Gender} & & \\
\quad Male & 245 & 49.0 \\
\rowcolor{tablealt} \quad Female & 255 & 51.0 \\
\textbf{Age Group} & & \\
\quad 18--30 & 150 & 30.0 \\
\rowcolor{tablealt} \quad 31--45 & 200 & 40.0 \\
\quad 46--60 & 120 & 24.0 \\
\rowcolor{tablealt} \quad 60+ & 30 & 6.0 \\
\bottomrule
\end{tabular}
\end{table}
\section{Instruments}
\subsection{Primary Measures}
The following instruments were used to collect data:
\begin{itemize}
\item \textbf{Instrument 1:} Description and psychometric properties
\item \textbf{Instrument 2:} Description and psychometric properties
\item \textbf{Instrument 3:} Description and psychometric properties
\end{itemize}
\section{Procedures}
Data collection occurred between [dates]. The procedure involved the following steps:
\begin{enumerate}
\item Informed consent was obtained from all participants.
\item Baseline assessments were administered.
\item Intervention/treatment was delivered (if applicable).
\item Follow-up assessments were conducted at [timepoints].
\end{enumerate}
\section{Statistical Analysis}
Data were analyzed using [software] version [X.X]. The following analyses were performed:
\begin{itemize}
\item Descriptive statistics for all variables
\item [Analysis type] to test hypothesis 1
\item [Analysis type] to test hypothesis 2
\end{itemize}
Statistical significance was set at $\alpha = 0.05$. Effect sizes were calculated using [method] and interpreted according to [guidelines].
% ----------------------------------------------------------------------------
% CHAPTER 3: RESULTS
% ----------------------------------------------------------------------------
\chapter{Results}
\section{Descriptive Statistics}
Table~\ref{tab:descriptives} presents the descriptive statistics for the primary outcome measures.
\begin{table}[htbp]
\centering
\caption{Descriptive Statistics for Primary Outcome Measures}
\label{tab:descriptives}
\begin{tabular}{@{}lccccc@{}}
\toprule
\tableheader{Variable} & \tableheader{n} & \tableheader{Mean} & \tableheader{SD} & \tableheader{Min} & \tableheader{Max} \\
\midrule
Outcome 1 & 500 & 42.5 & 8.3 & 18 & 72 \\
\rowcolor{tablealt} Outcome 2 & 498 & 3.7 & 1.2 & 1 & 7 \\
Outcome 3 & 495 & 128.4 & 24.7 & 68 & 195 \\
\rowcolor{tablealt} Outcome 4 & 500 & 0.68 & 0.15 & 0.28 & 0.95 \\
\bottomrule
\end{tabular}
\figurenote{SD = Standard Deviation}
\end{table}
\section{Primary Analyses}
\subsection{Hypothesis 1}
\begin{resultsbox}[Primary Finding]
Analysis revealed a significant effect of [IV] on [DV], \effectsize{F(2, 497)}{12.45}, \psig{< 0.001}, $\eta^2$ = 0.048. Post-hoc comparisons indicated that [specific findings].
\end{resultsbox}
The results support our primary hypothesis. As shown in Figure~\ref{fig:main_results}, participants in the experimental condition demonstrated significantly higher scores compared to the control group.
% Placeholder for figure
\begin{figure}[htbp]
\centering
\fbox{\parbox{0.8\textwidth}{\centering\vspace{3cm}[Figure: Main Results Comparison]\\Bar chart showing group differences\vspace{3cm}}}
\caption{Comparison of Outcome Scores by Experimental Condition}
\label{fig:main_results}
\figuresource{Study data}
\end{figure}
\subsection{Hypothesis 2}
Results indicated a moderate positive correlation between [variable 1] and [variable 2], \effectsize{r}{0.45}, \psig{< 0.001}, \CI{0.38}{0.52}.
\section{Secondary Analyses}
Table~\ref{tab:regression} presents the results of the regression analysis predicting [outcome].
\begin{table}[htbp]
\centering
\caption{Multiple Regression Analysis Predicting Outcome}
\label{tab:regression}
\begin{tabular}{@{}lcccc@{}}
\toprule
\tableheader{Predictor} & \tableheader{B} & \tableheader{SE} & \tableheader{$\beta$} & \tableheader{p} \\
\midrule
(Intercept) & 12.45 & 2.34 & --- & < .001 \\
\rowcolor{tablealt} Predictor 1 & 0.58 & 0.12 & 0.28\sigthree & < .001 \\
Predictor 2 & 0.34 & 0.09 & 0.22\sigtwo & .002 \\
\rowcolor{tablealt} Predictor 3 & 0.15 & 0.11 & 0.08\signs & .172 \\
Predictor 4 & -0.42 & 0.14 & -0.18\sigtwo & .003 \\
\midrule
\multicolumn{5}{l}{$R^2$ = 0.34, Adjusted $R^2$ = 0.33, \effectsize{F(4, 495)}{63.82}\sigthree} \\
\bottomrule
\end{tabular}
\vspace{0.5em}
{\small \siglegend}
\end{table}
% ----------------------------------------------------------------------------
% CHAPTER 4: DISCUSSION
% ----------------------------------------------------------------------------
\chapter{Discussion}
\section{Summary of Findings}
\begin{keyfindings}[Key Takeaways]
\begin{enumerate}
\item The primary hypothesis was \highlight{supported}, with significant effects observed for [variables].
\item Evidence quality for the main findings is \evidencestrong, based on effect sizes and replication potential.
\item Unexpected finding: [description of any surprising results].
\end{enumerate}
\end{keyfindings}
\section{Interpretation}
The findings from this study contribute to our understanding of [topic] in several important ways. First, the significant effect of [IV] on [DV] suggests that [interpretation]. This aligns with previous research by [Author] (Year), who found similar patterns in [context].
\begin{pullquote}
``These findings represent a significant advancement in our understanding of [topic] and have direct implications for [application/practice].''
\end{pullquote}
Second, the correlation between [variables] indicates that [interpretation]. This relationship has important implications for [field/practice].
\section{Implications}
\subsection{Theoretical Implications}
The results have several theoretical implications:
\begin{itemize}
\item Support for [theory/model]
\item Extension of [existing framework]
\item Challenge to [alternative perspective]
\end{itemize}
\subsection{Practical Implications}
\begin{recommendations}[Practical Applications]
Based on our findings, we recommend the following practical applications:
\begin{enumerate}
\item \textbf{For practitioners:} [specific recommendation]
\item \textbf{For policymakers:} [specific recommendation]
\item \textbf{For researchers:} [specific recommendation]
\end{enumerate}
\end{recommendations}
\section{Limitations}
\begin{limitations}[Study Limitations]
Several limitations should be considered when interpreting these findings:
\begin{itemize}
\item \textbf{Sample:} The sample was drawn from [population], which may limit generalizability to [other populations].
\item \textbf{Design:} The [cross-sectional/correlational] design precludes causal inference.
\item \textbf{Measurement:} Self-report measures may be subject to [bias type].
\end{itemize}
\end{limitations}
\section{Future Directions}
Future research should address the following questions:
\begin{enumerate}
\item Does the effect generalize to [different population/context]?
\item What mechanisms underlie the relationship between [variables]?
\item How do [moderating factors] influence the observed effects?
\end{enumerate}
% ----------------------------------------------------------------------------
% CHAPTER 5: CONCLUSIONS
% ----------------------------------------------------------------------------
\chapter{Conclusions}
\begin{executivesummary}[Conclusion]
This research investigated [topic] using [methodology] with a sample of \samplesize{500} participants. The findings demonstrate that [main conclusion]. These results have important implications for [field/practice] and suggest that [recommendation]. Future research should continue to explore [direction].
\end{executivesummary}
\section{Key Contributions}
\begin{keyfindings}[Research Contributions]
This study makes the following key contributions:
\begin{enumerate}
\item \textbf{Empirical contribution:} First demonstration of [finding] in [context].
\item \textbf{Methodological contribution:} Novel application of [method] to study [phenomenon].
\item \textbf{Practical contribution:} Evidence-based recommendations for [application].
\end{enumerate}
\end{keyfindings}
% ----------------------------------------------------------------------------
% REFERENCES
% ----------------------------------------------------------------------------
\chapter*{References}
\addcontentsline{toc}{chapter}{References}
% If using BibTeX:
% \bibliographystyle{apalike}
% \bibliography{references}
% Manual references for template demonstration:
\noindent
\hangindent=0.5in Author, A. A. (Year). Title of article. \textit{Journal Name}, \textit{Volume}(Issue), pages. https://doi.org/xxxxx
\vspace{0.5em}
\noindent
\hangindent=0.5in Author, B. B., \& Author, C. C. (Year). \textit{Title of book}. Publisher.
% ----------------------------------------------------------------------------
% APPENDICES
% ----------------------------------------------------------------------------
\appendix
\chapter{Supplementary Materials}
\appendixsection{Additional Tables}
Table~\ref{tab:appendix1} presents additional descriptive statistics not included in the main text.
\begin{table}[htbp]
\centering
\caption{Supplementary Descriptive Statistics}
\label{tab:appendix1}
\begin{tabular}{@{}lccc@{}}
\toprule
\tableheader{Variable} & \tableheader{Mean} & \tableheader{SD} & \tableheader{n} \\
\midrule
Variable A & 15.2 & 3.4 & 500 \\
\rowcolor{tablealt} Variable B & 22.8 & 5.1 & 498 \\
Variable C & 8.9 & 2.2 & 495 \\
\bottomrule
\end{tabular}
\end{table}
\appendixsection{Instruments}
Full text of instruments used in this study:
\begin{enumerate}
\item \textbf{Instrument Name 1:} [Description or full text]
\item \textbf{Instrument Name 2:} [Description or full text]
\end{enumerate}
\appendixsection{Additional Figures}
[Include any supplementary figures here]
% ============================================================================
% END DOCUMENT
% ============================================================================
\end{document}