Load Generator


Automate wind speed, wind design and snow calculations.


Functions#

The following functions assist in the determination of loads due to wind and snow.


loads.getLoads#

Using the below variables, users can get the wind speed, snow loads and wind pressures from ASCE, AS1170, NBCC or Eurocode Design Standards.

Sample input for loads.getLoads
{
"function": "loads.getLoads",
"arguments": {
"project_details": {
"name": "Pat's House",
"id": "SKYPH-001",
"company": "SkyCiv",
"designer": "Patrick",
"client": "",
"notes": "",
"units": "imperial" //imperial or metric
},
"site_data": {},
"building_data": {}
}
}
Try loads.getLoads

Relevant components#

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:

Sample response for loads.getLoads
{
"site_data": {
"country": "United Kingdom",
"lat": 51.501364,
"lng": -0.14189,
"elevation": 6.36,
"formatted_address": "Westminster, London SW1A 1AA, UK"
},
"wind_data": {
"uk_ireland_contour": 21.621648873984707,
"distance_from_shore": {
"0": {
"distance": 233.92573712464545,
"lat": 53.60510578995467,
"lng": -0.1418899999999966
},
"30": {
"distance": 174.5852678317777,
"lat": 52.98168910830151,
"lng": 0.7127760997660391
}
// etc
},
"wind_speed": 21.8
},
"snow_data": {
"snow_region": "zone3",
"snow_load": 0.5
},
"topography": {
"code": "en1991",
"topo_factor": 1,
"comments": "",
"location_of_peak": 1740,
"elevation_of_peak": 26.6097240447998,
"location_of_foot": -1580,
"elevation_of_foot": 0,
"elevation_of_midheight": 13.3048620223999,
"slope": 0.008014977121927652,
"H": 26.6097240447998,
"x": -1740,
"Lu": 3320,
"Ld": 240,
"terrain_type": "Flat",
"elevation_image_base64": "**Base 64 Data**"
},
"snow_pressure": null,
"wind_pressure": {
"pressure_type": "building",
"pressure_unit": "Pa",
"elevation_or_location_unit": "m",
"pressures": [
{
"dirn": "along_L",
"surface": "windward_wall",
"elevation": [3, 6, 9],
"pos_Cpi": [204.49, 204.49, 204.49],
"neg_Cpi": [425.75, 425.75, 425.75]
},
{
"dirn": "along_L",
"surface": "leeward_wall",
"elevation": 21,
"pos_Cpi": -325.11,
"neg_Cpi": -103.85
},
{
"dirn": "along_L",
"surface": "sidewall",
"location": [2, 10, 12.4],
"pos_Cpi": [-619.531865399467, -442.5227609996193, -309.7659326997335],
"neg_Cpi": [-398.27048489965733, -221.26138049980966, -88.50455219992386]
},
{
"surface": "roof",
"zone": "F",
"pos_Cpi": 194.71,
"neg_Cpi": -592.98
},
{
"surface": "roof",
"zone": "G",
"pos_Cpi": 194.71,
"neg_Cpi": -495.63
},
// etc
],
"forces": null
}
}

Here is a sample of the elevation image that is returned when elevation_img: true :


wind.getPressures#

For generating pressure loads with respect to site and building data.

Sample input for wind.getPressures
{
"function": "wind.getPressures",
"arguments": {
"design_code": "asce7-16", //asce7-10 or asce7-16
"structure": "freestandingwall", //building, freestandingwall, trusstower
"freestandingwall_dimensions": {
"ground_to_top": 20, //ground to top of wall
"wall_width": 50,
"wall_height": 10,
"ratio_of_solid_area_to_gross": 0.9, // between 0 to 1.0
"length_of_return_corner": 0
},
"wind_parameters": {
"structure_type": "freestandingwall-asce7-16" //freestandingwall or freestandingwall-asce7-16
},
"snow_parameters": false // not available for freestandingwall and truss towers
}
}
Sample input for wind.getPressures
const bld_args = {
design_code: 'en1991',
structure: 'building',
roof_profile: 'gable', //gable, hip, monoslope, pitched, troughed, open-monoslope
building_dimensions: {
length: 12.4,
width: 10,
ground_to_top: 21,
roof_angle: 12,
},
//"wind_parameters" can be an object or false if not considered
wind_parameters: {
structure_type: 'building', // building or free_roof
// "wind_blockage": "obstructed", // clear or obstructed,
flat_roof_type: 'not-applicable', // not-applicable, sharp-eaves, with-parapet, curved-eaves, mansard-eaves
structure_level: [
{ floor_level: '2', floor_elevation: 3 },
{ floor_level: '3', floor_elevation: 6 },
{ floor_level: 'roof', floor_elevation: 9 },
],
wall_area_en1991: 10, //optional - default value is 10. Ranging from 1 to 10 sqm if wall component/cladding is analyzed
roof_area_en1991: 10, //optional - default value is 10. Ranging from 1 to 10 sqm if roof component/cladding is analyzed
},
// "snow_parameters" can be an object or false if not considered
snow_parameters: false,
};

