You can make your own libraries and fill them with items to use in your documents, and you can share these tools with others.
The examples here will often make use of the Example library, which every account is automatically subscribed to.
Values and functions stored in a library can be used in formulas in a document.
There are three basic ways to do this:
The long form name for a library item looks something like this:
For a specific example:
The long form name starts with the overall library (Library) and works it's way down to the item location in the primary libraries and sub-libraries.
This works a lot like accessing a value in a frame with dot notation.
If you're using a library a lot in a file, the long form name gets to be too much text real fast.
To get around this, use a formula to give the library a shortcut name, then use the shortcut name instead of the long form name in other equations.
When libraries are included in a file, you can reference the items inside directly. There's no need to use a long form or shortcut name.
The core libraries that hold basic functions like Sqrt() are included by default. This is how you can use them directly in an equation.
Once the library is included, you can use functions or values from it just like normal functions or values.
To use a value stored in the library, use one of the methods to use a library item described above, and that's it.
To use a function stored in the library, use one of the methods to use a library item described above, and then use parentheses with the inputs, like a normal function.
To use the values in the frame, first reference the frame through the library, then use dot notation to access the values and functions inside. (Basically treat a frame as a sub-library).
Note that you can assign a shortcut name directly to the frame to make references shorter.
To reference information from a data table stored in the library, first use a method to reference library items as described above.
Then treat the data table like a function. The first input is the row lookup, and the second input is the column lookup.
The steel shapes table is a good example.
Blocks are mini-apps that can be used as calculation modules. They work a little differently from other library items like values and functions.
The Block deep dive how to use blocks in the library.
The core libraries come with any Blockpad subscription, and are automatically included in a file.
There are also built-in libraries that come free with any subscription but aren't auto-included, like the Scripts library.
To use these in a file, use one of the methods for accessing library items described above.
There are also libraries only available with specific subscriptions, like the engineering library.
Personal libraries give you the power to re-use your work across your documents or to more effectively share with others.
You can publish values that you've calculated, functions that you've defined, or even full calculation modules as blocks.
First, every user has a personal library based on their email address. It's best practice to treat this as your primary library and make sub-libraries inside.
You can create sub-libraries in your primary personal library from the online page.
From the new sub-library page, you can create deeper sub-libraries (think folders in folders). You can also navigate back to your primary personal library using the links at the top.
When you navigate back to your primary personal library, you should see your new sub-library on the page.
Now let's add something to your library. This is done directly from the Blockpad app.
The first step is to create the value in Blockpad, then use the Save to Library tool.
Saving entire frames to a library makes sense if you have a lot of related values in one document. You can upload the frame once, and then use the values from there.
See the block deep dive for how to save a block to the library.
From the online page for a personal library, you can edit sharing permissions, create online documentation, and delete library items.
You can also view other library pages online, and subscribe to them.
By sharing a library, you give someone access to all the tools you've created in your library.
After the permissions are created, they can immediately use the library values and functions in their documents.
You can also share the url with them, so they can subscribe to it.
You can create library documentation for people viewing your library online.
Right now, you can only create this documentation with html. If you're not familiar with html, you can use a text to html editor. We like this one - wordhtml.com.
You can also create documentation for a specific library item. Follow the steps above, but select the library item after step 2.
Sometime you just need to clear some space.