{"id":19808955,"url":"https://github.com/robbert-harms/mot","last_synced_at":"2025-05-01T08:30:30.103Z","repository":{"id":57443283,"uuid":"69730716","full_name":"robbert-harms/MOT","owner":"robbert-harms","description":"Multi-threaded Optimization Toolbox","archived":false,"fork":false,"pushed_at":"2022-10-20T17:22:13.000Z","size":2631,"stargazers_count":31,"open_issues_count":1,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-01T08:39:33.925Z","etag":null,"topics":["high-performance-computing","opencl","parallel-computing","science"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robbert-harms.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-01T09:43:51.000Z","updated_at":"2024-06-11T13:10:25.000Z","dependencies_parsed_at":"2022-09-02T08:15:36.154Z","dependency_job_id":null,"html_url":"https://github.com/robbert-harms/MOT","commit_stats":null,"previous_names":[],"tags_count":67,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robbert-harms%2FMOT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robbert-harms%2FMOT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robbert-harms%2FMOT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robbert-harms%2FMOT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robbert-harms","download_url":"https://codeload.github.com/robbert-harms/MOT/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224245799,"owners_count":17279649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["high-performance-computing","opencl","parallel-computing","science"],"created_at":"2024-11-12T09:15:18.674Z","updated_at":"2024-11-12T09:15:19.173Z","avatar_url":"https://github.com/robbert-harms.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"###################################\nMulti-threaded Optimization Toolbox\n###################################\nThe Multi-threaded Optimization Toolbox (MOT) is a library for parallel optimization and sampling using the OpenCL compute platform.\nUsing OpenCL allows parallel processing using all CPU cores or using the GPU (Graphics card).\nMOT implements OpenCL parallelized versions of the Powell, Nelder-Mead Simplex and Levenberg-Marquardt non-linear optimization algorithms\nalongside various flavors of Markov Chain Monte Carlo (MCMC) sampling.\n\nFor the full documentation see: https://mot.readthedocs.org\n\n\n****************\nCan MOT help me?\n****************\nMOT can help you if you have multiple small independent optimization problems.\nFor example, if you have a lot of (\u003e10.000) small optimization problems, with ~30 parameters or less each, MOT may be of help.\nIf, on the other hand, you have one big optimization problem with 10.000 variables, MOT unfortunately can not help you.\n\n\n****************\nExample use case\n****************\nMOT was originally written as a computation package for the `Microstructure Diffusion Toolbox \u003chttps://github.com/robbert-harms/MDT\u003e`_, used in dMRI brain research.\nIn diffusion Magnetic Resonance Imaging (dMRI) the brain is scanned in a 3D grid where each grid element, a *voxel*, represents its own optimization problem.\nThe number of data points per voxel is generally small, ranging from 30 to 500 datapoints, and the models fitted to that data have generally\nsomewhere between 6 and 20 parameters.\nSince each of these voxels can be analyzed independently of the others, the computations can be massively parallelized and hence programming\nin OpenCL potentially allows large speed gains.\nThis software toolbox was originally built for exactly this use case, yet the algorithms and data structures are generalized such that any\nscientific field may take advantage of this toolbox.\n\nFor the diffusion MRI package *MDT* to which is referred in this example, please see https://github.com/robbert-harms/MDT.\n\n\n*******\nSummary\n*******\n* Free software: LGPL v3 license\n* Interface in Python, computations in OpenCL\n* Implements Powell, Nelder-Mead Simplex and Levenberg-Marquardt non-linear optimization algorithms\n* Implements various Markov Chain Monte Carlo (MCMC) sampling routines\n* Tags: optimization, sampling, parallel, opencl, python\n\n\n*****\nLinks\n*****\n* Full documentation: https://mot.readthedocs.org\n* Project home: https://github.com/robbert-harms/MOT\n* PyPi package: `PyPi \u003chttp://badge.fury.io/py/mot\u003e`_\n\n\n************************\nQuick installation guide\n************************\nThe basic requirements for MOT are:\n\n* Python 3.x\n* OpenCL 1.2 (or higher) support in GPU driver or CPU runtime\n\n\n**Linux**\n\nFor Ubuntu \u003e= 16 you can use:\n\n* ``sudo add-apt-repository ppa:robbert-harms/cbclab``\n* ``sudo apt update``\n* ``sudo apt install python3-pip python3-mot``\n* ``sudo pip3 install tatsu``\n\n\nFor Debian users and Ubuntu \u003c 16 users, install MOT with:\n\n* ``sudo apt install python3 python3-pip python3-pyopencl python3-devel``\n* ``sudo pip3 install mot``\n\n\n**Mac**\n\n* Install Python Anaconda 3.* 64bit from https://www.continuum.io/downloads\u003e\n* Open a terminal and type ``pip install mot``\n\n\n**Windows**\nFor Windows the short guide is:\n\n* Install Python Anaconda 3.* 64bit from https://www.continuum.io/downloads\n* Install or upgrade your GPU drivers\n* Install PyOpenCL using one of the following methods:\n    1. Use a binary, for example from http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyopencl or;\n    2. Compile PyOpenCL with ``pip install pyopencl``, this requires:\n        * Visual Studio 2015 (Community edition or higher) with the Python and Common Tools for Visual C++ options enabled\n        * OpenCL development kit (`NVidia CUDA \u003chttps://developer.nvidia.com/cuda-downloads\u003e`_ or `Intel OpenCL SDK \u003chttps://software.intel.com/en-us/intel-opencl\u003e`_ or the `AMD APP SDK \u003chttp://developer.amd.com/tools-and-sdks/opencl-zone/amd-accelerated-parallel-processing-app-sdk/\u003e`_)\n* Open a Anaconda shell and type: ``pip install mot``\n\n\nFor more information and for more elaborate installation instructions, please see: https://mot.readthedocs.org\n\n\n*******\nCaveats\n*******\nThere are a few caveats and known issues, primarily related to OpenCL:\n\n* Windows support is experimental due to the difficulty of installing PyOpenCL, hopefully installing PyOpenCL will get easier on Windows soon.\n* GPU acceleration is not possible in most virtual machines due to lack of GPU or PCI-E pass-through, this will change whenever virtual machines vendors program this feature.\n  Our recommendation is to install Linux on your machine directly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobbert-harms%2Fmot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobbert-harms%2Fmot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobbert-harms%2Fmot/lists"}