Objects#

The following objects are required arguments for the above functions.


site_data#

Get wind speed from site location, based on ASCE 7-10, ASCE 7-16, AS/NZS 1170, NBCC and EN 1991.

Common properties for all design codes#

KeyTypeDescription
design_codestringWhich design code is this based on:
as1170, asce7-10, asce7-16, en1991, nbcc2015.
project_addressstringThe site location. This will use Google Maps to search the address and select the first option.
wind_directionstringWind direction (going to). N, NE, E, SE, S, SW, W, NW.
latfloatLatitude of site location (used instead of project_address). E.g. 41.878100 for Chicago
lngfloatLongitude of site location (used instead of project_address). E.g. -87.629800 for Chicago

Design code specific properties#

KeyTypeDesign CodeDescription/Options
risk_categorystringASCE 7I, II, III, IV
exposurestringASCE 7Required for topography result B, C, D
ariintegerAS/NZS 1170Annual Recurrence Interval (in years)
1, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, 5000, 10000
sls_and_ulsbooleanAS/NZS 1170true or false
countrystringAS/NZS 1170australia or new_zealand
Required for SLS and ULS wind speeds
design_working_lifestringAS/NZS 1170construction_equipment, 10_years, 25_years, 50_years, 100_years, less_than_6_months (NZ only)
Required for SLS and ULS wind speeds
importance_levelstringAS/NZS 1170Number between 1, 5 specifying importance level
Required for SLS and ULS wind speeds

Design code specific topography properties#

KeyTypeDesign CodeDescription/Options
terrain_categorystringAS/NZS 1170CAT2, CAT3, CAT4
snow_regionstringAS/NZS 1170alpine, sub-alpine
snow_terrain_classintegerAS/NZS 11701, 2, 3
aristringNBCC 2015Annual Recurrence Interval: 10_years, 50_years
importance_levelstringNBCC 2015low, normal, high, post_disaster
limit_statestringNBCC 2015SLS, ULS
snow_area_classificationstringNBCC 2015rural, exposed-north-treeline
countrystringEN 1991Germany, United Kingdom, France...
Required for additional parameters (season_month, wind_direction, terrain_category
season_monthstringEN 1991For 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_directionstring or integerEN 1991The angle of which the wind is going to, referenced from N in clockwise direction. Use Any for worst case
For 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_categorystringEN 1991For 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_townfloatEN 1991Required for UK and Ireland. Default value is 20
distance_from_shorefloatEN 1991Required for UK and Ireland. Can be obtained from server if wind direction is not equal to Any. Default value is 100
displacement_heightfloatEN 1991Required for UK and Ireland. Default value is 0
Sample site_data input
{
"design_code": "asce7-16",
"project_address": "Wacker Avenue, Chicago",
"country": "United States",
"risk_category": "III",
// lat: 41.878100, or lat: 41°52"41.2"N
// lng: -87.629800, or lng: 87°37"47.3"W
"topography": {
"terrain_data": true,
"wind_direction": "N",
"exposure": "B",
"topo_image": true,
}
}
Try loads.getLoads

building_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#

structureRemarks
buildingDefault value
freestanding_wallASCE 7 only
truss_towerASCE 7 only

Options for ASCE 7, NBCC 2015#

roof_profileenclosurewind_blockage
gableenclosed, partially-enclosed, partially-open
monoslopeenclosed, partially-enclosed, partially-open
hipenclosed, partially-enclosed, partially-open
pitchedopenFor ASCE 7/NBCC 2015: clear, obstructed
For AS/NZS 1170: empty, blocked
troughedopenstring
open-monoslopeopenstring
structure_typeDescription
mwfrsMain Wind Force Resisting System
claddingComponents and Cladding

Options for AS/NZS 1170 and EN 1991#

structure_typeroof_profile
buildinggable, monoslope, hip
free_roofFor EN 1991: pitched, open-monoslope
For AS/NZS 1170: pitched, open-monoslope, troughed
For AS/NZS 1170: claddinggable, monoslope, hip, pitched, open-monoslope, troughed

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.