standalone.loads
The standalone.loads namespace provides functions to manage sessions for wind speed, wind design and snow calculations.
standalone.loads.start#
At the beginning of every API session, the session must be started. This function must be the first function in the array. This initiates a session and will return a session_id which can be used in subsequent calls made in the following 30 minutes to skip the verification process, thereby dramatically reducing the time to response.
important
The start function must always be the first function even if session_id is provided.
| Key | Type | Accepts | Description | Default |
|---|---|---|---|---|
keep_open | boolean | true, false | If the session should be kept on standby. If true, subsequent calls to the API using the session_id provided from the first call in lieu of key, will be 4-8x faster. | false |
After authenticating using the API key, the response object will contain some useful information. The session_id key can be used to make further calls to the same session, skipping authentication. The session_expiry_time provides an approximate Unix time until the session expires. After this, the user must re-authenticate using their API key.
tip
The returned session_id can be provided in the auth object of subsequent calls to make the request faster.
standalone.loads.getLoads#
Using the below variables, users can get the wind speed, snow loads and wind pressures from ASCE 7, AS1170, NBCC, Eurocode Design Standards, IS 875, and NSCP 2015.
standalone.loads.getLoadsRelevant components#
- The
site_dataobject - The
building_dataobject - (Optional)
project_detailsobject
The response will return design wind speed, elevations, topography, wind and snow pressures and confirm the address of the site location under the key wind_speed. In addition to this, if the terrain data is requested (user provides wind_direction and exposure keys) it will also return topography data:
Here is a sample of the elevation image that is returned when elevation_img: true :
Parameters#
The following Objects are required parameters for the above functions.
site_data#
Get wind speed from site location, based on ASCE 7-10, ASCE 7-16, AS/NZS 1170, NBCC 2015, EN 1991, IS 875, and NSCP 2015.
Common properties for all design codes#
| Key | Type | Description |
|---|---|---|
design_code | string | Which design code is this based on: as1170, asce7-10, asce7-16, en1991, nbcc2015, is875, nscp2015. |
project_address | string | The site location. This will use Google Maps to search the address and select the first option. |
wind_direction | string | Wind direction (going to). N, NE, E, SE, S, SW, W, NW. |
lat | float | Latitude of site location (used instead of project_address). E.g. 41.878100 for Chicago |
lng | float | Longitude of site location (used instead of project_address). E.g. -87.629800 for Chicago |
Design code specific properties#
| Key | Type | Design Code | Description/Options |
|---|---|---|---|
risk_category | string | ASCE 7 | I, II, III, IV |
exposure | string | ASCE 7/NSCP 2015 | Required for topography result B, C, D |
ari | integer | AS/NZS 1170 | Annual Recurrence Interval (in years)1, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, 5000, 10000 |
sls_and_uls | boolean | AS/NZS 1170 | true or false |
country | string | AS/NZS 1170 | australia or new_zealand Required for SLS and ULS wind speeds |
design_working_life | string | AS/NZS 1170 | construction_equipment, 10_years, 25_years, 50_years, 100_years, less_than_6_months (NZ only) Required for SLS and ULS wind speeds |
importance_level | string | AS/NZS 1170 | Number between 1, 5 specifying importance level Required for SLS and ULS wind speeds |
importance_category | string | IS 875 | I, II, III, IV |
structure_class_is875 | string | IS 875 | I, II, III, IV |
occupancy_category | string | NSCP 2015 | I, II, III, IV, V |
Additonal parameter for user-defined wind speed or ground snow load#
| Key | Type | Design Code |
|---|---|---|
wind_speed_override | float | ASCE 7, AS/NZS 1170, EN 1991, IS 875, NSCP 2015 Wind Load Calculation |
hourly_wind_pressure_override | float | NBCC 2015 Wind Load Calculation |
snow_load_override | float | ASCE 7, AS/NZS 1170, EN 1991, NBCC 2015 Snow Load Calculation |
Design code specific topography properties#
| Key | Type | Design Code | Description/Options |
|---|---|---|---|
terrain_category | string | AS/NZS 1170 | CAT1, CAT2, CAT2.5, CAT3, CAT4 |
snow_region | string | AS/NZS 1170 | alpine, sub-alpine |
snow_terrain_class | integer | AS/NZS 1170 | 1, 2, 3 |
ari | string | NBCC 2015 | Annual Recurrence Interval: 10_years, 50_years |
importance_level | string | NBCC 2015 | low, normal, high, post_disaster |
limit_state | string | NBCC 2015 | SLS, ULS |
snow_area_classification | string | NBCC 2015 | rural, exposed-north-treeline |
country | string | EN 1991 | Germany, United Kingdom, France... Required for additional parameters (season_month, wind_direction, terrain_category |
season_month | string | EN 1991 | For Belgium, France, UK, and Ireland 1 month: January, February, ... 2 months (UK and Ireland only): January-February, March-April, ...4 months (UK and Ireland only): November-February, December-March, ... 6 months (UK and Ireland only): October-March, April-September, ... |
wind_direction | string or integer | EN 1991 | The angle of which the wind is going to, referenced from N in clockwise direction. Use Any for worst caseFor Belgium, Poland, United Kingdom, Ireland, and France: (in degrees). Increments of 30° ranging from 0 - 360 For other countries: N, NE, E, SE, S, SW, W, NW |
terrain_category | string | EN 1991 | For UK and Ireland:0 for Sea I or II for Country III or IV for Town For France: 0 II IIIa IIIb IV For Netherlands: 0 II III Other countries: I II III IV |
distance_inside_town | float | EN 1991 | Required for UK and Ireland. Default value is 20 |
distance_from_shore | float | EN 1991 | Required for UK and Ireland. Can be obtained from server if wind direction is not equal to Any. Default value is 100 |
displacement_height | float | EN 1991 | Required for UK and Ireland. Default value is 0 |
terrain_category | string | IS 875 | 1, 2, 3, 4 |
- ASCE 7-16
- AS/NZS 1170.2
- NBCC 2015
- EN 1991
- IS 875
- NSCP 2015
standalone.loads.getLoadsbuilding_data#
Generate wind pressures or snow loads based on building parameters. These parameters have minor differences between design codes. If you need any assistance, please email us at [email protected].
Options for Structure#
| building_data.structure | Remarks |
|---|---|
building | Default value |
freestanding_wall | ASCE 7 only |
truss_tower | ASCE 7 only |
solar_panel | ASCE 7 and AS/NZS 1170 only |
signboard | EN 1991 only |
pole | EN 1991 only |
Options for ASCE 7, AS/NZS 1170, NBCC 2015, NSCP 2015#
| building_data.roof_profile | building_data.wind_parameters.enclosure | building_data.wind_parameters.wind_blockage |
|---|---|---|
gable | enclosed, partially-enclosed, partially-open | |
monoslope | enclosed, partially-enclosed, partially-open | |
hip | enclosed, partially-enclosed, partially-open | |
pitched | open | For ASCE 7/NBCC 2015/NSCP 2015: clear, obstructed For AS/NZS 1170: empty, blocked |
troughed | open | string |
open-monoslope | open | string |
| building_data.wind_parameters.structure_type | Description |
|---|---|
mwfrs | Main Wind Force Resisting System |
cladding | Components and Cladding |
Options for IS 875#
| building_data.roof_profile | building_data.wind_parameters.enclosure |
|---|---|
gable | enclosed, medium-opening, large-opening |
monoslope | enclosed, medium-opening, large-opening |
hip | enclosed, medium-opening, large-opening |
pitched | open |
open-monoslope | open |
Options for AS/NZS 1170, EN 1991, and IS 875#
| building_data.wind_parameters.structure_type | building_data.roof_profile |
|---|---|
building | gable, monoslope, hip |
free_roof | For EN 1991: pitched, open-monoslope For AS/NZS 1170: pitched, open-monoslope, troughed |
For AS/NZS 1170 and IS 875: cladding | gable, monoslope, hip, pitched, open-monoslope, troughed |
User-defined parameter for AS/NZS 1170.2 (2021)#
| Parameter | Description |
|---|---|
building_data.wind_parameters.Mh | User-defined input for Hill-shape multiplier, Mh |
building_data.wind_parameters.Mlee | User-defined input for Lee multiplier, Mlee |
building_data.wind_parameters.Ms | User-defined input for Shielding multiplier, Ms |
building_data.wind_parameters.Md | User-defined input for Wind Direction multiplier, Md |
building_data.wind_parameters.Mc | User-defined input for Climate Change multiplier, Mc |
project_details#
Optional data to be included in the detailed report generated:
| Parameter | Description |
|---|---|
project_details.units | Optional. For ASCE 7-16 only: metric, imperial |
project_details.pressure_unit | User-defined setting to convert the calculated pressures to the desired pressure unit (for AS/NZS 1170 wind load calculation) |
project_details.name | Optional |
project_details.id | Optional |
project_details.company | Optional |
project_details.designer | Optional |
project_details.client | Optional |
project_details.notes | Optional |
site_analysis#
Optional data to calculate design wind pressures for all directions and get the worst wind source direction:
| Parameter | Description |
|---|---|
site_analysis.topo_factor_all_direction | For AS/NZS 1170, ASCE 7, and NSCP 2015 The user-defined terrain/exposure category per wind source direction |
site_analysis.topo_factor_all_direction | For AS/NZS 1170, ASCE 7, and NSCP 2015 The user-defined calculated topographic factor per wind source direction at z = 0 m |
site_analysis.lee_multiplier_all_direction | For AS/NZS 1170 only The user-defined calculated Mlee factor per wind source direction |
- ASCE 7/NSCP 2015
- AS/NZS 1170.2
Use the sample json files above to start with our API. For more info on parameters used for wind or snow load calculation, please refer to our documentation and/or the load generator UI. You can also generate the API files by clicking the "API file" button on the load generator UI.