Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
doc:migration_guide [2016/02/09 17:58] gkazhoyadoc:migration_guide [2016/03/04 14:31] (current) – old revision restored (2016/02/09 19:12) gkazhoya
Line 86: Line 86:
  
  
-==== cram_bridge ====+**Hint:** there are some awesome tutorials on ''cram_core'' on this website, all the tutorials that are under "Beginner tutorials" category [[http://cram-system.org/tutorials|here]] use solely ''cram_core'' and demonstrate the features of CRAM, check them out. 
 + 
 + 
 +===== cram_bridge =====
  
 The ''cram_bridge'' repository / metapackage had enormous dependencies on the other CRAM / IAI packages - you needed the whole CRAM and a bunch of robot drivers and some experimental code just to be able to use a Lisp JSON Prolog implementation or the semantic logging mechanism. To avoid that the three most widely used packages from there got separated into their own repositories: [[https://github.com/cram2/cram_beliefstate|cram_beliefstate]], [[https://github.com/cram2/cram_json_prolog|cram_json_prolog]], [[https://github.com/cram2/cram_moveit|cram_moveit]]. The ''cram_bridge'' repository / metapackage had enormous dependencies on the other CRAM / IAI packages - you needed the whole CRAM and a bunch of robot drivers and some experimental code just to be able to use a Lisp JSON Prolog implementation or the semantic logging mechanism. To avoid that the three most widely used packages from there got separated into their own repositories: [[https://github.com/cram2/cram_beliefstate|cram_beliefstate]], [[https://github.com/cram2/cram_json_prolog|cram_json_prolog]], [[https://github.com/cram2/cram_moveit|cram_moveit]].
  
-==== Higher level packages ====+===== cram_highlevel and cram_physics ===
 + 
 +There were way too many changes in the higher level packages to write a comprehensive migration guide but here is a general overview. (If you have your own code that uses ''cram_highlevel'' or ''cram_physics'' you are strongly advised to get in touch with [[/user/gayane_kazhoyan|Gaya]] and get her to help you with migration.)
  
-There were really a lot of changes in the higher level packages to write a comprehensive migration guide but here is a general overview.+There used to be two high-level packages: ''cram_highlevel'' and ''cram_physics'', now there are four: ''cram_plans'', ''cram_semantic_maps'', ''cram_3d_world'', ''cram_costmaps''. The functionality that used semantic environment maps from KnowRob in ''cram_highlevel'' got separated into ''cram_semantic_maps'' such that if you only want, say the plan library, you wouldn't have to download the whole semantic map business and have to compile that. The same with the specific costmaps that were in ''cram_physics'', they are now in ''cram_costmaps'', also PR2-specific code of ''cram_physics'' went to ''cram_pr2''.
  
-There used to be two high-level packages+To get a better picture of the current state take a look at [[https://docs.google.com/spreadsheets/d/1FTPf2HjlM18BMpSwd9GKimZCcmlNYAZLuQPkJAROVLg/edit#gid=0|this spreadsheet]] 
 +or at [[https://github.com/cram2/cram_projection_demos/blob/master/cram-with-projection.rosinstall|this rosinstall file]].
  
 +There is a tutorial on how you can use the semantic environment maps with minimal dependencies in your own code [[http://cram-system.org/tutorials/intermediate/semantic_environment_map|here]].
  
 +Soon there will be a tutorial on writing your own plan library with minimal dependencies, so stay tuned.