structuraid_core 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b01de831b96f114f85f1e9b0942bb793140c50425a564bad135ce06cb2b56554
-  data.tar.gz: 8bf897de647fe493060877279819266f495ee72cbaa843d815d588c7b8346932
+  metadata.gz: e6a3c25bdfad6f0af2c266ad01cf0321e74780e4366a9a0b941e37c108f6d152
+  data.tar.gz: 60afe6f91b70f5acd7ac3d12b1e0c33282afed9620f2c55ee2c29ada6fe3295f
 SHA512:
-  metadata.gz: c4804e1b46845546e655da89afb6a5f37909226001645ce0117b2a6cc4bb29992a818c900541eb7e9bd49934feeb208eabf1519c344fac24e481b6a65a995d34
-  data.tar.gz: 5498aca686ae447b04c983aca955e3008de5e83f8c63105001ec7ceb59858bf3904c91e71d88ba2d15847efa7a29408204ac75caaf92e9b66c7781153f1feac7
+  metadata.gz: fc6983c21cb7278bb90e9b2b3d4a68e6c873e1fd7de57205724344385200e4674c05fceb61c02342a4329c5ce1515636c614ec8c55d5dba6952f08cd595a309b
+  data.tar.gz: da91f2acb4102987f40c8d05b314727349782e0ac170859423460e131aa6b5793c4761066c583b0c6836d1db0392f47b574911faf75368fef61ebf4b4485497e

data/.rubocop.yml

@@ -25,6 +25,12 @@ RSpec/MultipleMemoizedHelpers:
 RSpec/NestedGroups:
   Enabled: false
 
+RSpec/ContainExactly:
+  Enabled: false
+
+RSpec/MatchArray:
+  Enabled: false
+
 Lint/MissingSuper:
   Enabled: false
 

data/lib/structuraid_core/design_codes/aci_318_19/rc/footings/min_height.rb

