{"id":5785,"date":"2018-10-12T18:18:47","date_gmt":"2018-10-12T22:18:47","guid":{"rendered":"https:\/\/blogs.mathworks.com\/community\/?p=5785"},"modified":"2018-11-07T14:36:46","modified_gmt":"2018-11-07T19:36:46","slug":"new-citations-on-the-file-exchange","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/community\/2018\/10\/12\/new-citations-on-the-file-exchange\/","title":{"rendered":"New! Citations on the File Exchange"},"content":{"rendered":"<p>Citations make the world go around. I once read a (tongue in cheek) article about an improved design for scientific papers. In it, citations would go at the very beginning, because that&#8217;s actually what most people read first. <em>&lt;Flips rapidly to the last page&gt; Did the author cite my work as an important precedent?!<\/em>\u00a0It&#8217;s a joke that points to a truth: giving credit where it&#8217;s due is one of the things that holds together communities of researchers.<\/p>\n<p><img decoding=\"async\" loading=\"lazy\" width=\"200\" height=\"70\" class=\"alignnone size-full wp-image-5789\" src=\"https:\/\/blogs.mathworks.com\/community\/files\/palm-civet.jpg\" alt=\"\" \/><\/p>\n<p>If I reference a finding in your Nature article on crepuscular palm civets, I know just how to do it. But what if the work I am citing comes directly from the File Exchange? What should I say? <em>This is a thing I found on the File Exchange?<\/em> Somewhere I should probably mention your name and the URL, but how? Is it important to say when I downloaded it?<\/p>\n<p>Or we can turn the problem around: how do you want other people to cite your work? You can work out a way to fit the key elements of the citation together, but you&#8217;d be happier knowing that you&#8217;re following a standard template. You&#8217;d be happier still if that template was provided by default so you didn&#8217;t have to fiddle with it at all. And you&#8217;d be deliriously happy if, on the rare occasions when it was necessary, you could customize the template to suit your needs.<\/p>\n<p>My friends, I am here to make you deliriously happy. We have finally released the much-requested citations feature for the File Exchange. Here&#8217;s what it says on the <a href=\"https:\/\/www.mathworks.com\/matlabcentral\/about\/fx\/\">&#8220;About File Exchange&#8221; page<\/a>.<\/p>\n<p><img decoding=\"async\" loading=\"lazy\" width=\"597\" height=\"308\" class=\"alignnone size-full wp-image-5791\" style=\"border: thin solid black;\" src=\"https:\/\/blogs.mathworks.com\/community\/files\/about-citations.png\" alt=\"\" \/><\/p>\n<p>The DOI is a reference to a Digital Object Identifier as maintained by <a href=\"http:\/\/www.doi.org\/\">doi.org<\/a>.\u00a0The DOI system provides infrastructure for permanent citation identifiers. They let computers on the internet reason about citations in a straightforward way. If you need them, you&#8217;ll be glad to know our citations work with them. If you don&#8217;t need them, just use the default citation.<\/p>\n<p>The first File Exchange submission to use our DOI functionality is this one on the <a href=\"https:\/\/www.mathworks.com\/matlabcentral\/fileexchange\/63773-automated-modeling-of-planetary-gears\">modeling of planetary gears<\/a>.<\/p>\n<blockquote><p>Huang, Jianfeng, et al. \u201cA Generic Function for Automated Modeling and Feedforward Control of Planetary Gear Sets.\u201d Journal of Dynamic Systems, Measurement, and Control, vol. 140, no. 10, {ASME} International, May 2018, p. 101007, doi:10.1115\/1.4039859.<\/p><\/blockquote>\n<p>Here are the first few files to use the default File Exchange format.<\/p>\n<ol>\n<li>Alberto Comin (2018).\u00a0<span id=\"defaultCitationTitle\">NeurNetRegr<\/span>\u00a0(<a href=\"https:\/\/www.mathworks.com\/matlabcentral\/fileexchange\/69084-neurnetregr\">https:\/\/www.mathworks.com\/matlabcentral\/fileexchange\/69084-neurnetregr<\/a>), MATLAB Central File Exchange.\u00a0<span class=\"translation_missing\" title=\"translation missing: en.citation.retrieved\">Retrieved<\/span>\u00a0<time datetime=\"2018-10-12 20:10:20 UTC\">October 12, 2018<\/time>.<\/li>\n<li>JCBod Bodoque (2018).\u00a0<span id=\"defaultCitationTitle\">Change scale in stl text mesh file<\/span>\u00a0(<a href=\"https:\/\/www.mathworks.com\/matlabcentral\/fileexchange\/69082-change-scale-in-stl-text-mesh-file\">https:\/\/www.mathworks.com\/matlabcentral\/fileexchange\/69082-change-scale-in-stl-text-mesh-file<\/a>), MATLAB Central File Exchange.\u00a0<span class=\"translation_missing\" title=\"translation missing: en.citation.retrieved\">Retrieved<\/span>\u00a0<time datetime=\"2018-10-12 20:10:20 UTC\">October 12, 2018<\/time>.<\/li>\n<li>Jiri Dostal (2018).\u00a0<span id=\"defaultCitationTitle\">EnergyPlus co-simulation toolbox<\/span>\u00a0(<a href=\"https:\/\/www.github.com\/dostaji4\/EnergyPlus-co-simulation-toolbox\">https:\/\/www.github.com\/dostaji4\/EnergyPlus-co-simulation-toolbox<\/a>), GitHub.\u00a0<span class=\"translation_missing\" title=\"translation missing: en.citation.retrieved\">Retrieved<\/span>\u00a0<time datetime=\"2018-10-12 20:10:20 UTC\">October 12, 2018<\/time>.<\/li>\n<li>Usama Mehmood (2018).\u00a0<span id=\"defaultCitationTitle\">Cuboid fit (RANSAC)<\/span>\u00a0(<a href=\"https:\/\/www.github.com\/usamamehmood3\/Cuboid-Fitting-RanSAC\">https:\/\/www.github.com\/usamamehmood3\/Cuboid-Fitting-RanSAC<\/a>), GitHub.\u00a0<span class=\"translation_missing\" title=\"translation missing: en.citation.retrieved\">Retrieved<\/span>\u00a0<time datetime=\"2018-10-12 20:10:20 UTC\">October 12, 2018<\/time>.<\/li>\n<\/ol>\n<p>So there you go. Citations on the File Exchange.<\/p>\n<p>And by the way, I really enjoyed your palm civet paper. First class work!<\/p>\n","protected":false},"excerpt":{"rendered":"<div class=\"overview-image\"><img decoding=\"async\"  class=\"img-responsive\" src=\"https:\/\/blogs.mathworks.com\/community\/files\/palm-civet.jpg\" onError=\"this.style.display ='none';\" \/><\/div>\n<p>Citations make the world go around. I once read a (tongue in cheek) article about an improved design for scientific papers. In it, citations would go at the very beginning, because that&#8217;s&#8230; <a class=\"read-more\" href=\"https:\/\/blogs.mathworks.com\/community\/2018\/10\/12\/new-citations-on-the-file-exchange\/\">read more >><\/a><\/p>\n","protected":false},"author":69,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/posts\/5785"}],"collection":[{"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/users\/69"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/comments?post=5785"}],"version-history":[{"count":9,"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/posts\/5785\/revisions"}],"predecessor-version":[{"id":5906,"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/posts\/5785\/revisions\/5906"}],"wp:attachment":[{"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/media?parent=5785"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/categories?post=5785"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.mathworks.com\/community\/wp-json\/wp\/v2\/tags?post=5785"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}