You are now in a GitHub source code view - click this link to view Read Me file as a web page

Online Sustainable Analytical Model (SAM) JSON file interactive 3D viewer

<iframe src=https://hoarelea.github.io/sam-viewer/sam-viewer/ width=100% height=100%>Iframes are not viewable in GitHub source code view</iframe>

SAM Viewer - Touch me! Resize me!

Canonical links

We build new versions frequently. Every version are dated and always available. The following links wil always take you to the the latest or "canonical" version. So use these links for your bookmarks.

GitHub - supports a community where more than 50 million* people learn, share, and work together to build software

• https://hoarelea.github.io/sam-viewer/sam-viewer/
• https://github.com/HoareLea/sam-viewer/issues

Glitch - see the three things here: https://glitch.com/about

• https://hoarelea-sam-viewer.glitch.me/
• https://glitch.com/~hoarelea-sam-viewer

Link to first version of the viewer:

SAM Viewer v-2020-05-20

See also

• https://github.com/HoareLea/SAM

Concept

Online Hoare Lea Sustainable Analytical Model (SAM) JSON file interactive 3D viewer in your browser designed to be forked, hacked and remixed using the WebGL and the Three.js JavaScript library

To Do / Wish List

• 2020-05-26 ~ Theo ~ SAM roadmap with mission and vision
• 2020-05-26 ~ Theo ~ HL coding buddy
• 2020-05-21/24 ~ Theo ~ Fix Apertures

Issues

Things you can do using this script

• Click the Octocat icon to view or edit the source code on GitHub
• Click on title to reload
• Press Control-U/Command-Option-U to view the source code
• Press Control-Shift-J/Command-Option-J to see if the JavaScript console reports any errors

Links of Interest

Notes

• We use Calendar Versioning
  • https://en.wikipedia.org/wiki/Software_versioning#Date_of_release
  • https://calver.org/
  • https://news.ycombinator.com/item?id=21967879
• We use Trunk Based Development
  • https://trunkbaseddevelopment.com/
  • https://medium.com/@mattia.battiston/why-i-love-trunk-based-development-641fcf0b94a0
  • https://www.toptal.com/software/trunk-based-development-git-flow
• We don't compile
• Everything is hosted on GitHub pages - ie, static files only
• All scripts can work locally
• We don't use JavaScript modules - so try try to be careful about name-spacing
• We try to follow the style guide used by the principal libraries we are working with
• File names are designed to the Web
  • https://www.dummies.com/web-design-development/site-development/how-to-name-html-files/
  • https://www.thesitewizard.com/webdesign/create-good-filenames.shtml
  • https://www.surrealcms.com/blog/best-practices-for-filenames-on-the-web.html
• All versions of the scripts must always be runnable with a single click
• Our scripts run well on phone, tablet and high end workstation
• We develop around what most people mostly use: Windows 10, Chrome browser, VS Code and so on

If you like this effort

• Please give this repository a star
• Sign up to receive notices of issues

Change Log

See also change logs in readme files in individual folders

2020-05-26 ~ Theo

Done or dealt with for the most part

• 2020-05-24 ~ Theo ~ Bi-directional link between 3D model and JSON Tree View

2020-05-24 ~ Theo

Done or dealt with for the most part

• 2020-05-21 ~ Theo ~ Add colors to the panels
• 2020-05-23 ~ Theo ~ Add open file using file dialog box
• 2020-05-23 ~ Theo ~ Add tree view menu

2020-05-21 ~ Theo

• First commit to repo
• Update license to MIT
• Rename repo with web-friendly title

---

❦