Skip to content

Commit

Permalink
updating docs
Browse files Browse the repository at this point in the history
  • Loading branch information
poldrack committed Apr 20, 2024
1 parent dd0e1cb commit 5afe840
Show file tree
Hide file tree
Showing 7 changed files with 42 additions and 25 deletions.
14 changes: 10 additions & 4 deletions docs/labguide/general_lab_policies.html
Original file line number Diff line number Diff line change
Expand Up @@ -366,7 +366,7 @@ <h2 id="toc-title">On this page</h2>

<ul>
<li><a href="#administrative-requests" id="toc-administrative-requests" class="nav-link active" data-scroll-target="#administrative-requests">Administrative requests</a></li>
<li><a href="#onboarding" id="toc-onboarding" class="nav-link" data-scroll-target="#onboarding">Onboarding</a></li>
<li><a href="#lab-procedures" id="toc-lab-procedures" class="nav-link" data-scroll-target="#lab-procedures">Lab procedures</a></li>
</ul>
<div class="toc-actions"><ul><li><a href="https://github.com/poldracklab/poldracklab.github.io/edit/main/labguide/general_lab_policies.md" class="toc-action"><i class="bi bi-github"></i>Edit this page</a></li><li><a href="https://github.com/poldracklab/poldracklab.github.io/issues/new" class="toc-action"><i class="bi empty"></i>Report an issue</a></li></ul></div></nav>
</div>
Expand Down Expand Up @@ -396,9 +396,15 @@ <h1 class="title">General lab policies</h1>
<h2 class="anchored" data-anchor-id="administrative-requests">Administrative requests</h2>
<p>The assigned administrative assistant for the lab (currently Diana Savastio) should be the default person to send any administrative requests. In the past, we have had issues where requests were coming from multiple members of our lab and/or to multiple administrative staff, which was not being sufficiently mindful of time and busy schedules of the administrative staff. Therefore, in general, you should not directly contact other departmental administrators with requests unless directed by the administrative assistant or Dr.&nbsp;Poldrack. However, there may be exceptions to this that justify contacting other staff directly (e.g., CNI-related questions directly to CNI staff like Laima Baltusis).</p>
</section>
<section id="onboarding" class="level2">
<h2 class="anchored" data-anchor-id="onboarding">Onboarding</h2>
<p>New members of the lab will be provided with a detailed list of onboarding procedures as well as access to the lab’s Google Drive which contains internal lab documentation.</p>
<section id="lab-procedures" class="level2">
<h2 class="anchored" data-anchor-id="lab-procedures">Lab procedures</h2>
<p>Internal information about lab procedures are available via a set of Google docs (all of which require permission to access):</p>
<ul>
<li><a href="https://docs.google.com/document/d/1_oT0BUf4DACLc1_6Aw55gBrKC5R6QjWnlPs_apjQnHs/edit?usp=sharing">Financial procedures</a></li>
<li><a href="https://docs.google.com/document/d/10G0cc6wAdvfheM3CZcdt4JMUeesK-05h8fb8iX4YCvY/edit?usp=sharing">Travel procedures</a></li>
<li><a href="https://docs.google.com/document/d/1aAwvMg5888baJNTw9I2QW69V9E-iTAY_smNSPh_SR98/edit?usp=sharing">Onboarding procedures for new lab members</a></li>
<li><a href="https://docs.google.com/document/d/1X5mf0G1OLp8kRzdRdHzqDPsOK7CqPof1XRJQPRIwNJ0/edit?usp=sharing">Offboarding procedures for departing lab members</a></li>
</ul>


