Valispace intends to be open to integration into various other tools. This is how we imagine Valispace integrating with your engineering workflow:
For this vision to become reality, Valispace offers a series of Addons and encourages you, to build additional ones yourself. Valispace currently integrates to:
Most of the data stored in the Valispace database is accessible in machine readable (.json) format through a REST API. You can find it in yourdeployment.valispace.com/rest/ (e.g. here in our demo deployment)
The REST API is very powerful and gives you direct read/write access to your data. However with great power comes great responsibility. In case you would like to write your own application which can interface to Valispace, don't hesitate to contact us to support you.
You can read the API documentation here.
The Valispace python API lets you access and update objects in your Valispace deployment with python code.
Install the Valispace python API with pip:
pip install valispace
Import valispace API module in a python script:
and initialize with
valispace = valispace.API()
More information about the functionalities and functions in the API can be found at github.com/valispace/ValispacePythonAPI. The Valispace python API is licensed under the MIT license, which means that anyone can contribute to the code by cloning the GitHub repository.
To store your Valispace login credentials we recommend using Keyring, instead of storing them as variables in your source code.
STK Integration using Python APIs¶
Model, simulate and analyse your complex missions using AGI Systems Tool Kit (STK) and set up automated interfaces between your advanced calculation sequences to improve the data management through design iteration. This integration ensures two-way intelligent data exchange and updates all the dependent parameters of the project with every analysis update in STK.
Check out the tutorial for preliminary integration using Python APIs to learn how to utilize it. Also, check out advanced capabilities that this integration enables in this Astrogator Integration Video.
Microsoft Word Addon¶
The Microsoft Word Addon lets you insert values, budgets, and charts from your Valispace deployment into your document as a field and let's you refresh them with the newest values at any time.
In the sidebar, you can look for Valis in the component tree and add them to the document by clicking on
Add to Document.
Refresh all in the top ribbon, all values which have been inserted with this plugin are refreshed with the newest values from the Valispace database.
When you give your Word document to another person who does not have the plugin or access to your Valispace deployment, all values will still be available in the document.
The plugin is compatible with:
- Word 2010 [Windows - Desktop]
- Word 2013 [Windows - Desktop]
- Word 2016 [Windows - Desktop]
- Word 365 [Windows - Desktop]
Current plugin version: 184.108.40.206
Download and installation¶
Download the Word plugin here: Download Word plugin (v220.127.116.11).
Install it by clicking the setup.exe file and following the instruction.
Warning! We are still working on getting a valid code certificate for the plugin, which means that Windows might deem the setup file to be not secure. It is however safe to run the installation anyway.
Next time you open Word, you will see the Valispace tab at the top of your document. Fill in your user credentials in the Settings tab and log in to see your components and Valis.
Remember to use https:// in the URL if you want the connection to be securely encrypted.
MS Excel Addon¶
The MS Excel Addon lets you exchange data bi-directionally between your Excel Worksheet and your Valispace deployment.
By clicking on
Add Vali in the ValiSpace Ribbon, you can select a Vali which you would like to reference in the cell which is selected.
It will then be inserted.
By clicking on
Refresh Valis in the ValiSpace Ribbon, all of your cells which reference (Pull) Valis in your workbook will be updated to the newest value from your Valispace Deployment.
Select a cell in your workbook, for which you want to recurrently upload its value to your Valispace deployment. Then click
Add Push Vali to connect it to a Vali which you can select from the list.
Whenever you click
Push Valis in the ValiSpace Ribbon, all Push Valis will be pushed to your Valispace deployment. You will receive a message with all performed updates.
Download and installation¶
1) Download the addon from GitHub here and store it to a folder of your choice.
2) Open Excel, click on the main menu (or
File in newer Excel versions) then
Add-Ins --> Excel-Addins:
Browse and select the .xlam file, select it with a check-box and click
4) A new Ribbon called
Valispace should have appeared in the top main menu.
5) To prevent the need to re-do the same steps every time you start Excel, you will have to add the folder containing the Add-In to your "Trusted File Locations". To do this, click on
Trust Center -->
Trust Center Settings... -->
Trusted Locations -->
Add new location... -->
Browse and add the folder where you stored the Addon.
6) To setup Valispace, in the new
ValiSpace Ribbon, select
Settings and insert your deployment's URL (e.g.
https://yourdeployment.valispace.com), your username and password and confirm with
The Matlab Toolbox lets you read from and write to your Valispace deployment directly from your Matlab simulations.
% 1) Valispace Login ValispaceInit("https://demo.valispace.com","username","password") % 2) optional: pull all Valis for faster access or access via name ValispacePull() % 3a) get Vali as a struct 3a) ValispaceGetVali("MySat.Mass") % 3b) get value 3b) ValispaceGetValue("MySat.Mass") % 4) push value to Valispace 4) ValispacePushValue("MySat.Mass",0) % 4b) update dataset (x values as first row and y values as second row) 4b) ValispacePushDataset("MySat.Mass", [0,1,2,3,4,5,6; 10,20,30,40,50,60,70]) % get matrix values from matrix ID 5) ValispaceGetMatrix(217) % push matrix values 6) ValispacePushMatrix(217,[2,3;4,5]) % post data through REST API 7) ValispacePost(url, data) % get data in json format through REST API 8) ValispaceGet(url)
Please note: Until you run
clear all the all
ValispaceGetValue() will use the cached values from your last
ValispacePushValue() work with the argument as a string (name) or integer (id)
When using these functions with an integer id, step 2) can be skipped. In this case the WebInterface will be accessed with every individual call.
Both ValispacePushValue() and ValispacePushMatrix() can also push formulas (e.g. $MySat.Mass*5) instead of values
Download and installation¶
Download it from GitHub here and install the toolbox via double click. You can then activate it by clicking the Valispace Toolbox Icon in your Apps Ribbon inside Matlab.
The Matlab plugin is tested with Matlab version R2017a.
The satsearch integration enables you to populate your Valispace environment with subsystems and components from the satsearch database.
Setting up the integration on satsearch.co¶
To get started, sign up for an account at satsearch.co/register. Once you’ve activated your account, log in, which will take you to your account home.
Click on Integrations to take you to the Integrations home.
Click on the Valispace integration tile. You can watch the video on this page for an overview of how the satsearch integration with Valispace works.
Click on the Activate button the left, to activate the integration with Valispace for your account. Click on the View Settings button or Settings tab that appear after successful activation to edit the URL for your Valispace server. You can use demo.valispace.com for testing purposes (if you’ve created a demo account previously).
Using the integration¶
To add a satsearch part to your Valispace project, navigate to a project page, e.g., Honeywell’s HR 0610 reaction wheel. On the product page, below the image you’ll see an Add button. Click on this button to push an instance of this reaction wheel to Valispace.
You’ll be prompted to log in with your Valispace credentials and authorize the integration to write data to your project.
If the part was successfully added to your Valispace project, you’ll be returned to the product page on satsearch and greeted with a success message.
To see the results of your push action, go to your Valispace project, where you will find the new component listed in your project tree.