Logging on to a Sage Server and Creating a Worksheet

This Sage worksheet is from a series of tutorials developed for the MAA PREP Workshop “Sage: Using Open-Source Mathematics Software with Undergraduates” (funding provided by NSF DUE 0817071). It is licensed under the Creative Commons Attribution-ShareAlike 3.0 license (CC BY-SA).

This document describes how to get into a Sage worksheet in the first place, including:

If you already feel comfortable with this process, or at least comfortable enough to see how to actually use Sage, the main content of the tutorials begins with the introductory tutorial.

Creating an Account

When coming to a Sage server for the first time, it will look something like this.

_images/SignIn.png

You can create an account in two ways.

  • Use an OpenID account to verify your account
  • Create a login in the standard way by creating a username and password.

OpenID

With many public Sage servers, you can use an OpenID such as Google, Yahoo!, and so forth to create an account.

_images/SignInOpenID.png

To create an account, just make sure you are logged in with your verification website, and then click the correct logo of the many on the lower right. Then you should come to a page like this.

_images/OpenIDPage.png

From there, you should be taken directly to your new notebook, ready to make your first worksheet.

Standard Account Creation

The normal way to create an account is quite straightforward as well.

_images/SignInNormal.png

Just click on the relevant link, and you’ll be taken to a page where you create a new username and password.

_images/RegularSigninPage.png

In this example, there is a “magic word”; there could be a different security question as well. In that case, you’ll have already been given the information if you’re authorized to be on that server.

In this scenario, you’ll be taken back to the main login page, where you’ll need to put in your new login information.

_images/HaveSignin.png

Then you’ll be sent to a new notebook, ready to make your first worksheet.

Two Usage Scenarios

There are two main scenarios when starting with Sage on a server.

  • You are going to a Sage server, and just want to start trying some mathematics. We cover this situation first.
  • Someone has given you a link to a published tutorial or other worksheet (perhaps one similar to this!) and you would like to try out the mathematics there, using your own editable copy of the worksheet. We cover this less common situation below.

Starting a New Worksheet from Scratch

Sage on a server functions via individual documents called worksheets. If you are sent to one and you want to make a live copy, that is one thing, but usually you will start your Sage session with just an empty notebook, with no worksheets yet in it.

_images/EmptyNotebook.png

There are a few things you can do here, but usually you’ll want to start a new worksheet.

_images/EmptyNotebookGetNew.png

Once you’ve done this, it should look something like this:

_images/NewWorksheet.png

You can leave the name, or call it whatever you like. Then you should see your first “cell”, the rectangle in this picture.

_images/FirstCell.png

But at this point you are ready to go on evaluate Sage commands!

Getting a Live Copy of a Worksheet

Occasionally, you’ll get started with Sage by someone giving you a link to a published worksheet that someone else has created. In order to do math on it, you’ll need your own copy of the worksheet on the server.

If you are logged in and have your own copy, it should look like this at the top:

_images/LiveWorksheet.png

Except, of course, your username will appear! If you already have a live copy, you’re all set and should start trying it out, possibly referring to the first tutorial for tips.

More likely, you’ll need to follow a few steps.

  • Take another look at the top of the screen. Does it look like this?

    _images/NotLoggedIn.png

    If you already have an account on the server, log in; otherwise, you may want to review how to get an account.

  • Once you have an account and are logged in, you’ll need to go back to your original link for the published worksheet. In either event, the worksheet should now look like this.

    _images/LoggedIn.png
  • Now just click ‘Edit a copy’ so that it looks like this!

    _images/LiveWorksheet.png

Now you’re ready to learn how to actually evaluate those Sage commands! Good luck.