</section>
Expand Down
2 changes: 1 addition & 1 deletion docs/labguide/mentoring/mentoring.html
Original file line number Diff line number Diff line change
Expand Up @@ -428,7 +428,7 @@ <h3 class="anchored" data-anchor-id="what-does-it-take-to-get-accepted">What doe
<p>There are always more qualified applicants than there are spots in our graduate programs, and there is no way to guarantee admission to any particular program. On the flipside, there are also no absolute requirements: we look at the whole picture, and other factors can sometimes outweigh a weaker academic record. There are a few factors that are particularly important for admission to my lab:</p>
<ol type="1">
<li><em>Research experience</em>: It is very rare for someone to be accepted into any of the programs I am affiliated with at Stanford without significant research experience. Sometimes this can be obtained as an undergraduate, but more often successful applicants to our program have spent at least a year working as a research assistant in an active research laboratory. There are a couple of important reasons for this. First, we want you to understand what you are getting into; many people have rosy ideas of what it’s like to be a scientist, which can fall away pretty quickly in light of the actual experience of doing science. Spending some time in a lab helps you make sure that this is how you want to spend your life. In addition, it provides you with someone who can write a recommendation letter that speaks very directly to your potential as a researcher. Letters are a very important part of the admissions process, and the most effective letters are those that go into specific detail about your abilities, aptitude, and motivation.</li>
<li><em>Technical skills</em>: The research that we do in our lab is highly technical, requiring knowledge of computing systems, programming, and math/statistics. I would say that decent programming ability is a pretty firm prerequisite for entering my lab; once you enter the lab I want you to be able to jump directly into doing science, and this just can’t happen if you have to spend a year teaching yourself how to program from scratch. More generally, we expect you to be able to pick up new technical topics easily; I don’t expect students to necessarily show up knowing how a reinforcement learning model works, but I expect them to be able to go and figure it out on their own by reading the relevant papers and then implement it on their own. The best way to demonstrate programming ability is to show a specific project that you have worked on. This could be an open source project that you have contributed to, or a project that you did on the side for fun (for example, mine your own social media feed, or program a cognitive task and measure how your own behavior changes from day to day). If you don’t currently know how to program, see my post on <a href="http://www.russpoldrack.org/2016/05/advice-for-learning-to-code-from-scratch.html">learning to program from scratch</a>, and get going!</li>
<li><em>Technical skills</em>: The research that we do in our lab is highly technical, requiring knowledge of computing systems, programming, and math/statistics. I would say that decent programming ability is a pretty firm prerequisite for entering my lab; once you enter the lab I want you to be able to jump directly into doing science, and this just can’t happen if you have to spend a year teaching yourself how to program from scratch. More generally, we expect you to be able to pick up new technical topics easily; I don’t expect students to necessarily show up knowing how a reinforcement learning model works, but I expect them to be able to go and figure it out on their own by reading the relevant papers and then implement it on their own. The best way to demonstrate programming ability is to show a specific project that you have worked on. This could be an open source project that you have contributed to, or a project that you did on the side for fun (for example, mine your own social media feed, or program a cognitive task and measure how your own behavior changes from day to day). If you don’t currently know how to program, see my post on <a href="https://russpoldrack.blogspot.com/2016/05/advice-for-learning-to-code-from-scratch.html">learning to program from scratch</a>, and get going!</li>
<li><ol start="3" type="a">
<li><em>Risk taking and resilience:</em> If we are doing interesting science then things are going to fail, and we have to learn from those failures and move on.<span class="Apple-converted-space">&nbsp; </span>I want to know that you are someone who is willing to go out on a limb to try something risky, and can handle the inevitable failures gracefully.<span class="Apple-converted-space">&nbsp; </span>Rather than seeing a statement of purpose that only lists all of your successes, I find it very useful to also know about risks you have taken (be they physical, social, or emotional), challenges you have faced, failures you have experienced, and most importantly what you learned from all of these experiences.</li>
</ol></li>
Expand Down
19 changes: 9 additions & 10 deletions docs/labguide/publication/authorship.html
Original file line number Diff line number Diff line change
Expand Up @@ -365,7 +365,8 @@
<h2 id="toc-title">On this page</h2>

