.. _notebook_transfer_file:

Transfer file into Notebook session
===================================

Smaller files can be uploaded into a Notebook session easily in two different
ways.  These are outlined in turn below.

Directly Upload the File
------------------------

Once you have navigated into your directory of interest using the browser
in the left-hand side, click the upward-pointing arrow on the top menu
bar.

   .. image:: images/transfer_file/1_landing_click_upload.png 

This will bring up a window that will let you select the file you wish
to upload.  Click the 'Open' button as usual to confirm your choice of
files.

   .. image:: images/transfer_file/2_upload_window.png

Success!  Your file is now visible in the browser, and would also be accessible
in the same location in a Desktop or a CARTA session.

   .. image:: images/transfer_file/3_file_is_uploaded.png


Copy-Paste Text
---------------

Alternatively, you can copy and paste text directly into a a file within 
your Notebook session.  This might be prefered if, for example, you want 
to copy a snippet of code into an already existing file in your session.
Start by opening up a terminal by double-clicking on the icon.

   .. image:: images/transfer_file/4_open_terminal.png

This opens a terminal on the right hand side of the screen which you can
interact with as usual.  In the example shown, the text editor vi is
being initiated on the command line.

   .. image:: images/transfer_file/5_new_terminal.png

On your local computer, you would select and copy the text of interest.

   .. image:: images/transfer_file/6_copy_local_text.png

You can then paste this text into a text editor in the terminal.

   .. image:: images/transfer_file/7_paste_text.png

Once the file is saved, it is accessible from the file browser in the current
directory, and would be visible in a Desktop or a CARTA session as well.

   .. image:: images/transfer_file/8_file_saved.png