|
|
@@ -0,0 +1,646 @@
|
|
|
+<!DOCTYPE html>
|
|
|
+<html>
|
|
|
+<head data-suburl="">
|
|
|
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
|
+ <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
|
|
|
+
|
|
|
+ <meta name="author" content="Moberg"/>
|
|
|
+ <meta name="description" content="2P_PT - some default"/>
|
|
|
+ <meta name="keywords" content="gin, data, sharing, science git">
|
|
|
+
|
|
|
+ <meta name="referrer" content="no-referrer" />
|
|
|
+ <meta name="_csrf" content="5Ksww4c0SSyRC3VJljsetlY-pMY6MTY5MjY5NDQ3MTM3MTU5NzIxNA" />
|
|
|
+ <meta name="_suburl" content="" />
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <meta property="og:url" content="https://gin.g-node.org/Moberg/2P_PT" />
|
|
|
+ <meta property="og:type" content="object" />
|
|
|
+ <meta property="og:title" content="Moberg/2P_PT">
|
|
|
+ <meta property="og:description" content="some default">
|
|
|
+ <meta property="og:image" content="https://secure.gravatar.com/avatar/dd9e1e5a9e32ede74ba5dd86848891cf?d=identicon" />
|
|
|
+
|
|
|
+
|
|
|
+ <link rel="shortcut icon" href="/img/favicon.png" />
|
|
|
+
|
|
|
+ <script src="/js/jquery-1.11.3.min.js"></script>
|
|
|
+ <script src="/js/libs/jquery.are-you-sure.js"></script>
|
|
|
+ <link rel="stylesheet" href="/assets/font-awesome-4.6.3/css/font-awesome.min.css">
|
|
|
+ <link rel="stylesheet" href="/assets/octicons-4.3.0/octicons.min.css">
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <link rel="stylesheet" href="/css/semantic-2.3.1.min.css">
|
|
|
+ <link rel="stylesheet" href="/css/gogs.css?v=0b67f1414e0be5c3bab3905fe172c80e">
|
|
|
+ <noscript>
|
|
|
+ <style>
|
|
|
+ .dropdown:hover > .menu { display: block; }
|
|
|
+ .ui.secondary.menu .dropdown.item > .menu { margin-top: 0; }
|
|
|
+ </style>
|
|
|
+ </noscript>
|
|
|
+
|
|
|
+
|
|
|
+ <script src="/js/semantic-2.3.1.min.js"></script>
|
|
|
+ <script src="/js/gogs.js?v=0b67f1414e0be5c3bab3905fe172c80e"></script>
|
|
|
+
|
|
|
+ <title>Moberg/2P_PT: some default - G-Node GIN</title>
|
|
|
+
|
|
|
+ <meta name="theme-color" content="#ffffff">
|
|
|
+
|
|
|
+
|
|
|
+<link rel="stylesheet" href="/css/custom.css">
|
|
|
+
|
|
|
+
|
|
|
+ <meta name="robots" content="noindex,nofollow"/>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+<link href='https://fonts.googleapis.com/css?family=Kaushan+Script' rel='stylesheet' type='text/css'>
|
|
|
+
|
|
|
+
|
|
|
+<meta name="twitter:card" content="summary" />
|
|
|
+<meta name="twitter:site" content="@gnode" />
|
|
|
+<meta name="twitter:title" content="GIN" />
|
|
|
+<meta name="twitter:description" content="Modern Research Data Management for Neuroscience"/>
|
|
|
+<meta name="twitter:image" content="https://web.gin.g-node.org/img/favicon.png" />
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <script src="/js/libs/js.cookie.js"></script>
|
|
|
+ <div class="ui inline cookie nag">
|
|
|
+ <span class="title">We use cookies to ensure you get the best experience on our website</span>
|
|
|
+ <i class="nag close icon"></i>
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+</head>
|
|
|
+<body>
|
|
|
+ <div class="full height">
|
|
|
+ <noscript>This website works better with JavaScript</noscript>
|
|
|
+
|
|
|
+
|
|
|
+ <div class="following bar light">
|
|
|
+ <div class="ui container">
|
|
|
+ <div class="ui grid">
|
|
|
+ <div class="column">
|
|
|
+
|
|
|
+
|
|
|
+ <div class="ui top secondary menu">
|
|
|
+ <a class="item brand" href="/">
|
|
|
+ <img class="ui mini image" src="/img/favicon.png">
|
|
|
+ </a>
|
|
|
+
|
|
|
+
|
|
|
+ <a class="item" href="/">Übersicht</a>
|
|
|
+ <a class="item" href="/issues">Issues</a>
|
|
|
+ <a class="item" href="/pulls">Pull-Requests</a>
|
|
|
+
|
|
|
+
|
|
|
+ <a class="item" href="/explore/repos"><i class="octicon octicon-search"></i>Erkunden</a>
|
|
|
+
|
|
|
+
|
|
|
+ <a class="item" href="/G-Node/info/wiki" rel="noreferrer"><i class="octicon octicon-question"></i>Hilfe</a>
|
|
|
+ <a class="item" href="/G-Node/Info/wiki/News">News</a>
|
|
|
+
|
|
|
+ <div class="right menu">
|
|
|
+ <div class="ui dropdown head link jump item poping up" data-content="Erstellen..." data-variation="tiny inverted">
|
|
|
+ <span class="text">
|
|
|
+ <i class="octicon octicon-plus"><span class="sr-only">Erstellen...</span></i>
|
|
|
+ <i class="octicon octicon-triangle-down"></i>
|
|
|
+ </span>
|
|
|
+ <div class="menu">
|
|
|
+ <a class="item" href="/repo/create">
|
|
|
+ <i class="octicon octicon-plus"></i> Neues Repository
|
|
|
+ </a>
|
|
|
+ <a class="item" href="/repo/migrate">
|
|
|
+ <i class="octicon octicon-repo-clone"></i> Neue Migration
|
|
|
+ </a>
|
|
|
+
|
|
|
+ <a class="item" href="/org/create">
|
|
|
+ <i class="octicon octicon-organization"></i> Neue Organisation
|
|
|
+ </a>
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+
|
|
|
+ <div class="ui dropdown head link jump item poping up" tabindex="-1" data-content="Benutzerprofil und mehr" data-variation="tiny inverted">
|
|
|
+ <span class="text avatar">
|
|
|
+ <img class="ui small rounded image" src="https://secure.gravatar.com/avatar/f7d61322919317e0a72c3519a0e7e980?d=identicon">
|
|
|
+ <span class="sr-only">Benutzerprofil und mehr</span>
|
|
|
+ <i class="octicon octicon-triangle-down" tabindex="-1"></i>
|
|
|
+ </span>
|
|
|
+ <div class="menu" tabindex="-1">
|
|
|
+ <div class="ui header">
|
|
|
+ Angemeldet als <strong>jwu</strong>
|
|
|
+ </div>
|
|
|
+
|
|
|
+ <div class="divider"></div>
|
|
|
+ <a class="item" href="/jwu">
|
|
|
+ <i class="octicon octicon-person"></i> Ihr Profil
|
|
|
+ </a>
|
|
|
+ <a class=" item" href="/user/settings">
|
|
|
+ <i class="octicon octicon-settings"></i> Ihre Einstellungen
|
|
|
+ </a>
|
|
|
+
|
|
|
+
|
|
|
+ <div class="divider"></div>
|
|
|
+
|
|
|
+ <form id="logout-form" class="item" action="/user/logout" method="POST">
|
|
|
+ <input type="hidden" name="_csrf" value="5Ksww4c0SSyRC3VJljsetlY-pMY6MTY5MjY5NDQ3MTM3MTU5NzIxNA">
|
|
|
+ <div class="submit-button" data-form="#logout-form">
|
|
|
+ <i class="octicon octicon-sign-out"></i> Abmelden
|
|
|
+ </div>
|
|
|
+ </form>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+<div class="repository file list">
|
|
|
+ <div class="header-wrapper">
|
|
|
+
|
|
|
+ <div class="ui container">
|
|
|
+ <div class="ui vertically padded grid head">
|
|
|
+ <div class="column">
|
|
|
+ <div class="ui header">
|
|
|
+ <div class="ui huge breadcrumb">
|
|
|
+
|
|
|
+ <i class="mega-octicon octicon-lock"></i>
|
|
|
+
|
|
|
+ <a href="/Moberg">Moberg</a>
|
|
|
+ <div class="divider"> / </div>
|
|
|
+ <a href="/Moberg/2P_PT">2P_PT</a>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+ <div class="ui right">
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <form class="display inline" action="/Moberg/2P_PT/action/unwatch?redirect_to=%2fMoberg%2f2P_PT%2fsrc%2fmaster%2fREADME.md" method="POST">
|
|
|
+ <input type="hidden" name="_csrf" value="5Ksww4c0SSyRC3VJljsetlY-pMY6MTY5MjY5NDQ3MTM3MTU5NzIxNA">
|
|
|
+ <div class="ui labeled button" tabindex="0">
|
|
|
+ <button class="ui basic button">
|
|
|
+ <i class="eye icon"></i>Beobachten beenden
|
|
|
+ </button>
|
|
|
+ <a class="ui basic label" href="/Moberg/2P_PT/watchers">
|
|
|
+ 2
|
|
|
+ </a>
|
|
|
+ </div>
|
|
|
+ </form>
|
|
|
+ <form class="display inline" action="/Moberg/2P_PT/action/star?redirect_to=%2fMoberg%2f2P_PT%2fsrc%2fmaster%2fREADME.md" method="POST">
|
|
|
+ <input type="hidden" name="_csrf" value="5Ksww4c0SSyRC3VJljsetlY-pMY6MTY5MjY5NDQ3MTM3MTU5NzIxNA">
|
|
|
+ <div class="ui labeled button" tabindex="0">
|
|
|
+ <button class="ui basic button">
|
|
|
+ <i class="star outline icon"></i>Favorit hinzufügen
|
|
|
+ </button>
|
|
|
+ <a class="ui basic label" href="/Moberg/2P_PT/stars">
|
|
|
+ 0
|
|
|
+ </a>
|
|
|
+ </div>
|
|
|
+ </form>
|
|
|
+
|
|
|
+ <div class="ui labeled button" tabindex="0" data-tooltip="Please note: annexed file content will not be forked" data-position="bottom center">
|
|
|
+ <a class="ui basic button " href="/repo/fork/9336">
|
|
|
+ <i class="octicon octicon-repo-forked"></i>Fork
|
|
|
+ </a>
|
|
|
+ <a class="ui basic label" href="/Moberg/2P_PT/forks">
|
|
|
+ 0
|
|
|
+ </a>
|
|
|
+ </div>
|
|
|
+
|
|
|
+ </div>
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+ <div class="ui tabs container">
|
|
|
+ <div class="ui tabular menu navbar">
|
|
|
+
|
|
|
+ <a class="active item" href="/Moberg/2P_PT">
|
|
|
+ <i class="octicon octicon-file-text"></i> Dateien
|
|
|
+ </a>
|
|
|
+
|
|
|
+
|
|
|
+ <a class=" item" href="/Moberg/2P_PT/issues">
|
|
|
+ <i class="octicon octicon-issue-opened"></i> Issues <span class="ui gray small label">0</span>
|
|
|
+ </a>
|
|
|
+
|
|
|
+
|
|
|
+ <a class=" item" href="/Moberg/2P_PT/pulls">
|
|
|
+ <i class="octicon octicon-git-pull-request"></i> Pull-Requests <span class="ui gray small label">0</span>
|
|
|
+ </a>
|
|
|
+
|
|
|
+
|
|
|
+ <a class=" item" href="/Moberg/2P_PT/wiki">
|
|
|
+ <i class="octicon octicon-book"></i> Wiki
|
|
|
+ </a>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ <div class="ui tabs divider"></div>
|
|
|
+
|
|
|
+</div>
|
|
|
+
|
|
|
+ <div class="ui container">
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <div class="ui secondary menu">
|
|
|
+
|
|
|
+ <div class="fitted item" data-tooltip="Please note: annexed file content will not be part of a pull request">
|
|
|
+ <a href="/Moberg/2P_PT/compare/master...master">
|
|
|
+ <button class="ui green small button"><i class="octicon octicon-git-compare"></i></button>
|
|
|
+ </a>
|
|
|
+ </div>
|
|
|
+
|
|
|
+ <div class="fitted item choose reference">
|
|
|
+ <div class="ui floating filter dropdown" data-no-results="Keine Ergebnisse verfügbar.">
|
|
|
+ <div class="ui basic small button">
|
|
|
+ <span class="text">
|
|
|
+ <i class="octicon octicon-git-branch"></i>
|
|
|
+ Branch:
|
|
|
+ <strong>master</strong>
|
|
|
+ </span>
|
|
|
+ <i class="dropdown icon"></i>
|
|
|
+ </div>
|
|
|
+ <div class="menu">
|
|
|
+ <div class="ui icon search input">
|
|
|
+ <i class="filter icon"></i>
|
|
|
+ <input name="search" placeholder="Nach Branch oder Tag filtern...">
|
|
|
+ </div>
|
|
|
+ <div class="header">
|
|
|
+ <div class="ui grid">
|
|
|
+ <div class="two column row">
|
|
|
+ <a class="reference column" href="#" data-target="#branch-list">
|
|
|
+ <span class="text black">
|
|
|
+ Branches
|
|
|
+ </span>
|
|
|
+ </a>
|
|
|
+ <a class="reference column" href="#" data-target="#tag-list">
|
|
|
+ <span class="text ">
|
|
|
+ Tags
|
|
|
+ </span>
|
|
|
+ </a>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ <div id="branch-list" class="scrolling menu" >
|
|
|
+
|
|
|
+ <div class="item " data-url="/Moberg/2P_PT/src/git-annex/README.md">git-annex</div>
|
|
|
+
|
|
|
+ <div class="item selected" data-url="/Moberg/2P_PT/src/master/README.md">master</div>
|
|
|
+
|
|
|
+ </div>
|
|
|
+ <div id="tag-list" class="scrolling menu" style="display: none">
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+</div>
|
|
|
+
|
|
|
+ <div class="fitted item">
|
|
|
+ <div class="ui breadcrumb">
|
|
|
+ <a class="section" href="/Moberg/2P_PT/src/master">2P_PT</a>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <div class="divider"> / </div>
|
|
|
+
|
|
|
+ <span class="active section">README.md</span>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ <div class="right fitted item">
|
|
|
+
|
|
|
+ <div id="file-buttons" class="ui tiny blue buttons">
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+
|
|
|
+ <div id="file-content" class="tab-size-8">
|
|
|
+ <h4 class="ui top attached header" id="repo-readme">
|
|
|
+
|
|
|
+ <i class="octicon octicon-book"></i>
|
|
|
+
|
|
|
+ <strong>README.md</strong> <span class="text grey normal">9.7 KB</span>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <div class="ui right file-actions">
|
|
|
+ <div class="ui buttons">
|
|
|
+
|
|
|
+ <a class="ui button" href="/Moberg/2P_PT/src/2d8710409122990b2dc66dc4a981a941dd956455/README.md">Permalink</a>
|
|
|
+
|
|
|
+ <a class="ui button" href="/Moberg/2P_PT/commits/master/README.md">Verlauf</a>
|
|
|
+ <a class="ui button" href="/Moberg/2P_PT/raw/master/README.md">Download</a>
|
|
|
+ </div>
|
|
|
+
|
|
|
+
|
|
|
+ <a href="/Moberg/2P_PT/_edit/master/README.md"><i class="octicon octicon-pencil btn-octicon poping up" data-content="Datei bearbeiten" data-position="bottom center" data-variation="tiny inverted"></i></a>
|
|
|
+
|
|
|
+
|
|
|
+ <a href="/Moberg/2P_PT/_delete/master/README.md"><i class="octicon octicon-trashcan btn-octicon btn-octicon-danger poping up" data-content="Datei löschen" data-position="bottom center" data-variation="tiny inverted"></i></a>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+
|
|
|
+ </h4>
|
|
|
+
|
|
|
+ <div class="ui attached table segment">
|
|
|
+ <div id="" class="file-view markdown has-emoji">
|
|
|
+
|
|
|
+ <h1>How to get this dataset?</h1>
|
|
|
+
|
|
|
+<p>You have the following options to get the dataset:</p>
|
|
|
+
|
|
|
+<ul>
|
|
|
+<li>use Datalad to clone and manage this dataset</li>
|
|
|
+<li>use Gin to clone and manage this dataset</li>
|
|
|
+<li>download the data manaually</li>
|
|
|
+</ul>
|
|
|
+
|
|
|
+<p>This guide will only cover the first option.</p>
|
|
|
+
|
|
|
+<h2>Install Datalad</h2>
|
|
|
+
|
|
|
+<p>The Datalad handbook offers a comprehensive guide on <a href="https://handbook.datalad.org/en/latest/intro/installation.html" rel="nofollow">how to install Datalad</a>. You can simply follow it, or follow Meng's suggestions below. In principle, Datalad is a command line tool, so you'll need to use a shell such as CMD on Windows which is really ugly or you use Git Bash which looks like the terminal on Linux and uses the same set of commands just as Linux.</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>Download and install <a href="https://gitforwindows.org/" rel="nofollow">Git</a></li>
|
|
|
+<li>Download and install <a href="https://git-annex.branchable.com/install/Windows/" rel="nofollow">Git-Annex</a></li>
|
|
|
+<li>Download and install <a href="https://docs.conda.io/en/latest/miniconda.html" rel="nofollow">Miniconda</a> or <a href="https://www.anaconda.com/download/" rel="nofollow">Anaconda</a>; it doesn't matter which, you only need conda, but maybe you already have Anaconda installed?</li>
|
|
|
+<li>Now open Git Bash and type <code>conda</code> to see if the command is found. If not, you need to add the path to conda to your environment variable:
|
|
|
+
|
|
|
+<ul>
|
|
|
+<li>Hit the Windows key and search for "environ...", select "Edit the system environment variables"</li>
|
|
|
+<li>Click "Environment Variables..." in the System Properties window that pops up</li>
|
|
|
+<li>Edit "Path" under system variables</li>
|
|
|
+<li>Add the path to your Minicond/Anaconda to it, mine looks like "C:\Users\jiame\Anaconda3\Scripts"</li>
|
|
|
+<li>Save setting, and type again <code>conda</code> in a new Bash, you should see the doc string for conda</li>
|
|
|
+</ul></li>
|
|
|
+<li>Install Datalad via Bash using <code>conda install -c conda-forge datalad</code></li>
|
|
|
+
|
|
|
+<li><p>Set up user configuration:</p>
|
|
|
+
|
|
|
+<pre><code># enter your home directory using the ~ shortcut
|
|
|
+% cd ~
|
|
|
+% git config --global --add user.name "Bob McBobFace"
|
|
|
+% git config --global --add user.email bob@example.com
|
|
|
+</code></pre></li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Setup ssh connection to Gin</h2>
|
|
|
+
|
|
|
+<p>Skip this one if you are already using Gin on your computer, i.e. you already have the ssh connection set up.</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>Generate a new SSH pair: <code>ssh-keygen -t ed25519 -C "your_email@example.com"</code>, press ENTER for the default settings; You can choose a file name by supplying the command with <code>-f <filename></code></li>
|
|
|
+<li>Start the SSH agent: <code>eval "$(ssh-agent -s)"</code></li>
|
|
|
+<li>Add the private key to the SSH agent: <code>ssh-add ~/.ssh/id_ed25519</code>, replace <code>id_ed25519</code> with your chosen filename</li>
|
|
|
+<li>Copy the public key to the clip-board: <code>clip < ~/.ssh/id_ed25519.pub</code>, replace <code>id_ed25519</code> with your chosen filename</li>
|
|
|
+<li>Go to your gin personal settings on the website and add new SSH keys, give it a reasonable name that refers to the specific device, and <code>ctrl+V</code> to paste the public key
|
|
|
+You can read upon more information on the SSH keys in <a href="https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent" rel="nofollow">this tutorial</a>.</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Add personal access token</h2>
|
|
|
+
|
|
|
+<p>A personal access token is needed so you don't have to enter username and password when you try to either clone or publish a private repo.</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>Go to Gin - Settings - Applications: click the blue button on top right to create a new token</li>
|
|
|
+<li>Give it a meaningful name, e.g. sara-laptop</li>
|
|
|
+<li>Once the token is generated, it will be displayed only once, make sure to copy it or save it in a text file temporarily</li>
|
|
|
+<li>Go to Git Bash, enter <code>datalad credentials set [name] token=<personal-access-token></code>, if the command is unknown, you need to:
|
|
|
+
|
|
|
+<ul>
|
|
|
+<li><code>pip install datalad-next</code>, if you don't have <code>pip</code>, install it with <code>conda install pip</code></li>
|
|
|
+<li>try setting the credentials again</li>
|
|
|
+</ul></li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Clone and get the dataset</h2>
|
|
|
+
|
|
|
+<p>You are finally good to go! Fingers crossed ...</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>In Git Bash: go to the directory you want to clone the dataset into by using <code>cd</code> command, and run <code>datalad clone git@gin.g-node.org:/jwu/ds_SM_PT_2P.git</code>; if you want to name it differently, you simply add a name to the command</li>
|
|
|
+<li>Cloning should not take very long, since all your files are annexed, i.e. unless you explicitly get them, you only have placeholders on your computer</li>
|
|
|
+<li>Run <code>datalad status --annex all</code> and verify that the size of your dataset on the computer is only few KB</li>
|
|
|
+<li>Now choose your favorite file and run <code>datalad get <path/to/file/></code> to see if you can indeed get it</li>
|
|
|
+<li>Run <code>datalad status --annex all</code> again and see if you have a bigger filesize now</li>
|
|
|
+<li>If it all looks good, you can either get the entire dataset by running <code>datalad get .</code> which might take days or you select specific directories to get one mouse at a time</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Drop & get annexed content</h2>
|
|
|
+
|
|
|
+<p>Sometimes you run out of storage on your device, so you might want to drop the annexed content to free up storage. Datalad would not drop anything that is not available on at least one sibling, in this case, on gin.</p>
|
|
|
+
|
|
|
+<p>Run <code>datalad drop [path]</code>.</p>
|
|
|
+
|
|
|
+<p>You can run <code>datalad status --annex all</code> before and after dropping to see for yourself how much file content is being dropped.</p>
|
|
|
+
|
|
|
+<h2>Update a dataset with the remote</h2>
|
|
|
+
|
|
|
+<p>You always want to "sync" your local repo with the remote (gin). This requires you to push & pull updates to your dataset. It is recommended to do this on daily basis: start your day with pulling and finish your day with pushing! Always follow the steps to avoid merge conflicts:</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>Check if you have unsaved changes on your local device: <code>datalad status</code>.</li>
|
|
|
+<li>If yes, commit the changes to datalad: <code>datalad save -m "Say what has happened to the dataset to the future you"</code>. Note, it is recommendable to do the commits in logical units that make sense to you, i.e. when you have changed something that can affect multiple files, for instance "rerun suite2p with different parameters" and specify the files that are associated with this change. You simply add the files/directories to the command above after the commit message.</li>
|
|
|
+<li>Repeat 1.&2. until you have commited all changes and there is nothing to save.</li>
|
|
|
+<li>Before you publish these changes, you have to collect the changes from the remote. Imagine someone (maybe yourself) has published changes to the remote that you haven't fetched yet, or you have changed the README.md using the browser, so the remote is ahead of you. But also your local changes are not available to the remote yet, so you are ahead of the remote as well. This can be complicated, so it is the best to first fetch all possible updates from the remote and integrate them into your local dataset, before you publish your changes: <code>datalad update --how merge</code>.</li>
|
|
|
+<li>Finally, you can publish your changes: <code>datalad push --to gin</code>.</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Create a datalad dataset</h2>
|
|
|
+
|
|
|
+<p>When you start with a new dataset, you want to turn it into a datalad dataset on your local device (e.g. acquisition system), and then publish the dataset to gin.</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>In git bash, go into the root directory of your dataset.</li>
|
|
|
+<li>Create a datalad dataset here: <code>datalad create --force -c text2git</code>. <code>--force</code> is needed to create a dataset in a non-empty directory. <code>-c text2git</code> is a configuration that automatically tells datalad to not annex text files. Yes, everything else is annexed, which means the content of the files is actually hidden from the user behind a separate object folder. The user "only" sees the link to the object file. This allows your to drop & get content as you wish, and is the key to deal with large files. We don't want that with text files for convenience, so that we can edit them anytime without getting them.</li>
|
|
|
+<li>Run <code>datalad status</code> and you should see that your dataset is empty so far, i.e. all your files are untracked. So use the <code>datalad save -m "add files"</code>command to add your files. You can add all at one by not specifying any particular files.</li>
|
|
|
+<li>If you want to have subdatasets within this dataset, I suggest you visit the section subdatasets first, and do not add the directory that you want to turn into a subdataset as normal directory to your superdataset.</li>
|
|
|
+<li>Now you are ready to publish your dataset to gin: <code>datalad create-sibling-gin --private --access-protocol ssh --credential [name] [name of the gin repo]</code>. This step requires you to have set up the ssh connection and the personal-access-token to your gin account. <code>[name]</code> refers to the name you gave to the personal-access-token. <code>[name of the gin repo]</code> will be the name this repo has on gin. The recommendation is to be consistent with the local remote so you easily identify which gin repo belongs to which dataset.</li>
|
|
|
+<li>Run <code>datalad siblings</code> to see that gin has indeed been added as a sibling of your dataset.</li>
|
|
|
+<li>Now you can push your content to gin: <code>datalad push --to gin</code>.</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+<h2>Subdatasets</h2>
|
|
|
+
|
|
|
+<p>One big advantage of datalad is that it allows you to have modular setup of your dataset. This means you can and should organize your project in a way that data, code, results, manuscripts are all separated from each other, and within data, you would separate between raw, processed or derived data, as well as between different data types: imaging, behavior, ephys, histology etc. For each of these modules (as much as it makes sens to you) you would create a subdataset within your superdataset (which is your project folder). We assume you have turned your project folder into a datalad dataset already. Now you want to add the raw 2p data as a subdataset.</p>
|
|
|
+
|
|
|
+<ol>
|
|
|
+<li>Go into your project folder, run <code>datalad create --force -c text2git -d . [path/to/raw_2p_data]</code>.</li>
|
|
|
+<li>Now go into the subdataset, and add files to datalad (see prev. section), until <code>datalad status</code> shows nothing to save.</li>
|
|
|
+<li>Go back to the superds, run <code>datalad status</code> you should see that the subds is modified. This is important: the superds always records the most updated version of the subds ONLY, but not the entire history. So for all changes happening in the subds, you commit them there and the history is stored there by datalad. And then you save the newest version to the superds.</li>
|
|
|
+<li>Run <code>datalad save -d . -m "save subds" [path/to/subds]</code>.</li>
|
|
|
+<li>Run <code>datalad status</code> again and you should see a clean working tree.</li>
|
|
|
+</ol>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+
|
|
|
+</div>
|
|
|
+
|
|
|
+<script>
|
|
|
+ function submitDeleteForm() {
|
|
|
+ var message = prompt("delete_confirm_message\n\ndelete_commit_summary", "Delete ''");
|
|
|
+ if (message != null) {
|
|
|
+ $("#delete-message").val(message);
|
|
|
+ $("#delete-file-form").submit()
|
|
|
+ }
|
|
|
+ }
|
|
|
+</script>
|
|
|
+
|
|
|
+
|
|
|
+ </div>
|
|
|
+</div>
|
|
|
+
|
|
|
+ </div>
|
|
|
+ <footer>
|
|
|
+ <div class="ui container">
|
|
|
+ <div class="ui center links item brand footertext">
|
|
|
+ <a href="http://www.g-node.org"><img class="ui mini footericon" src="https://projects.g-node.org/assets/gnode-bootstrap-theme/1.2.0-snapshot/img/gnode-icon-50x50-transparent.png"/>© 2016-2023 G-Node</a>
|
|
|
+ <a href="/G-Node/Info/wiki/about">About</a>
|
|
|
+ <a href="/G-Node/Info/wiki/imprint">Imprint</a>
|
|
|
+ <a href="/G-Node/Info/wiki/contact">Contact</a>
|
|
|
+ <a href="/G-Node/Info/wiki/Terms+of+Use">Terms of Use</a>
|
|
|
+ <a href="/G-Node/Info/wiki/Datenschutz">Datenschutz</a>
|
|
|
+
|
|
|
+ <div class="ui language bottom floating slide up dropdown link item" data-tooltip="Non-English translations may be incomplete">
|
|
|
+ <i class="world icon"></i>
|
|
|
+ <div class="text">Deutsch</div>
|
|
|
+ <div class="menu">
|
|
|
+
|
|
|
+ <a class="item active selected" href="#">Deutsch</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=en-US">English</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=zh-CN">简体中文</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=zh-HK">繁體中文（香港）</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=zh-TW">繁體中文（臺灣）</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=fr-FR">français</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=nl-NL">Nederlands</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=lv-LV">latviešu</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=ru-RU">русский</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=ja-JP">日本語</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=es-ES">español</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=pt-BR">português do Brasil</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=pl-PL">polski</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=bg-BG">български</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=it-IT">italiano</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=fi-FI">suomi</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=tr-TR">Türkçe</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=cs-CZ">čeština</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=sr-SP">српски</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=sv-SE">svenska</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=ko-KR">한국어</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=gl-ES">galego</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=uk-UA">українська</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=en-GB">English (United Kingdom)</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=hu-HU">Magyar</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=sk-SK">Slovenčina</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=id-ID">Indonesian</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=fa-IR">Persian</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=vi-VN">Vietnamese</a>
|
|
|
+
|
|
|
+ <a class="item " href="/Moberg/2P_PT/src/master/README.md?lang=pt-PT">Português</a>
|
|
|
+
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ <div class="ui center links item brand footertext">
|
|
|
+ <span>Powered by: <a href="https://github.com/gogits/gogs"><img class="ui mini footericon" src="/img/gogs.svg"/></a> </span>
|
|
|
+ <span>Hosted by: <a href="http://neuro.bio.lmu.de"><img class="ui mini footericon" src="/img/lmu.png"/></a> </span>
|
|
|
+ <span>Funded by: <a href="http://www.bmbf.de"><img class="ui mini footericon" src="/img/bmbf.png"/></a> </span>
|
|
|
+ <span>Registered with: <a href="http://doi.org/10.17616/R3SX9N"><img class="ui mini footericon" src="/img/re3data_logo.png"/></a> </span>
|
|
|
+ <span>Recommended by:
|
|
|
+ <a href="https://www.nature.com/sdata/policies/repositories#neurosci"><img class="ui mini footericon" src="/img/sdatarecbadge.jpg"/></a>
|
|
|
+ <a href="https://fairsharing.org/recommendation/PLOS"><img class="ui mini footericon" src="/img/sm_plos-logo-sm.png"/></a>
|
|
|
+ <a href="https://fairsharing.org/recommendation/eLifeRecommendedRepositoriesandStandards"><img class="ui mini footericon" src="/img/elife-logo-xs.fd623d00.svg"/></a>
|
|
|
+ </span>
|
|
|
+ </div>
|
|
|
+ </div>
|
|
|
+ </footer>
|
|
|
+</body>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+ <link rel="stylesheet" href="/plugins/highlight-9.16.2/github.css">
|
|
|
+ <script src="/plugins/highlight-9.16.2/highlight.pack.js"></script>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+<script src="/js/libs/emojify-1.1.0.min.js"></script>
|
|
|
+<script src="/js/libs/clipboard-1.5.9.min.js"></script>
|
|
|
+
|
|
|
+
|
|
|
+</html>
|
|
|
+
|
