A GUI-based (PyQt5) tool used to design 2D linkage mechanism.

Overview

Build status Build status Documentation Status GitHub repo size in bytes Downloads

Language grade: Python PyPI sourceforge

kernel kernel

pyslvs-icon Pyslvs-UI

A GUI-based (PyQt5) tool used to design 2D linkage mechanism.

  • Planar Linkages Simulation
  • Mechanical Synthesis
    • Number Synthesis: Combine the attributes of mechanism.
    • Structural Synthesis: Cython algorithm used to find out structural possibilities of the mechanism.
    • Dimensional Synthesis: Kernel from the three Cython algorithms (rewrite).
  • Websites
  • Others
    • Cross three platforms.
    • CAD-like user interface.
    • Auto layout of generalized chain.
    • The code is following with Python Enhancement Proposals (PEP):

If you have any question, please post on GitHub issue or contact [email protected].

Getting Started

Executables

Download portable executable file of your platform.

PyPI

pip install pyslvs-ui

Source

Branch master is in development, use stable branch to install stable dependencies directly.

git checkout stable
pip install -e .

There are more detailed instructions in the documentation.

Libraries

Pyslvs has a solver backend that can works without the GUI:

from pyslvs import example_list, parse_vpoints, t_config, expr_solving

# Get example with name
expr, inputs = example_list("Jansen's linkage (Single)")
# Parse the mechanism expression into a list of joint data
vpoints = parse_vpoints(expr)
# Config joint data and control data for the solver
exprs = t_config(vpoints, inputs)
# Solve the position
result = expr_solving(exprs, vpoints, {pair: 0. for pair in inputs})
# Get the result from joint 7
x, y = result[7]
print(x, y)  # -43.170055 -91.753226

Please see the documentation for more information.

Documentation

The documentation of Pyslvs and kernel API. Start it from sources:

pip install mkdocs
pip install -r doc-requirements.txt
mkdocs serve

Cite

Please see the reference.

