From bee8880182669c6a659bd72090f3bddc608ecb8a Mon Sep 17 00:00:00 2001 From: Michael Heppler Date: Thu, 20 Aug 2020 17:51:15 -0400 Subject: [PATCH 01/25] Added static preview icon btn to file table on dataset pg, reviewed references in guides to explore tools [ref #6919] --- .../admin/dataverse-external-tools.tsv | 2 +- .../source/admin/external-tools.rst | 12 +++---- .../source/admin/geoconnect-worldmap.rst | 4 +-- doc/sphinx-guides/source/api/apps.rst | 4 +-- .../source/api/external-tools.rst | 12 +++---- .../source/developers/geospatial.rst | 4 +-- .../source/installation/config.rst | 4 +-- .../source/installation/prep.rst | 2 +- .../installation/r-rapache-tworavens.rst | 11 +++---- .../user/data-exploration/tworavens.rst | 10 +++--- .../source/user/data-exploration/worldmap.rst | 12 +++---- .../source/user/dataset-management.rst | 24 +++++++------- .../source/user/find-use-data.rst | 2 +- src/main/webapp/file.xhtml | 32 ++++++++++++++++++ src/main/webapp/filesFragment.xhtml | 33 +++++++++---------- 15 files changed, 96 insertions(+), 72 deletions(-) diff --git a/doc/sphinx-guides/source/_static/admin/dataverse-external-tools.tsv b/doc/sphinx-guides/source/_static/admin/dataverse-external-tools.tsv index 556a17ef0eb..0cbf13d55fe 100644 --- a/doc/sphinx-guides/source/_static/admin/dataverse-external-tools.tsv +++ b/doc/sphinx-guides/source/_static/admin/dataverse-external-tools.tsv @@ -1,5 +1,5 @@ TwoRavens explore file A system of interlocking statistical tools for data exploration, analysis, and meta-analysis: http://2ra.vn. See the :doc:`/user/data-exploration/tworavens` section of the User Guide for more information on TwoRavens from the user perspective and the :doc:`/installation/r-rapache-tworavens` section of the Installation Guide. Data Explorer explore file A GUI which lists the variables in a tabular data file allowing searching, charting and cross tabulation analysis. See the README.md file at https://github.com/scholarsportal/Dataverse-Data-Explorer for the instructions on adding Data Explorer to your Dataverse; and the :doc:`/installation/prerequisites` section of the Installation Guide for the instructions on how to set up **basic R configuration required** (specifically, Dataverse uses R to generate .prep metadata files that are needed to run Data Explorer). Whole Tale explore dataset A platform for the creation of reproducible research packages that allows users to launch containerized interactive analysis environments based on popular tools such as Jupyter and RStudio. Using this integration, Dataverse users can launch Jupyter and RStudio environments to analyze published datasets. For more information, see the `Whole Tale User Guide `_. -File Previewers explore file A set of tools that display the content of files - including audio, html, `Hypothes.is `_ annotations, images, PDF, text, video, tabular data, and spreadsheets - allowing them to be viewed without downloading. The previewers can be run directly from github.io, so the only required step is using the Dataverse API to register the ones you want to use. Documentation, including how to optionally brand the previewers, and an invitation to contribute through github are in the README.md file. Initial development was led by the Qualitative Data Repository and the spreasdheet previewer was added by the Social Sciences and Humanities Open Cloud (SSHOC) project. https://github.com/GlobalDataverseCommunityConsortium/dataverse-previewers +File Previewers preview, explore file A set of tools that display the content of files - including audio, html, `Hypothes.is `_ annotations, images, PDF, text, video, tabular data, and spreadsheets - allowing them to be viewed without downloading. The previewers can be run directly from github.io, so the only required step is using the Dataverse API to register the ones you want to use. Documentation, including how to optionally brand the previewers, and an invitation to contribute through github are in the README.md file. Initial development was led by the Qualitative Data Repository and the spreasdheet previewer was added by the Social Sciences and Humanities Open Cloud (SSHOC) project. https://github.com/GlobalDataverseCommunityConsortium/dataverse-previewers Data Curation Tool configure file A GUI for curating data by adding labels, groups, weights and other details to assist with informed reuse. See the README.md file at https://github.com/scholarsportal/Dataverse-Data-Curation-Tool for the installation instructions. diff --git a/doc/sphinx-guides/source/admin/external-tools.rst b/doc/sphinx-guides/source/admin/external-tools.rst index 405c710d07e..42790eee642 100644 --- a/doc/sphinx-guides/source/admin/external-tools.rst +++ b/doc/sphinx-guides/source/admin/external-tools.rst @@ -1,7 +1,7 @@ External Tools ============== -External tools can provide additional features that are not part of Dataverse itself, such as data exploration. +External tools can provide additional features that are not part of Dataverse itself, such as data file previews and exploration. .. contents:: |toctitle| :local: @@ -78,14 +78,12 @@ Once you have added an external tool to your installation of Dataverse, you will File Level Explore Tools ++++++++++++++++++++++++ -File level explore tools are specific to the file type (content type or MIME type) of the file. For example, Data Explorer is tool for exploring tabular data files. - -An "Explore" button will appear (on both the dataset page and the file landing page) for files that match the type that the tool has been built for. When there are multiple explore tools for a filetype, the button becomes a dropdown. +File level explore tools are specific to the file type (content type or MIME type). For example, Data Explorer is tool for exploring tabular data files. File Level Preview Tools ++++++++++++++++++++++++ -File level explore tools can be set up to display in preview mode, which is a simplified view of an explore tool designed specifically for embedding in the file page. +File level preview tools allow the user to see a preview of the file contents without having to download it. Explore tools can also be set up to display in a preview, which is a simplified view of an explore tool designed specifically for embedding in the file page. File Level Configure Tools ++++++++++++++++++++++++++ @@ -95,12 +93,12 @@ File level configure tools are only available when you log in and have write acc Dataset Level Explore Tools +++++++++++++++++++++++++++ -When a dataset level explore tool is added, an "Explore" button on the dataset page will appear. This button becomes a drop down when there are multiple tools. +Dataset level explore tools allow the user to explore all the files in a dataset. Dataset Level Configure Tools +++++++++++++++++++++++++++++ -Configure tools at the dataset level are not currently supported. No button appears in the GUI if you add this type of tool. +Configure tools at the dataset level are not currently supported. Writing Your Own External Tool ------------------------------ diff --git a/doc/sphinx-guides/source/admin/geoconnect-worldmap.rst b/doc/sphinx-guides/source/admin/geoconnect-worldmap.rst index 0af163a2916..fb8250c0650 100644 --- a/doc/sphinx-guides/source/admin/geoconnect-worldmap.rst +++ b/doc/sphinx-guides/source/admin/geoconnect-worldmap.rst @@ -35,7 +35,7 @@ SQL commands to point a Dataverse installation at different Geoconnect servers: Removing Dead Explore Links --------------------------- -After a map has been created in WorldMap (assuming all the setup has been done), an "Explore" button will appear next to the name of the file in Dataverse. The "Explore" button should open the map in WorldMap. In rare occasions, the map has been deleted on the WorldMap side such that the "Explore" button goes nowhere, resulting in a dead link, a 404. +After a map has been created in WorldMap (assuming all the setup has been done), in Dataverse the file will display WorldMap as an explore option. In rare occasions, the map has been deleted on the WorldMap resulting in a dead link, a 404 page not found error. Functionality has been added on the Dataverse side to iterate through all the maps Dataverse knows about (stored in the ``maplayermetadata`` database table) and to check for the existence of each map in WorldMap. The status code returned from WorldMap (200, 404, etc.) is recorded in Dataverse along with a timestamp of when the check was performed. To perform this check, you can execute the following ``curl`` command: @@ -43,7 +43,7 @@ Functionality has been added on the Dataverse side to iterate through all the ma The output above will contain the ``layerLink`` being checked as well as the HTTP response status code (200, 404, etc.) in the ``lastVerifiedStatus`` field. 200 means OK and 404 means not found. 500 might indicate that the map is only temporarily unavailable. The ``lastVerifiedStatus`` and ``lastVerifiedTime`` will be persisted to the ``maplayermetadata`` database table. -Armed with this information about WorldMap returning a 404 for a map, you may want to delete any record of the map on the Dataverse side so that the "Explore" button goes away (and so that thumbnail files are cleaned up). To accomplish this, use the following ``curl`` command, substituting the id of the file: +Armed with this information about WorldMap returning a 404 for a map, you may want to delete any record of the map on the Dataverse side removing WorldMap as an explore option (and so that thumbnail files are cleaned up). To accomplish this, use the following ``curl`` command, substituting the id of the file: ``curl -H "X-Dataverse-key: $API_TOKEN" -X DELETE http://localhost:8080/api/files/{file_id}/map`` diff --git a/doc/sphinx-guides/source/api/apps.rst b/doc/sphinx-guides/source/api/apps.rst index c1d3a0a5395..161795842d2 100755 --- a/doc/sphinx-guides/source/api/apps.rst +++ b/doc/sphinx-guides/source/api/apps.rst @@ -65,10 +65,10 @@ OSF allows you to view, download, and upload files to and from a Dataverse datas https://github.com/CenterForOpenScience/osf.io/tree/develop/addons/dataverse -GeoConnect +Geoconnect ~~~~~~~~~~ -GeoConnect allows Dataverse files to be visualized on http://worldmap.harvard.edu with the "Explore" button. Read more about it in the :doc:`/user/data-exploration/worldmap` section of the User Guide. +Geoconnect configures Dataverse files to be visualized and explored on `WorldMap `_. Read more about it in the :doc:`/user/data-exploration/worldmap` section of the User Guide. https://github.com/IQSS/geoconnect diff --git a/doc/sphinx-guides/source/api/external-tools.rst b/doc/sphinx-guides/source/api/external-tools.rst index f9231f55359..f94b813de42 100644 --- a/doc/sphinx-guides/source/api/external-tools.rst +++ b/doc/sphinx-guides/source/api/external-tools.rst @@ -9,7 +9,7 @@ External tools can provide additional features that are not part of Dataverse it Introduction ------------ -You can think of a external tool as **a glorified hyperlink** that opens a browser window in a new tab on some other website. The term "external" is used to indicate that the user has left the Dataverse web interface. For example, perhaps the user is looking at a dataset on https://demo.dataverse.org . They click "Explore" and are brought to https://fabulousfiletool.com?fileId=42&siteUrl=http://demo.dataverse.org +External tools are additional applications the user can open from Dataverse to preview or explore data files. The term "external" is used to indicate that the user has left the Dataverse web interface. For example, the user looking at a dataset on ``demo.dataverse.org`` can open an explore tool hosted on the domain ``fabulousfiletool.com``. The "other website" (fabulousfiletool.com in the example above) is probably part of the same ecosystem of scholarly publishing that Dataverse itself participates in. Sometimes the other website runs entirely in the browser. Sometimes the other website is a full blown server side web application like Dataverse itself. @@ -31,8 +31,8 @@ How External Tools Are Presented to Users An external tool can appear in Dataverse in one of three ways: -- under an "Explore" or "Configure" button either on a dataset landing page -- under an "Explore" or "Configure" button on a file landing page +- as an "Explore" or "Preview" option for a file or dataset +- as an "Configure" option for a file - as an embedded preview on the file landing page See also the :ref:`testing-external-tools` section of the Admin Guide for some perspective on how installations of Dataverse will expect to test your tool before announcing it to their users. @@ -70,7 +70,7 @@ Terminology =========================== ========== Term Definition =========================== ========== - external tool manifest A **JSON file** the defines the URL constructed by Dataverse when users click "Explore" or "Configure" buttons. External tool makers are asked to host this JSON file on a website (no app store yet, sorry) and explain how to use install and use the tool. Examples include :download:`fabulousFileTool.json <../_static/installation/files/root/external-tools/fabulousFileTool.json>` and :download:`dynamicDatasetTool.json <../_static/installation/files/root/external-tools/dynamicDatasetTool.json>` as well as the real world examples above such as Data Explorer. + external tool manifest A **JSON file** the defines the URL constructed by Dataverse when users click explore or configure tool options. External tool makers are asked to host this JSON file on a website (no app store yet, sorry) and explain how to use install and use the tool. Examples include :download:`fabulousFileTool.json <../_static/installation/files/root/external-tools/fabulousFileTool.json>` and :download:`dynamicDatasetTool.json <../_static/installation/files/root/external-tools/dynamicDatasetTool.json>` as well as the real world examples above such as Data Explorer. displayName The **name** of the tool in the Dataverse web interface. For example, "Data Explorer". @@ -78,11 +78,11 @@ Terminology scope Whether the external tool appears and operates at the **file** level or the **dataset** level. Note that a file level tool much also specify the type of file it operates on (see "contentType" below). - type Whether the external tool is an **explore** tool or a **configure** tool. Configure tools require an API token because they make changes to data files (files within datasets). Configure tools are currently not supported at the dataset level (no "Configure" button appears in the GUI for datasets). + type Whether the external tool is an **explore** tool, a **preview** tool or a **configure** tool. Configure tools require an API token because they make changes to data files (files within datasets). Configure tools are currently not supported at the dataset level. toolUrl The **base URL** of the tool before query parameters are added. - hasPreviewMode A boolean that indicates whether tool has a preview mode which can be embedded in the File Page. Since this view is designed for embedding within Dataverse, the preview mode for a tool will typically be a view without headers or other options that may be included with a tool that is designed to be launched in a new window. Sometimes, a tool will exist solely to preview files in Dataverse and the preview mode will be the same as the regular view. + hasPreviewMode A boolean that indicates whether tool has a preview mode which can be embedded in the File Page. Since this view is designed for embedding within Dataverse, the preview mode for a tool will typically be a view without headers or other options that may be included with a tool that is designed to be launched in a new window. contentType File level tools operate on a specific **file type** (content type or MIME type such as "application/pdf") and this must be specified. Dataset level tools do not use contentType. diff --git a/doc/sphinx-guides/source/developers/geospatial.rst b/doc/sphinx-guides/source/developers/geospatial.rst index 8a19a0b11f2..0a82c7128cb 100644 --- a/doc/sphinx-guides/source/developers/geospatial.rst +++ b/doc/sphinx-guides/source/developers/geospatial.rst @@ -10,7 +10,7 @@ Geoconnect Geoconnect works as a middle layer, allowing geospatial data files in Dataverse to be visualized with Harvard WorldMap. To set up a Geoconnect development environment, you can follow the steps outlined in the `local_setup.md `_ guide. You will need Python and a few other prerequisites. -As mentioned under the :ref:`architecture` section of Preparation in the Installation Guide, Geoconnect is an optional component of Dataverse, so this section is only necessary to follow it you are working on an issue related to this feature. +As mentioned under the :ref:`architecture` section of Preparation in the Installation Guide, Geoconnect is an optional external tool for Dataverse, so this section is only necessary to follow it you are working on an issue related to this feature. How Dataverse Ingests Shapefiles -------------------------------- @@ -186,7 +186,7 @@ The ``get_latest_jointarget_information()`` in ``utils.py`` retrieves recent Joi Setting Up WorldMap Test Data ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -For the dataset page, this script gives a query to add test WorldMap map data. After the query is run, the "Explore Map" button should appear for a tabular file or shapefile. In the example SQL queries below, substitute ``$DATASET_ID`` and ``$DATAFILE_ID`` with the appropriate ID's. +For the dataset page, this script gives a query to add test WorldMap map data. After the query is run, the explore in WorldMap option should display for tabular files or shapefiles. In the example SQL queries below, substitute ``$DATASET_ID`` and ``$DATAFILE_ID`` with the appropriate ID's. To add sample map data for a tabular file: diff --git a/doc/sphinx-guides/source/installation/config.rst b/doc/sphinx-guides/source/installation/config.rst index 0a664f87853..0f697d5b395 100644 --- a/doc/sphinx-guides/source/installation/config.rst +++ b/doc/sphinx-guides/source/installation/config.rst @@ -1680,14 +1680,14 @@ The ``:TwoRavensTabularView`` option is no longer valid. See :doc:`r-rapache-two :GeoconnectCreateEditMaps +++++++++++++++++++++++++ -Set ``GeoconnectCreateEditMaps`` to true to allow the user to create GeoConnect Maps. This boolean effects whether the user sees the map button on the dataset page and if the ingest will create a shape file. +Set ``GeoconnectCreateEditMaps`` to true to allow the user to create maps using Geoconnect. This boolean enables the map configure tool option for a data file and the ingest to create a shape file. ``curl -X PUT -d true http://localhost:8080/api/admin/settings/:GeoconnectCreateEditMaps`` :GeoconnectViewMaps +++++++++++++++++++ -Set ``GeoconnectViewMaps`` to true to allow a user to view existing maps. This boolean effects whether a user will see the "Explore" button. +Set ``GeoconnectViewMaps`` to true to allow a user to view existing maps. This boolean enables the map explore tool option for a data file. ``curl -X PUT -d true http://localhost:8080/api/admin/settings/:GeoconnectViewMaps`` diff --git a/doc/sphinx-guides/source/installation/prep.rst b/doc/sphinx-guides/source/installation/prep.rst index a792c5a4e9c..3135e09cb5b 100644 --- a/doc/sphinx-guides/source/installation/prep.rst +++ b/doc/sphinx-guides/source/installation/prep.rst @@ -64,7 +64,7 @@ Optional Components There are a number of optional components you may choose to install or configure, including: - External Tools: Third party tools for data exploration can be added to Dataverse by following the instructions in the :doc:`/admin/external-tools` section of the Admin Guide. -- R, rApache, Zelig, and TwoRavens: :doc:`/user/data-exploration/tworavens` describes the feature and :doc:`r-rapache-tworavens` describes how to install these components. :doc:`/admin/external-tools` explains how third-party tools like TwoRavens can be added to Dataverse. +- R, rApache, Zelig, and TwoRavens: Statistical tools for data exploration, analysis, and meta-analysis. See the :doc:`r-rapache-tworavens` section of the Installation Guide, as well as :doc:`/user/data-exploration/tworavens` section of the User Guide. - Dropbox integration :ref:`dataverse.dropbox.key`: for uploading files from the Dropbox API. - Apache: a web server that can "reverse proxy" Jakarta EE applications (like Dataverse) and rewrite HTTP traffic. - Shibboleth: an authentication system described in :doc:`shibboleth`. Its use with Dataverse requires Apache. diff --git a/doc/sphinx-guides/source/installation/r-rapache-tworavens.rst b/doc/sphinx-guides/source/installation/r-rapache-tworavens.rst index 1ba0bd083ec..3498fdcca85 100644 --- a/doc/sphinx-guides/source/installation/r-rapache-tworavens.rst +++ b/doc/sphinx-guides/source/installation/r-rapache-tworavens.rst @@ -342,8 +342,8 @@ Compare the two files. **It is important that the two copies are identical**. *(Yes, this is a HACK! We are working on finding a better way to ensure this compatibility between TwoRavens and Dataverse!)* -e. Enable TwoRavens Button in Dataverse ---------------------------------------- +e. Enable TwoRavens in Dataverse +-------------------------------- Now that you have installed TwoRavens, you can make it available to your users by adding it an "external tool" for your Dataverse installation. (For more on external tools in general, see the :doc:`/admin/external-tools` section of the Admin Guide.) @@ -353,8 +353,7 @@ Once you have made your edits, make the tool available within Dataverse with the ``curl -X POST -H 'Content-type: application/json' --upload-file twoRavens.json http://localhost:8080/api/admin/externalTools`` -Once enabled, an "Explore" dropdown will appear next to ingested tabular data files a "TwoRavens" button; clicking it will redirect -the user to the instance of TwoRavens, initialized with the data variables from the selected file. +Once enabled, TwoRavens will display as an explore tool option for tabular data files. Clicking it will redirect the user to the instance of TwoRavens, initialized with the data variables from the selected file. f. Perform a quick test of TwoRavens functionality -------------------------------------------------- @@ -373,10 +372,10 @@ change the view to Tabular, it likely means that something went very wrong with tabular ingest. Consult the app server log for any error messages that may explain the failure. -If the file is showing as Tabular Data, but the ``Explore`` button isn't present, +If the file type is tabular data, but TwoRavens is not displayed as an explore tool option, double-check that the steps in ``e.``, above, were correctly performed. -Otherwise, click on the ``Explore`` button. This will open TwoRavens in a new browser window. +Selecting the TwoRavens explore tool option will open TwoRavens in a new browser window. If the application initializes successfully, you should see the "data pebbles" representing the first 3 variables in the file: diff --git a/doc/sphinx-guides/source/user/data-exploration/tworavens.rst b/doc/sphinx-guides/source/user/data-exploration/tworavens.rst index 1c046d310d0..ddf58ee2615 100755 --- a/doc/sphinx-guides/source/user/data-exploration/tworavens.rst +++ b/doc/sphinx-guides/source/user/data-exploration/tworavens.rst @@ -3,17 +3,17 @@ TwoRavens: Tabular Data Exploration +++++++++++++++++++++++++++++++++++ -**Please note:** This document is a bit old and may need an update. The TwoRavens -project has a more recently published user guide on their site: `http://2ra.vn/papers/tworavens-guide.pdf `_. - - .. contents:: |toctitle| :local: Exploring and Analyzing Tabular files in Dataverse ================================================== -On the files tab, click on the “Explore” button to initiate TwoRavens Data Exploration and Analysis Tool. +TwoRavens Data Exploration and Analysis Tool is a statistical data exploration application integrated with Dataverse, which allows the user to run statistical models, view summary statistics, create and download subsets of variable vectors and more. + +Tabular files can have external explore tools such as TwoRavens configured, which are linked from the file actions and open in a new window. + +.. note:: The information on this page may be old and need updating. More recent user guides are being maintained on the `TwoRavens project site `_. Selection/Left Panel ==================== diff --git a/doc/sphinx-guides/source/user/data-exploration/worldmap.rst b/doc/sphinx-guides/source/user/data-exploration/worldmap.rst index fe2a6e25785..8fa4373cd14 100644 --- a/doc/sphinx-guides/source/user/data-exploration/worldmap.rst +++ b/doc/sphinx-guides/source/user/data-exploration/worldmap.rst @@ -16,9 +16,9 @@ Note: WorldMap hosts their own `user guide `_ . -.. _file-handling: - -File Handling -============= - -Certain file types in Dataverse are supported by additional functionality, which can include downloading in different formats, previews, file-level metadata preservation, file-level data citation; and exploration through data visualization and analysis. See the sections below for information about special functionality for specific file types. - .. _duplicate-files: Duplicate Files -=============== +--------------- Beginning with Dataverse 5.0, the way Dataverse handles duplicate files (filename and checksums) is changing to be more flexible. Specifically: @@ -160,6 +153,13 @@ Beginning with Dataverse 5.0, the way Dataverse handles duplicate files (filenam - If a user attempts to replace a file with another file that has the same checksum, an error message will be displayed and the file will not be able to be replaced. - If a user attempts to replace a file with a file that has the same checksum as a different file in the dataset, a warning will be displayed. +.. _file-handling: + +File Handling +============= + +Certain file types in Dataverse are supported by additional functionality, which can include downloading in different formats, previews, file-level metadata preservation, file-level data citation; and exploration through data visualization and analysis. See the sections below for information about special functionality for specific file types. + File Previews ------------- @@ -168,7 +168,7 @@ Installations of Dataverse can install previewers for common file types uploaded Tabular Data Files ------------------ -Files in certain formats - Stata, SPSS, R, Excel(xlsx) and CSV - may be ingested as tabular data (see :doc:`/user/tabulardataingest/index` section of the User Guide for details). Tabular data files can be further explored and manipulated with `TwoRavens <../user/data-exploration/tworavens.html>`_ - a statistical data exploration application integrated with Dataverse, as well as other :doc:`/admin/external-tools` if they have been enabled in the installation of Dataverse you are using. TwoRavens allows the user to run statistical models, view summary statistics, download subsets of variable vectors and more. To start, click on the "Explore" button, found next to each relevant tabular file (the application will be opened in a new window). Create and download your subset using `TwoRavens <../user/data-exploration/tworavens.html>`_. See the `TwoRavens documentation section <../user/data-exploration/tworavens.html>`_ for more information. +Files in certain formats - Stata, SPSS, R, Excel(xlsx) and CSV - may be ingested as tabular data (see :doc:`/user/tabulardataingest/index` section of the User Guide for details). Tabular data files can be further explored and manipulated with :doc:`/admin/external-tools` if they have been enabled in the installation of Dataverse you are using. Additional download options available for tabular data (found in the same drop-down menu under the "Download" button): @@ -184,7 +184,7 @@ See also :ref:`restricted-tabular-files`. Geospatial ---------- -Geospatial `shapefiles `_ can be further explored and manipulated through our integration with `WorldMap <../user/data-exploration/worldmap.html>`_, a geospatial data visualization and analysis tool developed by the `Center for Geographic Analysis `_ at Harvard University. A shapefile is a set of files, often uploaded/transferred in .zip format. This set may contain up to 15 files. A minimum of 3 specific files (.shp, .shx, .dbf) are needed to be a valid shapefile and a 4th file (.prj) is required for WorldMap--or any type of meaningful visualization. +Geospatial `shapefiles `_ can be further explored and manipulated through an optional installation configuration with `WorldMap <../user/data-exploration/worldmap.html>`_, a geospatial data visualization and analysis tool developed by the `Center for Geographic Analysis `_ at Harvard University. A shapefile is a set of files, often uploaded/transferred in .zip format. This set may contain up to 15 files. A minimum of 3 specific files (.shp, .shx, .dbf) are needed to be a valid shapefile and a 4th file (.prj) is required for WorldMap--or any type of meaningful visualization. For ingest into Dataverse and connecting to WorldMap, these 4 files are the minimum required: @@ -200,14 +200,14 @@ For a zipped shapefile, we require 4 files with these extensions. Other files ma * .prj * .dbf -For example, if these files were included within a .zip, the “Map Data” button would appear: +For example, if these files were included within a .zip, the Geoconnect configure tool option is displayed: * subway_line.shp * subway_line.shx * subway_line.prj * subway_line.dbf -Once you publish your dataset with your shape files, you will be able to use the "Map Data" button using `GeoConnect `_ to visualize and manipulate these files for users to Explore this geospatial data using the `WorldMap `__ interface. Please note: In order to map your data file, a copy will be sent to Harvard's `WorldMap `__ platform. You have the ability to delete any maps, and associated data, from the Harvard WorldMap platform, at any time. +Once you publish your dataset with your shape files, you will be able to use the configure tool `Geoconnect `_ to visualize and manipulate these files for users to explore this geospatial data on `WorldMap `__. Please note: In order to map your data file, a copy will be sent to Harvard's `WorldMap `__ platform. You have the ability to delete any maps, and associated data, from the Harvard WorldMap platform, at any time. Astronomy (FITS) ---------------- diff --git a/doc/sphinx-guides/source/user/find-use-data.rst b/doc/sphinx-guides/source/user/find-use-data.rst index 6a1883cbc22..bc8f11f19d1 100755 --- a/doc/sphinx-guides/source/user/find-use-data.rst +++ b/doc/sphinx-guides/source/user/find-use-data.rst @@ -104,7 +104,7 @@ If you'd like to download a single file or some subset of the dataset's files, y You may also download a file from its file page by clicking the Download button in the upper right corner of the page, or by :ref:`url_download` under the Metadata tab on the lower half of the page. -Tabular data files offer additional options: You can explore using any data exploration or visualization :doc:`/admin/external-tools` (if they have been enabled) by clicking the Explore button, or choose from a number of tabular-data-specific download options available as a dropdown under the Download button. +Tabular data files offer additional options such as explore using any data exploration or visualization :doc:`/admin/external-tools`, or choose from a number of tabular-data-specific download options. Tabular Data ^^^^^^^^^^^^ diff --git a/src/main/webapp/file.xhtml b/src/main/webapp/file.xhtml index 9a68212ab9b..58637ab3fdf 100644 --- a/src/main/webapp/file.xhtml +++ b/src/main/webapp/file.xhtml @@ -399,6 +399,31 @@ + + + + + + + + + + + + + + + + + + + + + + + + +