garywelz commited on
Commit
7ae13ad
Β·
1 Parent(s): 39ecb95

Add ProgFrame_README.md and create documentation links in UI

Browse files
Files changed (3) hide show
  1. ProgFrame_README.md +227 -0
  2. index.html +12 -0
  3. style.css +11 -0
ProgFrame_README.md ADDED
@@ -0,0 +1,227 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Genome Logic Modeling Project (GLMP)
3
+ emoji: 🧬
4
+ colorFrom: blue
5
+ colorTo: green
6
+ sdk: static
7
+ sdk_version: latest
8
+ app_file: README.md
9
+ pinned: false
10
+ ---
11
+
12
+ # 🧬 Programming Framework for Complex Systems
13
+
14
+ **A systematic visualization methodology for analyzing complex systems across biology, chemistry, physics, and computer science using computational flowcharts and standardized color coding.**
15
+
16
+ [![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
17
+ [![Hugging Face Spaces](https://img.shields.io/badge/Hugging%20Face-Spaces-orange)](https://huggingface.co/spaces/garywelz/programming_framework)
18
+
19
+ ## 🎯 Overview
20
+
21
+ The Programming Framework represents a revolutionary approach to understanding complex systems by translating them into standardized computational representations. Using Mermaid Markdown syntax and large language model (LLM) processing, we demonstrate the framework's application to representative biological and chemical systems.
22
+
23
+ **Key Insight:** Complex systems across biology, chemistry, and physics exhibit remarkable similarities in their organizational principles despite operating at vastly different scales and domains. The Programming Framework reveals these common computational patterns.
24
+
25
+ ## πŸ”¬ Methodology
26
+
27
+ The Programming Framework methodology involves systematic analysis of complex systems through the following steps:
28
+
29
+ 1. **System Identification:** Identify the biological, chemical, or physical system to be analyzed
30
+ 2. **Component Categorization:** Classify system components into the five functional categories
31
+ 3. **Flowchart Construction:** Create Mermaid flowcharts with appropriate color coding
32
+ 4. **Logic Verification:** Verify computational logic and system dynamics
33
+ 5. **Cross-Disciplinary Comparison:** Identify patterns across different domains
34
+
35
+ ## 🎨 Universal Color Coding System
36
+
37
+ Each process is represented as a computational flowchart with standardized color coding:
38
+
39
+ | Color Category | Biology | Chemistry | Computer Science | Physics | Mathematics |
40
+ |----------------|---------|-----------|------------------|---------|-------------|
41
+ | πŸ”΄ **Red** - Triggers & Inputs | Environmental signals, Nutrient availability | Reactant supply, Temperature | Input data, User commands | Energy input, Force application | Axioms, Given conditions |
42
+ | 🟑 **Yellow** - Structures & Objects | Enzymes, Receptor proteins | Catalysts, Reaction vessels | Data structures, Algorithms | Fields, Particles | Theorems, Methods |
43
+ | 🟒 **Green** - Processing & Operations | Metabolic reactions, Signal transduction | Chemical reactions, Equilibrium shifts | Algorithm execution, Data processing | Wave propagation, Quantum operations | Logical steps, Calculations |
44
+ | πŸ”΅ **Blue** - Intermediates & States | Metabolites, Signaling molecules | Reaction intermediates, Transition states | Variables, Memory states | Quantum states, Energy levels | Intermediate results, Sub-proofs |
45
+ | 🟣 **Violet** - Products & Outputs | Biomolecules, Cellular responses | Final products, Reaction yields | Program outputs, Computed results | Measured quantities, Physical phenomena | Proven theorems, Mathematical results |
46
+
47
+ **Note:** Yellow nodes use black text for optimal readability, while all other colors use white text.
48
+
49
+ ## πŸ“Š Dataset and Evidence Base
50
+
51
+ We analyzed a comprehensive dataset of biological processes spanning multiple organisms and systems:
52
+
53
+ - **110 processes** from *Saccharomyces cerevisiae* (yeast) covering DNA replication, cell cycle control, signal transduction, energy metabolism, and stress responses
54
+ - **Multiple processes** from *Escherichia coli* including DNA replication, gene regulation, central metabolism, motility, and specialized systems like the lac operon
55
+ - **Advanced systems** including photosynthesis, bacterial sporulation, circadian clocks, and viral decision switches
56
+
57
+ **Total:** 297+ processes across 36 individual collections
58
+
59
+ The complete dataset is publicly available through the [Genome Logic Modeling Project (GLMP)](https://huggingface.co/spaces/garywelz/glmp) Hugging Face Space.
60
+
61
+ ## 🌟 Representative Applications
62
+
63
+ ### Case Study: Ξ²-Galactosidase Analysis (2025)
64
+ The Ξ²-galactosidase system represents one of the most well-characterized examples of genetic regulation in molecular biology. Using modern tools and AI assistance, we can now create sophisticated and detailed visualizations that demonstrate the full computational complexity of the lac operon system.
65
+
66
+ **Key Features:**
67
+ - Environmental inputs (lactose, glucose, energy status)
68
+ - Regulatory logic gates
69
+ - Gene expression control
70
+ - Metabolic pathway integration
71
+ - Feedback control mechanisms
72
+
73
+ ### Case Study: Algorithm Execution Analysis
74
+ To demonstrate the framework's applicability to computer science, we applied the methodology to algorithm execution, specifically sorting algorithms. This example shows how the same computational logic can be applied to fundamental computer science processes.
75
+
76
+ **Key Features:**
77
+ - Input data validation
78
+ - Algorithm selection and execution
79
+ - Performance analysis
80
+ - Error handling mechanisms
81
+ - Complexity analysis
82
+
83
+ ### Case Study: Mathematical Proof Tree Analysis
84
+ To demonstrate the framework's applicability to pure mathematics, we applied the methodology to mathematical proof construction, a fundamental process in mathematical logic.
85
+
86
+ **Key Features:**
87
+ - Axiom processing
88
+ - Logical deduction steps
89
+ - Theorem application
90
+ - Proof validation
91
+ - Mathematical rigor verification
92
+
93
+ ## πŸ› οΈ Technical Foundation
94
+
95
+ The Programming Framework builds upon **Mermaid Markdown (MMD)**, a text-based diagram generation syntax developed by Knut Sveidqvist in 2014. MMD enables the creation of complex flowcharts and diagrams from simple text descriptions.
96
+
97
+ **Key Capabilities:**
98
+ - **Text-to-Diagram Conversion:** Process descriptions from scientific literature can be directly converted into visual representations
99
+ - **Standardized Syntax:** Consistent formatting across different systems and domains
100
+ - **Automated Generation:** LLMs can rapidly process text descriptions and generate MMD code
101
+ - **Cross-Platform Compatibility:** MMD integrates with documentation platforms and can be rendered in multiple formats
102
+ - **Automatic Color Coding:** Canvas automatically derives color categories from MMD syntax
103
+
104
+ ## πŸ“ˆ Historical Evolution: From 1995 to 2025
105
+
106
+ The Programming Framework represents the culmination of a 30-year evolution in computational biology visualization:
107
+
108
+ ### 1995: Manual Creation
109
+ - Months of research and reading
110
+ - Manual flowchart creation with Inspiration
111
+ - Single process analysis
112
+ - Community discussion on bionet.genome.chromosome
113
+ - Foundation for computational biology
114
+
115
+ ### 2025: AI-Assisted Analysis
116
+ - Hours of AI-assisted processing
117
+ - Automated Mermaid Markdown generation
118
+ - Systematic analysis of 297+ processes
119
+ - Cross-disciplinary pattern recognition
120
+ - Universal computational framework
121
+
122
+ ## πŸš€ Getting Started
123
+
124
+ ### Quick Start Guide
125
+
126
+ 1. **Choose Your System:** Identify a biological, chemical, or physical system to analyze
127
+ 2. **Apply the Framework:** Use the five-category color coding system
128
+ 3. **Create Flowcharts:** Generate Mermaid Markdown representations
129
+ 4. **Verify Logic:** Ensure computational logic is sound
130
+ 5. **Compare Patterns:** Look for similarities across domains
131
+
132
+ ### Sample Analysis Prompt
133
+
134
+ ```
135
+ "Analyze the [system name] using the Programming Framework methodology. Create a Mermaid Markdown file that will enable the creation in HTML of a computational flowchart showing how environmental inputs are processed through regulatory mechanisms to produce specific outputs. Use the universal color scheme: Red for triggers/inputs, Yellow for structures/catalysts, Green for processing operations, Blue for intermediates, and Violet for products. Include a discipline-specific color key beneath the flowchart."
136
+ ```
137
+
138
+ ## πŸ“š Applications
139
+
140
+ ### Biological Systems
141
+ - Gene regulation networks
142
+ - Metabolic pathways
143
+ - Signal transduction cascades
144
+ - Cell cycle control systems
145
+ - Stress response mechanisms
146
+
147
+ ### Chemical Processes
148
+ - Catalytic reactions
149
+ - Equilibrium systems
150
+ - Kinetic analysis
151
+ - Industrial processes
152
+ - Environmental chemistry
153
+
154
+ ### Physical Systems
155
+ - Quantum processes
156
+ - Thermodynamic cycles
157
+ - Wave phenomena
158
+ - Energy transfer systems
159
+ - Field interactions
160
+
161
+ ### Computer Science
162
+ - Algorithm analysis
163
+ - Data structures
164
+ - Computational complexity
165
+ - Software architecture
166
+ - System design
167
+
168
+ ### Mathematical Systems
169
+ - Proof construction
170
+ - Logical frameworks
171
+ - Theorem development
172
+ - Computational mathematics
173
+ - Formal systems
174
+
175
+ ## 🎯 Key Applications
176
+
177
+ - **Bio-inspired Computing:** Biological computational patterns can inspire revolutionary new computing paradigms
178
+ - **Synthetic Biology:** Understanding cellular programming enables the design of programmable biological systems
179
+ - **Medical Applications:** Diseases can be understood as software bugs that can be debugged and fixed
180
+ - **Evolutionary Computation:** Evolution becomes visible as a programming process that optimizes biological software
181
+
182
+ ## πŸ“– Documentation
183
+
184
+ - **[Methodology Guide](methodology/)** - Detailed step-by-step framework application
185
+ - **[Examples Gallery](examples/)** - Comprehensive collection of analyzed systems
186
+ - **[Tools & Resources](tools/)** - Templates, guidelines, and educational materials
187
+ - **[Case Studies](case-studies/)** - Deep dives into specific applications
188
+
189
+ ## 🀝 Contributing
190
+
191
+ We welcome contributions to expand the Programming Framework across new domains and applications. Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
192
+
193
+ ### How to Contribute
194
+ 1. **Submit Examples:** Share your own system analyses using the framework
195
+ 2. **Improve Documentation:** Help expand methodology guides and tutorials
196
+ 3. **Develop Tools:** Create software tools for framework application
197
+ 4. **Cross-Disciplinary Applications:** Apply the framework to new domains
198
+
199
+ ## πŸ“„ License
200
+
201
+ This project is licensed under the Creative Commons Attribution 4.0 International License - see the [LICENSE](LICENSE) file for details.
202
+
203
+ ## πŸ‘¨β€πŸ”¬ Author
204
+
205
+ **Gary Welz**
206
+ - Retired Faculty Member, John Jay College, CUNY (Department of Mathematics and Computer Science)
207
+ - Borough of Manhattan Community College, CUNY
208
+ - CUNY Graduate Center (New Media Lab)
209
+ - Email: gwelz@jjay.cuny.edu
210
+
211
+ ## πŸ”— Related Projects
212
+
213
+ - **[Genome Logic Modeling Project (GLMP)](https://huggingface.co/spaces/garywelz/glmp)** - Comprehensive biological systems analysis
214
+ - **[Programming Framework Examples](https://huggingface.co/spaces/garywelz/programming_framework_examples)** - Extended case studies and applications
215
+
216
+ ## πŸ“ž Contact
217
+
218
+ For questions, suggestions, or collaborations:
219
+ - **Email:** gwelz@jjay.cuny.edu
220
+ - **Hugging Face:** [@garywelz](https://huggingface.co/garywelz)
221
+ - **Issues:** Use the [GitHub Issues](https://github.com/garywelz/programming-framework/issues) page
222
+
223
+ ---
224
+
225
+ **The genome is indeed like a computer programβ€”not as a metaphor, but as a fundamental reality of how biological systems operate. This analysis provides the empirical evidence to support this revolutionary understanding of biological complexity.**
226
+
227
+ *We stand at the threshold of a new era in biology - one where we understand life itself as an information processing phenomenon.*
index.html CHANGED
@@ -213,6 +213,18 @@ console.log(result); // Output: krowemarF gnimmargorP</code></pre>
213
  <li>Postman - API testing</li>
214
  </ul>
215
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
216
  </div>
217
  </div>
218
  </div>
 
213
  <li>Postman - API testing</li>
214
  </ul>
215
  </div>
216
+
217
+ <div class="resource">
218
+ <h3>πŸ“– Documentation</h3>
219
+ <ul>
220
+ <li><a href="ProgFrame_README.md" target="_blank">Programming Framework README</a></li>
221
+ <li><a href="programming_framework_article.html" target="_blank">Academic Article</a></li>
222
+ <li><a href="computer_science_processes.html" target="_blank">Computer Science Examples</a></li>
223
+ <li><a href="chemistry_examples.html" target="_blank">Chemistry Examples</a></li>
224
+ <li><a href="physics_processes.html" target="_blank">Physics Examples</a></li>
225
+ <li><a href="mathematics_processes.html" target="_blank">Mathematics Examples</a></li>
226
+ </ul>
227
+ </div>
228
  </div>
229
  </div>
230
  </div>
style.css CHANGED
@@ -264,6 +264,17 @@ header p {
264
  border-bottom: none;
265
  }
266
 
 
 
 
 
 
 
 
 
 
 
 
267
  /* Responsive design */
268
  @media (max-width: 768px) {
269
  .container {
 
264
  border-bottom: none;
265
  }
266
 
267
+ .resource a {
268
+ color: #667eea;
269
+ text-decoration: none;
270
+ transition: color 0.3s ease;
271
+ }
272
+
273
+ .resource a:hover {
274
+ color: #764ba2;
275
+ text-decoration: underline;
276
+ }
277
+
278
  /* Responsive design */
279
  @media (max-width: 768px) {
280
  .container {