NaxToPy 2.2.3__tar.gz → 3.1.0__tar.gz

{naxtopy-2.2.3/src/NaxToPy.egg-info → naxtopy-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: NaxToPy
-Version: 2.2.3
+Version: 3.1.0
 Summary: Package for postprocessing FEM results in Python
 Home-page: https://www.idaerosolutions.com/Home/NaxToPy
 Download-URL: https://apps.microsoft.com/detail/XP9MMH0KDKGRJN?hl=en-US&gl=US
@@ -107,7 +107,7 @@ License: Copyright (c) 2024 Idaero Solutions
         
         The above copyright notice and this permission notice shall be included in all
         copies or substantial portions of the Software.
-Project-URL: Documentation, https://www.idaerosolutions.com/NaxToPyDoc/index.html
+Project-URL: Documentation, https://www.idaerosolutions.com/NaxToDocumentation/NaxToPy/3.1.0/index.html
 Project-URL: LinkedIn, https://www.linkedin.com/company/idaero/
 Keywords: NaxTo,Postprocessing,FEM
 Classifier: Intended Audience :: Science/Research
@@ -124,10 +124,11 @@ Requires-Dist: setuptools>=67.8.0
 Requires-Dist: h5py>=3.12.1
 Dynamic: download-url
 Dynamic: home-page
+Dynamic: license-file
 
 [![Idaero](https://img.shields.io/badge/powered%20by-Idaero%20Solutions-299797)](https://idaerosolutions.com)
 [![PyPi](https://img.shields.io/pypi/v/NaxToPy?color=ffd500)](https://pypi.org/project/NaxToPy/)
-[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-00699d)](https://www.python.org/downloads/)
+[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-00699d)](https://www.python.org/downloads/)
 ![License](https://img.shields.io/badge/license-proprietary-red)
 [![MicrosoftStore](https://img.shields.io/badge/Microsoft%20Store-NaxTo-blue?logo=microsoftstore&logoColor=blue&labelColor=lightgrey)](https://apps.microsoft.com/detail/XP9MMH0KDKGRJN?hl=en-US&gl=US)
 [![PyPi - Downloads](https://img.shields.io/pypi/dm/NaxToPy?color=dgreen)](https://pypi.org/project/NaxToPy/#files)
@@ -151,10 +152,10 @@ additional software beyond NaxTo (see the Download and Homepage links on the lef
 ---------------
 
 ⚠️**Warning:** To use NaxToPy, [**NaxTo**](https://apps.microsoft.com/detail/XP9MMH0KDKGRJN?hl=en-US&gl=US) must be installed.
-This version is compatible with **NaxTo 2024.3**. It is compatible with all the steps of this version (2024.3.0, 2024.3.1).
+This version is compatible with **NaxTo 2025.1**. 
 Check in _Programs and Features_ the NaxTo version that is installed.
 
-📘**Note:** If a specific NaxTo version is installed, search the [**NaxToPy History**](https://pypi.org/project/NaxToPy/2.2.1/#history) to find which newer version is compatible with it.
+📘**Note:** If a specific NaxTo version is installed, search the [**NaxToPy History**](https://pypi.org/project/NaxToPy/3.1.0/#history) to find which newer version is compatible with it.
 
 
 ## Installation
@@ -327,12 +328,36 @@ is redundant. The coordinate system will prevail.
 8. BugFix: The method get_elements_attached() is fixed so when there are MPC connectors with the same ID.
 
 ### v.2.2.3
-1. Requirement: Now NaxToPy require the package [**h5py** ](https://pypi.org/project/h5py/).
+1. Requirement: Now NaxToPy require the package [**h5py**](https://pypi.org/project/h5py/).
 2. Feat: N2PGetLoadFastener now can use PAG method and display format.
 3. BugFix: Some bugs are solved in N2PGetFastener and N2PGetLoadFastener.
 4. Feat: N2PGetLoadFastener can export results in HDF5 format.
 5. BugFix: The filtering in the method get_result_by_LCs_Incr() in elements when results are in Corner Data is fixed.
 
+### v.3.0.0
+1. Feat: Now it is supported more properties from Nastran: PBAR, PBARL, PBEAM, PBEAML, PBUSH, PWELD, PELAS, PFAST, PMASS, PGAP. They are kept as N2PBeam, N2PBeamL, N2PBush, N2PWeld, N2PElas, N2PFast, N2PMass, N2PGap.
+2. Feat: Now it is supported more properties from Abaqus: *BEAM SECTION and *BEAM GENERAL SECTION as N2PBeamL and N2PBeam.
+3. Feat: Overloaded `get_result_by_LCs_Incr()` to accept a list of components. It load multiple components and load cases of the same result in parallel, improving efficiency.
+4. Feat: New property N2PComp.EqQBenMatrix that returns the equivalent stifness matrix for bending. 
+5. Feat: Added `N2PComp.EqMemProps` and `N2PComp.EqBenProps` properties to return equivalent engineering values (Ex, Ey, G, and ν) for membrane and bending behavior, respectively.
+6. Feat: Added two new methods in `N2PModelContent`: `get_material()` and `get_property()` to search easelly for materials and properties.
+7. Feat: new method in `N2PModelContent`: `get_elements_filtered()`. It returns a list of `N2PElement` that matches a material, property, part or type-element.
+8. Feat: New checks in the results methods to avoid invalid parameters.
+
+### v.3.1.0
+1. Feat: New optional argument in `load_model()` called **loadconnectors**. True by default.
+2. Feat: New module N2PNeuber to obtain stresses using the Neuber method.
+3. Feat: New module N2PSandwich to calculate sandwich structures failure modes.
+4. Feat: New module N2PCompositeFailure for evaluating structural failure in laminates.
+5. Feat: New module N2PEdgeDelamination  to obtain interlaminar stresses and RF from edge delamination.
+6. Feat: New module N2PCalculatorRFJoints manages the Reserve Factor (RF) calculation process of the joints obtained through the modules N2PGetFasteners and N2PGetLoadFasteners.
+7. Feat: New module N2PUpdateFastener provides methods to update rivet and bolt stiffness and generate a new FEM Input File (.bdf, .fem, .dat, etc.) file with the updated data.
+8. BugFix: Several bugs are fixed in N2PGetFastener and N2PGetLoadFastener modules.
+9. Feat: Extra information in the log when the NaxToPy is running from a executable.
+10. Feat: `N2PLoadModelContent.SetList` is now an encapsulated property.
+11. Refactor: the method `N2PLoadModelContent.get_result_by_LCs_Incr()` is optimized.
+
+
 # Documentation
 
 **NaxToPy** is a package developed by Idaero Solutions© as a part of the **NaxTo** software.
@@ -550,7 +575,10 @@ For more documentation visit https://idaerosolutions.com/Home/NaxToPy
 
 Reference Guide at: https://www.idaerosolutions.com/NaxToPyDoc/NaxToPy.html
 
-
 # License
 
-Copyright is owned by Idaero Solutions©
+See the license in Python\Lib\site-packages\NaxToPy-{version}.dist-info\LICENSE or executing the command `python -m pip show NaxToPy`
+
+-------------
+
+<p align="center">  <img src="https://www.idaerosolutions.com/images/web/Idaero.png" alt="Idaero Icon" width=200></p><div align="center">© 2025 Idaero Solutions S.L. All rights reserved.</div>

{naxtopy-2.2.3 → naxtopy-3.1.0}/README.md

@@ -1,6 +1,6 @@
 [![Idaero](https://img.shields.io/badge/powered%20by-Idaero%20Solutions-299797)](https://idaerosolutions.com)
 [![PyPi](https://img.shields.io/pypi/v/NaxToPy?color=ffd500)](https://pypi.org/project/NaxToPy/)
-[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-00699d)](https://www.python.org/downloads/)
+[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-00699d)](https://www.python.org/downloads/)
 ![License](https://img.shields.io/badge/license-proprietary-red)
 [![MicrosoftStore](https://img.shields.io/badge/Microsoft%20Store-NaxTo-blue?logo=microsoftstore&logoColor=blue&labelColor=lightgrey)](https://apps.microsoft.com/detail/XP9MMH0KDKGRJN?hl=en-US&gl=US)
 [![PyPi - Downloads](https://img.shields.io/pypi/dm/NaxToPy?color=dgreen)](https://pypi.org/project/NaxToPy/#files)
@@ -24,10 +24,10 @@ additional software beyond NaxTo (see the Download and Homepage links on the lef
 ---------------
 
 ⚠️**Warning:** To use NaxToPy, [**NaxTo**](https://apps.microsoft.com/detail/XP9MMH0KDKGRJN?hl=en-US&gl=US) must be installed.
-This version is compatible with **NaxTo 2024.3**. It is compatible with all the steps of this version (2024.3.0, 2024.3.1).
+This version is compatible with **NaxTo 2025.1**. 
 Check in _Programs and Features_ the NaxTo version that is installed.
 
-📘**Note:** If a specific NaxTo version is installed, search the [**NaxToPy History**](https://pypi.org/project/NaxToPy/2.2.1/#history) to find which newer version is compatible with it.
+📘**Note:** If a specific NaxTo version is installed, search the [**NaxToPy History**](https://pypi.org/project/NaxToPy/3.1.0/#history) to find which newer version is compatible with it.
 
 
 ## Installation
@@ -200,12 +200,36 @@ is redundant. The coordinate system will prevail.
 8. BugFix: The method get_elements_attached() is fixed so when there are MPC connectors with the same ID.
 
 ### v.2.2.3
-1. Requirement: Now NaxToPy require the package [**h5py** ](https://pypi.org/project/h5py/).
+1. Requirement: Now NaxToPy require the package [**h5py**](https://pypi.org/project/h5py/).
 2. Feat: N2PGetLoadFastener now can use PAG method and display format.
 3. BugFix: Some bugs are solved in N2PGetFastener and N2PGetLoadFastener.
 4. Feat: N2PGetLoadFastener can export results in HDF5 format.
 5. BugFix: The filtering in the method get_result_by_LCs_Incr() in elements when results are in Corner Data is fixed.
 
+### v.3.0.0
+1. Feat: Now it is supported more properties from Nastran: PBAR, PBARL, PBEAM, PBEAML, PBUSH, PWELD, PELAS, PFAST, PMASS, PGAP. They are kept as N2PBeam, N2PBeamL, N2PBush, N2PWeld, N2PElas, N2PFast, N2PMass, N2PGap.
+2. Feat: Now it is supported more properties from Abaqus: *BEAM SECTION and *BEAM GENERAL SECTION as N2PBeamL and N2PBeam.
+3. Feat: Overloaded `get_result_by_LCs_Incr()` to accept a list of components. It load multiple components and load cases of the same result in parallel, improving efficiency.
+4. Feat: New property N2PComp.EqQBenMatrix that returns the equivalent stifness matrix for bending. 
+5. Feat: Added `N2PComp.EqMemProps` and `N2PComp.EqBenProps` properties to return equivalent engineering values (Ex, Ey, G, and ν) for membrane and bending behavior, respectively.
+6. Feat: Added two new methods in `N2PModelContent`: `get_material()` and `get_property()` to search easelly for materials and properties.
+7. Feat: new method in `N2PModelContent`: `get_elements_filtered()`. It returns a list of `N2PElement` that matches a material, property, part or type-element.
+8. Feat: New checks in the results methods to avoid invalid parameters.
+
+### v.3.1.0
+1. Feat: New optional argument in `load_model()` called **loadconnectors**. True by default.
+2. Feat: New module N2PNeuber to obtain stresses using the Neuber method.
+3. Feat: New module N2PSandwich to calculate sandwich structures failure modes.
+4. Feat: New module N2PCompositeFailure for evaluating structural failure in laminates.
+5. Feat: New module N2PEdgeDelamination  to obtain interlaminar stresses and RF from edge delamination.
+6. Feat: New module N2PCalculatorRFJoints manages the Reserve Factor (RF) calculation process of the joints obtained through the modules N2PGetFasteners and N2PGetLoadFasteners.
+7. Feat: New module N2PUpdateFastener provides methods to update rivet and bolt stiffness and generate a new FEM Input File (.bdf, .fem, .dat, etc.) file with the updated data.
+8. BugFix: Several bugs are fixed in N2PGetFastener and N2PGetLoadFastener modules.
+9. Feat: Extra information in the log when the NaxToPy is running from a executable.
+10. Feat: `N2PLoadModelContent.SetList` is now an encapsulated property.
+11. Refactor: the method `N2PLoadModelContent.get_result_by_LCs_Incr()` is optimized.
+
+
 # Documentation
 
 **NaxToPy** is a package developed by Idaero Solutions© as a part of the **NaxTo** software.
@@ -423,7 +447,10 @@ For more documentation visit https://idaerosolutions.com/Home/NaxToPy
 
 Reference Guide at: https://www.idaerosolutions.com/NaxToPyDoc/NaxToPy.html
 
-
 # License
 
-Copyright is owned by Idaero Solutions©
+See the license in Python\Lib\site-packages\NaxToPy-{version}.dist-info\LICENSE or executing the command `python -m pip show NaxToPy`
+
+-------------
+
+<p align="center">  <img src="https://www.idaerosolutions.com/images/web/Idaero.png" alt="Idaero Icon" width=200></p><div align="center">© 2025 Idaero Solutions S.L. All rights reserved.</div>

{naxtopy-2.2.3 → naxtopy-3.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "NaxToPy"
-version = "2.2.3"
+version = "3.1.0"
 license = {file = "LICENSE"}
 authors = [ { name = "Idaero Solutions", email = "manuel.sanchez@idaerosolutions.com" }, ]
 requires-python = ">=3.9"
@@ -25,7 +25,7 @@ keywords = ["NaxTo",
             "FEM"]
 
 [project.urls]
-"Documentation" = "https://www.idaerosolutions.com/NaxToPyDoc/index.html"
+"Documentation" = "https://www.idaerosolutions.com/NaxToDocumentation/NaxToPy/3.1.0/index.html"
 "LinkedIn" = "https://www.linkedin.com/company/idaero/"
 
 [tool.setuptools]

{naxtopy-2.2.3 → naxtopy-3.1.0}/src/NaxToPy/Core/Classes/N2PAbaqusInputData.py

@@ -1,7 +1,7 @@
 """This module contains classes related with a Abaqus Input File (.inp files). The parent classes are similar but not
-the same as the Nastran Input File. Child classes of N2PKeyword are based on Abaqus Keywords Reference Guide"""
+the same as the Nastran Input File. Child classes of N2PKeyword are based on Abaqus Keywords Reference Guide."""
 from __future__ import annotations  # For compatibility with Python 3.9 or higher
-from typing import Literal
+from typing import Literal, overload
 
 from NaxToPy.Core.Errors.N2PLog import N2PLog
 from NaxToPy.Core.Classes.N2PNastranInputData import N2PInputData
@@ -10,7 +10,8 @@ from NaxToPy.Core.Classes.ABQEntities import *
 
 
 class N2PAbaqusInputData:
-    """Class with the complete data of an Abaqus MEF input file (text file usually with the extension .inp).
+    """
+    Class with the complete data of an Abaqus MEF input file (text file usually with the extension .inp).
     """
 
     __slots__ = (
@@ -48,34 +49,58 @@ class N2PAbaqusInputData:
             {entityelement: N2PEntityElement(entityelement, self.__dictKeywordToN2P, self.__dictEntityToN2P)
              for entityelement in inputfiledata.StructuredInfo.ModelElements})
 
+    # Método para optener los objetos N2PCard del Input File -----------------------------------------------------------
     @property
     def ListBulkDataKeywords(self) -> list[N2PKeyword, ...]:
-        """List with the N2PCard objects of the input FEM file. It has all bulk data cards of the model"""
+        """
+        List with the N2PCard objects of the input FEM file. It has all bulk data cards of the model.
+        """
         return self.__listbulkdatakeywords
+    # ------------------------------------------------------------------------------------------------------------------
 
+    # Método para obtener el diccionaro de IDs a FilePaths -------------------------------------------------------------
     @property
     def DictionaryIDsFiles(self) -> dict:
+        """
+        Dictionary with ID (`int`) as keys and FilePaths (`string`) as values.
+        """
         return dict(self.__inputfiledata.DictionaryIDsFiles)
+    # ------------------------------------------------------------------------------------------------------------------
 
+    # Método para obtener el diccionario de FilePaths a IDs ------------------------------------------------------------
     @property
     def DictionaryFilesIDs(self) -> dict:
+        """
+        Dictionary FilePaths (`string`) as keys and with ID (`int`) as values.
+        """
         return dict(self.__dictionary_files_ids)
+    # ------------------------------------------------------------------------------------------------------------------
 
+    # Método para obtener el tipo de Input File ------------------------------------------------------------------------
     @property
     def TypeOfFile(self) -> str:
+        """
+        Type of Input File.
+        """
         return "ABAQUS"
+    # ------------------------------------------------------------------------------------------------------------------
 
+    # Método para obtener la lista de comentarios en el Input File -----------------------------------------------------
     @property
     def ListComments(self) -> list[N2PInputData, ]:
-        """List with all the comments in the FEM Input File"""
+        """
+        List with all the comments in the FEM Input File.
+        """
         if self.__listcomments:
             return self.__listcomments
         else:
             self.__listcomments = [N2PInputData(i) for i in self.__inputfiledata.StructuredInfo.ModelComments]
             return self.__listcomments
+    # ------------------------------------------------------------------------------------------------------------------
 
     def get_keywords_by_type(self, field: KeyWordType) -> list[N2PKeyword,]:
-        """Method that returns a list with the N2PKeyword objects of the input FEM file asked.
+        """
+        Method that returns a list with the :class:`N2PKeyword` objects of the input FEM file asked. They can be uppercase or lowecase indistinctly.
 
         Args:
             field: str
@@ -85,36 +110,53 @@ class N2PAbaqusInputData:
         """
         if not isinstance(field, str):
             Exception(N2PLog.Critical.C201())
-        elif field not in CONSTRUCTABQDICT:
+        elif field.upper() not in CONSTRUCTABQDICT:
             N2PLog.Error.E205()
             return []
         else:
             return [self.__dictKeywordToN2P[keyword] for keyword in self.__inputfiledata.GetKeywordsByType(field)]
-
-    def get_entity_by_key_and_id(self, entitytype: EntityType, entitityid: int) -> list[N2PEntity, ]:
-        """Method that returns a list with the N2Entities objects of the input FEM file asked. There can be several
-        Entities with the same ID and EntityType as they can belong to different part.
+    
+    @overload
+    def get_entity_by_key_and_id(self, entitytype: EntityType, entitityid: int, part: str) -> N2PEntity: ...
+    @overload
+    def get_entity_by_key_and_id(self, entitytype: EntityType, entitityid: int) -> list[N2PEntity, ]: ...
+    # Actual implementation
+    def get_entity_by_key_and_id(self, entitytype, entitityid, part=None):
+        """
+        Method that returns a list with the :class:`N2PEntities` objects of the input FEM file asked. There can be 
+        several Entities with the same ID and EntityType as they can belong to different part. If the part is given,
+        only a :class:`N2PEntity` will be returned.
 
         Args:
             entitytype: str
             entitityid: int
+            part: str (optional)
 
         Returns:
-            list[N2PKeyword, ]
+            N2PEntity || list[N2PEntity, ]
         """
         if not isinstance(entitytype, str):
             Exception(N2PLog.Critical.C201())
         elif not isinstance(entitityid, int):
             Exception(N2PLog.Critical.C201())
-        elif entitytype not in ["NODE", "ELEMENT"]:
-            N2PLog.Error.E205()
-            return []
-        else:
+        elif part:
+            entity_error = self.__inputfiledata.GetEntitiesByTypeAndId(entitytype, entitityid, part)
+            if entity_error.Item2 == 0:
+                return self.__dictEntityToN2P[entity_error.Item1]
+            elif entity_error.Item2 == -1:
+                N2PLog.Error.E205(entitytype)
+            elif entity_error.Item2 == -2:
+                N2PLog.Error.E241(part)
+            elif entity_error.Item2 == -3:
+                N2PLog.Error.E242(part, entitityid)
+            return None
+        else: 
             return [self.__dictEntityToN2P[entitytype]
                     for entitytype in self.__inputfiledata.GetEntitiesByTypeAndId(entitytype, entitityid)]
 
     def rebuild_file(self, folder: str) -> None:
-        """Method that writes the solver input file with the same file structure that was read in the folder is specified
+        """
+        Method that writes the solver input file with the same file structure that was read in the folder is specified.
 
         Args:
             folder: str -> Path of the folder where the file or files will be writen