Home

Welcome to the NAS6LIB wiki!

This wiki provides detailed information about NAS6LIB, including tutorials,
architecture, advanced features, and detailed technical specifications.
Its primary goal is to empower users to leverage NAS6LIB effectively
and resolve common queries independently, minimizing the need for direct support.

---

Support this project

---

Features

• Reproduces the perihelion precession of Mercury with over 99.9% accuracy
• Enables verification of relativistic effects, including 2.5PN terms

---

Operating environment (Optional)

NAS6LIB works in major browser environments.
Currently, we have confirmed that it works with the following libraries as options, although they are not required:
jQuery 3.7.1
x3dom 1.8.3
ThreeJS R177

Related files will be updated in due course.

---

• Purpose and use cases of NAS6LIB

NAS6LIB specializes in precise numerical calculations, and many of them encapsulate calculations
in the fields of 3DCG and physics calculations, making it relatively easy to write them.
Also, NAS6LIB provides timer control to realize pseudo multi-threading in JavaScript
in a single-threaded environment, and also provides a method for flexible keyboard input detection.

• Use cases

Realization of pseudo multi-threading

• N6LTimerMan makes it easy to implement multi-threading in Javascript

Customizing keyboard input

• Input Handling (Keyboard)

Solar system planetary orbit simulator
Relativity satellite orbit simulator

• Physics Simulations (Kepler & Runge-Kutta)

Expressing the water surface using Fresnel reflection

• Custom ThreeJS Shaders

---

Table of contents

---

Wiki External Links

• NAS6LIB Repository

• LICENCE.md : GPLv3.0

• README.md : Introduction

• ClassMethod.md : Class Method Reference

• AdvancedReadMe.md : In-depth information

• DeepRelativityDiscussion.md : Deep Relativity Discussion

• Zip Files Links : List of frequently updated Zip files

---

Wiki Internal Links

• Japanese version 日本語版

• Release Notes

  • NAS6LIB_2_1_1
  • NAS6LIB_2_1_2

• Study order : If you would like to see the table of contents for each learning order, please click here.

  • Project Template and Basic Tutorials : Introducing the Simple Template
    • Installation and Setup Guide
    • Minimal tutorial
    • Matrices and Vectors (Fundamental Operations)
      • N6LMatrix & N6LVector basics
        • Creation, initialization
        • Addition, subtraction, multiplication (vectors and matrices, matrices and matrices), Division (for convenience)
        • Normalization, Absolute Value
        • Inner product, cross product (Vector)
        • Transpose, inverse matrix (Matrix)
        • Coordinate transformation basics
          • Creating and applying rotation, translation, and scale matrices
          • Conversion between local and world coordinates
          • About row-major and column-major arrangement of rotation matrices
          • Homogeneous Coordinates & the bHomo Flag
          • Proof that the special arrangement of homogeneous coordinates in NAS6LIB is computationally problem-free
        • Abstraction by type identification in N6L
    • Quaternions (N6LQuaternion)
      • Quaternion basics
        • Benefits of quaternions as rotation representation (avoiding gimbal lock, etc.)
        • Creation, initialization
        • Multiplication, normalization
        • Mutual conversion with matrices (cooperation between N6LQuaternion, N6LVector and N6LMatrix)
      • Application to animation Slerp (spherical linear interpolation), etc.
      • Quaternion Spherical Interpolation Display
    • Camera and Projection
      • Simple Perspective Projection Test
        • Screen (x,y) to 3D (X,Y,Z) Coordinate Conversion (Picking)
      • View Matrix
        • Constructing the LookAt matrix
        • Camera movement and rotation
      • Projection Matrix
        • Setting Perspective Projection
        • Setting Orthographic Projection
    • Time Management with N6LTimerMan
      • Building the main thread : Mastering how to create the main thread is paramount.
      • N6LTimerMan makes it easy to implement multi-threading in Javascript
  • Mathematical and physical foundations
    • Vector
    • Matrix
    • Quaternion
    • Mathematical Appendix
      • Geometric Interpretation of Imaginary Units and Rotations
      • Relationship between vector dot product, cross product and orthogonal axes
  • N6LDate/CalendarLibrary
  • N6LBigFloatCalculator/arbitrary-precision-real-number-calculation-class
  • Physics Simulations (Kepler & Runge-Kutta)
    • Kepler Equations
    • Runge-Kutta Method
  • Integration with 3D Rendering Libraries
    • Access NAS6LIB with general placement rules
    • Coexistence with X3DOM
      • testpoly.htm
      • rottest.htm
    • Coexistence with Three.js (3JS)
      • The outline of the collaboration between NAS6LIB and Three.js
      • test3JS000.htm
      • test3js.htm
      • rottest3js.htm
  • Input Handling (Keyboard)
    • Future Implementation Idea: A Unified N6LInput System
  • Custom ThreeJS Shaders
    • TransparentShader.js
    • WaterPlane.js
  • Advanced Topics
    • Debugging Techniques for Advanced Topics
    • Programing tips
      • Synchronization solutions for asynchronous processing
      • Class templates as managed class imitations
      • Class design is based on the idea of ​​binary operators in managed classes
    • Optimization Tips
      • Use Quaternions for Faster Rotation
    • Numerical Stability Quaternion and Rounding Error Debugging
      • Quaternion Normalization and Debugging Pitfalls (SLERP Prerequisites)
      • Logarithmic Quaternion Normalization and Debugging Pitfalls (Lie Algebraic Spaces)
      • Efficient Solutions to Floating-Point Rounding Errors (Epsilon Snapping)
    • Customization
  • ■■■ FAQ ■■■
    • Q: After upgrading Three.js beyond R148
    • FAQ about modifying X3DomXXX.js
  • Polygonal approximation of pi Archimedes' and Pythagoras' Figures

---

Back to NAS6LIB Repository [Links outside the wiki]