This library contains contact force models and force laws for multibody modeling in Simscape Multibody. They cover 2-dimensional and 3-dimensional problems with or without friction. More than 35 example models are provided, including basic contact force examples (bouncing ball) and more complex applications such as a cam-follower mechanism, differential drive robot, and a robot arm with a gripper. Both linear and nonlinear force laws are included, and you can easily add your own custom force law.
Please read the README.txt file to get started.
See how to use these forces to model a cam-follower mechanism:
Learn more about multibody simulation with Simscape Multibody by watching this webinar
Find other Simscape examples by searching posts for the keyword "physical modeling"
Learn more about MathWorks Simscape Products:
You may reuse this content, with or without modification, in your work.
Please follow the conditions of the license file and use the following citation:
 Miller, Steve (2017), Simscape Multibody Contact Forces Library (https://www.mathworks.com/matlabcentral/fileexchange/47417) MATLAB Central File Exchange. Retrieved on <date you downloaded submission>
Hi Nikolaos -- please provide me your email address and I will email you the R2015a version directly. Click on my name above to access my profile page within MATLAB Central, and then click on the "Contact" button that appears below my name to send me your email address. --Steve
would it be possible for you steve to please send to my email the r2015a contact library?
thank you in advance
Hi Guessam -- please provide me your email address and I will email you the R2017a version directly. Click on my name above to access my profile page within MATLAB Central, and then click on the "Contact" button that appears below my name to send me your email address.
Unfortunately, the File Exchange does not permit submissions of over 20MB, and with all the examples I can only save 2 releases worth in the zip file. I have versions of library for each release all the way back to R2015a, so get me your email and I will send it.
Hi, how to add Contact Forces Library in simscape multibodysuch that i get Matlab ver2017a
Hi Utku -- please provide me your email address and I will email you the R2015b version directly. Unfortunately, the File Exchange does not permit submissions of over 20MB, and with all the examples I can only save 2 releases worth in the zip file. I have versions of library for each release all the way back to R2015a, so get me your email and I will send it.
Thank you for this wonderful library. Could you please send me the 2017A version? My email id is firstname.lastname@example.org.
Hi Steve I am trying to simulate a balance robot but I need a 2015b version can you help?
Hi Mostafa - please provide me your email address and I will email you the R2016b version directly. Unfortunately, the File Exchange does not permit submissions of over 20MB, and with all the examples I can only save 2 releases worth in the zip file. I have versions of library for each release all the way back to R2015a, so get me your email and I will send it.
Would you re-uploud 2016b version please?
Can you send me a copy for ver 17a?
Seems very promising!
Is it possible to have a R2017a version?
This looks great. I don't see to model tube in tube (3D) contact (application: piston in cylinder). Can you add that to the next submission. Thanks!
@Angelo - contact me directly for R2017a versions.
@deltanabla - your park brake mechanism looks do-able to me.
@Dmitriy - mesh-to-mesh is possible but computationally expensive. I haven't worked on that yet, as I'm trying to see how far we can go with computationally efficient models.
@zy - for uneven terrain, you could use this library if your bumps can all be spheres or cylinders. The linear contact force is Kelvin-Voigt, the nonlinear one is similar to Hunt and Crossley, mainly included to show how to create a custom force. The documentation in the submission shows the formula I used.
What is the contact model in the library?
Is it linear "Kelvin-Voigt Contact Model" and nonlinear "Hunt and Crossley Contact Model"? Or someone else?
Steve, you're the best! Will there ever be a mesh to mesh contact model?
I am right now using this library to simulate unmanned ground vehicle on uneven terrain, is there possible to add some more complicate type of contact, like sphere to sine wave cure surface, or sphere to self defined curve surface?
And, is there possible to add cylinder to x contact?
I am interested in modelling the following parklock mechanism using simscape. I see in your library that there is a 'disk on finite plane'. I think this might be a starting point.
I would need to somehow create a wheel consisting of a circular pattern of flat surfaces which will be in contact with a cylindrical surface on the pawl.
What is your opinion?
Steve, now I can open the models but many of them seem not run with R2017a.
Undefined functions of variable error for many values . I think it does not depend on the matlab reléase but on some missing parameters in the initialization.
Can you help in this?
thank u sooooooooo much
All solved now, thanks for the help Steve!
@Chris - perhaps your stiffness and damping coefficients are too small. This should certainly work. If you can't figure it out, send me the model.
@Anousha - for uneven terrain, you need to insert a force between the feet and every panel of the surface. Not sure what kind of errors you're getting. Errors with this library are unusual, normally it is unexpected behavior.
@Shubham - there is a tread drive example for a chain-drive system such as a bulldozer. I have a better version of that model that I hope to upload soon. Email me if that is what you're looking for.
Hi Steve, I have an adapted model of a quadruped, based on the walking robot tutorial. When the joints are moving (i.e. a friction force is acting) the model behaves as expected. When the joints are completely stationary (no changes to the model itself), the robot falls through the floor. I am using Face to Plane contact forces (but have tried Sphere to Plane contact forces, with the same problem). Am I missing something, or have I discovered a bug?
It's a nice library. Did anyone get around with biped walking on uneven terrain? I am working on it and its showing lot of error messages.If so please share me your insight.
I am working with chain drive system For this which contact should i use? Can anyone suggest me this ?
I have read your answers, thanks a lot. I want to simulate the ring(or tube) on a cylinder, so I want a tube-on-tube contact force. Or you can give me some advices based on existing contact force library. Thanks very much!
Many thanks, Steve, I've extended the two legs walking robot (robotics arena) to a six-legged robot. Everything was perfect. My question is, what to do to extend to step over an object or walking on an uneven surface?
@Dhayaa - see https://www.mathworks.com/matlabcentral/fileexchange/64227-matlab-and-simulink-robotics-arena--walking-robot for robot walking on flat surface, can be extended to uneven surface.
@ HT. Tube-on-Tube would be great. I haven't yet had the time to derive (or find) the equations to determine the contact point and relative velocity between two tubes. Perhaps the community has suggestions.
@ Pavel - 69 and still going strong, wow. I'm inspired by you!
Thank you so much for this very useful libraries.
Would it be possible to simulate contact with different surface level?
In other words, modelling a walking robot walk on uneven ground.
promising library, would this library can simulate the tube on tube force ?
Thanks, Steve. Learning from you. I'm 69 years old. Saint Petersburg, Russia.
@Sebastian Castro: Thank you for your help! I did what you told, and now it works. I was suffer from that error until you help :)
@Taewon Kim: This is a commonly encountered error and it has an easy solution. Please refer to the following MATLAB Answer.
First of all, thanks for your library!
However, I need some help. I just try to make simple example of collision between ball and plane, but I got some error.
'External Force and Torque External_Force_and_Torque_PlaB has its follower port rigidly connected to the world frame; it has no effect. You can configure this diagnostic in the Simscape Multibody Configuration Parameters dialog.'
I compared with example that you provide and tried figure out what is problem, but I don't know what is wrong.
Would you like to give me some advice please?
I get the error :(
Number of blocks in the block diagram 'Coll3D_05_Ball_Peg_Board' and all models it references exceeds the license limit of 1000 nonvirtual blocks.
Please heelp ! I cannot run any demo model
Wonderful work! I've been using your library for about a year now at the Robotics Institute to simulate various robot-environment interactions. I was wondering if you have any advice regarding solver settings for robust but efficient execution of models with stiff collisions (metal on metal, etc.)? I've landed on ode15s with relative tolerance 1e-5, auto for max/min step size and abs tol, no shape preservation, fast solver reset, NDF max order 3, and auto for jacobian solver.
I know the documentation suggests that 1e-3 rel tol is usually sufficient, but I get instability very quickly otherwise.
This is all in the context of stick-slip friction with velocity thresholds on the order of 1e-3, and linear spring/damper normal forces with spring constants on the order of 1e4 N/m and damping on the order of 1e3 Ns/m...
My only thought is to artificially soften the stiffness in order to lower the effective time constants of the impulsive collisions that occur in the model... might you have any other insights?
Does Matlab Home edition still gives error with this library that a limit of 1000 blocks has been reached or has it been fixed ?
For your use case, I believe you would like to model an uneven 3D surface. I think to do this more efficiently, a triangular contact force element would be good. It would be easier to create a tesselated surface could be created that would only require 1 force per reference point instead of 3.
As with many modeling and simulation scenarios, you either "pay" during the modeling and compilation phase or pay during the simulation phase. Put another way, you either expend extra time during the modeling and compilation phase to create an efficient model that runs quickly, or you use a generic but expensive collision detection algorithm during simulation. For the time being, this submission is focused on the first method. Thanks -- Steve
Wow, in retrospect it is really obvious.
Last question, if you don't mind: is it in any way possible to model an uneven surface with this lib? I understand that i can, theoretically, assemble whatever surface i want from lots of small planes and balls. But when i as much as try to add lots of contact blocks - the model begins to take forever to compile.
I recognize that this is a complex subject and i guess there is no magical solution, but maybe you have any hints for me.
Thank you for great work.
Hi Anton - to prevent the sphere from entering at the edge of the plane, you need to add another contact force. With 3 Sphere to plane contact forces oriented along the X, Y, and Z axes of a cube, you can create a "Sphere to Cube" contact force. --Steve
Hello, Steve and Richard.
Yes, the error was due to rigid transforms in a loop, and now i have found a workaround for it. Turns out the contact forces don't have to be connected to the actual planes.
Here is the screenshot of how i have connected them https://puu.sh/xbJdQ/68920d5cb2.png Inside the FE blocks there are parallel contact forces https://puu.sh/xbJj2/bafeacf2c2.png
This basically creates 4 balls in the same location and 4 planes in different locations (i can correct locations with rigid transform).
Now i have another issue: contact planes are represented as two planes with a space between them https://puu.sh/xbJs1/0927fa52c2.png When a ball contacts with the outer side of these planes it works as intended. But in case when the ball gets in between these planes and touches one of them from the inside my model freezes. And since there is no "side" planes, nothing prevents the ball from going in between the planes. Is there any possible solution for it? I'd be happy if the plane was treated as a square, if it is possible.
Hi Anton and Richard - Weld Joints are only rarely needed in Simscape Multibody, and I don't expect you would need them here. Can you upload a screenshot of the error, and perhaps the model? I suspect you have connected rigid transforms in a loop and all you would need to do is delete one of the connection lines, but I would need to see the error message and model to be sure. Thanks, --Steve
Hi Anton, I have encountered a similar issue and using weld joint to connect to the contact block helped me to solve the issue.
Hi, can you help me with a certain problem?
I'm trying to build a model of a platform with four legs, which is landing on four "tables". I placed contact forces on the ends of the legs, and currently it looks like this https://puu.sh/x5Knq/498696785f.png
But in this model each leg can only interact with it's respective plane, because I connected them this way https://puu.sh/x5Kta/0a938c9a43.png
I need several contact forces to be connected to several planes, but when I try to do so I'm getting an error (rigid cycle).
What should i do? Thanks in advance,
plz,help me. I don't quite understand the the friction force in the library. your friction force in always a product of the coefficient of the friction times the Normal force. If the ball purely rolls, the velocity at point of contact is zero. Then,the coefficient is zero,there would be no friction.
First off, awesome library, this was definitely missing from simbody.
For that project I am trying to model a car. I have 2 free rear wheels and two steering wheels in the front. The weight of the car is 1500kg. When I apply a constant torque of 250Nm on the front wheels, the car gain speed, but the wheel rotation speed seem to oscillate around a ramp. It is slow at first but the frequency of the oscillation seems to increase at the vehicle speed increases as well.
Is it a natural behaviour in any car? Are there oscillations in the wheel rotation speed that are not really a problem? Is it something coming from your library? I am a bit new to mechanics so I cannot really tell.
You can reproduce all that in your 2 wheel robots buy applying a constant torque of 0.05 and plotting the angle rate from the revolute joint directly.
In my case I get the oscillations with any torque value, say from 100 to 500 for example.
Any help or tip on that would be much appreciated.
Again, thanks for your work.
Daniel - thanks for catching the problem with the signal outputs. That is fixed in latest update (v3.4, both R16a and R16b).
Jing -- the Simscape blocks could be used for contact along one dimension, such as a hardstops in a cylinder or backlash in gears. These models are intended for 2D or 3D contacts. See this File Exchange Submission:
Qing -- anisotropic friction, good request. These models assume friction is the same in all directions. Do you have an animation of the movement you are expecting? There might be a way to use multiple forces at right angles to get the desired effect, but it would require some thought.
Thanks for all the comments and feedback!
This library is awesome! But I got some trouble when I used it to model the snake robot. The snake robots need anisotropic friction to move forward. If I used Sphere-to-Plane Force to model the contact force and friction force between the wheels and plane, the friction became isotropic. So the robot just rolled on the floor and did not move a bit. Could you give me some advice about how to achieve anisotropic friction between wheels and plane? Thank you so much!
This library is great! But I found there is some friction blocks in Simscape, like the Rotational Friction/Damper blocks in the Foundation Library of Simscape. What is the difference between your library and those simple blocks? Is it possible to build the same contact model with these original Simscape blocks?
Thanks for your sharing!
This library has been a great asset for the work that I'm doing. Thank you very much for this!
(now for the "But...")
I'm using the 2D library and I've noticed what I believe is an error with the output forces for the Circle to Ring block. I think the forces are applied to the joints correctly, but the output force does not "turn off" when the circle has passed beyond the active range. Therefore my plots are showing a constant ring force once the circle is beyond the ring (my model transitions from a ring to a circle to a line).
Normally this would be essentially a cosmetic problem, but I need the contact forces so I'm having to put my own logic in to zero out the force at the appropriate location.
Thanks again for these powerful tools.
I found that there might something wrong with the friction force law.
When v_th < v < 1.5v_th, I think the function should be:
u = 3*us - 2*uk - (us-uk)*v/(0.5*v_th)
u = us - (us-uk)*v/(0.5*v_th).
However I checked the "Friction Law" block and it should works correctly.
I wonder your lib allow me to use multiple point on one elements. I try to achieve it by putting 4 sphere at the corner of the lower side of a cube(which was imported from solidwork). I thought I will see four ball connected to each other through the cube and bounce when it hit the plane. However, it turns out that only one sphere does the correct reaction.
This library is really helpful!
I wonder if someone has modeled contact between two surfaces whose geometries are determined by splines. If this library suitable in such a case?
I will appreciate it if anyone can help.
Hi, thanks Steve For the library ...
i am searching for a way to determine the collision detection between two bodies,
would guide me please ...
The error is not there actually. I just made a minimum working example and it works as it should :) So your model works very well. I might have made a mistake somewhere in my previous project where it seemed that there was an error in the contact block.
Hi Tudor - not sure which blocks you are referring to. Damping behavior appears correct in Frict3D_04_Ball_on_Ball. Will follow up with you separately.
Vinay - sorry it took me a while to react to your post. Feel free to contact me via my author page.
Janmejaya - yes, you can measure force per leg.
Prof Liebgott - Converting the internals of the force blocks to an S-Function would likely create a model with less than 1000 blocks. I will give this a try.
Thanks for all the interest and use of the library! --Steve
The damping force in the sphere-to-sphere is not correct. You are applying it to the norm of the speed, which can never be negative, so after the saturator the result is always 0.
Can I use it to find magnitude of Ground Reaction Force acting on a leg of hexapod ?
If I am going to vary weight on each leg, by adding some mass block, is GRF calculated using this library is going to vary?
Thanks a lot,
This library is very useful and correspond to classical mechanical enginneering problems. Unfortunatly most of examples use more than 1000 blocs and it is not possible to use them with the MATLAB Pass licence with my students...Is there any solution to run these models on MATLAB pass licence?
Thanks for your answer.
Professor Ivan LIEBGOTT
Well, it's very useful,thanks a lot. I met a problem on 08 July and this file update to 3D one day later ,I'm so lucky and thank to Steve Miller.
I am very happy to have found this library, as it helped me a lot in my simulations.
I will, however, need a version of this library that works in 3D; is there any such thing? If not, would you be interested in providing some tips for me to create one, based on this current submission (which is great btw)?
Under what license is your work published? Can I modify it? Would I be able to publish a new library, based on yours, if I ever get it to work?
Hello Steve, My name is Montassar and I m a young PhD Student from France.
i have seen your work the 2D contact library, i really find it very interesting and innovating, but i do have a question, how did you find information about the variables "k" and "b" for the spring and the dumper, i know it is related to the material used and k=the young modulus, but how can you be "sure" of the values of the k and b that you are using.
thank you very much for you time and your help.
OK, I had to make a new File Exchange submission.
Thanks Steve for your help!
The models in this submission are for use with SimMechanics Second Generation Technology. SimMechanics is being actively developed with new features each release (every six months) -- see the release notes online:
New features are added to Second Generation Technology (2G). First Generation Technology (1G) will be supported as long as is necessary.
Thanks for your update. Will these models work for the First-Generation SimMech or the Second-Generation technology ?
I'm not feeling comfortable to use a product in which is not being actively developed anymore. Sure it will work for a few next releases, but for how long ?
3D contacts and contacts with splines are possible with SimMechanics. We've done that with other users, using both Simulink and MATLAB for custom contact detection and force calculation. Though I cannot share those confidential models, I'm working on versions that can be shared. Thanks for your interest and questions.
As far as I understand no 3D contacts are possible. Only line to line, line to circle etc.
For more complex cam geometries simmechanics is pretty useless. You can't use a cubic spline for instance.
We used Adams for this, a real multi body package.
Great library. However, I would need a 3D contact, for example "Circle to Finite Plane Force". It could be used to model a ball on a plane. Are you going to provide that?
Added robot walking on uneven surface, updated tread drive example, small change to Sphere to Belt Force. R18a and R17b included here, contact me for earlier releases.
Added Sphere to Tube Enabled Force, Sphere to Belt Force. New examples Ball Bearing Testrig and Tread Drive on Uneven Surface. v4.0 works with R15a-R18a, contact me if your MATLAB release is not in this submission.
Added Cam Roller Constraint which uses Point-on-Curve Constraint to model circular roller on a cam with arbitrary profile. New example Cam_Follower_Constraint.slx uses the new block.
Added R2017b version.
Added Sphere-to-Cone, fixed error in Sphere-to-Tube, many other updates. Submission includes versions for R17a, R16b, R16a, contact me for earlier releases. Recommend updating to this version.
Updated for R2017a. Added MATLAB code to extract a copy of just the libraries for use in other projects.
Added Face-to-Plane and Face-to-Belt (3D Composite Forces), Sphere-to-Plane Enabled (3D). Added "Gripper with Conveyor Belts" example (3D application). Re-added R14b version, removed GIF files, removed STL files from R14b and R15b.
Added R2016b version; Fixed reported output force signals for Circle-to-Ring, Sphere-to-Tube, Sphere-to-Plane (not calculation, just outputted value); Dropped R2014b version due to 20MB file size limitation on File Exchange.
Hid the contact force surfaces in conveyor belt example.
Added ability to visualize contact surfaces to all contact forces. Helps you make sure you positioned, oriented, and sized the surfaces appropriately.
Disabled one zero crossing in Circle-to-Finite Line, two in Sphere-to-Plane. Better performance in a few cases.
Added R2016a version.
Includes v3.0 for R2015b, R2015a, and R2014b.
Includes v3.0 for R2015b, R2015a, and R2014b.
Version 3.0 Added 3D contact models (Sphere-to-Sphere, Sphere to Plane, Sphere-to-Tube) with friction. Added composite 2D forces (Box to Box, Box to Belt). New examples include box on conveyor belts, two wheel robot. See README.txt in zip file.
Version 2.0. Added friction to contact models; added many friction examples, fixed two mistakes in force laws (Contact_Forces_Lib.slx); added box-to-box contact force (Spinning_Boxes.slx). See README.txt in zip file for details.
Added video links
Updated submission name
Inspired: MATLAB and Simulink Robotics Arena: Walking Robot, Sphero Simulation in Simscape Multibody, MATLAB and Simulink Robotics Arena: Designing Robot Manipulator Algorithms, MATLAB and Simulink Robotics Arena: Introduction to Contact Modeling, Simscape Multibody Parts Library, Simscape Multibody Mini Golf Library, Simscape Multibody Multiphysics Library, Simscape Tutorial Exercises, Robot Arm with Conveyor Belts, Running Robot Model in Simscape, Scissor Lift Model in Simscape Multibody
View the winning live scripts from faculty and students who participated in the recent challenge.Learn more
Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.