<ul>
<li><a href="#affiliation" id="toc-affiliation" class="nav-link active" data-scroll-target="#affiliation">Affiliation</a></li>
<li><a href="#authorship-policies" id="toc-authorship-policies" class="nav-link active" data-scroll-target="#authorship-policies">Authorship policies</a></li>
<li><a href="#affiliation" id="toc-affiliation" class="nav-link" data-scroll-target="#affiliation">Affiliation</a></li>
</ul>
<div class="toc-actions"><ul><li><a href="https://github.com/poldracklab/poldracklab.github.io/edit/main/labguide/publication/authorship.md" class="toc-action"><i class="bi bi-github"></i>Edit this page</a></li><li><a href="https://github.com/poldracklab/poldracklab.github.io/issues/new" class="toc-action"><i class="bi empty"></i>Report an issue</a></li></ul></div></nav>
</div>
Expand All @@ -391,6 +392,8 @@ <h1 class="title">Authorship</h1>
</header>


<section id="authorship-policies" class="level2">
<h2 class="anchored" data-anchor-id="authorship-policies">Authorship policies</h2>
<ul>
<li>The lab’s policy follows the IJCME recommendations on <a href="http://www.icmje.org/recommendations/browse/roles-and-responsibilities/defining-the-role-of-authors-and-contributors.html">Defining the Role of Authors and Contributors</a>, which state that authorship should be based on four criteria:
<ul>
Expand All @@ -400,18 +403,14 @@ <h1 class="title">Authorship</h1>
<li>Agreement to be accountable for all aspects of the work in ensuring that questions related to the accuracy or integrity of any part of the work are appropriately investigated and resolved.</li>
</ul></li>
<li>Importantly, we view substantial contributions to data acquisition or analysis alone to be sufficient for authorship on the primary project manuscript, as long criteria 2-4 are met. For this reason, research assistants in our lab often end up being coauthors on our publications.</li>
<li>Criterion #1 also implies that Dr.&nbsp;Poldrack will <em>not</em> accept authorship on any work that he has not played a substantial role in either designing, analyzing, or interpreting.<span class="Apple-converted-space">&nbsp; </span>Please do not send completed manuscripts with a request for him to be a coauthor.</li>
<li>The sharing of data is not considered to be sufficient on its own to warrant authorship; instead, credit should be given through citation of a data descriptor and/or dataset DOI.<span class="Apple-converted-space">&nbsp; </span>However, authorship is appropriate in cases where the dataset owner provides substantial input into the research, or when required by the data use agreement.</li>
<li>Criterion #1 also implies that Dr.&nbsp;Poldrack will <em>not</em> accept authorship on any work that he has not played a substantial role in either designing, analyzing, or interpreting. Please do not send completed manuscripts with a request for him to be a coauthor.</li>
<li>The sharing of data is not considered to be sufficient on its own to warrant authorship; instead, credit should be given through citation of a data descriptor and/or dataset DOI. However, authorship is appropriate in cases where the dataset owner provides substantial input into the research, or when required by the data use agreement.</li>
</ul>
</section>
<section id="affiliation" class="level2">
<h2 class="anchored" data-anchor-id="affiliation">Affiliation</h2>
<ol type="1">
<li>The listed affiliation should include any institutions where one was affiliated while completing the work.
<ul>
<li>Any work completed at Stanford should include the Stanford affiliation, even if the individual has left Stanford.</li>
<li>Work completed prior to joining Stanford but published after joining the lab does not need to include the Stanford affiliation, but it may be included (along with the institution where the work was completed) if work was done on the paper after joining the lab.</li>
</ul></li>
</ol>
<p>The listed affiliation for a publication should include any institutions where one was affiliated while completing the work.<br>
- Any work completed at Stanford should include the Stanford affiliation, even if the individual has left Stanford. - Work completed prior to joining Stanford but published after joining the lab does not need to include the Stanford affiliation, but it may be included (along with the institution where the work was completed) if work was done on the paper after joining the lab.</p>


</section>
Expand Down
4 changes: 2 additions & 2 deletions docs/labguide/research/intellectual_property.html
Original file line number Diff line number Diff line change
Expand Up @@ -380,8 +380,8 @@ <h2 id="toc-title">On this page</h2>

