Query Explorer feature

kevin_o_toole_1

Hello FeatureScripters!

Learning what FeatureScript's queries can do is often a slow process of reading lots of documentation, and the number of different queries avaiable can be overwhelming during this phase!

To help make this easier, we've made a "Query Explorer" custom feature. This custom feature's dialog lets you play around with Onshape's query functions, using and combining them, and seeing what the results are in real time.



You can add the feature to your toolbar here, or make a copy of the document to play around with its samples.
https://cad.onshape.com/documents/a5d9b2a6211c9576e5747d3d/w/0a149e82759d30f76fc88bb6/e/db0fd8f10a5c8328d3232869

Happy FeatureScripting!

TimRice

Did you make this so I stop bugging you and Jake for help all the time? Great feature! Thanks Kevin!

MBartlett21

@kevin_o_toole_1

How does the `convertToFs` function work? I tried opening its document, but it says I don't have permission.

konstantin_shiriazdanov

I want to beleve this is some preparation to make possible to feed filtered queries to the native features. But I see you also faced the problem of too long user interface section. If we only had ability to pack more UI options into something like lookup table.

MichaelPascoe

Thanks Kevin!

EvanReese

Kevin, this is really cool! thanks. I'm with @konstantin_shiriazdanov it would be sooo helpful for many things to have robust updatable selections built into the model. I'm kind of scratching that itch with my Selection Fillet feature, but the real deal would be something like a "Query Feature" that lets you set it all up, then call the query in any downstream features.

EvanReese

by the way. does anyone have any idea why this document is taking so long in "loading custom features and tables"? it's been spinning for over 10 minutes, and I can't add the feature

kevin_o_toole_1

does anyone have any idea why this document is taking so long in "loading custom features and tables"?

We're aware of this bug and working on a fix. In the meantime a workaround is to simply refresh the page.

john_mcclary

Oh nice! this should help a lot when trying to debug my fail queries.

EvanReese

kevin_o_toole_1 said:

does anyone have any idea why this document is taking so long in "loading custom features and tables"?

We're aware of this bug and working on a fix. In the meantime a workaround is to simply refresh the page.

got it. I tried another day and it worked.

lemon1324

This is going to be amazingly helpful, thanks for putting this together!

S1mon

Any chance of this being updated? I assume there have been updates to the query functionality since 2021.

One thing I noticed is that I can't figure out a way to select a sketch feature and a sketch entity at the same time as seeds. There's also no option to create an implicit mate connector as part of the selection process.

[edit: a quick search of the changelog shows at least one new query since 2021: "FeatureScript: New query for objects on one side of a plane ('qInFrontOfPlane')"]

MBartlett21

Changes in query.fs since 8th October 2020 (FS 1378):

GeometryType now includes ALL_MESH and MIXED_MESH options.

New functions:

• qAllSolidBodies
• qAllModifiableSolidBodiesNoMesh
• qHasAttribute
• qHasAttributeWithValue
• qHasAttributeWithValueMatching
• qOpHoleProfile
• qOpHoleFace
• qToleranceFilter (marked internal)
• qSourceMesh with EntityType
• qEdgeVertex (for getting the edge vertices at start and end rather than having to filter with a qAdjacent)
• qTangentConnectedFaces with a tangency tolerance
• qInFrontOfPlane
• areQueriesEquivalent
• isQueryEmpty
• qCoincidentFilter (marked internal)

S1mon

@MBartlett21
Good catches.

The last update was V5 which was in 2021. It references FS 1389, but it looks like they were just starting to update as there's a few commented references to "qSourceMesh", but the rest of those others are completely missing.

Kevin seems to be at Formlabs now so I'm not sure if anyone at Onshape is actively maintaining this. It is a really useful tool.

MBartlett21

Also fyi, I've done a mirror of the FS standard library at GitHub here. (making it easier to see changes). I also normalised it on the nover branch, taking version numbers out of each studio.

mbartlett21/fs-std at nover