GithubHelp home page GithubHelp logo

blueprints-org / blueprints Goto Github PK

View Code? Open in Web Editor NEW
12.0 2.0 2.0 3.91 MB

Blueprints, open source python package for civil engineering calculations.

Home Page: https://blueprints.readthedocs.io

License: GNU Lesser General Public License v2.1

Python 100.00%
civil-engineering concrete digital-engineering eurocode python steel

blueprints's Introduction

Run Tests Read the Docs codecov PyPI GitHub Python versions

blueprints banner

Can someone explain to me why Eurocode is not publicly available in code and that all of us are coding Eurocode with massive maintenance costs and shortages in technical personnel? Well, no longer!

Welcome to Blueprints, the cornerstone repository for civil engineering professionals and enthusiasts alike!

Blueprints is a collaboration of several engineering companies which contains programmable Eurocode information such as tables, figures and formulas. It also provides materials, geometry and even section checks. The basis as well as the implemented use cases provide all key necessities for the civil engineer.

Mission

Our mission is to:

  • Offer a robust suite of tools and libraries that encapsulate common and advanced engineering tasks.
  • Foster a community where sharing knowledge and best practices is the norm, not the exception.
  • Provide a solid foundation of code and documentation that adheres to the highest quality standards (100% code coverage).

Installation

For the last release:

pip install blue-prints

For the actively developed version:

pip install git+https://github.com/Blueprints-org/blueprints.git

Read the docs!

Documentation is available at blueprints.readthedocs.io.

Quick Reference to Blueprint's Objects

This table serves as a quick navigator to the key elements of the code within Blueprints, offering immediate links to its formulas, tables, and figures for streamlined access and reference.

Document Description Formulas Tables Figures
NEN-EN 1992-1-1+C2:2011 Eurocode 2: Design of concrete structures – Part 1-1: General rules and rules for buildings (code) 304 38 104
NEN-EN 1993-1-1+C2+A1:2016 Eurocode 3: Design of steel structures – Part 1-1: General rules and rules for buildings (code) 108 20 28
NEN 9997-1+C2:2017 Eurocode 7: Geotechnical design of structures - Part 1: General rules (code) 88 11 25
NEN-EN 1993-5:2008 Eurocode 3: Design of steel structures – Part 5: Piling (code) 63 0 0

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Blueprints is free and open source software. Distributed under the terms of the LGPL-2.1 license.

Support

If you have found a bug 🐛, or have a feature request ✨, raise an issue on the GitHub issue tracker. Alternatively you can get support on the discussions page.

Disclaimer

Blueprints is an open source engineering tool that continues to benefit from the collaboration of many contributors. Although efforts have been made to ensure the that relevant engineering theories have been correctly implemented, it remains the user's responsibility to confirm and accept the output. Refer to the license for clarification of the conditions of use.

By using the Blueprints package, you are agreeing to the following:

  1. Usage Risk: The usage (i.e. downloading, installing, running, modifying the code, or some or all of the above) of Blueprints is entirely at your own risk as a user and/or contributor. All maintainers and contributors to Blueprints are not responsible for and cannot be held responsible or liable for any direct or indirect damages, injuries, death, faults, mistakes, or omissions that result from the usage of the package.

  2. Adherence to Laws and Regulations: At all times, the user is fully responsible for the adherence to (local) laws and regulations. It is the user's responsibility to ensure that their use of Blueprints complies with all relevant legal and regulatory requirements.

  3. Outdated Results: Results may be outdated due to circumstances, changes in rules and regulations, and/or changes in the Eurocodes and/or national annexes. Users should always verify the results and not solely rely on the output from the Blueprints package.

  4. Agreement to Terms: When using Blueprints, you agree to the terms and conditions of the license and this disclaimer. If you do not agree with these terms, please do not use the Blueprints package.

  5. Warrenties: The Blueprins package is provided as is without any warrenties of any kind, either expressed or implied.

Please note that this disclaimer is intended to be as broad and inclusive as permitted by the law of the jurisdiction in which you reside. If any portion of this disclaimer is held invalid, the remainder shall continue in full legal force and effect.

blueprints's People

Contributors

bro-wi avatar dependabot[bot] avatar egarciamendez avatar gerjandorgelo avatar johan-tuls-bam avatar klaassicking avatar lbsmulders avatar maartenbw avatar petervwestrienen avatar simone-de-rijke avatar szeltaat avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

blueprints's Issues

[✨ Feature request]: Add formula 8.6 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.6 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 8.6
Unittesting
Complete docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: From 1992-1-1+C2 2011 add formula 4.1 and 4.2

Title

Add the EC formulas 4.1 and 4.2 of 1992-1-1+C2 2011: Concrete cover

Description

Formulas to calculate the nominal concrete cover

Acceptance Criteria

Formula 4.1
Formula 4.2

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 9.16 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 9.16 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 9.16
Unitesting
Complete docstrings
Check reference in README
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 2.1a from NEN 9997-1+C2:2017

Description

