Difference between revisions of "Analytica Cloud Platform (ACP)"

 
(47 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
[[Category:Analytica User Guide]]
 
[[Category:Analytica User Guide]]
<breadcrumbs>Analytica User Guide > Creating Interfaces for End Users > {{PAGENAME}}</breadcrumbs>
+
[[Category: Analytica Cloud Platform]]
 +
<breadcrumbs>Analytica User Guide > User Interfaces for End Users> {{PAGENAME}}</breadcrumbs>
 +
<br>
 +
You can make an Analytica model accessible via a web browser in a few seconds by publishing it to the [[Analytica Cloud Platform]] (ACP).
 +
<br><br>
 +
Collaborators and end users can then view and run the model on the web. Key advantages of ACP are that:
 +
* End users don't have to install Analytica or any other software on their computer, and can access it from non-Windows computers.
 +
* They can modify inputs to define their own scenarios and generate result tables and graphs.
 +
* After you upload your model to ACP,  you can simply email your end-users an invitation with a URL link to view the model.
  
 +
==ACP Account types==
  
You can rapidly make an Analytica model available via a web browser by publishing it to the [[Analytica Cloud Player]] (ACP) hosted by Lumina. Your collaborators and end users can then view and run the model on the web. They don't have to install Analytica or any other software on their computer other than a web browser. They can access it from non-Windows computers. After you upload your model to ACP,  you can simply email your end-users an invitation with a URL link to view the model.
+
Every copy of Analytica on the desktop comes with a free ACP account. We offer these kinds of ACP accounts:
  
'''ACP individual account''': Every copy of Analytica comes with a free ACP account.  Even [[Analytica Free 101]] or a copy of Analytica with expired support comes with 25 user sessions when you sign up with ACP.  If you have a paid copy of Analytica with active support, you get 25 user sessions per month. If you need more you can buy session credits in sets of 50 [https://www.lumina.com/shoppingcart/productorder/ online].  
+
* '''ACP individual account''': You get 25 free sessions with [[Analytica Free Edition]] or Analytica with expired support.  If you have a paid Analytica license with active support, you get 25 user sessions per month. You can buy more session credits [https://analytica.com/purchase-analytica/ online].  
  
'''ACP Group Plans: '''A Group Plan for ACP allows a group of modelers to collaborate, share models, and provide them to end users. As a member of a Group Plan, you can save changes to model inputs as a snapshot so that you can modify and run it over multiple sessions. You can organize your models into '''Project Directories'''. Group members may have different levels of access for each Project Directory: '''Reviewer access'''  lets you run models; '''Author access'''  lets you upload or edit models; '''Admin access''' lets you add other Group members or modify their access.  The ACP Premium Group Plan allows more members, more sessions, more CPU time per session, and supports models that use the [[Analytica Optimizer Guide|Optimizer]].  To see prices or buy a Group Plan, see [https://www.lumina.com/shoppingcart/productorder/ Lumina.com].
+
* '''ACP Group Plan''' lets a group of up  to 5 modelers collaborate, share models, and provide them to end users. As a member of a Group Plan, you can save changes to model inputs as a snapshot so that you can modify and run it over multiple sessions. You can organize models into '''Project Directories'''. Group members may have different levels of access for each Project Directory:  
 +
** '''Reviewer access'''  lets you run models;  
 +
** '''Author access'''  lets you upload or edit models;  
 +
** '''Manager access''' lets you add new members or modify their access.   
 +
** '''Admin access''' is a Manager, which can also add or delete projects, and delete users.
  
'''Upload to ACP''': To publish a model to ACP, open the model in Analytica, then select '''File &rarr; Publish to cloud...'''.
+
* '''ACP Premium Group Plan''' extends the basic Group Plan up to 12 users, more sessions, more CPU time per session, and supports models that use the [[Analytica Optimizer Guide|Optimizer]]. 
 +
 
 +
* '''ACP Server license''' lets you install ACP on a dedicated server for your organization. The number of users, sessions, and computational time is limited only by the configuration of your server. A dedicated ACP Server can provide a higher level of security for sensitive data and models.
 +
 
 +
To see prices or buy a Group Plan, see [https://analytica.com/purchase-analytica/ Analytica.com].
 +
 
 +
==Publish to ACP==
 +
 
 +
To publish a model to ACP, open the model in Analytica, then select [[File menu|File]] &rarr; '''Publish to cloud...'''.
  
 
If you already have an ACP account set up, it shows this dialog with the '''Publish model''' tab (see below to Set up an account):
 
If you already have an ACP account set up, it shows this dialog with the '''Publish model''' tab (see below to Set up an account):
Line 23: Line 44:
 
Opening the model in ACP consumes a session credit, while viewing the model folder page does not. From the folder page, you have the option of launching the model.
 
Opening the model in ACP consumes a session credit, while viewing the model folder page does not. From the folder page, you have the option of launching the model.
  
You can also jump to the ACP model folder page by selecting '''File &rarr; Manage published models...'''.
+
You can also jump to the ACP model folder page by selecting [[File menu|File]] &rarr; '''Manage published models...'''.
  
 
'''To Set up an ACP account''': The first time you select '''Publish to cloud...''',  it opens the dialog showing the '''Configure account '''tab.
 
'''To Set up an ACP account''': The first time you select '''Publish to cloud...''',  it opens the dialog showing the '''Configure account '''tab.
Line 29: Line 50:
 
:[[File:Chapter9_24.png]]
 
:[[File:Chapter9_24.png]]
  
Click the [https://www.analyticacloud.com/acp/Signup/acpIndividualSignup.aspx sign up] link for a free ACP individual account in a web browser. You will get  account information to enter in this dialog. Then  press '''OK'''. For detailed steps on signing up for an ACP account, see [[Sharing_Models_with_Others#Analytica_Cloud_Player_.28ACP.29|Analytica Cloud Player (ACP)]] in the [[Analytica Tutorial]].  
+
Click the [https://www.analyticacloud.com/acp/Signup/acpIndividualSignup.aspx sign up] link for a free ACP individual account in a web browser. You will get  account information to enter in this dialog. Then  press '''OK'''. For detailed steps on signing up for an ACP account, see [[Tutorial: Sharing a model with ACP#Analytica_Cloud_Platform_.28ACP.29|Analytica Cloud Platform (ACP)]] in the [[Analytica Tutorial]].
 +
 
 +
== Designing models for ACP ==
  
== Designing models for viewing in web browsers ==
+
You can upload and run any Analytica model via a web browser with ACP. But, here are some guidelines to design a user interface to work well as a web application.  ACP also offers some user interface options not yet available in Analytica on the desktop, such as a tab-based interface, where each module in the main model is accessible via a tab.
You can upload and view any Analytica model on ACP. But, if you plan to publish your model on ACP for multiple end users, it's useful to follow some stylistic and pragmatic guidelines to build a user interface that works well on the web.  ACP also offers some user interface options not yet available in Analytica on the desktop, such as a tab-based interface, where each module in the main model is accessible via a tab.
 
  
'''Limit computation times''': People expect each operation in a web application to complete quickly. When operations take more than about 60 seconds, users will typically leave or close the page. ACP itself enforces a 60 second maximum duration on any single computational step (you can configure this maximum in an ACP group account, even though it isn’t highly recommended for these stylistic reasons). Models that inherently involve multi-minute computations or longer are not well-suited for publishing on the Cloud.
+
'''Limit computation times''': People expect each operation in a web application to complete quickly. When operations take more than a minute or so, users may give up and leave the page. Normally, ACP enforces a 60 second maximum compute time for each step. (If you have an ACP Group Account, you can modify this.) The Lumina-hosted ACP server is shared by many users. It is not a super computer, and is not intended for computationally intensive models.  
  
The ACP server is not a super computer, and is not intended for the evaluation of computationally excessive models. The server(s) are shared by all ACP users.
+
'''Use small diagrams''': Even people with large screens often narrower web browser windows. We recommend that you don't design a web app that needs more than 1200 pixels wide. ACP shows scroll bars if the window is wider than fits in the browser window, but that doesn't make for a  great user experience. You can achieve this by organizing a large model into a hierarchy of modules, each with not more than about 20 nodes.
  
'''Use small diagrams''': Even people with huge monitors make use of narrow web browser windows. A standard guideline is that web-apps should be a maximum of 800 pixels in width to display fully in the browser window. While ACP does not limit the actual displayed diagram size (scroll bars appear when required), you should keep diagrams within this size range to eliminate the need for users to scroll when viewing your diagrams.
+
'''Single window design''': Analytica on the desktop lets you have multiple windows open simultaneously, side-by-side or overlapping. This gives lots of flexibility to display and arrange information. ACP shows only a single diagram (or result or object view), plus an Outline view on the left -- and  you can expand a view in ACP by  [[Embed table or graph with ACP | embedding tables and graphs in a diagram]] using Tall nodes or Frame nodes.  
  
Achieving small diagrams usually translates to keeping influence diagrams to 15 nodes or less, not exceeding 5 nodes wide. For input/output panels, limit these to two columns. It is also desirable to limit the length of diagrams and input/output panels similarly so that they be fully visible without scrolling for most users. These guidelines are highly recommended even when models will not be viewed on the web, since they also correspond to the amount of visual information the human brain can assimilate holistically in a glance.
+
'''Navigation styles''': ACP provides some [[ACP Style Library#Navigation styles| layout options]] that are not (yet) available in Analytica. These include tabbed module navigation, embedded tables and graphs, an outline tree or hierarchy header, control over what surrounding interface components display, and visual styles for diagram nodes.
  
To attain small diagrams, you should make use of modules to structure your models hierarchically. Each module should “tell” a small self-contained story. The default ACP presentation includes a outliner bar along the left side of the screen (which you can disable using an ACP style setting, if desired). Although this consumes some valuable screen width, it helps to make the module hierarchy more visible and accessible, and thus help you feel more comfortable with keeping each module small.
+
:[[File:Chapter9_25a.png|600px]]
  
'''Single window design''': Desktop Analytica uses a Multiple Document Interface (MDI) paradigm, in which you can have multiple windows open simultaneously, side-by-side or overlapping. This provides a tremendous flexibility to display many items of information simultaneously in flexible arrangements, with other information close at hand. However, ACP model users view one diagram, one result, or one table at a time. It thus becomes important to cluster information that is intended to be viewed together within the same diagram. Make use of ACP layout to help accomplish this.
+
The full set of layout options and how to specify the settings are beyond the scope of this manual. The reference guide for these is on the Analytica Docs, see [[AcpStyles]], [[ACP Rendering tables and graphs on the diagram]], and [https://docs.analytica.com/index.php?title=What%27s_new_in_ACP%3F What's new in ACP].
  
'''Utilize layout styles''': ACP provides several layout options that are not yet available in Analytica 4.6. These include tabbed module navigation, embedded tables and graphs, re-usable embedded space for result views, an outline tree or hierarchy header, control over what surrounding interface components display, and additional control over node-level appearance.
+
'''ACP Style Library''' '''makes it easy '''to select most navigation options and display settings in ACP. The Style Library is packaged as an Analytica library file, which you add to your model, then access the control panels by opening the library diagrams from within Analytica.
  
:[[File:Chapter9_25.png]]
+
You can make use of the styles without using the Style Library. Styles are specified in the AcpStyles attribute, as described at [[AcpStyles]]. However, the Style Library makes these far easier to use.
  
The full set of layout options and how to specify the settings are beyond the scope of this manual. The reference guide for these is on the Analytica Wiki, see [http://wiki.lumina.com/index.php/CloudPlayerStyles_Attribute_Values CloudPlayerStyles attribute values], [http://wiki.lumina.com/index.php/ACP_Rendering_tables_and_graphs_on_the_diagram ACP rendering tables and graphs on the diagram], and [http://wiki.lumina.com/index.php/Analytica_Cloud_Player#Features_of_ACP_not_available_in_Analytica Features of ACP not available in Analytica].
+
See also the instructions for obtaining the latest version of the [[ACP Style Library]], and for using it.
  
'''Use the Style Library''': The ACP Style Library is a tool you can use when defining the ACP styles. It provides a set of control panels to select options with immediate preview displays to help you understand what each setting does. The Style Library is packaged as an Analytica library file, which you add to your model, then access the control panels by opening the library diagrams from within Analytica.
+
<iframe width="560" height="315" src="https://www.youtube.com/embed/uUAk4TwrOAw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
  
You can make use of the styles without using the Style Library. Styles are specified in the Cloud Player Styles attribute, as described at CloudPlayerStyles attribute values. However, the Style Library makes these far easier to use.
+
==Summary==
 +
'''Analytica Cloud Platform''' (ACP) is a convenient way to share models over the internet, and is usable by people who have not installed any edition of Analytica, as well as people on non-Window’s platforms. ACP accounts are free, and a moderate level of usage is free as long as you keep your support active.
  
Instructions for obtaining the latest version of the ACP Style Library, and for using it, are located on the Analytica Wiki at http://wiki.lumina.com/index.php/ACP_Style_Library.
+
When sharing models from the Cloud Platform, additional stylistic considerations are important for providing users of your model with a satisfactory browser-based experience. These include limiting evaluation times, keeping diagrams small, and making effective use of diagram real estate through embedded tables and graphs, tabbed panes and hierarchy headers. The Style Library provides an interface for selecting ACP styles.
  
 
==See Also==
 
==See Also==
* [[Analytica Cloud Player]]
+
* [[Analytica Cloud Platform]] More in-depth information.
* [[Sharing_Models_with_Others#Analytica_Cloud_Player_.28ACP.29|Analytica Cloud Player (ACP)]]
+
* [[Tutorial: Sharing a model with ACP]]
 
* [[Model Licensing]]
 
* [[Model Licensing]]
 +
* [[Editions of Analytica]]
 +
* [[What's new in ACP?]]
 +
* [[ACP Style Library]]
 +
* [[AcpStyles]]
  
  
<footer>Analytica Free 101 / {{PAGENAME}} / Using Expressions</footer>
+
<footer>User Interfaces for End Users / {{PAGENAME}} / Arrays and Indexes</footer>

Latest revision as of 21:24, 7 May 2024


You can make an Analytica model accessible via a web browser in a few seconds by publishing it to the Analytica Cloud Platform (ACP).

Collaborators and end users can then view and run the model on the web. Key advantages of ACP are that:

  • End users don't have to install Analytica or any other software on their computer, and can access it from non-Windows computers.
  • They can modify inputs to define their own scenarios and generate result tables and graphs.
  • After you upload your model to ACP, you can simply email your end-users an invitation with a URL link to view the model.

ACP Account types

Every copy of Analytica on the desktop comes with a free ACP account. We offer these kinds of ACP accounts:

  • ACP individual account: You get 25 free sessions with Analytica Free Edition or Analytica with expired support. If you have a paid Analytica license with active support, you get 25 user sessions per month. You can buy more session credits online.
  • ACP Group Plan lets a group of up to 5 modelers collaborate, share models, and provide them to end users. As a member of a Group Plan, you can save changes to model inputs as a snapshot so that you can modify and run it over multiple sessions. You can organize models into Project Directories. Group members may have different levels of access for each Project Directory:
    • Reviewer access lets you run models;
    • Author access lets you upload or edit models;
    • Manager access lets you add new members or modify their access.
    • Admin access is a Manager, which can also add or delete projects, and delete users.
  • ACP Premium Group Plan extends the basic Group Plan up to 12 users, more sessions, more CPU time per session, and supports models that use the Optimizer.
  • ACP Server license lets you install ACP on a dedicated server for your organization. The number of users, sessions, and computational time is limited only by the configuration of your server. A dedicated ACP Server can provide a higher level of security for sensitive data and models.

To see prices or buy a Group Plan, see Analytica.com.

Publish to ACP

To publish a model to ACP, open the model in Analytica, then select FilePublish to cloud....

If you already have an ACP account set up, it shows this dialog with the Publish model tab (see below to Set up an account):

Chapter9 23.png

You can optionally change ACP model name from your local file name -- useful if you want to keep several local file revisions, or want to publish different revisions. When you press Publish, it uploads the model to the ACP server. You have three options for what happens once the upload completes:

  • Open ACP model folder page
  • Open model in ACP
  • Do nothing

Opening the model in ACP consumes a session credit, while viewing the model folder page does not. From the folder page, you have the option of launching the model.

You can also jump to the ACP model folder page by selecting FileManage published models....

To Set up an ACP account: The first time you select Publish to cloud..., it opens the dialog showing the Configure account tab.

Chapter9 24.png

Click the sign up link for a free ACP individual account in a web browser. You will get account information to enter in this dialog. Then press OK. For detailed steps on signing up for an ACP account, see Analytica Cloud Platform (ACP) in the Analytica Tutorial.

Designing models for ACP

You can upload and run any Analytica model via a web browser with ACP. But, here are some guidelines to design a user interface to work well as a web application. ACP also offers some user interface options not yet available in Analytica on the desktop, such as a tab-based interface, where each module in the main model is accessible via a tab.

Limit computation times: People expect each operation in a web application to complete quickly. When operations take more than a minute or so, users may give up and leave the page. Normally, ACP enforces a 60 second maximum compute time for each step. (If you have an ACP Group Account, you can modify this.) The Lumina-hosted ACP server is shared by many users. It is not a super computer, and is not intended for computationally intensive models.

Use small diagrams: Even people with large screens often narrower web browser windows. We recommend that you don't design a web app that needs more than 1200 pixels wide. ACP shows scroll bars if the window is wider than fits in the browser window, but that doesn't make for a great user experience. You can achieve this by organizing a large model into a hierarchy of modules, each with not more than about 20 nodes.

Single window design: Analytica on the desktop lets you have multiple windows open simultaneously, side-by-side or overlapping. This gives lots of flexibility to display and arrange information. ACP shows only a single diagram (or result or object view), plus an Outline view on the left -- and you can expand a view in ACP by embedding tables and graphs in a diagram using Tall nodes or Frame nodes.

Navigation styles: ACP provides some layout options that are not (yet) available in Analytica. These include tabbed module navigation, embedded tables and graphs, an outline tree or hierarchy header, control over what surrounding interface components display, and visual styles for diagram nodes.

Chapter9 25a.png

The full set of layout options and how to specify the settings are beyond the scope of this manual. The reference guide for these is on the Analytica Docs, see AcpStyles, ACP Rendering tables and graphs on the diagram, and What's new in ACP.

ACP Style Library makes it easy to select most navigation options and display settings in ACP. The Style Library is packaged as an Analytica library file, which you add to your model, then access the control panels by opening the library diagrams from within Analytica.

You can make use of the styles without using the Style Library. Styles are specified in the AcpStyles attribute, as described at AcpStyles. However, the Style Library makes these far easier to use.

See also the instructions for obtaining the latest version of the ACP Style Library, and for using it.

Summary

Analytica Cloud Platform (ACP) is a convenient way to share models over the internet, and is usable by people who have not installed any edition of Analytica, as well as people on non-Window’s platforms. ACP accounts are free, and a moderate level of usage is free as long as you keep your support active.

When sharing models from the Cloud Platform, additional stylistic considerations are important for providing users of your model with a satisfactory browser-based experience. These include limiting evaluation times, keeping diagrams small, and making effective use of diagram real estate through embedded tables and graphs, tabbed panes and hierarchy headers. The Style Library provides an interface for selecting ACP styles.

See Also


Comments


You are not allowed to post comments.