Differences

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

--- doc:migration_guide [2016/02/09 17:50] – created gkazhoya
+++ doc:migration_guide [2016/03/04 14:31] (current) – old revision restored (2016/02/09 19:12) gkazhoya
@@ Line 1: / Line 1: @@
 ====== CRAM v0.1 -> CRAM v0.2 ======
+===== cram_3rdparty =====
+Stayed unchanged. Only got updated (merged PRs from one of the Suturo students).
 ===== cram_core =====
@@ Line 81: / Line 85: @@
 If you don't like this change, please complain.
+**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]].
+===== 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 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''.
+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.