Add formula 2.1a from NEN 9997-1+C2:2017

Acceptance Criteria

  • Formula 2.1a
  • Full docstring
  • Unit test
  • Integration test with 2.1b

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Refactor every formula class to its own file

Description

Every formula gets its own python file

Acceptance Criteria

All existing formulas in main refactored to it's own file

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add a validations modules to Blueprints

Description

Currently all logic to validate formulas is written inside Formula._valuate. We want to separate logic in a separate module puerely for that purpose.

Acceptance Criteria

  • separate validations module

Dependencies

None

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: From 1992-1-1+C2:2011 add formulas 3.11 - 3.14

Title

Add the EC formulas 3.11 - 3.14 of 1992-1-1+C2:2011 chapter 3 materials

Description

Formulas 3.11 - 3.14

Acceptance Criteria

Formula 3.11
Formula 3.12
Formula 3.13
Formula 3.14

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.9 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.9 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 8.9
Unittesting
Docstrings

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formulas from section 3.1.7 (Formulas 3.17 - 3.22)

Description

Adds all the formulas from section 3.1.7 of 1992-1-1+C2:2011

Acceptance Criteria

Formula 3.17
Formula 3.18
Formula 3.19
Formula 3.20
Formula 3.21
Formula 3.22

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.3 from NEN-EN-1992-1-1+C2:2011

Description

Add formula 8.3 from NEN-EN-1992-1-1+C2:2011

Acceptance Criteria

Formula 8.3
Unitesting
Complete docstrings
Check reference in README
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.17 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.17 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 8.17
Unit Test
Integration test with 8.16
Full docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.12 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.12 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Add formula
Add unittest
Add complete docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.15 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.15 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula
Unittesting
Complete docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 5.2 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 5.2 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 5.2
Unitesting
Complete docstrings
Check reference in README

Dependencies

None

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: From 1992-1-1+C2 2011 add formula 7.3

Title

Add the EC formula 7.3 of 1992-1-1+C2 2011: kc coefficient

Description

Calculate the formula 7.3 for the coefficient kc for flanges of tubular cross-sections and T-sections

Acceptance Criteria

  • Formula 7.3
  • Unitesting
  • Complete docstrings
  • Check reference in README

Dependencies

None, pure python.

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.14 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.14 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Add formula
Add unittesting
Add complete docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Formula 6.1 of 1922-1-1

Description

Formula based on:
image

Acceptance Criteria

  • The summation of al shear resitances should add up to the design resistance.

Dependencies

N/A

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add from NEN-EN 1992-1-1+C2:2011 formula 3.1 and 3.2

Title

Add from NEN-EN 1992-1-1+C2:2011 formula 3.1 and 3.2: Approximation Concrete Compressive Strength

Description

Formulas to calculate the approximation of the concrete compressive strength over time with average temperature 20C

Acceptance Criteria

Formula 3.1
Formula 3.2

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula from section 3.1.8 (Formula 3.23)

Description

Add all the formulas from section 3.1.8 of 1992-1-1+C2:2011

Acceptance Criteria

Formula 3.23

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add a formula 8.7 from NEN-EN 1992-1-1+C2:2011

Description

Add a formula 8.7 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 8.8
Unitesting
Complete docstrings

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formulas from section 9.2 (Formulas 9.1N-9.8N)

Description

Add formulas from chapter 9.2 from EC 1992-1-1+C2:2011

Acceptance Criteria

Formula 9.1N
image
Formula 9.2
image
Formula 9.3
image
Formula 9.4
Formula 9.5N
image
Formula 9.6N
image
Formula 9.7N
image
Formula 9.8N
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.4 from NEN-EN-1992-1-1+C2:2011

Description

Add formula 8.4 from NEN-EN-1992-1-1+C2:2011

Acceptance Criteria

Formula 8.4
Unitesting
Complete docstrings
Check reference in README

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add Equation ABC

Title

Add a ABC class for Equations

Description

ABC cparent class for all Equations in Blueprints

Acceptance Criteria

methods:

  • result
  • equation number
  • source document

Dependencies

None

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 9.15 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 9.15 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 9.15
Unitesting
Complete docstrings
Check reference in README
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 2.1b from NEN 9997-1+C2:2017

Description

Add formula 2.1b from NEN 9997-1+C2:2017

Acceptance Criteria

-Formula 2.1b
-Full docstring
-Unit test

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.11 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.11 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 8.11
Unittesting
Docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formulas from section 3.1.9 (Formulas 3.24 - 3.27)

Description

Add all the formulas from section 3.1.9 of 1992-1-1+C2:2011

Acceptance Criteria

Formula 3.24
Formula 3.25
Formula 3.26
Formula 3.27

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 5.3a from NEN-EN 1992-1-1+C2:201

Description

Add formula 5.3a from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 5.3a
Unittesting
Complete docstring

Dependencies

None

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[❓ Question]: How to implement inequalities like (9.11) from NEN-EN 1992-1-1+C2:2011

