{"id":531,"date":"2017-11-04T17:59:03","date_gmt":"2017-11-04T17:59:03","guid":{"rendered":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/?p=531"},"modified":"2017-11-04T17:59:03","modified_gmt":"2017-11-04T17:59:03","slug":"c-vieira-a-j-magana-ml-falk-re-garcia-writing-in-code-comments-to-self-explain-in-computational-science-and-engineering-education-acm-transactions-on-computing-education-toce-17417","status":"publish","type":"post","link":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/11\/04\/c-vieira-a-j-magana-ml-falk-re-garcia-writing-in-code-comments-to-self-explain-in-computational-science-and-engineering-education-acm-transactions-on-computing-education-toce-17417\/","title":{"rendered":"C Vieira, A J Magana, ML Falk, RE Garc\u00eda &#8220;Writing in-code comments to self-explain in computational science and engineering education.&#8221;\u00a0ACM Transactions on Computing Education (TOCE), 17(4):17, 2017."},"content":{"rendered":"<p>C Vieira, A J Magana, ML Falk, RE Garc\u00eda &#8220;<a class=\"gsc_vcd_title_link\" href=\"http:\/\/dl.acm.org\/citation.cfm?id=3058751\" target=\"_blank\" rel=\"noopener\" data-clk=\"hl=en&amp;sa=T&amp;ei=exH-WZSgApHAmgGj3xA\">Writing in-code comments to self-explain in computational science and engineering education<\/a>.&#8221;\u00a0ACM Transactions on Computing Education (TOCE), 17(4):17, 2017.<\/p>\n<h3>Abstract<\/h3>\n<div id=\"citationdetails\" class=\" x-tabs-top\">\n<div id=\"tab-body9\" class=\" x-tabs-body\">\n<div id=\"abstract\" class=\"ytab x-tabs-item-body\">\n<div class=\"tabbody\">\n<div>\n<p>This article presents two case studies aimed at exploring the use of self-explanations in the context of computational science and engineering (CSE) education. The self-explanations were elicited as students\u2019 in-code comments of a set of worked-examples, and the cases involved two different approaches to CSE education: glass box and black box. The glass-box approach corresponds to a programming course for materials science and engineering students that focuses on introducing programming concepts while solving disciplinary problems. The black-box approach involves the introduction of Python-based computational tools within a thermodynamics course to represent disciplinary phenomena. Two semesters of data collection for each case study allowed us to identify the effect of using in-code comments as a self-explanation strategy on students\u2019 engagement with the worked-examples and students\u2019 perceptions of these activities within each context. The results suggest that the use of in-code comments as a self-explanation strategy increased students\u2019 awareness of the worked-examples while engaging with them. The students\u2019 perceived uses of the in-code commenting activities include: understanding the example, making a connection between the programming code and the disciplinary problem, and becoming familiar with the programming language syntax, among others.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p class=\"post-excerpt\" class=\"post-excerpt\">C Vieira, A J Magana, ML Falk, RE Garc\u00eda &#8220;Writing in-code comments&hellip;<\/p>\n<div class=\"link-more\"><a href=\"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/11\/04\/c-vieira-a-j-magana-ml-falk-re-garcia-writing-in-code-comments-to-self-explain-in-computational-science-and-engineering-education-acm-transactions-on-computing-education-toce-17417\/\">Continue reading<span class=\"screen-reader-text\"> &#8220;C Vieira, A J Magana, ML Falk, RE Garc\u00eda &#8220;Writing in-code comments to self-explain in computational science and engineering education.&#8221;\u00a0ACM Transactions on Computing Education (TOCE), 17(4):17, 2017.&#8221;<\/span>&hellip;<\/a><\/div>\n<div class=\"link-more\"><a href=\"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/11\/04\/c-vieira-a-j-magana-ml-falk-re-garcia-writing-in-code-comments-to-self-explain-in-computational-science-and-engineering-education-acm-transactions-on-computing-education-toce-17417\/\">Continue reading<span class=\"screen-reader-text\"> \"C Vieira, A J Magana, ML Falk, RE Garc\u00eda &#8220;Writing in-code comments to self-explain in computational science and engineering education.&#8221;\u00a0ACM Transactions on Computing Education (TOCE), 17(4):17, 2017.\"<\/span>&hellip;<\/a><\/div>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"advanced_seo_description":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true},"categories":[45],"tags":[56],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/peeeSR-8z","jetpack_likes_enabled":true,"jetpack-related-posts":[{"id":688,"url":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2018\/01\/25\/c-vieira-a-jana-m-konieczny-r-e-garcia-and-a-magana-integrating-computational-science-tools-into-a-thermodynamic-course-journal-of-science-education-and-technology-januar\/","url_meta":{"origin":531,"position":0},"title":"C. Vieira, A. Jana, M. Konieczny, R.E. Garc\u00eda, and A. Magana. \u201cIntegrating Computational Science Tools into a Thermodynamic Course.\u201d Journal of Science Education and Technology. January 2018.","date":"01\/25\/2018","format":false,"excerpt":"C. Vieira, A. Jana, M. Konieczny, R.E. Garc\u00eda, and A. Magana. \u201cIntegrating Computational Science Tools into a Thermodynamic Course.\u201d Journal of Science Education and Technology. January, 2018. https:\/\/doi.org\/10.1007\/s10956-017-9726-9 Abstract Computational tools and methods have permeated multiple science and engineering disciplines, because they enable scientists and engineers to process large amounts\u2026","rel":"","context":"In &quot;Papers&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":509,"url":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/11\/04\/uas-shaikh-a-j-magana-c-vieira-re-garcia-an-exploratory-study-of-the-role-of-modeling-and-simulation-in-supporting-or-hindering-engineering-students-problem-solving-skills-proceedings-o\/","url_meta":{"origin":531,"position":1},"title":"UAS Shaikh, A J Magana, C Vieira, RE Garc\u00eda &#8220;An exploratory study of the role of modeling and simulation in supporting or hindering engineering students&#8217; problem solving skills.&#8221;\u00a0Proceedings of the 2015 ASEE Annual Conference and Exposition, June, 2015.","date":"11\/04\/2017","format":false,"excerpt":"UAS Shaikh, A J Magana, C Vieira, RE Garc\u00eda \"An exploratory study of the role of modeling and simulation in supporting or hindering engineering students' problem solving skills.\"\u00a0Proceedings of the 2015 ASEE Annual Conference and Exposition, No volume, No page, June, 2015.","rel":"","context":"In &quot;Papers&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":511,"url":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/11\/04\/o-alabi-aj-magana-re-garcia-gibbs-computational-simulation-as-a-teaching-tool-for-students-understanding-of-thermodynamics-of-materials-concepts-journal-of-materials-education-375-6-239\/","url_meta":{"origin":531,"position":2},"title":"O Alabi, AJ Magana, RE Garc\u00eda &#8220;Gibbs, computational simulation as a teaching tool for students&#8217; understanding of thermodynamics of materials concepts.&#8221; Journal of Materials Education. 37(5-6), 239-260, 2015.","date":"11\/04\/2017","format":false,"excerpt":"O Alabi, AJ Magana, RE Garc\u00eda \"Gibbs, computational simulation as a teaching tool for students' understanding of thermodynamics of materials concepts.\" Journal of Materials Education. 37(5-6), 239-260, 2015. \u00a0","rel":"","context":"In &quot;Papers&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":383,"url":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/10\/31\/fipy-and-oof-computational-simulations-for-modeling-and-simulation-of-computational-materials\/","url_meta":{"origin":531,"position":3},"title":"AJ Magana, RE Garc\u00eda &#8220;FiPy and OOF: Computational simulations for modeling and simulation of computational materials.&#8221;\u00a0Proceedings of the 117th Annual Conference of the American Society of Engineering Education (ASEE), Louisville, Kentucky, June. 20-23, 2010.","date":"10\/31\/2017","format":false,"excerpt":"AJ Magana, RE Garc\u00eda \"FiPy and OOF: Computational simulations for modeling and simulation of computational materials.\"\u00a0Proceedings of the 117th Annual Conference of the American Society of Engineering Education (ASEE), Louisville, Kentucky, June. 20-23, 2010. Abstract Modeling and simulation of materials has been identified as one relevant skill for undergraduate and\u2026","rel":"","context":"In &quot;Papers&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":379,"url":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/10\/31\/computational-materials-science-and-engineering-education-a-survey-of-trends-and-needs\/","url_meta":{"origin":531,"position":4},"title":"K Thornton, S. Nola, RE Garc\u00eda, M. Asta, GB Olson &#8220;Computational materials science and engineering education: A survey of trends and needs.&#8221;\u00a0JOM Journal of the Minerals, Metals and Materials Society. 61(10): 12-17, 2009.","date":"10\/31\/2017","format":false,"excerpt":"K Thornton, S. Nola, RE Garc\u00eda, M. Asta, GB Olson \"Computational materials science and engineering education: A survey of trends and needs.\"\u00a0JOM Journal of the Minerals, Metals and Materials Society. 61(10): 12-17, 2009. Abstract Results from a recent reassessment of the state of computational materials science and engineering (CMSE) education\u2026","rel":"","context":"In &quot;Papers&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":336,"url":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/2017\/10\/31\/microstructural-modeling-of-multifunctional-material-properties-the-oof-project\/","url_meta":{"origin":531,"position":5},"title":"RE Garc\u00eda, ACE Reid, SA Langer, WC Carter&#8221;Microstructural modeling of multifunctional material properties: the OOF project&#8221;\u00a0Continuum Scale Simulation of Engineering Materials: Fundamentals-Microstructures-Process Applications,\u00a0573-587.\u00a0Wiley\u2010VCH Verlag GmbH &#038; Co. KGaA, 2005.","date":"10\/31\/2017","format":false,"excerpt":"RE Garc\u00eda, ACE Reid, SA Langer, WC Carter\"Microstructural modeling of multifunctional material properties: the OOF project\"\u00a0Continuum Scale Simulation of Engineering Materials: Fundamentals-Microstructures-Process Applications,\u00a0573-587.\u00a0Wiley\u2010VCH Verlag GmbH & Co. KGaA, 2005. Abstract Recent advances in and applications of the public domain Object Oriented Finite Element software for Materials Science (OOF) are discussed.\u2026","rel":"","context":"In &quot;Papers&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/posts\/531"}],"collection":[{"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/comments?post=531"}],"version-history":[{"count":1,"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/posts\/531\/revisions"}],"predecessor-version":[{"id":532,"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/posts\/531\/revisions\/532"}],"wp:attachment":[{"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/media?parent=531"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/categories?post=531"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/engineering.purdue.edu\/ComputationalMaterials\/index.php\/wp-json\/wp\/v2\/tags?post=531"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}