@@ -0,0 +1,27 @@
+module StructuraidCore
+  module DesignCodes
+    module ACI31819
+      module RC
+        module Footings
+          class MinHeight
+            include DesignCodes::Utils::CodeRequirement
+            use_schema DesignCodes::Schemas::RC::Footings::MinHeightSchema
+
+            MIN_HEIGHT = 150
+            CODE_REFERENCE = 'ACI 318-19 13.3.1.2'.freeze
+
+            def call
+              return true if bottom_rebar_effective_height >= MIN_HEIGHT
+
+              raise RequirementNotFulfilledError.new(
+                :min_height,
+                "Effective Height #{bottom_rebar_effective_height} is below #{MIN_HEIGHT} mininmum",
+                CODE_REFERENCE
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/structuraid_core/design_codes/nsr_10/rc/footings/min_height.rb

@@ -0,0 +1,38 @@
+module StructuraidCore
+  module DesignCodes
+    module NSR10
+      module RC
+        module Footings
+          class MinHeight
+            include DesignCodes::Utils::CodeRequirement
+            use_schema DesignCodes::Schemas::RC::Footings::MinHeightSchema
+
+            MIN_HEIGHT_MAPPINGS = {
+              over_soil: 150,
+              over_piles: 300
+            }.freeze
+
+            CODE_REFERENCE = 'NSR-10 C.15.7'.freeze
+
+            def call
+              support_type = params.support_type || :over_soil
+              unless MIN_HEIGHT_MAPPINGS.keys.include?(support_type)
+                raise UnrecognizedValueError.new(:support_type, support_type)
+              end
+
+              min_height = MIN_HEIGHT_MAPPINGS[support_type]
+
+              return true if bottom_rebar_effective_height >= min_height
+
+              raise RequirementNotFulfilledError.new(
+                :min_height,
+                "Height #{bottom_rebar_effective_height} is below #{min_height} mininmum",
+                CODE_REFERENCE
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/structuraid_core/design_codes/schemas/rc/footings/min_height_schema.rb

@@ -0,0 +1,16 @@
+module StructuraidCore
+  module DesignCodes
+    module Schemas
+      module RC
+        module Footings
+          class MinHeightSchema
+            include DesignCodes::Utils::SchemaDefinition
+
+            required_params %i[bottom_rebar_effective_height]
+            optional_params %i[support_type]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/structuraid_core/elements/reinforcement/straight_longitudinal_layer.rb

@@ -1,3 +1,5 @@
+require 'matrix'
+
 module StructuraidCore
   module Elements
     module Reinforcement
@@ -44,7 +46,13 @@ module StructuraidCore
           offset ||= 0.5 * diameter
 
           [@start_location, @end_location].each do |location|
-            location.value_3 = above_middle ? location.value_3 - offset : location.value_3 + offset
+            location.update_from_vector(
+              Vector[
+                location.value_1,
+                location.value_2,
+                above_middle ? location.value_3 - offset : location.value_3 + offset
+              ]
+            )
           end
         end
 
@@ -67,9 +75,9 @@ module StructuraidCore
         def length
           vector = length_vector
 
-          vector.value_x = 0 if @distribution_direction == :length_1
-          vector.value_y = 0 if @distribution_direction == :length_2
-          vector.value_z = 0 if @distribution_direction == :length_3
+          vector[0] = 0 if @distribution_direction == :length_1
+          vector[1] = 0 if @distribution_direction == :length_2
+          vector[2] = 0 if @distribution_direction == :length_3
 
           vector.magnitude
         end
@@ -77,11 +85,11 @@ module StructuraidCore
         private
 
         def length_vector
-          Engineering::Vector.new(
-            value_x: @end_location.value_1 - @start_location.value_1,
-            value_y: @end_location.value_2 - @start_location.value_2,
-            value_z: @end_location.value_3 - @start_location.value_3
-          )
+          Vector[
+            @end_location.value_1 - @start_location.value_1,
+            @end_location.value_2 - @start_location.value_2,
+            @end_location.value_3 - @start_location.value_3
+          ]
         end
       end
     end

data/lib/structuraid_core/engineering/analysis/footing/centric_isolated.rb

@@ -7,7 +7,10 @@ module StructuraidCore
 
           def initialize(footing:, load_from_column:, section_direction:)
             if ORTHOGONALITIES.none?(section_direction)
-              raise Engineering::Analysis::SectionDirectionError.new(section_direction, ORTHOGONALITIES)
+              raise Engineering::Analysis::SectionDirectionError.new(
+                section_direction,
+                ORTHOGONALITIES
+              )
             end
 
             @footing = footing

data/lib/structuraid_core/engineering/base.rb

@@ -5,6 +5,5 @@ module StructuraidCore
   end
 end
 
-require_relative 'vector'
 require_relative 'analysis/footing/centric_isolated'
 require_relative 'locations/base'

data/lib/structuraid_core/engineering/locations/absolute.rb

@@ -1,8 +1,10 @@
+require 'matrix'
+
 module StructuraidCore
   module Engineering
     module Locations
       class Absolute < Base
-        attr_accessor :value_x, :value_y, :value_z
+        attr_reader :value_x, :value_y, :value_z
 
         def initialize(value_x:, value_y:, value_z:)
           @value_x = value_x.to_f
@@ -10,8 +12,14 @@ module StructuraidCore
           @value_z = value_z.to_f
         end
 
-        def to_a
-          [@value_x, @value_y, @value_z]
+        def to_matrix
+          Matrix.column_vector(
+            [
+              value_x,
+              value_y,
+              value_z
+            ]
+          )
         end
       end
     end

data/lib/structuraid_core/engineering/locations/base.rb

@@ -9,3 +9,4 @@ end
 
 require_relative 'absolute'
 require_relative 'relative'
+require_relative 'coordinates_system'

data/lib/structuraid_core/engineering/locations/coordinates_system.rb

@@ -0,0 +1,60 @@
+require 'matrix'
+
+module StructuraidCore
+  module Engineering
+    module Locations
+      class CoordinatesSystem < Base
+        attr_reader :relative_locations, :axis_1
+
+        def initialize(anchor_location:, relative_locations: [])
+          @anchor_location = anchor_location
+          @relative_locations = relative_locations
+          @axis_1 = Vector[1.0, 0.0, 0.0]
+          @axis_3 = Vector[0.0, 0.0, 1.0]
+        end
+
+        def align_axis_1_with(vector:)
+          relative_locations.each { |relative_location| rotate_axes(relative_location, theta(vector)) }
+          @axis_1 = vector.normalize
+        end
+
+        def add_location(relative_location)
+          relative_locations << relative_location
+        end
+
+        def axis_2
+          axis_3.cross_product axis_1
+        end
+
+        private
+
+        attr_reader :axis_3
+
+        def theta(vector)
+          unitary_vector = vector.normalize
+          return Math.acos(axis_1.inner_product(unitary_vector)) if axis_1.cross_product(unitary_vector)[2].zero?
+
+          Math.asin(axis_1.cross_product(unitary_vector)[2])
+        end
+
+        def rotate_axes(relative_location, theta)
+          transformed = rotation_matrix(theta) * relative_location.to_matrix
+          transformed_vector = Vector[
+            transformed[0, 0],
+            transformed[1, 0],
+            transformed[2, 0]
+          ]
+          relative_location.update_from_vector(transformed_vector)
+        end
+
+        def rotation_matrix(theta)
+          Matrix[
+            [Math.cos(theta), Math.sin(theta), 0.0],
+            [-Math.sin(theta), Math.cos(theta), 0.0],
+            [0.0, 0.0, 1.0]
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/structuraid_core/engineering/locations/relative.rb

@@ -1,14 +1,44 @@
+require 'matrix'
+
 module StructuraidCore
   module Engineering
     module Locations
       class Relative < Base
-        attr_accessor :value_1, :value_2, :value_3
+        attr_reader :value_1, :value_2, :value_3
+
+        def self.from_matrix(matrix)
+          new(
+            value_1: matrix[0, 0],
+            value_2: matrix[1, 0],
+            value_3: matrix[2, 0]
+          )
+        end
 
         def initialize(value_1:, value_2:, value_3:)
           @value_1 = value_1.to_f
           @value_2 = value_2.to_f
           @value_3 = value_3.to_f
         end
+
+        def to_matrix
+          Matrix.column_vector(
+            [
+              value_1,
+              value_2,
+              value_3
+            ]
+          )
+        end
+
+        def update_from_vector(vector)
+          @value_1 = vector[0]
+          @value_2 = vector[1]
+          @value_3 = vector[2]
+        end
+
+        def to_vector
+          Vector[value_1, value_2, value_3]
+        end
       end
     end
   end

data/lib/structuraid_core/errors/design_codes/requirement_not_fulfilled_error.rb

@@ -0,0 +1,15 @@
+module StructuraidCore
+  module DesignCodes
+    class RequirementNotFulfilledError < StandardError
+      attr_reader :requirement, :message, :code_reference
+
+      def initialize(requirement, message, code_reference)
+        @requirement = requirement
+        @message = message
+        @code_reference = code_reference
+
+        super(message)
+      end
+    end
+  end
+end

data/lib/structuraid_core/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StructuraidCore
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: structuraid_core
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Pradaing
@@ -94,6 +94,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.22.0
+- !ruby/object:Gem::Dependency
+  name: matrix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -144,13 +158,16 @@ files:
 - lib/structuraid_core/db/base.rb
 - lib/structuraid_core/db/rebars.yml
 - lib/structuraid_core/design_codes/aci_318_19/rc/elastic_modulus.rb
+- lib/structuraid_core/design_codes/aci_318_19/rc/footings/min_height.rb
 - lib/structuraid_core/design_codes/aci_318_19/rc/footings/punching_shear_capacity.rb
 - lib/structuraid_core/design_codes/base.rb
 - lib/structuraid_core/design_codes/nsr_10/rc/elastic_modulus.rb
+- lib/structuraid_core/design_codes/nsr_10/rc/footings/min_height.rb
 - lib/structuraid_core/design_codes/nsr_10/rc/footings/punching_shear_capacity.rb
 - lib/structuraid_core/design_codes/resolver.rb
 - lib/structuraid_core/design_codes/schemas/empty_schema.rb
 - lib/structuraid_core/design_codes/schemas/rc/elastic_modulus_schema.rb
+- lib/structuraid_core/design_codes/schemas/rc/footings/min_height_schema.rb
 - lib/structuraid_core/design_codes/schemas/rc/footings/punching_shear_capacity_schema.rb
 - lib/structuraid_core/design_codes/utils/code_requirement.rb
 - lib/structuraid_core/design_codes/utils/schema_definition.rb
@@ -168,10 +185,11 @@ files:
 - lib/structuraid_core/engineering/base.rb
 - lib/structuraid_core/engineering/locations/absolute.rb
 - lib/structuraid_core/engineering/locations/base.rb
+- lib/structuraid_core/engineering/locations/coordinates_system.rb
 - lib/structuraid_core/engineering/locations/relative.rb
-- lib/structuraid_core/engineering/vector.rb
 - lib/structuraid_core/errors/base.rb
 - lib/structuraid_core/errors/design_codes/missing_param_error.rb
+- lib/structuraid_core/errors/design_codes/requirement_not_fulfilled_error.rb
 - lib/structuraid_core/errors/design_codes/unknown_design_code_error.rb
 - lib/structuraid_core/errors/design_codes/unrecognized_value_error.rb
 - lib/structuraid_core/errors/engineering/analysis/section_direction_error.rb

data/lib/structuraid_core/engineering/vector.rb

@@ -1,35 +0,0 @@
-module StructuraidCore
-  module Engineering
-    class Vector < Base
-      attr_accessor :value_x, :value_y, :value_z
-
-      def self.with_value(value:, direction:)
-        new(
-          value_x: value.to_f * direction[0],
-          value_y: value.to_f * direction[1],
-          value_z: value.to_f * direction[2]
-        )
-      end
-
-      def initialize(value_x:, value_y:, value_z:)
-        @value_x = value_x.to_f
-        @value_y = value_y.to_f
-        @value_z = value_z.to_f
-      end
-
-      def magnitude
-        Math.sqrt(value_x**2 + value_y**2 + value_z**2)
-      end
-
-      def direction
-        vector_magnitude = magnitude
-
-        [
-          @value_x / vector_magnitude,
-          @value_y / vector_magnitude,
-          @value_z / vector_magnitude
-        ]
-      end
-    end
-  end
-end