Add New Studies

There are several guidelines to creating a study:

The steps to creating a study are:

  1. Enter Cataloging Information, including an abstract of the study.
    Set Terms of Use for the study in the Cataloging fields, if you choose.
  2. Upload files associated with the study.
    Be sure to review the Study File Tips before you start to upload your files.
  3. Set permissions to access the study, all of the study files, or some of the study files.
  4. Delete your study if you choose, before you submit it for review.
  5. Submit your study for review, to make it available to the public.

See the following topics to find out more:

Enter Cataloging Information

A complete list of Cataloging Information fields that comprise the metadata for a study is provided in the List of Metadata.

To enter the Cataloging Information for a new study:

  1. Log in to the Network and navigate to the dataverse to which you plan to contribute.
    This dataverse is specified in your Contributor account e-mail.
  2. Click My Options, scroll to Contributor Options, and then click Add New Study.
    If prompted to accept Terms of Use, check the I Accept box and then click the Continue button.
    You see the Cataloging Information tab of the Add or Edit Study page.
  3. To prepopulate Cataloging Information fields based on a study template, use the Select Study Template pull-down list to select the appropriate template.
    A template provides default values for basic fields in the Cataloging Information fields. The default template prepopulates the Depost Date field only.
  4. Enter a title in the Title field.
  5. Enter data in the Cataloging Information fields.
    To list all fields, including the Terms of Use fields, click the Show Additional Fields button after you enter a title. Use the following guidelines to complete these fields:

    • A light blue background in any form field indicates that HTML, JavaScript, and style tags are permitted. You cannot use the html and body element types.
    • To use the inline help and view information about a field, roll your cursor over the field title.
    • Be sure to complete the Abstract field.
    • To set Terms of Use for your study, scroll to the bottom of the Cataloging Information tab.
      Eight fields appear under the Terms of Use label. You must complete at least one of these fields to enable Terms for this study.
  6. Click Save to keep your changes, or click Cancel to lose your changes.
  7. Continue to the next topic and upload the Study Files.

Upload Study Files

See Study File Tips for more about uploading files for a dataverse study.

To upload files associated with a new study:

  1. After you enter the Cataloging Information on the study page, you can click the Upload Files tab before you click Save to upload your files.
    If you clicked Save on the Cataloging Information tab, click the Add File(s) link in the top-right area of the page to go to the Upload Files tab.
    If prompted to accept Terms of Use, check the I Accept box and then click the Continue button.
  2. For each file that you choose to upload to your study, click the Browse button to select the file and upload one file at a time.
    There is no restriction to the number or types of files that you can upload to the IQSS DVN. There is a maximum file size of 1 gigabyte for each subsettable data file that you upload.
  3. For each file that you upload, first click the check box in front of the file's entry in the list, and then use the Category drop-down list to select the type of file that you uploaded.
    Every checked file is assigned the category that you select. Be sure to click the checked box to remove the check before you select a new value in the Category list for another file.
  4. In the Description field, enter a brief message that identifies the contents of your file.
  5. Click Save when you are finished uploading files.
    You see the Documentation, Data and Analysis tab of the study page with a list of the uploaded files. For each subsettable data set file that you upload, the number of variables and a link to the Data Citation information for that data set are displayed. If you uploaded an SPSS (.sav or .por) file, the Type for that file is changed to Tab delimited and the file extension is changed to .tab when you click Save.
  6. Continue to the next step and set file permissions for the study or its files.

Study File Tips

Keep in mind these tips when uploading study files to your dataverse:

  • The following subsettable file types are supported:
    • SPSS sav - Versions 7.x to 16.x
    • STATA por - All versions
    • STATA dta - Versions 4 to 10
  • You can add information for each file, including:
    • File name
    • Category (documentation or data)
    • Description
  • If you upload the wrong file, click the Delete check box to prevent the addition of that file to your study.
    To replace a file after you upload it and save the study, first delete the file and then upload a new one.
  • If you upload a STATA (.dta) or SPSS (.sav or .por) file, the file automatically becomes subsettable (that is, subset and analysis tools are available for that file in the Network). In this case, processing the file might take some time and you will not see the file listed immediately after you click Save.
  • When you upload a subsettable data file, you are prompted to provide or confirm your e-mail address for notifications. One e-mail lets you know that the file upload is in progress; a second e-mail notifies you when the file upload is complete.
  • While the upload of the files takes place, your study is not available for editing. It becomes available as soon as the upload is completed.

Set Study Permissions

You can restrict access to a study, all of its files, or some of its files. This restriction extends to the search and browse functions.

To permit or restrict access:

  1. On the study page, click the Permissions link.
  2. To set permissions for the study:
    1. Scroll to the Entire Study Permissions panel, and click the drop-down list to change the study to Restricted or Public.
    2. In the If study is set as Restricted field, enter a user or group that you choose to grant access to the study, then click Add User/Group.

    To set permissions for all files in the study at one time, scroll to the All Files Permissions panel, and click the check box to require users to log in or to request by e-mail permission to view the study.
    To set permission for individual files in the study:

    1. Scroll to the Individual File Permissions panel, and enter a user or group to grant permissions to an individual file.
    2. Use the Set file permission pull-down list and select the permission level that you choose to apply to selected files: Restricted or Public.
    3. In the list of files, click the check box for each file to which you choose to apply permissions.
      To select all files within a category, click the check box for that category.
    4. Click Update.
  3. Click Save Changes to keep your changes or Cancel to return to the Cataloging Information tab.

Note: You can edit or delete your study if you choose, but only until you submit the study for reveiw. After you submit your study for review, you cannot edit or delete it from the dataverse.

Delete Studies

You can delete a study that you contribute, but only until you submit that study for review. After you submit your study for review, you cannot delete it from the dataverse.

When you delete a study, you remove it permanently from the dataverse. This includes the global identifier assigned to the study.

To delete a study:

  1. Click the Delete link in the top-right area of the page to go to the Upload Files tab.
    You see the Deleting a Study page.
  2. Click the Delete button to remove your study from the dataverse, or click Cancel to return to the study page without removing the study.
    If your delete was successful, you see the message The study has been deleted successfully.

Submit Study for Review

When you finish setting options for your study, click Ready for Review in the top-right corner. The study page changes to show In Review.

Note: After you click the Ready for Review button, no editing options are available to you for this study. Make sure that all your options are set for this study before you click the Ready for Review button.

You receive e-mail after you click Ready for Review, notifying you that your study was submitted for review by the Curator or Dataverse Admin. When a study is in review, it is not available to the public. You receive another e-mail notifying you when your study is released for public use.

After your study is reviewed and released, it is made available to the public, and it is included in the search and browse functions. The Cataloging Information tab for your study contains the Citation Information for the complete study. The Documentation, Data and Analysis tab lists the files associated with the study. For each subsettable file in the study, a link is available to show the Data Citation for that specific data set.