nodedge / nodedge

A Python3 graphic environment for next-generation engineering.

Nodedge

A Python3 graphic environment for next-generation engineering.

Nodedge.io

What is Nodedge?

Nodedge is the first open-source Python editor for scientific and engineering applications. It provides a comprehensive graphic environment for accelerating the design, simulation, analysis, and deployment of complex scientific and engineering systems. With Nodedge, you can:

• design and simulate dynamical systems such as robotic, physical, and chemical systems
• generate Python code from your graphic models with a simple click
• interactively plot and edit the data generated by your simulation
• plot and analyze log files with common extensions like csv, mf4, mat, and others.

Installation

You can install Nodedge in different ways.

Download the installer

• Windows: download latest release
• macOS: please bear with us, we are currently in the process of developing it!
• Linux: please bear with us, we are currently in the process of developing it!

Install from pip

Alternatively, you can install Nodedge form pip with:

pip install nodedge

Clone from GitHub

Alternatively, you can clone our project from Github and install the requirements with:

git clone https://github.com/nodedge/nodedge nodedge
cd nodedge
pip install -r .\requirements\freeze\requirements_dev.txt

Quick start examples

The list of examples is constantly expanding. You can find an up-to-date list in the examples folder on GitHub. The examples provided below will allow you to get started with Nodedge.

Create a model in Nodedge

In this example, we demonstrate how to create a model in Nodedge to calculate the gravitational force between two objects:

1. In Nodedge, create a new file by clicking on File > New
2. Add input nodes to your model to represent the constant variables of the gravitational force. From the Node libraries widget on the right, drag-and-drop Input nodes to the scene and insert the constant values in their labels
3. Rename the input nodes by editing their title in the Node details widget on the right
4. From the Operator library, drag-and-drop Multiplication, Division, and Power nodes to the scene and connect them to the input nodes
5. Connect an output node to display the result of the computation.

Congratulations! You have just created your first Nodedge model! If you want to compute the gravitational force for different objects, simply edit the mass values in the input nodes. Nodedge will instantly re-evaluate the model and display the updated result.

Open a dataset in Dats

In this example, we show you how to import a dataset into Dats, plot the signals contained within it, and add new ones:

1. Open Dats by clicking on its icon in the home page
2. Click on File > Open then navigate to the example file examples/csv_analyzer/reinforcement_learning_data.csv
3. Click on Open
4. From the Variables widget on the left, select init_x and target_x by clicking on their labels
5. Plot the curves by:
   • clicking on the Plot button, or
   • drag-and-dropping the signals to the worksheet
6. Right-click on the worksheet window, then click on Add subplot
7. Plot the init_y and target_y signals as done at step 5
8. To save the current Dats configuration, click on File > Save configuration, then navigate to the folder where you want to save the configuration file and enter a file name like csv_analyzer_config.json. Click on Save

Congratulations! You have successfully analyzed your first dataset in Dats!

Roadmap

Nodedge development team has a lot of exciting features planned for the future! The project is actively being developed and there are plans to add support for a wide range of features. If you wish to join our efforts, do not hesitate to contact us. Any help is welcome!

Our roadmap includes, and is not limited to:

• In Dats, extend support to other file formats, including hdf, rosag, etc.
• In Nodedge, add support for saving and sharing Python custom nodes in a node library. In a custom node, the user can enter a custom piece of Python code that runs within the current Nodedge model. The custom node can be saved to the nodes library and reused it in the future
• In Nodedge, add support for the simulation of dynamic systems. In particular, add a widget for the selection of a solver and its configuration, as well as start/pause/stop buttons and others
• In Nodedge and Dats, add support for robotics-specific features, such as embedded code generation for common hardware platform, real-time data acquisition and inspection

Contributing

You can contribute to Nodedge in several ways:

• Donate to keep Nodedge core free and open-source, provide support for current features and implement new ones
• Submit your feedback. Share your goals and tell us how Nodedge can help
• Share example files
• Report bugs on Nodedge issue tracker
• Fix bugs and write documentation. To start contributing to Nodedge, you can check out the guidelines for contributors

