Manual 1 PS

• If you would like to contribute ideas to this pamphlet please contact me at lamalcz@sandia.gov.
• Table of Figures
  • Why
  • Precedent
  • Advantages
• Color and Naming and Capitalization - Oh, My!
  • Naming Conventions
  • Colors
  • Testing and temporary variables
• Units
  • System Units
  • Custom and Atomic Units
• Arrays, Ranges and Range Names
  • Advantages
  • Style
  • Pitfalls
• Modularity or Partitioning: Art and Science
  • Coupling
  • Cohesion
  • Practical Issues
  • Naming Constructor Diagrams
• Data
  • Potential data problems
• Coding Style
  • Indent at Operators
  • Indent at ()
  • General code layout and indentation
  • Align Arrays
  • Layout
  • Shortcut variables
  • Documentation
• Coding Pitfalls
  • DIVZ0
  • Equation complexity
• Techniques
  • Getting started on a model
  • Data Considerations
    • Input
    • Output
  • Model naming
• Interface Design
• Source Code Analysis – What Can Be Done?
  • Are there undefined or problematic variables?
  • Does every variable have a well defined unit assigned to it?
  • Does the model follow ‘standard’ naming conventions?
  • Does the model contain embedded constants?
  • Are stocks initialized internally with other than non-zero values?
  • Are Links marked with # (indicating they are not used in the variable they connect to)
  • Is every variable used by another variable? If not, why not?
  • Do variables exist in the Equations View and not on any of the model sheets?
  • Units Checking
  • Using the Find and Go to Variable Tools
  • Automatic Errors and Warnings – Executable Code at Every Stopping Point
  • Checklists
• Summary and Conclusion
• Appendix A: Assigning Constructor Diagram Names (sheet names) to Variables
• Appendix B: Creating ranges names from external data files
• Appendix C: Model Construction Checklist
• Appendix D: Model Analysis Checklist
• References