Menu

Tree [b1cfca] default tip /
 History

Read Only access


File Date Author Commit
 @CompleteConstraintContact 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @Contact 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @ContactStructure 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @Cover 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 @EntityWithPOIs 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @ExternalPlannerData 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 @Glove 2013-01-23 Matteo Morelli Matteo Morelli [b1cfca] fixing poiForwardKinematics() for Gloves with P...
 @GrOpt2dProblem 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @GrOptForceClosure 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @GrOutForceClosure 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @GrOutHomogeneousForces 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @GrOutManipulability 2012-09-01 Matteo Morelli Matteo Morelli [f92aad] adding GrOut* classes for mobility and manipula...
 @GrOutRigidManipulability 2012-09-01 Matteo Morelli Matteo Morelli [f92aad] adding GrOut* classes for mobility and manipula...
 @GrOutRigidMobility 2012-09-01 Matteo Morelli Matteo Morelli [f92aad] adding GrOut* classes for mobility and manipula...
 @Grasp 2012-09-01 Matteo Morelli Matteo Morelli [f92aad] adding GrOut* classes for mobility and manipula...
 @Hand 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 @HandPOIStructure 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @HardFingerContact 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @Limb 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @ManipulatedObject 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 @ObjectPOIStructure 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @POI 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @POIStructure 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 @SoftFingerContact 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 demo_examples 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 html 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 service 2013-01-22 Matteo Morelli Matteo Morelli [38a112] Adding support for external planners (ExternalP...
 README.txt 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 info.xml 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 license.txt 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 llc_gfo.m 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 llc_hforce.m 2012-05-06 Matteo Morelli Matteo Morelli [8102c2] initial revision of THE Robotic Grasping Toolbo...
 llc_hmanip.m 2012-06-24 Matteo Morelli Matteo Morelli [33601c] integrating the HMANIP routine with the rest of...
 llc_hmob.m 2012-09-01 Matteo Morelli Matteo Morelli [947ffb] fixing typos in the doc; fixing minor bugs in p...
 llc_smanip.m 2012-09-01 Matteo Morelli Matteo Morelli [947ffb] fixing typos in the doc; fixing minor bugs in p...

Read Me

======================================================================
= THE Robotic Grasping Toolbox, (brief) Installation and Usage notes =
======================================================================

Matteo Morelli, Interdepartmental Research Center "E.Piaggio", Faculty of Engineering - University of Pisa.

May 2012.

1. About THE Robotic Grasping Toolbox
-------------------------------------

This package, the Robotic Grasping Toolbox, is a cross-platform, free-software (released under the GPLv3) toolbox for
use with MATLAB(R).

It extends the functionalities of the Robotics Toolbox for MATLAB (RTB), by P. Corke, to deal with the modelling,
analysis and optimization of complex manipulation systems, ranging from cooperating multi-arm systems to closed-chain
mechanisms and underactuated robotic hands grasping objects.

Please refer to the included documentation for a more comprehensive description of its capabilities and unique features.

2. License
----------

The Robotic Grasping Toolbox for use with MATLAB(R) is free-software, released under the terms of the GNU General Public
License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later
version.

3. Software Requirements
------------------------

The RTB package is required to model the topology of the robotic fingers, that are simple chains of links connected
through revolute or prismatic joints.

The toolbox makes heavy use of the MATLAB(R)'s OOP framework, available since version R2008a. At the current stage of
implementation, the matlab.mixin.Heterogeneous abstract class is used to define hierarchies of classes whose instances
can be combined into heterogeneous arrays. As result, the Robotic Grasping Toolbox currently requires at least MATLAB(R)
R2011a.

Note that future releases may remove this dependency bringing the minimum required MATLAB(R) version back to R2008a.

4. Current Limitations
----------------------

The API of the toolbox is currently under internal revision at UNIPI and most of the documentation is still in progress.

Graphic functionalities are not available at this stage; in fact, this package should be meant as a *preliminary*,
*alpha-quality* distribution demostrating the potential of the final product. 

5. Installation Instructions
----------------------------

Assuming that the software requirements are met (see Section 3 for details), simply adjust the MATLABPATH to include
this directory *and* all its subdirectories.

For more information about adjusting the search path, please refer to the section "Adding Folders to the Search Path" in
the MATLAB(R) help, or at the following web link:
http://www.mathworks.it/help/techdoc/matlab_env/br7ppws-1.html#br7poxu-1.

6. Getting Started
------------------

In order to get started with the Robotics Grasping Toolbox, please follow the tutorials that are included in the section
"Getting Started" of the documentation.