Preliminary Checks

  • I have read the project documentation.
  • I have searched the issue tracker for similar questions.

What Have You Tried?

I tried implementing formula 9.11 from NEN-EN 1992-1-1+C2:2011, however I don't know what would be the best way to implement this formula for blueprints.

Question Description

Formula 9.11 is given as an inequality:
image

My own interpretation would be to re-write this inequality in the form A_sw,min=...., but that would not match EC exactly. There are multiple inequalities such as this one in EC e.g. 4.3N and 4.4N are also inequalities. It might be a good idea to think about a way to generally handle these formulas.

Relevant Code or Steps

No response

Confirmation

  • I have checked that this question does not already exist in the issue tracker or documentation.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add from NEN-EN 1992-1-1+C2:2011 formula 3.3 till 3.10

Title

Adds all formulas from 3.3 till 3.10

Description

All formulas up to and including formula 3.10

Acceptance Criteria

Formula 3.3
Formula 3.4
Formula 3.5
Formula 3.6
Formula 3.7
Formula 3.8
Formula 3.9
Formula 3.10

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.16 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.16 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 8.16
Unittesting
Complete docstring

Dependencies

None

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.8 from NEN-EN-1992-1-1+C2:2011

Description

Add formula 8.8 from NEN-EN-1992-1-1+C2:2011

Acceptance Criteria

Formula 8.8
Unitesting
Complete docstrings
Check reference in README

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.13 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.13 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Add formula
Add unittest
Add docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.2 from NEN-EN-1992-1-1+C2:2011

Description

Add formula 8.2 from NEN-EN-1992-1-1+C2:2011

Acceptance Criteria

Formula 8.2
Unitesting
Complete docstrings
Check reference in README
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add a latex to formula 9.1N

Description

Add a latex to formula 9.1N

Acceptance Criteria

-Latex formula 9.1N

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: From 1992-1-1+C2:2011 add formulas 3.15 and 3.16

Description

Add the formulas 3.15 and 3.16 from 1992-1-1+C2:2011 (formulas from section 3.1.6)

Acceptance Criteria

Formula 3.15 including its tests
Formula 3.16 including its tests

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.1 from NEN-EN-1992-1-1+C2:2011

Description

Add formula 8.1 from NEN-EN-1992-1-1+C2:2011

Acceptance Criteria

Formula 8.1
Unitesting
Complete docstrings
Check reference in README
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.18 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 8.18 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Add formula 8.18
Add unit test
add docstring
add integration with 8.16

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 2.2 from NEN-EN 1993-1-1+C2+A1:2016

Description

Add formula 2.2 from NEN-EN 1993-1-1+C2+A1:2016

Acceptance Criteria

Add formula 2.2
Add unit test
add docstring

Dependencies

None

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Latex representation of formula

Description

Each formula will, for traceability and verifiability purposes, need someway to represent itself.

Acceptance Criteria

  • It should give a Latex representation of the Symbol = Original formula = Numeric formula = Result
  • Symbel only
  • Formula symbolic
  • Formula Numeric
  • Result
  • Adjust decimals

(Nice to have's ? )

  • Show Units for the result only
  • Show Units for each argument
  • Avoid defining logic in different places, this should be the responsibility of the _evaluate method

Dependencies

Python only, however Latex syntax. So in the future adapters could be written from Latex --> external packages.

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 9.14 from NEN-EN 1992-1-1+C2:2011

Description

Add formula 9.14 from NEN-EN 1992-1-1+C2:2011

Acceptance Criteria

Formula 9.14
Unitesting
Complete docstrings
Check reference in README
image

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 8.10 from NEN-EN 19992-1-1+C2:2011

Description

Add formula 8.10 from NEN-EN 19992-1-1+C2:2011

Acceptance Criteria

Add formula 8.10
Add unittesting
Add complete docstring

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[✨ Feature request]: Add formula 5.1 from NEN-EN 1992-1-1+C2:2011

Title

Add formula 5.1 from NEN-EN 1992-1-1+C2:2011

Description

Calculate the formula 5.1 -> θi

Acceptance Criteria

Formula 5.1
Unitesting
Complete docstrings
Check reference in README

Dependencies

No response

Confirmation

  • I have checked that this feature does not already exist in the issue tracker.
  • I have read and understood the contribution guidelines.

[❓ Question]: Convention for formula names differs from meeting 20231113

Preliminary Checks

  • I have read the project documentation.
  • I have searched the issue tracker for similar questions.

What Have You Tried?

Just read through Python file chapter_7_servicability_limit_state.py

Question Description

Python file chapter_7_servicability_limit_state.py has got a class formule name of Form7Dot3CoefficientKc instead of EQ_7_3_coefficient_Kc .

I am unsure if there was a reason in the mean time that it changed.

Just asking to make sure the Form7Dot3CoefficientKc was a deliberate notation.

Relevant Code or Steps

No response

Confirmation

  • I have checked that this question does not already exist in the issue tracker or documentation.
  • I have read and understood the contribution guidelines.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.