From: <sfr...@us...> - 2011-06-17 02:29:01
|
Revision: 920 http://treebase.svn.sourceforge.net/treebase/?rev=920&view=rev Author: sfrgpiel Date: 2011-06-17 02:28:54 +0000 (Fri, 17 Jun 2011) Log Message: ----------- Separating out the submission tutorial instructions along with some youtube videos Modified Paths: -------------- trunk/treebase-web/src/main/resources/ApplicationResources.properties trunk/treebase-web/src/main/webapp/WEB-INF/decorators.xml trunk/treebase-web/src/main/webapp/WEB-INF/treebase-servlet.xml trunk/treebase-web/src/main/webapp/common/sidebarLeft.jsp trunk/treebase-web/src/main/webapp/login.jsp Added Paths: ----------- trunk/treebase-web/src/main/webapp/WEB-INF/pages/submitTutorial.jsp Modified: trunk/treebase-web/src/main/resources/ApplicationResources.properties =================================================================== --- trunk/treebase-web/src/main/resources/ApplicationResources.properties 2011-06-16 20:52:22 UTC (rev 919) +++ trunk/treebase-web/src/main/resources/ApplicationResources.properties 2011-06-17 02:28:54 UTC (rev 920) @@ -78,6 +78,7 @@ nav.contact=Contact nav.search=Search nav.search.treebase=Search TreeBASE +nav.submittutorial=Submission Tutorial nav.submit=Submit nav.dataman=NSF Data Management nav.stats=Stats Modified: trunk/treebase-web/src/main/webapp/WEB-INF/decorators.xml =================================================================== --- trunk/treebase-web/src/main/webapp/WEB-INF/decorators.xml 2011-06-16 20:52:22 UTC (rev 919) +++ trunk/treebase-web/src/main/webapp/WEB-INF/decorators.xml 2011-06-17 02:28:54 UTC (rev 920) @@ -8,6 +8,7 @@ <decorator name="main" page="mainTemplate.jsp"> <pattern>/home.html</pattern> <pattern>/dataMan.html</pattern> + <pattern>/submitTutorial.html</pattern> <pattern>/about.html</pattern> <pattern>/urlAPI.html</pattern> <pattern>/people.html</pattern> Added: trunk/treebase-web/src/main/webapp/WEB-INF/pages/submitTutorial.jsp =================================================================== --- trunk/treebase-web/src/main/webapp/WEB-INF/pages/submitTutorial.jsp (rev 0) +++ trunk/treebase-web/src/main/webapp/WEB-INF/pages/submitTutorial.jsp 2011-06-17 02:28:54 UTC (rev 920) @@ -0,0 +1,96 @@ +<%@page import="org.cipres.treebase.TreebaseUtil"%> +<% String purlBase = TreebaseUtil.getPurlBase(); %> + +<div class="gutter"> + +<h2>The Submission Process</h2> + +<p>Typically an author submits a paper to a journal for review + and initiates a TreeBASE submission. At this stage, the + submission is classified as "in progress." A submission + number is issued and the submitter is given a special URL + that can be mailed to the journal editor so that referees + or reviewers can inspect (but not change) the uploaded data. +</p> + +<p>When the journal editor says that the paper is "accepted" or + "accepted with minor revision," the submitter can return to the + submission and change its status from "in progress" to "ready." + At that point, the submitter can cite a URI in his or her paper + that serves as an accession number and as a permanent, resolvable + URL to the data. TreeBASE staff will verify that the submission + is complete, and if so, the data are made public. +</p> + +<h2>General Requirements</h2> + +<ul> + <li>The paper must be published in a peer-reviewed journal or book. Data for manuscripts that are "accepted with minor revision," "accepted," or "in press" can be published in TreeBASE. Data for manuscripts that are "submitted" or "in preparation" must not move beyond the initial "in progress" stage of TreeBASE submission.</li> + + <li>The names of all authors listed with the paper must be included.</li> + + <li>At least one data matrix must be included.</li> + + <li>At least one tree must result from an analysis of one or more data matrices. TreeBASE does not accept matrices that were not analyzed to produce a tree or trees for which the matrices used to produce them are not available.</li> + + <li>Normally the trees should be limited to those that were published as figures in the manuscript. However, a set of trees that were used to produce a published consensus tree is also acceptable.</li> + + <li>Only matrices and trees listed with an analysis will ultimately become available to the public. In other words, matrices or trees must not be orphaned but instead must be either the inputs or outputs of explicit analyses.</li> +</ul> + +<h2>Preparation of NEXUS files</h2> + +<p>Data are uploaded to TreeBASE in the NEXUS format, which is used by many popular phylogenetics software packages (e.g., MacClade and Mesquite: Maddison and Maddison, 1992; PAUP: Swofford, 1993). These programs allow other file formats (e.g. Hennig86, PHYLIP, etc.) to be converted into NEXUS. TreeBASE uses <a href="http://mesquiteproject.org/" title="Mesquite" target="_blank">Mesquite</a> to parse incoming data: <strong>if your data cannot be parsed by Mesquite then they will not be parsed by TreeBASE</strong>, so it's always a good idea to save your data in Mesquite prior to uploading. For example: </p> +<ul> +<li> Launch <a href="http://mesquiteproject.org/" title="Mesquite" target="_blank">Mesquite</a> </li> +<li>Under the <em>File Menu</em> select <em>Open File</em> and choose your character matrix</li> +<li>If your tree(s) are stored in a separate file, under the <em>File Menu</em> select + <em>Include File...</em> and choose your tree file </li> +<li>By clicking on "Taxa," "Character Matrix," or "Trees from treefile.tre" from the project margin on the left, you can rename + them: these names will be carried through into TreeBASE, so it's useful to give them informative names. For example, you could name your matrix "Hymenopteran COI Alignment" +or your tree block "Set of 5 MP Trees from COI Analysis"</li> +<li>By clicking on the <em>Tree</em> icon from the project margin on the left, you can examine your trees. + <ul> + <li>Use the <em>Reroot at Branch</em> tool to reorient the tree the way it appears in the figures of your paper</li> + <li>Under the<em> Drawing Menu</em>, + you can view the relative branch lengths in your tree by selecting <em>Branches Proportional to Lengths</em></li> + </ul> +</li> + + <li>To rename your trees, click the <em>List & Manage Trees</em> icon from the project margin on the left. Renaming your trees makes it easy to identify them after uploading to TreeBASE.</li> + <li>To view or edit the taxon labels, click the <em>Taxa</em> icon from the project margin on the left. Verify that the taxon labels comply with TreeBASE's requirements (see below) and edit as needed</li> + <li>If all looks good, select <em>Save File</em> from the <em>File</em> menu. + Your NEXUS file is now ready to upload to TreeBASE </li> + </ul> +<p>The most frequent error in submitting data to TreeBASE is when taxon labels in the matrices do not match with taxon labels in the trees. Using the above procedure with Mesquite, however, will avoid the problem. </p> + +<h3>Instructional Video on Preparing NEXUS Data in Mesquite</h3> + +<p> +<object width="480" height="385"><param name="movie" value="http://www.youtube.com/p/3F38DFE2626A5234?hl=en_US&fs=1"></param><param name="allowFullScreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://www.youtube.com/p/3F38DFE2626A5234?hl=en_US&fs=1" type="application/x-shockwave-flash" width="480" height="385" allowscriptaccess="always" allowfullscreen="true"></embed></object> +</p> + +<h3>Preparation of taxon labels</h3> + +<ul> + <li>Do not abbreviate taxon names (e.g. write "Homo sapiens", not "H. sapiens")</li> + + <li>The NEXUS file should use underscores ("_") to represent spaces (but when using the Mesquite GUI, use spaces: it will correctly save them as underscores in the NEXUS)</li> + + <li>Avoid using quotation marks, brackets, parentheses, commas, colons, and semicolons.</li> + + <li>Avoid using codes for non-redundant names (e.g. write "Drosophila melanogaster", not "DMelan45GRX"). However, it is acceptable two write "Drosophila melanogaster 45GRX".</li> + + <li>Separate the name of parasites and hosts with "ex.," e.g. "Wolbachia sp. ex. Drosophila melanogaster"</li> + +</ul> + +<h2>Instructional Video on Submitting to TreeBASE</h2> + +<p>If you are sufficiently caffeinated, please consider watching this video to understand the process of submitting data to TreeBASE. The video is also available in high-definition if you view in "Full screen"</p> + +<p> +<object width="480" height="385"><param name="movie" value="http://www.youtube.com/p/9AD9904B8782D600?hl=en_US&fs=1"></param><param name="allowFullScreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://www.youtube.com/p/9AD9904B8782D600?hl=en_US&fs=1" type="application/x-shockwave-flash" width="480" height="385" allowscriptaccess="always" allowfullscreen="true"></embed></object> +</p> + +</div> \ No newline at end of file Modified: trunk/treebase-web/src/main/webapp/WEB-INF/treebase-servlet.xml =================================================================== --- trunk/treebase-web/src/main/webapp/WEB-INF/treebase-servlet.xml 2011-06-16 20:52:22 UTC (rev 919) +++ trunk/treebase-web/src/main/webapp/WEB-INF/treebase-servlet.xml 2011-06-17 02:28:54 UTC (rev 920) @@ -932,7 +932,8 @@ <prop key="/phylows/matrix/**">phyloWSMatrixController</prop> <prop key="/about.html">filenameController</prop> <prop key="/dataMan.html">filenameController</prop> - <prop key="/home.html">filenameController</prop> + <prop key="/home.html">filenameController</prop> + <prop key="/submitTutorial.html">filenameController</prop> <prop key="/login.html">filenameController</prop> <prop key="/urlAPI.html">filenameController</prop> <prop key="/people.html">filenameController</prop> Modified: trunk/treebase-web/src/main/webapp/common/sidebarLeft.jsp =================================================================== --- trunk/treebase-web/src/main/webapp/common/sidebarLeft.jsp 2011-06-16 20:52:22 UTC (rev 919) +++ trunk/treebase-web/src/main/webapp/common/sidebarLeft.jsp 2011-06-17 02:28:54 UTC (rev 920) @@ -4,6 +4,7 @@ <div id="navcontainer"> <ul id="navlist"> <li><a href="<c:url value="/search/studySearch.html"/>"><fmt:message key="nav.search.treebase"/></a></li> + <li><a href="<c:url value="/submitTutorial.html"/>"><fmt:message key="nav.submittutorial"/></a></li> <li><a href="<c:url value="/user/processUser.html"/>"><fmt:message key="nav.submit"/></a></li> <li><span class="navlistHeading"><fmt:message key="nav.about"/></span> <ul id="innerNavlist"> Modified: trunk/treebase-web/src/main/webapp/login.jsp =================================================================== --- trunk/treebase-web/src/main/webapp/login.jsp 2011-06-16 20:52:22 UTC (rev 919) +++ trunk/treebase-web/src/main/webapp/login.jsp 2011-06-17 02:28:54 UTC (rev 920) @@ -17,83 +17,6 @@ </tr> </table> -<h2>The Submission Process</h2> - -<p>Typically an author submits a paper to a journal for review - and initiates a TreeBASE submission. At this stage, the - submission is classified as "in progress." A submission - number is issued and the submitter is given a special URL - that can be mailed to the journal editor so that referees - or reviewers can inspect (but not change) the uploaded data. -</p> - -<p>When the journal editor says that the paper is "accepted" or - "accepted with minor revision," the submitter can return to the - submission and change its status from "in progress" to "ready." - At that point, the submitter can cite a URI in his or her paper - that serves as an accession number and as a permanent, resolvable - URL to the data. TreeBASE staff will verify that the submission - is complete, and if so, the data are made public. -</p> - -<h2>General Requirements</h2> - -<ul> - <li>The paper must be published in a peer-reviewed journal or book. Data for manuscripts that are "accepted with minor revision," "accepted," or "in press" can be published in TreeBASE. Data for manuscripts that are "submitted" or "in preparation" must not move beyond the initial "in progress" stage of TreeBASE submission.</li> - - <li>The names of all authors listed with the paper must be included.</li> - - <li>At least one data matrix must be included.</li> - - <li>At least one tree must result from an analysis of one or more data matrices. TreeBASE does not accept matrices that were not analyzed to produce a tree or trees for which the matrices used to produce them are not available.</li> - - <li>Normally the trees should be limited to those that were published as figures in the manuscript. However, a set of trees that were used to produce a published consensus tree is also acceptable.</li> - - <li>Only matrices and trees listed with an analysis will ultimately become available to the public. In other words, matrices or trees must not be orphaned but instead must be either the inputs or outputs of explicit analyses.</li> -</ul> - -<h2>Preparation of NEXUS files</h2> - -<p>Data are uploaded to TreeBASE in the NEXUS format, which is used by many popular phylogenetics software packages (e.g., MacClade and Mesquite: Maddison and Maddison, 1992; PAUP: Swofford, 1993). These programs allow other file formats (e.g. Hennig86, PHYLIP, etc.) to be converted into NEXUS. TreeBASE uses <a href="http://mesquiteproject.org/" title="Mesquite" target="_blank">Mesquite</a> to parse incoming data: <strong>if your data cannot be parsed by Mesquite then they will not be parsed by TreeBASE</strong>, so it's always a good idea to save your data in Mesquite prior to uploading. For example: </p> -<ul> -<li> Launch <a href="http://mesquiteproject.org/" title="Mesquite" target="_blank">Mesquite</a> </li> -<li>Under the <em>File Menu</em> select <em>Open File</em> and choose your character matrix</li> -<li>If your tree(s) are stored in a separate file, under the <em>File Menu</em> select - <em>Include File...</em> and choose your tree file </li> -<li>By clicking on "Taxa," "Character Matrix," or "Trees from treefile.tre" from the project margin on the left, you can rename - them: these names will be carried through into TreeBASE, so it's useful to give them informative names. For example, you could name your matrix "Hymenopteran COI Alignment" -or your tree block "Set of 5 MP Trees from COI Analysis"</li> -<li>By clicking on the <em>Tree</em> icon from the project margin on the left, you can examine your trees. - <ul> - <li>Use the <em>Reroot at Branch</em> tool to reorient the tree the way it appears in the figures of your paper</li> - <li>Under the<em> Drawing Menu</em>, - you can view the relative branch lengths in your tree by selecting <em>Branches Proportional to Lengths</em></li> - </ul> -</li> - - <li>To rename your trees, click the <em>List & Manage Trees</em> icon from the project margin on the left. Renaming your trees makes it easy to identify them after uploading to TreeBASE.</li> - <li>To view or edit the taxon labels, click the <em>Taxa</em> icon from the project margin on the left. Verify that the taxon labels comply with TreeBASE's requirements (see below) and edit as needed</li> - <li>If all looks good, select <em>Save File</em> from the <em>File</em> menu. - Your NEXUS file is now ready to upload to TreeBASE </li> - </ul> -<p>The most frequent error in submitting data to TreeBASE is when taxon labels in the matrices do not match with taxon labels in the trees. Using the above procedure with Mesquite, however, will avoid the problem. </p> - - -<h3>Preparation of taxon labels</h3> - -<ul> - <li>Do not abbreviate taxon names (e.g. write "Homo sapiens", not "H. sapiens")</li> - - <li>The NEXUS file should use underscores ("_") to represent spaces (but when using the Mesquite GUI, use spaces: it will correctly save them as underscores in the NEXUS)</li> - - <li>Avoid using quotation marks, brackets, parentheses, commas, colons, and semicolons.</li> - - <li>Avoid using codes for non-redundant names (e.g. write "Drosophila melanogaster", not "DMelan45GRX"). However, it is acceptable two write "Drosophila melanogaster 45GRX".</li> - - <li>Separate the name of parasites and hosts with "ex.," e.g. "Wolbachia sp. ex. Drosophila melanogaster"</li> - -</ul> - <hr/> <p>Please fill in following information to login<br/> <span class="required">* Required Fields</span></p> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |