NEEShub_Boot_Camp-PENx

greenbeansneedlesSoftware and s/w Development

Dec 13, 2013 (3 years and 8 months ago)

82 views

Rachelle Howell

The University of Texas at Austin

Data

Photos

Videos

PEN


PEN
is the Project Explorer for NEES. It is a java tool
intended to run on a remote workstation or in the hub.


The
primary purpose of PEN is to

organize

files and
directories

for upload and download

with the NEES
Project Warehouse while a project is in active
development.

Yes! But with limitations….


The project editor limits the
file size that you can upload
to 650 MB.


The project editor also
limits the number of files
you can upload at one time.

(15 max)

If you have a lot of files or you
have very LARGE files such as
movies or data files, you
should use PEN to upload these
files into your project.

You will run PEN on
your computer

to upload
the data, photos, and videos that reside on
your
local machine
.



You will run PEN
within the hub

to upload files
that reside in your
personal workspace
at NEES.
For example, the
inDEED

files you created
earlier.

1.
Download the
tool from NEES


2.
Install PERL
(Windows)



You will need:


1.
Your NEES login
and password


2.
A local directory


3.
Your project
number

Step 1:
Enter your NEES login and password and click the login
button.

Step 2:

Browse to a local directory and click the open button.


This directory should initially be empty. PEN will create a copy
of the project structure from the Project Warehouse in this
directory.

Step 3:

Enter your project number and click the connect button.

Your Project Structure has
been copied to your local
directory

It’s the same structure you see in the
File Browser tab in the Project
Warehouse

If we expand the directory structure for Experiment 1, we will see
that there are no data folders. We need to create a Trial/Repetition
in order to create the data folders to which we will upload our files.

Right
-
click

menu

Data
Folders

PEN uses following color codes:


GREY:

The file exists at NEES but not locally


BLUE:

The file exists locally but not at NEES


BLACK:

The file exists locally and at NEES, and
the files are the same


RED:

The file exists locally and at NEES, but
the files may not be the same

Now that you have data folders, you can use the file import pane to
drag and drop the data you want to upload into the project
directory structure.

At this point, the files are copied

from the directory of origin to the
local project directory. You now
have two copies of these files on
your local machine.

You can edit the
basic

project, experiment, trial, repetition, and
file metadata from the info tab. The other metadata fields must
be edited through the Project Editor.

Be sure to save your changes

You have the option to checksum your files before you upload
them. The checksum is what allows PEN to determine if your local
file matches the file at NEES. If you do
NOT

checksum your files,
they will appear
red

after the upload even if your file matches the
file at NEES.

When you are done dragging and dropping your files into the
project, editing metadata, and
checksumming

the files, it is
time to upload them.

Right clicking on any directory that
contains
blue files
will result in a menu
that contains an upload option.


In this example, I have right
-
clicked on
the project directory so that
all of my
files

get uploaded at once.


Had I right
-
clicked on a particular
directory

(e.g., Videos), I could have
chosen to upload
only the files within
that directory
.


You can upload a
single file

by
selecting and right
-
clicking that file.

Your files changed color because
they now reside both locally and in
the Project Warehouse.


If your files turned
black

after the
upload completed, that indicates
that you have
checksummed

them.


If your files turned
red
after the
upload completed, that indicates
that you did not checksum them.
You can checksum them later if you
so desire.

You will need to launch PEN from within the hub
in order to upload files from your personal
workspace.


Navigate to the PEN tool page and click the
Launch Tool button.

You have a couple of options:


1.
Click the browse button
and use the browse dialog
box to create a new folder.


2.
Designate a folder that
does not exist and have
PEN create it for you.

Your file import pane will now show the folders that exist in
your personal workspace. Locate your
inDEED

file(s) and import
it into the
same directory as your associated data files
.
Don’t
for来琠to up汯慤l

You’re

not

done

yet!

PEN

allows

you

to

upload

files,

but

it

cannot

determine

settings

such

as

whether

or

not

a

file

should

be

opened

with

inDEED

or

if

a

photo

should

be

a

film

strip

photo
.

You

will

need

to

go

back

into

the

project

editor

to

create

these

associations/settings
.

1.
PEN can also be used to download files.


2.
PEN does not currently have the capability
to delete files so be careful not to make a
mistake. If you do make a mistake, contact
NEES for help.


3.
PEN is updated frequently. If you download
PEN to your desktop, remember to check
the tool page often for new releases.

Let’s say you connect to a project that already has files uploaded
to it. This is our project from before, but I’m connecting to it as
if for the first time.

To see the files, right click on a directory and
select “get file info”.

Right click on a grey file or a directory containing grey files, and
select download. The files
are downloaded to
your local directory.

If you connect to your project, and you have red files
that were not previously red, this indicates that either
your local file or the file at NEES has changed. You
should verify who has the correct file (either you or
NEES) and update the NEES file if necessary.

Check your permissions under the Team
Members tab in the Project Editor. You must
have the proper rights to perform these tasks
in PEN.

You can log a support ticket through the support link in the upper
right part of your screen. NEES customer support is VERY helpful.

You can submit “wishes”, ask questions, and write reviews of
PEN using the links on the PEN tool page.