View source for Tutorial: Sharing a model with ACP

[[Category:Analytica Tutorial]]
[[Category: Models]]
<breadcrumbs>Analytica Tutorial > {{PAGENAME}}</breadcrumbs>
{{ReleaseBar}}

__TOC__


Once you have built your own model, others can view and use it using Analytica Free Edition, or you can make it available on the web with [[Analytica Cloud Platform]] (ACP).

In this chapter, you will learn how to share models with others. In particular, you will:
*Learn how to instruct someone to install the [[Free Edition|Analytica Free Edition]]
*Set up an Analytica Cloud account.
*Upload a model to your Cloud account
*Send an invite yourself or a friend to view your model on the Web.
*View and navigate your model in ACP.

Once you have created an Analytica model, you may wish to share it with others. Other stake-holders will find an Analytica model to be dramatically richer and more informative than a static report showing your computed results. The visual influence diagrams enable people to understand how results have been computed, assumptions used, and variables and interrelationships that impact the analysis. An ability to change inputs and recompute results interactively enables stakeholders to easily question assumptions, try their own, and understand the impact of different assumptions. And the ability to interactively pivot multi-dimensional result tables and graphs allows others to visualize your results in ways not easily facilitated by static reports. There are two straightforward methods for sharing your model: 

*Send your Analytica (*.ana) model files to them either as an email attachment, or by posting on a shared file system or file repository.
*Post your model to the [[Analytica Cloud Platform]] server and send your colleagues a URL. 

In the first case, your colleagues will need to have Analytica installed, or will need to install the Free edition, in order to view your model. In the second case, your users need only have internet access.

==Viewing with Analytica Free Edition ==
Anyone can download the [[Free Edition|Analytica Free Edition]] and install it on a Windows computer. If you have already installed any edition of Analytica, then you already have Analytica Free Edition. 

The [[Free Edition]] allows people to view your model, navigate your influence diagram hierarchy, view object windows, compute and view results, change inputs and re-evaluate results. When your model has more than 101 user objects, user cannot change your model (other than inputs) or make use of any features available only in [[Analytica Enterprise]] or above, including for example the ability to import data from external live databases after the model is loaded. 

A non-free Analytica Power Player edition provides additional features for users of models who do not need to build or make changes to the model itself. The Power Player allows users to save changes to inputs, and make use of [[Analytica Enterprise|Enterprise]]-level features such as importation of data from live databases after a model is loaded.

===Distributing your model===
To share your model with users who either have Analytica already installed, or who are willing to install the [[Free Edition]] on their Windows-based computer, simply email them your model file as an attachment. However, in the email you should include the following text: 

:To view this model, you will need to install the Analytica Free Edition. To obtain the Analytica, please visit: https://www.lumina.com/products/free/ 

You can also post your Analytica model on a web page using HTML such as the following: <code><a href=”My Model.ana”>My Model</a></code> 

When you do this, you should include the same text instructing users how to download Analytica. Users who already have Analytica installed can launch the model just by clicking on the hyperlink.

==Analytica Cloud Platform (ACP)==
In this section, you will sign up for an [[Analytica Cloud Platform]] account, publish a model to your account, browse the model in a web browser, and send an invite to view the model in ACP.

===Publish to cloud===

Start by opening the model to publish in Analytica. For this tutorial, use the Project portfolio planner model, one of the [[Example Models and Libraries|example models]] that ships with Analytica:
#Start Analytica.
#Select {{Release||4.6|[[File menu|File]] &rarr; '''Open'''..., press the Example Analytica Models ([[File:Chapter 8.1-updated.png]]) icon.}}{{Release|5.0||More Example Models from the [[Intro screen]]}}
#Open the Business examples folder.
#Select Project portfolio planner and press '''Open'''.

With your model loaded, you will now publish the model, uploading the model to the [[Analytica Cloud Platform]] (ACP) server. The steps here assume you do not yet have an ACP account, so you will sign up for a free account in the process.