<section id="intellectual-property" class="level1">
<h1>Intellectual property</h1>
<p>All products of research at Stanford (including data and code) are the property of the University. However, faculty have wide latitude to release software as open source under the University’s <a href="https://otl.stanford.edu/open-source-stanford">open source policy</a>, as long as it doesn’t conflict with any other obligations. Students are allowed to release code under an open source license at Stanford with faculty permission; students in the Poldracklab have blanket permission to do so, as all of our code is intended to be made open available, as discussed in the section on <a href="https://poldracklab.github.io/research/code_management.html">code sharing</a>. After leaving the lab, trainees can continue to reuse any code or other research materials (e.g.&nbsp;stimuli) developed as part of their work in the lab as long as the code has been released under an open source license and they continue to abide by the terms of the license.</p>
<p>As discussed in the section on <a href="https://poldracklab.github.io/research/data_management.html">data management and sharing</a>, all data collected within our laboratory is meant to be shared upon submission of the related paper. In cases where these data can be deidentified they will be shared under a public domain dedication (CC0), which places no restrictions on their use by other researchers. Thus, any researcher can continue to use those data once they leave the lab. In other cases it may be necessary to restrict data sharing (e.g.&nbsp;when the data cannot be deidentified), in which case researchers will need to obtain a data use agreement from Stanford in order to access those data at their new institution. Dr.&nbsp;Poldrack commits to supporting any such requests, unless they violate other obligations of his or the University.</p>
<p>All products of research at Stanford (including data and code) are the property of the University. However, faculty have wide latitude to release software as open source under the University’s <a href="https://otl.stanford.edu/software">open source policy</a>, as long as it doesn’t conflict with any other obligations. Students are allowed to release code under an open source license at Stanford with faculty permission; students in the Poldracklab have blanket permission to do so, as all of our code is intended to be made open available, as discussed in the section on <a href="https://poldracklab.github.io/labguide/research/code_management.html">code sharing</a>. After leaving the lab, trainees can continue to reuse any code or other research materials (e.g.&nbsp;stimuli) developed as part of their work in the lab as long as the code has been released under an open source license and they continue to abide by the terms of the license.</p>
<p>As discussed in the section on <a href="https://poldracklab.github.io/labguide/research/data_management.html">data management and sharing</a>, all data collected within our laboratory is meant to be shared upon submission of the related paper. In cases where these data can be deidentified they will be shared under a public domain dedication (CC0), which places no restrictions on their use by other researchers. Thus, any researcher can continue to use those data once they leave the lab. In other cases it may be necessary to restrict data sharing (e.g.&nbsp;when the data cannot be deidentified), in which case researchers will need to obtain a data use agreement from Stanford in order to access those data at their new institution. Dr.&nbsp;Poldrack commits to supporting any such requests, unless they violate other obligations of his or the University.</p>
<p>In many cases we use data within the lab under Data Use Agreements (such as the ABCD or HCP datasets), and any researcher wishing to use such datasets must be explicitly listed on the DUA. Once a researcher is no longer included in the Stanford DUA for a particular dataset, they must no longer access the dataset via Stanford computer systems.</p>
<section id="research-ideas" class="level2">
<h2 class="anchored" data-anchor-id="research-ideas">Research ideas</h2>
Expand Down
2 changes: 1 addition & 1 deletion docs/publications.html
Original file line number Diff line number Diff line change
Expand Up @@ -385,7 +385,7 @@ <h1 class="title">Publications</h1>
</header>


<div id="b84b82ba" class="cell" data-message="false" data-execution_count="1">
<div id="2febfefa" class="cell" data-message="false" data-execution_count="1">
<section id="section" class="level3">
<h3 class="anchored" data-anchor-id="section">2024</h3>
<p>Demidenko MI, Mumford JA, Poldrack RA (2024). Impact of analytic decisions on test-retest reliability of individual and group estimates in functional magnetic resonance imaging: a multiverse analysis using the monetary incentive delay task. <em>bioRxiv</em>. <a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC10983911">OA</a> <a href="https://doi.org/10.1101/2024.03.19.585755">DOI</a></p>
Expand Down
Loading

0 comments on commit 5afe840

Please sign in to comment.