Comments
  • [AppImage] v18.2.0.glibc2.17 does not work on Debian Stretch 9.3

    [AppImage] v18.2.0.glibc2.17 does not work on Debian Stretch 9.3

    I downloaded the most recent release, pyslvs-18.2.0.glibc2.17-x86_64.AppImage. It does not work on Debian Stretch 9.3.

    $> ./pyslvs-18.2.0.glibc2.17-x86_64.AppImage 
    
    Traceback (most recent call last):
      File "/tmp/.mount_J3kT0G/usr/bin/pyslvs", line 6, in <module>
        from core import *
      File "/tmp/.mount_J3kT0G/usr/bin/core/__init__.py", line 10, in <module>
        from .info import *
      File "/tmp/.mount_J3kT0G/usr/bin/core/info/__init__.py", line 9, in <module>
        from .info import (
      File "/tmp/.mount_J3kT0G/usr/bin/core/info/info.py", line 23, in <module>
        import requests
      File "/tmp/.mount_J3kT0G/usr/lib/python3.5/site-packages/requests/__init__.py", line 43, in <module>
        import urllib3
      File "/tmp/.mount_J3kT0G/usr/lib/python3.5/site-packages/urllib3/__init__.py", line 8, in <module>
        from .connectionpool import (
      File "/tmp/.mount_J3kT0G/usr/lib/python3.5/site-packages/urllib3/connectionpool.py", line 11, in <module>
        from .exceptions import (
      File "/tmp/.mount_J3kT0G/usr/lib/python3.5/site-packages/urllib3/exceptions.py", line 2, in <module>
        from .packages.six.moves.http_client import (
      File "/tmp/.mount_J3kT0G/usr/lib/python3.5/site-packages/urllib3/packages/__init__.py", line 3, in <module>
        from . import ssl_match_hostname
      File "/tmp/.mount_J3kT0G/usr/lib/python3.5/site-packages/urllib3/packages/ssl_match_hostname/__init__.py", line 9, in <module>
        from ssl import CertificateError, match_hostname
      File "/usr/lib/python3.5/ssl.py", line 135, in <module>
        PROTOCOL_SSLv23 = _SSLMethod.PROTOCOL_SSLv23 = _SSLMethod.PROTOCOL_TLS
      File "/usr/lib/python3.5/enum.py", line 274, in __getattr__
        raise AttributeError(name) from None
    AttributeError: PROTOCOL_TLS
    

    Maybe you want to reach out to the IRC channel #AppImage on Freenode. There you'll find AppImage developers who are willing to help fix any problems you may have with packaging and testing your AppImage.

    opened by KurtPfeifle 15
  • [ENH] Extract calculation functions from GUI

    [ENH] Extract calculation functions from GUI

    Hi! First of all I would like to say that this system is amazing, it works great!

    I would like to use this in my thesis with Reinforcement learning in which I am creating mechanism (1-DOF, derived from a fourbar linkage) from python and I need to get the trajectories of those mechanism as fast as possible (3trajectories /second). Is there any way of defining the mechanism in a script and get the trajectories there without using the GUI interface ?

    This is how I define the linkages in python currently image

    Thanks in advance for your help!

    enhancement question 
    opened by juanma9613 10
  • AppImage builds for Linux

    AppImage builds for Linux

    @KmolYuan, thank you for the DEB's produced for KUbuntu 16.04, but it look little incomplete (no dependency information included)

    What about producing AppImages, that could run on near all Linux-based distributives?

    @probonopd, please, take a look and give an instructon how produce AppImage for Pyslvs under KUbuntu 16.04

    • https://github.com/KmolYuan/Pyslvs-PyQt5/releases
    opened by Symbian9 6
  • Can't Maximize program window

    Can't Maximize program window

    When try Maximize (Ctrl+Alt+5) program window size of it just freezed.

    The only way to change window is manually drag each windowborder or use "Filex -> Full screen (Shift+F1)"

    Pyslvs: v0.9.0(beta3) OS: Linux Mint 18 Xfce (64bit)

    opened by Symbian9 4
  • Compilation error on Mac OSX - symbol(s) not found

    Compilation error on Mac OSX - symbol(s) not found

    Hi,

    I would like to try your software but I get the following error during compilation (make build-kernel):

    [...]
     slvs_wrap.o
          SWIG_Py_Void() in slvs_wrap.o
          SWIG_Python_NewShadowInstance(SwigPyClientData*, _object*) in slvs_wrap.o
          SWIG_Python_AppendOutput(_object*, _object*) in slvs_wrap.o
      "__Py_NotImplementedStruct", referenced from:
          SwigPyObject_richcompare(SwigPyObject*, SwigPyObject*, int) in slvs_wrap.o
    ld: symbol(s) not found for architecture x86_64
    clang: error: linker command failed with exit code 1 (use -v to see invocation)
    make[1]: *** [_slvs.so] Error 1
    make: *** [build-solvespace] Error 2
    

    I tried few workaround with no success. Any idea ?

    macOS support 
    opened by matthieu-lapeyre 3
  • Linkage operational functions

    Linkage operational functions

    Let the linkage has more interactions on main canvas just like points.

    • [x] Merge function to move points to another linkage, then delete the original linkage.
    • [x] Select function.
      • Switch selection mode by entities tab widget.
      • Save selected item for each table.
    • [x] Free move function for adjust dimension of linkages.
    enhancement 
    opened by KmolYuan 3
  • [DOC] The docs don't seem to display well in Safari, Firefox, and Chrome (haven't tried more yet)

    [DOC] The docs don't seem to display well in Safari, Firefox, and Chrome (haven't tried more yet)

    When I open the documentation (https://pyslvs-ui.readthedocs.io/en/stable/python-solvespace-api/) I mostly see some huge search and code icons, it does show a menu but returns 404 errors as I navigate through it. I would love to dig in to this documentation though as I'm eager/curious to use the library for a course I am teaching on Algorithmic Folding (lecture = linkage folding)

    so far I tested with Chrome, Firefox, and Safari, happy to test more if that helps

    I love this project, thanks so much for putting this together!

    opened by ThijsRoumen 2
  • Compilation error using MSYS2

    Compilation error using MSYS2

    Traceback (most recent call last):
      File "launch_pyslvs.py", line 12, in <module>
        main()
      File "Y:\tmp\Pyslvs-UI\pyslvs_ui\__init__.py", line 49, in main
        from .core.main_window import MainWindow
      File "Y:\tmp\Pyslvs-UI\pyslvs_ui\core\main_window\__init__.py", line 24, in <module>
        from .io import IOMethodInterface
      File "Y:\tmp\Pyslvs-UI\pyslvs_ui\core\main_window\io.py", line 57, in <module>
        from .actions import ActionMethodInterface
      File "Y:\tmp\Pyslvs-UI\pyslvs_ui\core\main_window\actions.py", line 21, in <module>
        from .storage import StorageMethodInterface
      File "Y:\tmp\Pyslvs-UI\pyslvs_ui\core\main_window\storage.py", line 27, in <module>
        from .solver import SolverMethodInterface
      File "Y:\tmp\Pyslvs-UI\pyslvs_ui\core\main_window\solver.py", line 24, in <module>
        from pyslvs import (
    ImportError: cannot import name 'SolverSystem' from 'pyslvs' 
    
    invalid 
    opened by mdecourse 2
  • Can't run v0.9.0

    Can't run v0.9.0

    Pyslvs-PyQt5 version: 0.9.0 OS: MX Linux MX-17 (Debian 9 "Stretch"), x86_64 (64-bit)

    $ ./pyslvs-0.9.0.glibc2.17-x86_64.AppImage
    zenity, kdialog, Xdialog missing. Skipping /var/tmp/.mount_bbVPnT/usr/bin//pyslvs.wrapper.
    Traceback (most recent call last):
      File "/var/tmp/.mount_bbVPnT/usr/bin/pyslvs", line 6, in <module>
        from core.info.info import INFO, args
      File "/var/tmp/.mount_bbVPnT/usr/bin/core/info/info.py", line 21, in <module>
        import platform
      File "/usr/lib/python3.5/platform.py", line 117, in <module>
        import sys, os, re, subprocess
      File "/usr/lib/python3.5/subprocess.py", line 50, in <module>
        import signal
      File "/usr/lib/python3.5/signal.py", line 3, in <module>
        from functools import wraps as _wraps
      File "/var/tmp/.mount_bbVPnT/usr/lib/python3.5/functools.py", line 23, in <module>
        from weakref import WeakKeyDictionary
      File "/var/tmp/.mount_bbVPnT/usr/lib/python3.5/weakref.py", line 12, in <module>
        from _weakref import (
    ImportError: cannot import name '_remove_dead_weakref'
    $ 
    
    opened by Symbian9 2
  • "bata" (typo mistake in versioning)

    Version 0.9 bata 1

    This typo mistake should be fixed to "Version 0.9 beta 1". But I also recommend write it as "Pyslvs-PyQt5 0.9-beta.1", and as tag use v0.9-beta.1

    Also recommend you read the guide "Semantic Versioning"

    • http://semver.org

    "Semantic Versioning" now is most popular versioning sheme for user software.

    REFERENCE

    • https://www.sitepoint.com/semantic-versioning-why-you-should-using/
    • https://gist.github.com/jashkenas/cbd2b088e20279ae2c8e
    • https://en.wikipedia.org/wiki/Software_versioning
    opened by Symbian9 2
  • [BUG] release v20.08.0 Mac OS 10.15.1 版本启动闪退

    [BUG] release v20.08.0 Mac OS 10.15.1 版本启动闪退

    Describe the bug A clear and concise description of what the bug is. v20.08.0 Mac Release 版本 在 Mac OS 10.15.1 上启动后会直接崩溃退出,没有任何提示.

    PS. 如果哪位恰巧看到这条信息,并想在北京找一份机械设计师的工作请跟看看我们公司,想必喜欢这个软件的人都是能力极强的. http://www.autolabor.com.cn/join

    To Reproduce Steps to reproduce the behavior:

    1. 解压下载的安装包
    2. 点击启动程序
    3. 程序直接退出

    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: Mac OS
    • Version: 10.15.1

    Additional context Add any other context about the problem here.

    macOS support 
    opened by apachecd 1
  • [BUG]

    [BUG]

    Not sure if this is the correct place to report this, but

    pip install python-solvespace
    

    does not install on Ubuntu22.04

    In file included from python_solvespace/src/constraint.cpp:7:
          python_solvespace/src/solvespace.h:39:10: fatal error: Eigen/SparseCore: No such file or directory
             39 | #include <Eigen/SparseCore>
                |          ^~~~~~~~~~~~~~~~~~
          compilation terminated.
    
    
    opened by jloveric 0
  • [ENH] Plotting time histories of positions, velocities and accelerations

    [ENH] Plotting time histories of positions, velocities and accelerations

    Hi,

    this software is really great, thank you for sharing it. I just want to suggest an improvement to make it even better. Would it be possible to add an option to plot time histories of positions, velocities and accelerations for selected points ? It seems that currently these variables can be plotted only with respect to position. Such a feature would be very useful in my opinion.

    opened by FEA-eng 0
  • [BUG] Slider-crank mechanism doesn't work with aligned points

    [BUG] Slider-crank mechanism doesn't work with aligned points

    Hi,

    I think that I've encountered a bug. I followed this tutorial: https://www.youtube.com/watch?v=cB5wYyc0J0c

    and modeled a simple slider-crank mechanism:

    slider crank

    The problem is that it doesn't work properly - you can see that the curves showing paths of points belonging to the mechanism are very short and motion of this linkage can't be simulated. However, it happens only when point 0 and point 2 have the same Y coordinate. When I move one of them slightly above or below the other, it starts working:

    slider crank 2

    I also attached the .pyslvs file packed to zip below. Would it be possible to fix this bug ?

    Crank slider problem.zip

    opened by FEA-eng 0
Releases(v22.07.0)
A Python Script to convert Normal PNG Image to Apple iDOT PNG Image.

idot-png-encoder A Python Script to convert Normal PNG Image to Apple iDOT PNG Image (Multi-threaded Decoding PNG). Usage idotpngencoder.py -i inputf

Lrdcq 2 Feb 17, 2022
A sketch like(?) effect for images

lineArt A sketch like(?) effect for images How to run main.py [filename] [option {1,2}] option 1 retains colour option 2 gives gray image #results ori

1 Oct 28, 2021
Quickly 'anonymize' all people in an image. This script will put a black bar over all eye-pairs in an image

Face-Detacher Quickly 'anonymize' all people in an image. This script will put a black bar over all eye-pairs in an image This is a small python scrip

Don Cato 1 Oct 29, 2021
Convert bitmap images to seeds for Tiny-83 NFT project.

What is this? This tool allows you to convert any 14p high and 22p wide Bitmap (.bmp) to the seed needed for the Tiny-83 NFT project. Project Twitter:

shib_maximalist 1 Oct 31, 2021
Sombra is simple Raytracer written in pure Python.

Sombra Sombra is simple Raytracer written in pure Python. It's main purpose is to help understand how raytracing works with a clean code. If you are l

Hernaldo Jesus Henriquez Nuñez 10 Jul 16, 2022
A large-scale dataset of both raw MRI measurements and clinical MRI images

fastMRI is a collaborative research project from Facebook AI Research (FAIR) and NYU Langone Health to investigate the use of AI to make MRI scans faster. NYU Langone Health has released fully anonym

Facebook Research 907 Jan 04, 2023
Image2scan - a python program that can be applied on an image in order to get a scan of it back

image2scan Purpose image2scan is a python program that can be applied on an image in order to get a scan of it back. For this purpose, it searches for

Kushal Shingote 2 Feb 13, 2022
A simple image to text converter with GUI!

TEXTEMAGE! Textemage is a quick tool that extracts text from images, it is a Python based GUI program(also available in executable version). This is a

Akascape 5 Oct 26, 2022
Py3D - A 3d rendering engine written entirely in python

Py3D is a 3d rendering engine written entirely in python. It is a simple and eas

1up Community 2 Nov 14, 2022
Detecting haze image with hazer.

hazer-py Detecting haze image with hazer. What is hazer Hazer is a lib for getting "haze degree". This repository is python version of hazer: https://

Joey777210 2 Dec 27, 2021
A simple python script to reveal the contents of a proof of vaccination QR code.

vaxidecoder A simple python script to reveal the contents of a proof of vaccination QR code. It takes a QR code image as input, and returns JSon data.

Hafidh 2 Feb 28, 2022
An executor that wraps 3D mesh models and encodes 3D content documents to d-dimension vector.

3D Mesh Encoder An Executor that receives Documents containing point sets data in its blob attribute, with shape (N, 3) and encodes it to embeddings o

Jina AI 11 Dec 14, 2022
This Github Action automatically creates a GIF from a given web page to display on your project README

This Github Action automatically creates a GIF from a given web page to display on your project README

Pablo Lecolinet 28 Dec 15, 2022
kikuchipy is an open-source Python library for processing and analysis of electron backscatter diffraction (EBSD) patterns

kikuchipy is an open-source Python library for processing and analysis of electron backscatter diffraction (EBSD) patterns. The library builds on the

pyxem 53 Dec 29, 2022
Convert photos to paintings with python

Convert-photos-to-paintings Before the changes After the changes Before the changes After the changes This code is written in the Python programming l

Amir Hussein Sharifnezhad 3 May 31, 2022
Nutrify - take a photo of food and learn about it

Nutrify - take a photo of food and learn about it Work in progress. To make this a thing, we're going to need lots of food images... Start uploading y

Daniel Bourke 93 Dec 30, 2022
A ray tracing render implemented using Taichi language.

A ray tracing render implemented using Taichi language.

Mingrui Zhang 45 Oct 23, 2022
Python avatar generator for absolute nerds

pagan Welcome to the Python Avatar Generator for Absolute Nerds. Current version: 0.4.3 View the change history here. Remember those good old days whe

David Bothe 280 Dec 16, 2022
A simple Streamlit Component to compare images in Streamlit apps. It integrates Knightlab's JuxtaposeJS

streamlit-image-juxtapose A simple Streamlit Component to compare images in Streamlit apps using Knightlab's JuxtaposeJS. The images are saved to the

Robin 30 Dec 31, 2022
Python pygame project that turns your images to matrix rain

Matrix-Rain-An-Image This project implements the classic Matrix digital rain effect in python with pygame to build up an image provided with multiple

7 Dec 11, 2022