{"id":1723,"date":"2021-05-17T08:43:48","date_gmt":"2021-05-17T08:43:48","guid":{"rendered":"http:\/\/lucylabs.gatech.edu\/ml4t\/?page_id=1723"},"modified":"2021-05-18T15:02:06","modified_gmt":"2021-05-18T15:02:06","slug":"software-setup","status":"publish","type":"page","link":"https:\/\/lucylabs.gatech.edu\/ml4t\/summer2021\/software-setup\/","title":{"rendered":"Software Setup"},"content":{"rendered":"<p>[et_pb_section fb_built=&#8221;1&#8243; _builder_version=&#8221;4.4.5&#8243;][et_pb_row _builder_version=&#8221;4.4.5&#8243;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.4.5&#8243;][et_pb_text _builder_version=&#8221;4.4.6&#8243; header_font=&#8221;|700||on|||||&#8221;]<\/p>\n<h1 id=\"firstHeading\" class=\"firstHeading\" lang=\"en\" style=\"text-align: center;\"><span dir=\"auto\">ML4T Software Setup<\/span><\/h1>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.4.5&#8243;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.4.5&#8243;][et_pb_text _builder_version=&#8221;4.9.4&#8243; header_2_font=&#8221;|||on|on||||&#8221;]<\/p>\n<h2><span id=\"Notice\" class=\"mw-headline\">Notice<\/span><\/h2>\n<p>The repository has been made private for the Fall 2017 semester, and so the links to the repository below will no longer be visible for you. A zip file containing the grading script and any template code or data will be linked off of each assignment&#8217;s individual wiki page. A zip file containing the <tt>grading<\/tt> and <tt>util<\/tt> modules, as well as the data, is available here: <a class=\"internal\" href=\"https:\/\/www.dropbox.com\/s\/fgw4o1djuh67oyk\/ML4T_2021Sum.zip?dl=1\" target=\"_blank\" rel=\"noopener noreferrer\">File:ML4T_2021Sum.zip<\/a>. The instructions on running the test scripts provided below still apply.<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.4.5&#8243;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.4.5&#8243;][et_pb_text _builder_version=&#8221;4.9.4&#8243; header_2_font=&#8221;|||on|on||||&#8221;]<\/p>\n<h2><span id=\"Overview\" class=\"mw-headline\">Overview<\/span><\/h2>\n<p>Most of the projects in this class will be graded automatically. As of the summer 2017 semester, we are providing the grading scripts with the template code for each of the projects, so that students can test their code to make sure they are API compatible.<\/p>\n<h3><span id=\"Important_Notes\" class=\"mw-headline\">Important Notes<\/span><\/h3>\n<ul>\n<li>Your code <b>MUST<\/b> run properly on Gradescope. If you would like to develop on your personal machine and are comfortable installing libraries by hand, you can follow the instructions here: <a href=\"http:\/\/lucylabs.gatech.edu\/ml4t\/summer2021\/local-environment\/\" target=\"_blank\" rel=\"noopener noreferrer\">ML4T_Local_Environment<\/a>. Note that these instructions are from an earlier version of the class, but should work reasonably well.<\/li>\n<li>We use a specific, static dataset for this course, which is provided as part of the repository detailed below. If you download your own data from Yahoo (or elsewhere), you will get wrong answers on assignments.<\/li>\n<li>We reserve the right to modify the grading script while maintaining API compatibility with what is described on the project pages. This includes modifying or withholding test cases, changing point values to match the given rubric, and changing timeout limits to accommodate grading deadlines. The scripts are provided as a convenience to help students avoid common pitfalls or mistakes, and are intended to be used as a sanity check. <b>Passing all tests does not guarantee full credit on the assignment, and should be considered a necessary but not sufficient condition for completing an assignment.<\/b><\/li>\n<li>Using github.gatech.edu to back up your work is a very good idea which we encourage, however, make sure that you <b>do not<\/b> make your solutions to the assignments public. It&#8217;s easy to accidentally do this, so please be careful:\n<ul>\n<li><b>Do not<\/b> put your solutions in a <b>public<\/b> repository. Repositories on github.com are public by default. The Georgia Tech GitHub, github.gatech.edu, provides the same interface and allows for free private repos for students.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.4.6&#8243;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.4.6&#8243;][et_pb_text _builder_version=&#8221;4.9.4&#8243; header_2_font=&#8221;|||on|on||||&#8221;]<\/p>\n<h2><span id=\"Getting_code_templates\" class=\"mw-headline\">Getting code templates<\/span><\/h2>\n<p>As of Spring 2018, code for each of the individual assignments is provided in zip files, linked to on the individual project page. The data, grading module, and util.py, which are common across all assignments, are available here <a class=\"internal\" href=\"https:\/\/www.dropbox.com\/s\/fgw4o1djuh67oyk\/ML4T_2021Sum.zip?dl=1\" target=\"_blank\" rel=\"noopener noreferrer\">File:ML4T_2021Sum.zip<\/a>\u00a0(same file as above).<\/p>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.4.6&#8243;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.4.6&#8243;][et_pb_text _builder_version=&#8221;4.9.4&#8243; header_2_font=&#8221;|||on|on||||&#8221; hover_enabled=&#8221;0&#8243; sticky_enabled=&#8221;0&#8243;]<\/p>\n<h2><span id=\"Running_the_grading_scripts\" class=\"mw-headline\">Running the grading scripts<\/span><\/h2>\n<p>The above zip files contain the grading scripts, data, and util.py for all assignments. Some project pages will also have a link to a zip file containing a directory with some template code, which you should extract in the same directory that contains the <tt>data\/<\/tt> and <tt>grading\/<\/tt>directories, and <tt>util.py<\/tt>, (<tt>ML4T_2020Fall\/<\/tt>). To complete the assignments you&#8217;ll need to modify the templates according to the assignment description.<\/p>\n<p>To test your code, you&#8217;ll need to set up your PYTHONPATH to include the <tt>grading<\/tt> module and the utility module <tt>util.py<\/tt>, which are both one directory up from the project directories. Here&#8217;s an <b>example<\/b> of how to run the grading script for the optional (deprecated) assignment <a href=\"https:\/\/www.dropbox.com\/s\/84bn3ov4abin5tc\/assess_portfolio_2021Sum.zip?dl=1\" target=\"_blank\" rel=\"noopener\">Assess Portfolio<\/a> (note, grade_anlysis.py is included in the template zip file for Assess Portfolio):<\/p>\n<p>[\/et_pb_text][et_pb_dmb_code_snippet code=&#8221;UFlUSE9OUEFUSD0uLi86LiBweXRob24gZ3JhZGVfYW5hbHlzaXMucHk=&#8221; _builder_version=&#8221;4.9.4&#8243;]UFlUSE9OUEFUSD0uLi86LiBweXRob24gZ3JhZGVfYW5hbHlzaXMucHk=[\/et_pb_dmb_code_snippet][et_pb_text _builder_version=&#8221;4.9.4&#8243;]<\/p>\n<p>which assumes you&#8217;re typing from the folder <b>ML4T_2021SUM\/assess_portfolio\/<\/b>. This will print out a lot of information, and will also produce two text files: <tt>points.txt<\/tt> and <tt>comments.txt<\/tt>. It will probably be helpful to scan through all of the output printed out in order to trace errors to your code, while <tt>comments.txt<\/tt> will contain a succinct summary of which test cases failed and the specific errors (without the backtrace). Here&#8217;s an example of the contents of <tt>comments.txt<\/tt> for the first assignment using the unchanged template:<\/p>\n<p>[\/et_pb_text][et_pb_dmb_code_snippet code=&#8221;PHByZT4tLS0gU3VtbWFyeSAtLS0KVGVzdHMgcGFzc2VkOiAwIG91dCBvZiAzCgotLS0gRGV0YWlscyAtLS0KVGVzdCAjMDogZmFpbGVkClRlc3QgY2FzZSBkZXNjcmlwdGlvbjogV2lraSBleGFtcGxlIDEKSW5jb3JyZWN0T3V0cHV0OiBPbmUgb3IgbW9yZSBzdGF0cyB3ZXJlIGluY29ycmVjdC4KICBJbnB1dHM6CiAgICBzdGFydF9kYXRlOiAyMDEwLTAxLTAxIDAwOjAwOjAwCiAgICBlbmRfZGF0ZTogMjAxMC0xMi0zMSAwMDowMDowMAogICAgc3ltYm9sczogWydHT09HJywgJ0FBUEwnLCAnR0xEJywgJ1hPTSddCiAgICBhbGxvY3M6IFswLjIsIDAuMywgMC40LCAwLjFdCiAgICBzdGFydF92YWw6IDEwMDAwMDAKICBXcm9uZyB2YWx1ZXM6CiAgICBjdW1fcmV0OiAwLjI1IChleHBlY3RlZDogMC4yNTU2NDY3ODQ1MzQpCiAgICBhdmdfZGFpbHlfcmV0OiAwLjAwMSAoZXhwZWN0ZWQ6IDAuMDAwOTU3MzY2MjM0MjM4KQogICAgc2hhcnBlX3JhdGlvOiAyLjEgKGV4cGVjdGVkOiAxLjUxODE5MjQzNjQxKQoKVGVzdCAjMTogZmFpbGVkClRlc3QgY2FzZSBkZXNjcmlwdGlvbjogV2lraSBleGFtcGxlIDIKLi4u&#8221; language=&#8221;bash&#8221; _builder_version=&#8221;4.9.4&#8243;]PHByZT4tLS0gU3VtbWFyeSAtLS0KVGVzdHMgcGFzc2VkOiAwIG91dCBvZiAzCgotLS0gRGV0YWlscyAtLS0KVGVzdCAjMDogZmFpbGVkClRlc3QgY2FzZSBkZXNjcmlwdGlvbjogV2lraSBleGFtcGxlIDEKSW5jb3JyZWN0T3V0cHV0OiBPbmUgb3IgbW9yZSBzdGF0cyB3ZXJlIGluY29ycmVjdC4KICBJbnB1dHM6CiAgICBzdGFydF9kYXRlOiAyMDEwLTAxLTAxIDAwOjAwOjAwCiAgICBlbmRfZGF0ZTogMjAxMC0xMi0zMSAwMDowMDowMAogICAgc3ltYm9sczogWydHT09HJywgJ0FBUEwnLCAnR0xEJywgJ1hPTSddCiAgICBhbGxvY3M6IFswLjIsIDAuMywgMC40LCAwLjFdCiAgICBzdGFydF92YWw6IDEwMDAwMDAKICBXcm9uZyB2YWx1ZXM6CiAgICBjdW1fcmV0OiAwLjI1IChleHBlY3RlZDogMC4yNTU2NDY3ODQ1MzQpCiAgICBhdmdfZGFpbHlfcmV0OiAwLjAwMSAoZXhwZWN0ZWQ6IDAuMDAwOTU3MzY2MjM0MjM4KQogICAgc2hhcnBlX3JhdGlvOiAyLjEgKGV4cGVjdGVkOiAxLjUxODE5MjQzNjQxKQoKVGVzdCAjMTogZmFpbGVkClRlc3QgY2FzZSBkZXNjcmlwdGlvbjogV2lraSBleGFtcGxlIDIKLi4u[\/et_pb_dmb_code_snippet][et_pb_text _builder_version=&#8221;4.8.0&#8243;]The <tt>comments.txt<\/tt> file will contain a summary of which tests were passed or failed, and any error messages. The <tt>points.txt<\/tt> file reports the score from the autograder, used by the teaching staff to automate grading submitted code in a batch run, and can be safely ignored by students.[\/et_pb_text][\/et_pb_column][\/et_pb_row][\/et_pb_section]<\/p>\n","protected":false},"excerpt":{"rendered":"<p>ML4T Software SetupNotice The repository has been made private for the Fall 2017 semester, and so the links to the repository below will no longer be visible for you. A zip file containing the grading script and any template code or data will be linked off of each assignment&#8217;s individual wiki page. A zip file [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":1607,"menu_order":15,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"<!-- wp:divi\/placeholder \/-->","_et_gb_content_width":"","footnotes":""},"class_list":["post-1723","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/pages\/1723","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/comments?post=1723"}],"version-history":[{"count":4,"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/pages\/1723\/revisions"}],"predecessor-version":[{"id":1892,"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/pages\/1723\/revisions\/1892"}],"up":[{"embeddable":true,"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/pages\/1607"}],"wp:attachment":[{"href":"https:\/\/lucylabs.gatech.edu\/ml4t\/wp-json\/wp\/v2\/media?parent=1723"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}