160 lines
5.3 KiB
Markdown
160 lines
5.3 KiB
Markdown
# Git Repository Structure for Spin-Tether Paper
|
|
## Repository: https://git.esus.name/esus/spin_paper
|
|
|
|
### Recommended Directory Structure
|
|
|
|
```
|
|
spin_paper/
|
|
├── README.md # Project overview
|
|
├── CHANGELOG.md # Version history
|
|
├── LICENSE # License information
|
|
│
|
|
├── current/ # Current version (v23)
|
|
│ ├── main_document_v23.tex # Main compilation file
|
|
│ ├── main_header_v23.tex # Title, abstract, intro
|
|
│ ├── theory_atoms_v23.tex # Core theory: atoms are balls
|
|
│ ├── philosophical_considerations_v23.tex # Quantum gravity implications
|
|
│ ├── examples_explorations_v23.tex # Applications to other scales
|
|
│ ├── observations_discussion_v23.tex # Tests and conclusions
|
|
│ ├── spin_force_refs_v23.bib # Bibliography
|
|
│ └── README_v23.md # Version 23 specific notes
|
|
│
|
|
├── scripts/ # Analysis and verification scripts
|
|
│ ├── verify_atoms_are_balls.py # Multi-atom calculations
|
|
│ ├── cluster_analysis.py # Stellar cluster analysis
|
|
│ ├── galaxy_rotation_analysis.py # Galaxy rotation curves
|
|
│ ├── spin_tether_analysis_v2.py # Scale-dependent sigma
|
|
│ ├── spin_tether_tests.py # Comprehensive tests
|
|
│ └── data-convert.py # CF4 data visualization
|
|
│
|
|
├── figures/ # Generated figures
|
|
│ ├── cluster_analysis_results.png
|
|
│ ├── milky_way_rotation.png
|
|
│ ├── dwarf_galaxy_rotation.png
|
|
│ ├── cf4_velocity_SGXSGY_quiver.png
|
|
│ └── spin_tether_test_results.png
|
|
│
|
|
├── data/ # Raw data files
|
|
│ └── cosmic_data/
|
|
│ └── CF4gp_new_64-z008_velocity.fits
|
|
│
|
|
├── archive/ # Historical versions
|
|
│ ├── v01_initial_concept/ # Original dog walk insight
|
|
│ ├── v10_unified_framework/ # First unified attempt
|
|
│ ├── v21_split_files/ # Split into modules
|
|
│ └── v22_computational_results/ # Added failures/successes
|
|
│
|
|
└── docs/ # Additional documentation
|
|
├── Development_History.md # How we got here
|
|
├── AI_Collaboration_Notes.md # ChatGPT/Claude contributions
|
|
└── Future_Directions.md # Where to go next
|
|
```
|
|
|
|
### Sample Git Commit Messages
|
|
|
|
#### Initial v23 commit:
|
|
```bash
|
|
git commit -m "feat: v23 - Atoms are Balls paradigm shift
|
|
|
|
- New title emphasizing 3D vs 2D atomic conceptualization
|
|
- Extended analysis from H to Au proving universal pattern
|
|
- Added verify_atoms_are_balls.py showing 99%+ agreement
|
|
- Repositioned as quantum gravity discovery
|
|
- Zero free parameters across periodic table
|
|
|
|
The core insight: atoms are 3D spinning balls, not 2D circles,
|
|
and this reveals electromagnetic force as quantum gravity."
|
|
```
|
|
|
|
#### For organizing files:
|
|
```bash
|
|
git commit -m "refactor: organize repository structure
|
|
|
|
- Move current version to current/ directory
|
|
- Archive previous versions in archive/
|
|
- Separate scripts, figures, and data
|
|
- Add comprehensive documentation
|
|
- Prepare for public release at git.esus.name"
|
|
```
|
|
|
|
### Version Control Best Practices
|
|
|
|
1. **Tag releases:**
|
|
```bash
|
|
git tag -a v23 -m "Version 23: Atoms are Balls"
|
|
```
|
|
|
|
2. **Branch for major changes:**
|
|
```bash
|
|
git checkout -b feature/molecular-extension
|
|
```
|
|
|
|
3. **Keep development history:**
|
|
- Archive each major version
|
|
- Document key insights and breakthroughs
|
|
- Preserve AI collaboration artifacts
|
|
|
|
### Files to Include in Initial Commit
|
|
|
|
#### Core LaTeX files (current/):
|
|
- main_document_v23.tex
|
|
- main_header_v23.tex
|
|
- theory_atoms_v23.tex
|
|
- philosophical_considerations_v23.tex
|
|
- examples_explorations_v23.tex
|
|
- observations_discussion_v23.tex
|
|
- spin_force_refs_v23.bib
|
|
|
|
#### Essential scripts (scripts/):
|
|
- verify_atoms_are_balls.py (NEW - proves the concept)
|
|
- cluster_analysis.py
|
|
- galaxy_rotation_analysis.py
|
|
- spin_tether_analysis_v2.py
|
|
|
|
#### Documentation (root):
|
|
- README.md (main project description)
|
|
- README_v23.md (version specific)
|
|
- CHANGELOG.md (version history)
|
|
|
|
### .gitignore suggestions
|
|
```
|
|
# LaTeX auxiliary files
|
|
*.aux
|
|
*.log
|
|
*.out
|
|
*.toc
|
|
*.bbl
|
|
*.blg
|
|
*.synctex.gz
|
|
|
|
# Python
|
|
__pycache__/
|
|
*.pyc
|
|
.ipynb_checkpoints/
|
|
|
|
# OS files
|
|
.DS_Store
|
|
Thumbs.db
|
|
|
|
# Editor files
|
|
*.swp
|
|
*~
|
|
.vscode/
|
|
|
|
# Output files (regeneratable)
|
|
*.pdf
|
|
# But maybe keep final versions:
|
|
# !current/main_document_v23.pdf
|
|
```
|
|
|
|
### Repository Description
|
|
|
|
**Spin-Tether Paper: Atoms are Balls**
|
|
|
|
A novel framework showing that atoms are 3D spinning spheres (balls), not 2D mathematical abstractions. This simple reconceptualization reveals electromagnetic force as quantum gravity at the atomic scale. From a dog walk to unified forces - the journey of an accidental discovery.
|
|
|
|
Key result: Coulomb force emerges from 3D rotation with 99%+ accuracy across the periodic table (H to Au) using zero free parameters.
|
|
|
|
### Collaboration Notes
|
|
|
|
This repository preserves the development history including extensive AI collaboration with ChatGPT-4 and Claude Opus 4, showing how human intuition combined with AI formalization can lead to new scientific insights. |