Merge branch 'main' into dev/gear-var

Author: jguarato

README.md

@@ -1,4 +1,4 @@
-# Rotordynamic Open Source Software (ROSS)
+# ROSS — Rotordynamic Open-Source Software
 [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/ross-rotordynamics/ross/main)
 ![github actions](https://github.com/petrobras/ross/workflows/Tests/badge.svg)
 [![Documentation Status](https://readthedocs.org/projects/ross/badge/?version=latest)](https://ross.readthedocs.io/en/latest/?badge=latest)
@@ -16,32 +16,44 @@ energy is not taken into account. Bearings and seals are included as linear stif
 After defining the elements for the model, you can plot the rotor geometry and run simulations such as static analysis,
 modal analysis, undamped critical speed, frequency response, unbalance response, time response, and more.
 
-You can try it out now by running the tutorial on [binder](https://mybinder.org/v2/gh/ross-rotordynamics/ross/main)
+## 🚀 Quick Start
 
-# Documentation 
-Access the documentation [here](https://ross.readthedocs.io/en/latest/index.html).
-The documentation provides the [installation procedure](https://ross.readthedocs.io/en/latest/getting_started/installation.html), 
-[a tutorial](https://ross.readthedocs.io/en/latest/tutorials/tutorial_part_1.html), 
-[examples](https://ross.readthedocs.io/en/latest/discussions/discussions.html) and the 
-[API reference](https://ross.readthedocs.io/en/latest/references/api.html).
+You can try ROSS instantly in your browser:
 
-# Questions
-If you have any questions, you can use the [Discussions](https://github.com/petrobras/ross/discussions) area in the repository.
+👉 [**Launch ROSS in Binder**](https://mybinder.org/v2/gh/petrobras/ross/main)
 
-# 💡 ROSS GPT – Your Virtual Assistant for Rotordynamics
+Or install it locally:
+```bash
+pip install ross-rotordynamics
+```
 
-Meet [ROSS GPT](https://bit.ly/rossgpt), a virtual assistant specialized in the ROSS (Rotordynamic Open-Source Software) package. With ROSS GPT, you can:
+## 📚 Documentation
 
+Access full documentation [here](https://ross.readthedocs.io).
+
+Key sections:
+- [Installation guide](https://ross.readthedocs.io/en/latest/installation.html)
+- [User guide](https://ross.readthedocs.io/en/latest/user_guide/user_guide.html)
+- [API reference](https://ross.readthedocs.io/en/latest/api.html)
+- [Release notes](https://ross.readthedocs.io/en/latest/release_notes/release_notes.html)
+
+## 🤖 ROSS GPT
+
+Meet [ROSS GPT](https://bit.ly/rossgpt), the official AI assistant for the ROSS package. With ROSS GPT, you can:
 - Create and modify rotor models using ROSS in Python.
 - Request practical examples for modal analysis, Campbell diagrams, unbalance response, and more.
 - Get detailed technical explanations on elements such as shafts, disks, bearings, and couplings.
 
-Access [ROSS GPT here](https://bit.ly/rossgpt) and enhance your modeling workflow with expert automated support!
+## ❓ Support & Questions
+
+If you have **questions**, need **guidance**, or want to **discuss ideas**, please use the [**Discussions**](https://github.com/petrobras/ross/discussions) tab.
+
+If you encounter a **bug**, experience unexpected behavior, or want to **request a new feature**, please open an [**Issue**](https://github.com/petrobras/ross/issues) describing the problem and how to reproduce it.
 
+## 🤝 Contributing
 
-# Contributing to ROSS
 ROSS is a community-driven project. If you want to contribute to the project, please
-check [CONTRIBUTING.md](https://github.com/petrobras/ross/blob/main/CONTRIBUTING.md). 
+check [CONTRIBUTING.md](https://github.com/petrobras/ross?tab=contributing-ov-file). 
 
 The code has been initially developed by Petrobras in cooperation with the Federal University of Rio de Janeiro (UFRJ)
 with contributions from the Federal University from Uberlândia (UFU).

ross/rotor_assembly.py

@@ -735,8 +735,14 @@ def add_nodes(self, new_nodes_pos):
         for i in range(len(target_elements)):
             elem = target_elements[i]
 
-            left_elem = elem.create_modified(L=(elem.L - new_elems_length[i]))
-            right_elem = elem.create_modified(L=new_elems_length[i], n=(elem.n + 1))
+            left_length = elem.L - new_elems_length[i]
+            id_interp = np.interp(left_length, [0, elem.L], [elem.idl, elem.idr])
+            od_interp = np.interp(left_length, [0, elem.L], [elem.odl, elem.odr])
+
+            left_elem = elem.copy(L=left_length, idr=id_interp, odr=od_interp)
+            right_elem = elem.copy(
+                L=new_elems_length[i], idl=id_interp, odl=od_interp, n=(elem.n + 1)
+            )
 
             if left_elem.n != prev_left_node:
                 for elm in elements:

ross/shaft_element.py

@@ -1171,7 +1171,7 @@ def _patch(self, position, check_sld, fig, units):
 
         return fig
 
-    def create_modified(self, **attributes):
+    def copy(self, **attributes):
         """Return a new shaft element based on the current instance.
 
         Any attribute passed as an argument will be used to modify the corresponding