{{CalloutAnnotationBlock|[[Image:Chapter 8.2-updated.png|450px]]|{{
CalloutAnnotation|Click '''Publish to Cloud...'''|n=1|pt=23,134}}
}}

If you do not already have an ACP individual account, click the '''sign up''' link:

{{Release||4.6|{{CalloutAnnotationBlock|[[File:Chapter 8.3-updated.png]]|{{
CalloutAnnotation|Click <u>[https://Acp.Analytica.com sign up]</u>|n=+|pt=207,102}} 
}}}} {{Release|5.0||{{CalloutAnnotationBlock|[[File:Chapter8.3-updated5.0.png]]|{{
CalloutAnnotation|Click <u>[https://Acp.Analytica.com/a sign up]</u>|n=+|pt=207,102}} 
}}}}

Clicking this hyperlink opens up your web browser to the page at https://Acp.Analytica.com:

{{CalloutAnnotationBlock|[[image:ACP Signup.png]]|{{
CalloutAnnotation|Fill in your email.|n=+|v=20|pt=142,181}}{{
CalloutAnnotation|Select a password that you would like to use.|n=+|v=100|pt=142,216}}{{
CalloutAnnotation|Click '''Sign up'''.|n=+|v=220|pt=294,349}}
}}

An email message is immediately sent to the email that you entered with a link that you need to click to verify that this is you. Once you click the link in the email message, you are presented with a new account, with one example model pre-loaded:

:[[File:Chapter 8.5-updated.png]]

It is possible to upload the model from this screen, using the '''Upload model''' button; however, while developing a model, the '''Publish to cloud'''... option in Analytica is far more convenient, and hence, you will continue uploading from that option. You may close this browser instance, and return to Analytica:

{{Release||4.6|{{CalloutAnnotationBlock|[[File:Chapter 8.6-updated.png]]|{{
CalloutAnnotation|Enter email and password from Steps 3 & 4.|n=+|v=30|pt=125,139}}{{
CalloutAnnotation|Optionally, check '''Remember password.'''|n=+|v=150|pt=25,249}}{{
CalloutAnnotation|Click '''OK'''|n=+|v=255|pt=158,252|path=/}}
}}}}{{Release|5.0||{{CalloutAnnotationBlock|[[File:Chapter 8.6-updated5.0.png]]|{{
CalloutAnnotation|Enter email and password from Steps 3 & 4.|n=+|v=30|pt=125,139}}{{
CalloutAnnotation|Optionally, check '''Remember password.'''|n=+|v=150|pt=17,241}}{{
CalloutAnnotation|Click '''OK'''|n=+|v=255|pt=159,257|path=/}}
}}}}

With your account information complete, the '''Publish model''' tab is now selected. The fields are pre-populated how we want them:

{{CalloutAnnotationBlock|{{Release||4.6|[[File:Chapter 8.7-updated.png]]}}{{Release|5.0||[[File:Chapter 8.7-updated5.0.png]]}}|
{{Release||4.6|{{CalloutAnnotation|Click '''Publish'''.|n=+|v=200|pt=136,224|path=r}}}}{{Release|5.0||{{CalloutAnnotation|Click '''Publish'''.|n=+|v=200|pt=117,224|path=r}}}}
}}

Because '''Open ACP model folder page''' after publishing was selected, the browser opens to the model listing page, where your newly uploaded model is now listed.

===Browsing the model===
In this section, you will begin from where you left off in the previous section. If you are returning to the [[Analytica Tutorial|Tutorial]] after having completed the steps in the previous section earlier, then select '''File''' &rarr; '''Manage''' published models from Analytica, which will take you to this same model listing page:

{{CalloutAnnotationBlock|[[File:Chapter 8.8-updated.png]]|
{{CalloutAnnotation|Click the model name|n=1|v=100|pt=76,149}}}}

When you click on the model name, the model launches in your web browser. You can change inputs, view results, and navigate the model details. Next, you will change a few inputs and view results based on those new inputs.

{{CalloutAnnotationBlock|[[File:Chapter 8.9-6.0.png]]|
{{CalloutAnnotation|Change the discount rate to 12%|v=100|n=+|pt=366,222|path=R20!}}
{{CalloutAnnotation|Open the edit table for attribute weights.|v=220|n=+|pt=794,176|path=R520}}
}}

The attribute weights indicate how important each attribute is the overall multi-attribute score for each potential project being considered for the project portfolio. Next, you will change the relative importance of these. Double click on the edit table cell to edit, and optionally click the green check to accept changes before returning to the diagram by clicking the diagram tab.

{{CalloutAnnotationBlock|[[File:Chapter 8.10-6.0.png]]|
{{CalloutAnnotation|Set the strategy fit weight to 50%|v=40|n=+|pt=272,135}}
{{CalloutAnnotation|Set staff development weight to 30%.|v100|n=+|pt=272,158}}
{{CalloutAnnotation|Click the green check and then return to the diagram.|v=180|n=6|pt=3,18|path=R10!}}
{{CalloutAnnotation|Click the green check and then return to the diagram.|v=180|n=6|pt=503,84|path=R400}}
}}

Click the result button to view the efficient frontier of project portfolios at different budget levels.

{{CalloutAnnotationBlock|[[File:Chapter 8.11-6.0.png]]|
{{CalloutAnnotation|Press Calc to see the result|n=7|v=50|pt=351,124|path=b!}}}}

The result reflects the changes you made to discount rate and attribute weights.

{{CalloutAnnotationBlock|[[File:Chapter 8.12-6.0.png]]|
{{CalloutAnnotation|Close the model|n=8|v=100|pt=1315,30|path=R10(*,48)-}}}}

===Browsing another model (optional)===
This section leads you through additional browsing exercises with another model. If you are comfortable with model browsing in ACP, you may skip this section and advance to [[#Sending_Invitations|Sending Invitations]].

The '''Rent vs Buy Example Model''' is included in your model listing when you sign up for an ACP account. Launch this model:

{{CalloutAnnotationBlock|[[File:Chapter 8.8-updated.png]]|
{{CalloutAnnotation|Click the model name.|n=1|v=150|pt=85,155|path=r}}}}

Using the outline view on the left, you can quickly explore the module organization of the model. Clicking on a variable node displays its graph:

{{CalloutAnnotationBlock|[[File:Chapter 8.14-6.0.png]]|
{{CalloutAnnotation|Click on outline triangle to see modules inside '''Cost to buy'''.|n=+|v=70|pt=24,128}}
{{CalloutAnnotation|Click on a node to view it's result '''Cost to buy'''.|n=+|v=200|pt=707,301}}}}

Here we see the probability density result graph for '''Costs of buying and renting'''. Just like in Analytica desktop, you can view the result as a table or graph, using the tabs at the top to select the desired view, and can switch between different [[Uncertainty view of a result|uncertainty views]].

{{CalloutAnnotationBlock|[[File:Chapter 8.15-6.0.png]]|
{{CalloutAnnotation|Click on the Table tab to see the result table.|n=+|v=15|pt=773,63|path=T10-}}
{{CalloutAnnotation|Select '''statistics''' view.|n=+|v=170|pt=623,124}}}}

You can also pivot multidimensional [[Result Tables and Graphs|result tables or graphs]].
If you click on the row index '''.statistics''' the row pivoter appears.

{{CalloutAnnotationBlock|[[File:Chapter 8.16-6.0.png]]|
{{CalloutAnnotation|You can pivot the table by Selecting the index to show as row headers.|n=+|v=140|pt=313,227}}}}

Spend some additional time navigating the model on your own.

{{CalloutAnnotationBlock|[[File:Chapter 8.17-6.0.png]]|
{{CalloutAnnotation|Return to the top model diagram.|n=+|v=30|pt=8,106|path=b!}}
{{CalloutAnnotation|After you finish the exploring, close the model.|n=+|v=220|pt=1076,20|}}}}

===Sending Invitations===
You are now ready to invite a colleague to view your model. To experience the invitation yourself, you will send the invitation to yourself here, but if you wish, you can repeat the steps here and send an invitation to a friend.

{{CalloutAnnotationBlock|[[File:Chapter 8.8-updated.png]]|
{{CalloutAnnotation|Select the model to share.|n=1|v=150|pt=43,152|path=r/}}
{{CalloutAnnotation|Click '''Email invite'''|n=+|v=260|pt=410,235|path=r/}}
}}

You can customize the email message before sending it out. It also works fine to copy/paste the URL that appears in the suggested message text into an email you compose in your own email program, and send the email from there.

{{CalloutAnnotationBlock|[[File:Chapter 8.19-updated.png]]|
{{CalloutAnnotation|Enter one or more email addresses.|n=+|v=10|pt=217,40|path=r}}
{{CalloutAnnotation|Customize the email subject and/or text if desired, leaving the URL unaltered.|n=+|v=110|pt=223,81}}
{{CalloutAnnotation|||v=160|pt=126,204|Type=Bare}}
{{CalloutAnnotation|Click the button to email the invite.|n=+|v=545|pt=32,584}}
}}

Next, since you sent the email to yourself, bring up the program you use to read your email. The message usually arrives within a few seconds. Read the message to get an idea what your colleagues will see when they receive the invitation. Here is one example:

:[[File:Chapter 8.20-updated.png|border]]

===Sessions===
When you signed up for the [[Analytica Cloud Platform]], you automatically received 25 free sessions for signing up. If you keep your support active on your Analytica license, you’ll also receive an additional 25 sessions per month. Sessions expire at the end of each month if unused, but 25 new sessions appear at the beginning of each month. These free sessions allow for a moderate level of ACP usage at no charge. 

Sessions begin when a model is run, and time out after 20 minutes of inactivity, if a different browser is used, or if the user logs out. Viewing model listings does not use a session. Each user session is good for up to a certain amount of CPU computation time depending on your account type; these limits can be seen in the table below.

:{| class="wikitable"
|-
! Account Type !! CPU Minutes per Calculation
|-
| Individual without Support || 1
|-
| Individual with Support || 1
|-
| Group Account || 2
|-
| Premium Group Account || 5
|-
| ACP on Your Server || Unlimited
|}

Very occasionally, some models will contain very CPU-intensive computations. When these computations surpass the CPU computation limit, additional session credits may be consumed. If you have a excessively CPU-intensive model, then you should consider sharing it via [[Free Edition]] or Analytica Power Player instead. We want to keep the ACP server responsive for all users! From the Project Directory page in ACP, you can click the Account Info button to view your user session credit balance.

From the Project Directory page in ACP, you can click the '''Account Info''' button to view your user session credit balance.

{{CalloutAnnotationBlock|[[File:Chapter 8.8-updated.png]]|
{{CalloutAnnotation|Click the '''Account''' tab.|v=80|pt=129,22|path=r}}
}}

When you require a higher usage level than provided with the free monthly credits, you can purchase additional user session credits to your account by logging into ACP and pressing the '''Buy More''' link.

:[[File:Chapter8.21b.png]]

An ACP Group Plan subscription also exists with additional functionality for collaborative project support, higher included monthly user session levels, named users with access permissions, and additional features. Learn more on the [http://www.lumina.com/shoppingcart/acpgroupaccount/ Lumina web site].

==See Also==
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
* [[Analytica User FAQs/Sharing Models]]
* [[Analytica_Free_Edition#Model_sharing_options|Model sharing options]]
* [[Free Edition]]
* [https://Lumina.com/products/free101/ Download Analytica Free Edition]
* [[Analytica Cloud Platform]]
* [[Editions of Analytica]]
* [[Tutorial: Create a model]]
* [[Create a model]]
* [[Working with Large Models]]
* [[Model Licensing]]
* [[Example Models]]
* [[Example Models and Libraries]]
* [[Tutorial videos]]
</div>


<footer>Tutorial: Uncertainty/ {{PAGENAME}} / Tutorial: Decision trees</footer>