For developing Nodedge, we recommend using PyCharm IDE. You can find helpful information on how to install and set it up on Nodedge Wiki and PyCharm website.

nodedge's Issues

Generate code file navigator does not use the workspace path as default.

Add zooming bar

In dats, if there is no curve in plot, the behavior of the spacebar is unexpected.

The plot zooms out.

Comment is not taken into account for fitting model to view.

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

Add an action for removing/reloading a log from the log list.

Once a log is charged, it is not possible anymore to remove it from the list.

Rename objects

Tooltips:
New: Create new Nodedge graph -> Create new Nodedge model (in the tutorials, we call it a model)
Add comment: Add comment element in current scene -> Add comment to current model
Window: Node toolbar -> Node libraries
Simulation: Eval all nodes -> Simulation: Evaluate all nodes or Evaluate all nodes
Simulation: Simulate -> Start simulation (there will also be Stop simulation and Pause simulation)

Add toolbar actions:
Window: History
Window: Node details

In history:
Delete cut edges. -> Delete edges (check if it is associated with the action of cutting an edge or not)

On the website:
objects -> items

Dats menu bar:
File > Take screenShot ->Take screenshot
View > View all -> Fit to view

Dats right click:
Fix to view -> Fit to view

Dats menu bar: add
Window > Logs
Window > Signals

Move Tools before Help

Link help button to online tutorials

Tests fail with python 3.8.0

Describe the bug
$ pytest PySide2/__init__.py: Unable to import shiboken2 fro m C:\github\nodedge\venv38\Scripts\pytest.exe, C:\U sers\a.debortoli\AppData\Local\Programs\Python\Pyth on38\python38.zip, C:\Users\a.debortoli\AppData\Loc al\Programs\Python\Python38\DLLs, C:\Users\a.debort oli\AppData\Local\Programs\Python\Python38\lib, C:\ Users\a.debortoli\AppData\Local\Programs\Python\Pyt hon38, c:\github\nodedge\venv38, c:\github\nodedge\ venv38\lib\site-packages INTERNALERROR> Traceback (most recent call last): INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\_pytest\main.py", line 236, in wrap_ session INTERNALERROR> config._do_configure() INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\_pytest\config\__init__.py", line 91 1, in _do_configure INTERNALERROR> self.hook.pytest_configure.call_ historic(kwargs=dict(config=self)) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pluggy\hooks.py", line 308, in call_ historic INTERNALERROR> res = self._hookexec(self, self. get_hookimpls(), kwargs) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pluggy\manager.py", line 93, in _hoo kexec INTERNALERROR> return self._inner_hookexec(hook , methods, kwargs) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pluggy\manager.py", line 84, in <lam bda> INTERNALERROR> self._inner_hookexec = lambda ho ok, methods, kwargs: hook.multicall( INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pluggy\callers.py", line 208, in _mu lticall INTERNALERROR> return outcome.get_result() INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pluggy\callers.py", line 80, in get_ result INTERNALERROR> raise ex[1].with_traceback(ex[2] ) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pluggy\callers.py", line 187, in _mu lticall INTERNALERROR> res = hook_impl.function(*args) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pytestqt\plugin.py", line 218, in py test_configure INTERNALERROR> qt_api.set_qt_api(config.getini( "qt_api")) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pytestqt\qt_compat.py", line 111, in set_qt_api INTERNALERROR> self.QtCore = QtCore = _import_m odule("QtCore") INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\pytestqt\qt_compat.py", line 95, in _import_module INTERNALERROR> m = __import__(_root_module, glo bals(), locals(), [module_name], 0) INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\PySide2\__init__.py", line 91, in <m odule> INTERNALERROR> _setupQtDirectories() INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\PySide2\__init__.py", line 57, in _s etupQtDirectories INTERNALERROR> import shiboken2 INTERNALERROR> File "c:\github\nodedge\venv38\lib \site-packages\shiboken2\__init__.py", line 27, in <module> INTERNALERROR> from .shiboken2 import * INTERNALERROR> ImportError: DLL load failed while i mporting shiboken2: The specified procedure could n ot be found.
To Reproduce
Steps to reproduce the behavior:

