dx ls. The file listing is refreshed every 10s and it is possible to enforce a refresh by clicking on the whirl arrow icon in the top right corner of the file browser.
[DX]that is prepended to its name in the tab of all opened notebooks.
dx uploadin bash console
Upload Local Fileand select the file which you want to upload (file will be uploaded to the current DNAnexus folder)
dx downloadand access the downloaded local file from Jupyter notebook.
/mnt/projectfolder. Reading the content of the files in
/mnt/projectdynamically fetches the content from the DNAnexus platform, so this method uses minimal disk space in the JupyterLab execution environment, but uses more api calls to fetch the content.
dx downloadthe DNAnexus notebook from the current DNAnexus project to the JupyterLab environment and export the downloaded notebook. For exporting local notebook to certain formats, the following commands might be needed beforehand:
apt-get update && apt-get install texlive-xetex texlive-fonts-recommended texlive-plain-generic.
cmdinput and additional input files using the
ininput file array to the DxJupyterLab app. The provided command will run in the
/opt/notebooks/directory and any output files generated in this directory will be uploaded to the project and returned in the
outoutput field of the job that ran DxJupyterLab app.
papermillcommand that is pre-installed in the DxJupyterLab environment to execute notebooks non-interactively. For example, to execute all the cells in a notebook and produce an output notebook:
notebook.ipynbis the input notebook to the
papermillcommand, which is passed to the
dxjupyterlabapp using the
output_notebook.ipynbis the name of the output notebook, which will contain the result of executing the input notebook and will be uploaded to the project at the end of app's execution. See the DxJupyterLab app page for details.
Duplicate; after a few seconds, a notebook with the same name and a "copy" suffix should appear in the project.
.Notebook_archivefolder with a timestamp suffix added to its name and its ID is saved in the
propertiesof the new file. Saving notebooks directly in the project ensures that your analyses won't be lost when the DXJupyterLab session ends.
Update durationbutton). Even if the DxJupyterLab webpage is closed, the termination will be executed at the set timestamp. Job lengths have an upper limit of 30 days, which cannot be extended.
docker savecommands). Any installed packages and files created locally are saved to a snapshot file, with the exception of directories
/mnt/, which are not included. This file is then uploaded to the project to
.Notebook_snapshotsand can be passed as input the next time the app is started.
dx runfrom a notebook or the Terminal. If the
billToof the project that the JupyterLab session is running in is not licensed to start detached executions, the started jobs will be the subjobs of the interactive JupyterLab session. In this case, the
dx runwill be ignored and the JupyterLab job's workspace is used to run the job, not the given project. Also, if the attached subjob fails or is terminated on the DNAnexus platform, the whole job tree will be terminated, including the interactive JupyterLab session.
job-xxxxis the ID of the job that runs the app. Only the user who launched the JupyterLab job has access to the JupyterLab environment. Other users will see a “403 Permission Forbidden” message under the JupyterLab session's URL.
dx-toolkit, the JupyterLab server comes pre-installed with a number of popular data packages: