mirror of
https://github.com/JuliaFEM/JuliaFEM.jl.git
synced 2026-08-17 02:49:04 +00:00
Jukka Aho
31d8463ef0
**Problem:** - __precompile__(false) in create_basis.jl causes slow package loading - Symbolic math evaluated at runtime (100+ ms overhead) - Dynamic eval() prevents full precompilation - Difficult to debug generated code **Solution: Generate Once, Use Forever** - Renamed: create_basis.jl → lagrange_generator.jl (tool, not runtime code) - Created: scripts/generate_lagrange_basis.jl (orchestration script) - Created: scripts/README.md (documentation for generation workflow) - Created: docs/theory/lagrange_basis_functions.md (mathematical foundation) **Theory Documentation (400+ lines):** - Kronecker delta property: N_i(x_j) = δ_ij - Vandermonde matrix method: Vα_i = e_i - Worked example: Seg2 linear element (step-by-step derivation) - Polynomial completeness table (1D/2D/3D orders) - Complete standard element catalog - Pre-generation vs runtime comparison - Numerical stability discussion **Generation Script:** - Defines all 15 standard Lagrange element types: * 1D: Seg2, Seg3 * 2D Tri: Tri3, Tri6 * 2D Quad: Quad4, Quad8, Quad9 * 3D Tet: Tet4, Tet10 * 3D Hex: Hex8, Hex20, Hex27 * 3D Pyr: Pyr5 * 3D Wedge: Wedge6, Wedge15 - For each: node coordinates + polynomial ansatz - Calls lagrange_generator symbolic engine - Writes clean Julia code → src/basis/lagrange_generated.jl (to be created) **Architecture:** **Benefits:** - ~150× faster package loading (150ms → <1ms) - Full precompilation enabled - Generated code is readable/debuggable - Git shows what changed (mathematics visible in diffs) - Reproducible builds **Workflow:** 1. Edit element catalog in scripts/generate_lagrange_basis.jl 2. Run: julia --project=. scripts/generate_lagrange_basis.jl 3. Review src/basis/lagrange_generated.jl 4. Test and commit **Next Steps:** 1. Run generation script → create lagrange_generated.jl 2. Update src/JuliaFEM.jl to include generated file 3. Comment out old lagrange_*.jl includes 4. Remove __precompile__(false) 5. Verify all tests pass 6. Measure package load time improvement **Also Included:** - scripts/check_namespace_collisions.jl (consolidation tool) - scripts/fix_vendor_element_types.py (Element type fixer) See: docs/theory/lagrange_basis_functions.md for full mathematical explanation