1. pytest tests
2. Test fail.

Expected behavior
As in setup.py, the compatibility is 3.6+, tests should pass with 3.8.0

Desktop (please complete the following information):

• OS: Win10 pro
• Version: master branch

Workaround
It works with 3.8.3.

Unexpected label with coordinates appear on the middle subplot. Also, the cursor is not in the active subplot.

In the middle subplot, on the bottom left, some coordinates appear. What are they? Should they be removed or placed elsewhere?
Also, the cursor is in the second subplot, although the active subplot is the third one.
Finally, the cursor does not follow Nodedge style. What is the advantage of having a cursor? To which curve should it point?

Font sizes appear different on different screens.

This can be due to the monitor resolution, monitor scaling factor, etc.

Change block description from CSV to JSON.

H cannot be written in comments.

Fix bug when window is closed but a file has changed

In dats, if there are 3 subplots the middle subplot axes are not linked.

Improve node context menu to get library sub menus.

If node is clicked+moved, node detail is not updated.

Block titles should be lower case.

Add workspace path in settings.

In the block context menu, libraries should be upper case.

Rename Dats actions

Rename the following:
Remove log -> Close log (symmetric to Open)
Create worksheet -> Add worksheet
Create workbook -> Add workbook

Add Add suplot to File menu, right above Add worksheet

Dats configuration is restored wrongly.

While two curves are in subplot 1 and two curves are in subplot 2, they are all restored in the first subplot.

Rename toolbar button: Add Comment -> Add comment

Real-time node evaluation is broken

Real-time node evaluation is not performed anymore.

Middle mouse button should drag the scene.

In dats if the user change palette, grid and plots colors are not updated.

Implement simulation solver.

Failure when a csv contains numeric and string columns.

When opening a csv that contains both numbers and strings Dats fails. Add a check each column content. If the content is made of strings (or has at least one string), then discard the column. When there are only numeric columns Dats works properly. Of course, the header can be made of strings.

In input node labels, stop editing mode when `Enter` is pressed

At the moment, the text bar still blinks when enter is pressed.

Implement Pause/Stop simulation

Open files from homepage.

Add tutorials on the website.

• Move items

Dats cannot deal with two variables with the same name in two different groups.

Fix text bar in comment

The text bar behaves strangely in comments: in editing mode, sometimes it blinks while other times it is still and other times does not even appear.

In Dats, ctrl+N does not work.

Fix graphic view colors when switching palette between dark and light.

The background of the scene and the small and big square grids do not change color when the palette is changed.

Workspace path is not detected wrong when empty.

On the homepage, add `New` button for Dats with the same style of Nodedge `New` button.

Add support to python 3.11

In a menu is open and the user slides over the home menu, the app unexpectedly switches to home.

345

Decouple logs and workbooks.

At the moment, we can import two logs and plot signals from both of them in a worksheet. However, only those of the selected log will be displayed. We could either allow plot signals from different logs in the same worksheet or at least in different worksheet/books.

Open dialog box if a dataset file is not found when trying to open it from the homepage.

Set less visible color for Dats suplot grid

At the moment, in the Dark theme the grid is very bright, which is disturbing for the analysis of the curves (also very bright).
I guess that there is the same issue for the Light theme, but it needs to be checked.

Fix history text when a comment is created

At the moment, it says Change selection. It should be something different like Add comment.

Show code window is very small and does not show arrows for enlarging it.

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

Restyle cut edge: remove dash.

On homepage, long filenames are not displayed correctly.

Change color to button background

When closing a window, a dialog appears but the Save button background is the same as the dialog background.

Connect Nodedge and Dats `Help` buttons to online tutorials and/or documentation

test issue

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.