Q and Displayr work very well together. QPacks made in Displayr or Q can be used in each program interchangeably and can provide workflow options between teams.
Method
Step 1: Upload a QPack to Displayr
A QPack is a compressed file that contains both your project work and the associated data file.
- Open your project in Q
- Select File > Save as…, change the File type option to Q Pack Files, choose a file name, and press Save
- In Displayr, go to the Documents screen, press + Upload Document and select your file (ending in .QPack) and press OK
If you want to reproduce what I do in this post, you can download the QPack from here.
Step 2: Create your pages and folders in Displayr
Although Q and Displayr are 100% compatible, they are different in terms of how they present things and also how a few things work. See the Q Wiki for an overview of differences.
A key difference you will notice is that Displayr is organized around pages, whereas Q is organized around tables. The main consequence of this is that that every Q folder becomes a folder in Displayr, and every table or output is likewise stored on a separate page, with one exception. If a folder in Q has a single output (table, visualization, R Output, etc.) in it, that folder becomes a page in Displayr. For example, the screenshot below shows this data set in Q, where I have three folders containing crosstabs.
And here is the project in Displayr, where the first page is blank. My folder Techniques has become a blank page called Techniques, which also acts a folder for other pages (each page containing one of the crosstabs I had in Q).
Step 3: (Optional) Hiding all your Q work in the Displayr document
If you are using Q for your analysis, there is a good chance that you may want to continue to use Q later, as well as using Displayr. If this is the case, the trick is to avoid inadvertently deleting your Q work when you create your dashboard in Displayr. You can do this as follows in Displayr:
- Home > New Page > Title Page
- Type My Q stuff or whatever name you want into the heading field.
- Select all of your existing Q work (from the Pages tree), and drag it onto this new page.
- Hide the folder you have created: Appearance > Hide (Layout).
Step 4: Create your dashboard
Now, with the data in Displayr, it is time to build a dashboard. Building a Simple Dashboard in Displayr continues where this post leaves off, building a dashboard for this data file in Displayr. In the example dashboard in that post, I also deleted the My Q Stuff folder (rather than keeping it as described in the optional step 3 above). The reason for that was simply to make that post completely self-contained (if you are replicating the steps in this post, you can choose to either delete it, or not).
NEXT
How to Troubleshoot Problems Opening or Receiving QPacks
How to Edit a Displayr Document in Q