2c:null 2d:["$","title",null,{"children":"Section 3.2 - GUI controller interface - Check Box List | Felipe Ferrari | Observable"}] 32:T4c0,{ const renderer = new THREE.WebGLRenderer({ antialias: true }); renderer.toneMapping = THREE.ReinhardToneMapping; renderer.toneMappingExposure = 2.3; scene.background = new THREE.Color(0xA9CCE3); const height = 600; const aspect = width / height; const camera = new THREE.PerspectiveCamera(50, aspect); camera.up.set(0, 0, 1); scene.add(camera); camera.position.set(30, 20, 20); function onWindowResize() { renderer.setSize(width, height); camera.aspect = width / height; camera.updateProjectionMatrix(); } window.addEventListener('resize', onWindowResize); const controls = new THREE.OrbitControls(camera, renderer.domElement); controls.target = new THREE.Vector3(0, 0, 0); controls.update(); invalidation.then(() => renderer.dispose()); renderer.setSize(width, height); renderer.setPixelRatio(devicePixelRatio); const ambientLight = new THREE.AmbientLight(0xffffff, 0.3); const mainLight = new THREE.DirectionalLight(0xffffff, 1); mainLight.position.set(1, 1, 1); scene.add(ambientLight, mainLight); var animate = function() { requestAnimationFrame(animate); renderer.render(scene, camera); }; animate(); yield renderer.domElement; }33:T497,md` ### Product Hierarchy The system engineering best practices suggest a separation of the system into a product hierarchy to group different parts. The approach helps to identify the different stakeholders addressed to the specific subsystem and to manage each subsystem as a product of its own **[1]**. In software engineering the grouping of the system helps to contextualize the different functionalities of the ship depending of users needs. For example, a professional responsible for controlling the ship stability may be interested just on the distribution of the weights in each tank and the consumption of the fuel, for other hand, a user responsible for tracking the structural integrity of the ship may be interested only on the structural elements and the visualization of each particular tank could be suppressed. [Vessel.js](https://shiplab.github.io/vesseljs/) lybrary currently group the systems in four main subsystems in the first tear: Structure, Decks, Tanks and Machinery. The Structure is then separeted into Deck and Bulkheads. The hierarchy graph bellow helps to depict the organization of the structure. `34:T11c0,chart3 = { root.x0 = dy / 2; root.y0 = 0; root.descendants().forEach((d, i) => { d.id = i; d._children = d.children; if (d.depth && d.data.name.length !== 7) d.children = null; }); const svg = d3 .create("svg") .attr("viewBox", [-margin.left, -margin.top, width, dx]) .style("font", "10px sans-serif") .style("user-select", "none"); const gLink = svg .append("g") .attr("fill", "none") .attr("stroke", "#555") .attr("stroke-opacity", 0.4) .attr("stroke-width", 1.2); const gNode = svg .append("g") .attr("cursor", "pointer") .attr("pointer-events", "all"); function update(source) { const duration = d3.event && d3.event.altKey ? 2500 : 250; const nodes = root.descendants().reverse(); const links = root.links(); // Compute the new tree layout. tree2(root); let left = root; let right = root; root.eachBefore(node => { if (node.x < left.x) left = node; if (node.x > right.x) right = node; }); const height = right.x - left.x + margin.top + margin.bottom; const transition = svg .transition() .duration(duration) .attr("viewBox", [-margin.left, left.x - margin.top, width, height]) .tween( "resize", window.ResizeObserver ? null : () => () => svg.dispatch("toggle") ); // Update the nodes… const node = gNode.selectAll("g").data(nodes, d => d.id); // On mouse atempt function dist2(a, b) { return (a[0] - b[0]) ** 2 + (a[1] - b[1]) ** 2; } node.on("mousemove", function() { const m = d3.mouse(this); const leaf = node.data()[ d3.scan(node.data().map(d => dist2([d.y, d.x], m))) ]; let d = root .links() .filter(d => d.target === leaf) .pop().target; const path = []; do { path.push(d.data); } while ((d = d.parent)); node.classed("highlight", d => path.indexOf(d.data) > -1); node.classed("leaf", d => path.indexOf(d.data) === 0); link.classed("highlight", d => path.indexOf(d.target.data) > -1); svg.node().value = path; svg.node().dispatchEvent(new CustomEvent("input")); }); // Enter any new nodes at the parent's previous position. const nodeEnter = node .enter() .append("g") .attr("transform", d => `translate(${source.y0},${source.x0})`) .attr("fill-opacity", 0) .attr("stroke-opacity", 0) .on("click", d => { d.children = d.children ? null : d._children; update(d); }); nodeEnter .append("circle") .attr("r", 2.5) .attr("fill", d => (d._children ? "#555" : "#999")) .attr("stroke-width", 10); nodeEnter .append("text") .attr("dy", "0.31em") .attr("x", d => (d._children ? -6 : 6)) .attr("text-anchor", d => (d._children ? "end" : "start")) .text(d => d.data.name) .clone(true) .lower() .attr("stroke-linejoin", "round") .attr("stroke-width", 3) .attr("stroke", "white"); // Transition nodes to their new position. const nodeUpdate = node .merge(nodeEnter) .transition(transition) .attr("transform", d => `translate(${d.y},${d.x})`) .attr("fill-opacity", 1) .attr("stroke-opacity", 1); // Transition exiting nodes to the parent's new position. const nodeExit = node .exit() .transition(transition) .remove() .attr("transform", d => `translate(${source.y},${source.x})`) .attr("fill-opacity", 0) .attr("stroke-opacity", 0); // Update the links… const link = gLink.selectAll("path").data(links, d => d.target.id); // Enter any new links at the parent's previous position. const linkEnter = link .enter() .append("path") .attr("d", d => { const o = { x: source.x0, y: source.y0 }; return diagonal({ source: o, target: o }); }); // Transition links to their new position. link .merge(linkEnter) .transition(transition) .attr("d", diagonal); // Transition exiting nodes to the parent's new position. link .exit() .transition(transition) .remove() .attr("d", d => { const o = { x: source.x, y: source.y }; return diagonal({ source: o, target: o }); }); // Stash the old positions for transition. root.eachBefore(d => { d.x0 = d.x; d.y0 = d.y; }); } update(root); return svg.node(); }35:T61c7,Ship3D = { //@EliasHasle /* Draft for new version. More modularized, and interacts with a ship state. Uses an additional coordinate system for motions. The position.xy and rotation.z of the Ship3D object plane the ship in the 3D world. (Not geographically) position.z is the (negative) draft. fluctCont is a "fluctuations container" to be used for dynamically changing motions like heave, pitch, roll. cmContainer centers the motion on the center of gravity. normalizer nulls out the center of gravity height before the draft is applied. THREE.js Object3D constructed from Vessel.js Ship object. There are some serious limitations to this: 1. null values encountered are assumed to be either at the top or bottom of the given station. 2. The end caps and bulkheads are sometimes corrected with zeros where they should perhaps have been clipped because of null values. TODO: Use calculated draft for position.z, and place the ship model in a motion container centered at the calculated metacenter. */ //var hMat; //global for debugging function Ship3D( ship, { shipState, stlPath, deckOpacity = 0.2, objectOpacity = 0.5 } ) { THREE.Group.call(this); this.normalizer = new THREE.Group(); this.fluctCont = new THREE.Group(); this.fluctCont.rotation.order = "ZYX"; //right? this.cmContainer = new THREE.Group(); this.fluctCont.add(this.cmContainer); this.normalizer.add(this.fluctCont); this.add(this.normalizer); Object.defineProperty(this, "draft", { get: function() { return -this.position.z; } /*, set: function(value) { this.position.z = -value; }*/ }); Object.defineProperty(this, "surge", { get: function() { return this.fluctCont.position.x; }, set: function(value) { this.fluctCont.position.x = value; //this.shipState.motion.surge = value; } }); Object.defineProperty(this, "sway", { get: function() { return this.fluctCont.position.y; }, set: function(value) { this.fluctCont.position.y = value; //this.shipState.motion.sway = value; } }); Object.defineProperty(this, "heave", { get: function() { return this.fluctCont.position.z; }, set: function(value) { this.fluctCont.position.z = value; //this.shipState.motion.heave = value; } }); Object.defineProperty(this, "yaw", { get: function() { return this.fluctCont.rotation.z; }, set: function(value) { this.fluctCont.rotation.z = value; //this.shipState.motion.yaw = value; } }); Object.defineProperty(this, "pitch", { get: function() { return this.fluctCont.rotation.y; }, set: function(value) { this.fluctCont.rotation.y = value; //this.shipState.motion.pitch = value; } }); Object.defineProperty(this, "roll", { get: function() { return this.fluctCont.rotation.x; }, set: function(value) { this.fluctCont.rotation.x = value; //this.shipState.motion.roll = value; } }); this.objectOpacity = objectOpacity; this.ship = ship; this.shipState = shipState || ship.designState.clone(); let hull = ship.structure.hull; let LOA = hull.attributes.LOA; let BOA = hull.attributes.BOA; let Depth = hull.attributes.Depth; //console.log("LOA:%.1f, BOA:%.1f, Depth:%.1f",LOA,BOA,Depth); let { w: { cg, mass }, T, GMt, GMl } = ship.calculateStability(this.shipState); this.cmContainer.position.set(-cg.x, -cg.y, -cg.z); this.normalizer.position.z = cg.z; this.position.z = -T; let designDraft = ship.designState.calculationParameters.Draft_design; this.hull3D = new Hull3D(hull, designDraft); this.cmContainer.add(this.hull3D); //DEBUG, to show only hull: //return; let stations = hull.halfBreadths.stations; //Decks: var decks = new THREE.Group(); let deckMat = new THREE.MeshPhongMaterial({ color: 0xcccccc /*this.randomColor()*/, transparent: true, opacity: deckOpacity, side: THREE.DoubleSide }); //deckGeom.translate(0,0,-0.5); let ds = ship.structure.decks; //let dk = Object.keys(ds); let stss = stations.map(st => LOA * st); //use scaled stations for now //console.log(dk); //for (let i = 0; i < dk.length; i++) { for (let dk in ds) { //let d = ds[dk[i]]; //deck in ship structure let d = ds[dk]; //Will eventually use BoxBufferGeometry, but that is harder, because vertices are duplicated in the face planes. let deckGeom = new THREE.PlaneBufferGeometry(1, 1, stss.length, 1); //new THREE.BoxBufferGeometry(1,1,1,sts.length,1,1); //console.log("d.zFloor=%.1f", d.zFloor); //DEBUG let zHigh = d.zFloor; let zLow = d.zFloor - d.thickness; let wlHigh = hull.getWaterline(zHigh); let wlLow = hull.getWaterline(zLow); let pos = deckGeom.getAttribute("position"); let pa = pos.array; for (let j = 0; j < stss.length + 1; j++) { //This was totally wrong, and still would benefit from //not mapping directly to stations, as shorter decks will //Get zero-width sections let x = stss[j]; //d.xAft+(j/stss.length)*(d.xFwd-d.xAft); if (isNaN(x)) x = stss[j - 1]; x = Math.max(d.xAft, Math.min(d.xFwd, x)); let y1 = Vessel.f.linearFromArrays(stss, wlHigh, x); let y2 = Vessel.f.linearFromArrays(stss, wlLow, x); let y = Math.min(0.5 * d.breadth, y1, y2); pa[3 * j] = x; pa[3 * j + 1] = y; pa[3 * (stss.length + 1) + 3 * j] = x; pa[3 * (stss.length + 1) + 3 * j + 1] = -y; //test } pos.needsUpdate = true; //DEBUG //console.log("d.xFwd=%.1f, d.xAft=%.1f, 0.5*d.breadth=%.1f", d.xFwd, d.xAft, 0.5*d.breadth); //console.log(pa); let mat = deckMat; if (d.style) { mat = new THREE.MeshPhongMaterial({ color: typeof d.style.color !== "undefined" ? d.style.color : 0xcccccc, transparent: true, opacity: typeof d.style.opacity !== "undefined" ? d.style.opacity : deckOpacity, side: THREE.DoubleSide }); } let deck = new THREE.Mesh(deckGeom, mat); deck.name = dk; //[i]; // The try verification is used to verify if the group affiliation was inserted in the JSON structure, // the affiliation must be decided in the future if it will be incorporate into the main structure of the group // or if there is a better approach to classify it. // @ferrari212 try { deck.group = d.affiliations.group; } catch (error) { console.warn('Group tag were introduced to deck object'); console.warn(error); } deck.position.z = d.zFloor; //deck.scale.set(d.xFwd-d.xAft, d.breadth, d.thickness); //deck.position.set(0.5*(d.xFwd+d.xAft), 0, d.zFloor); decks.add(deck); } this.decks = decks; this.cmContainer.add(decks); //Bulkheads: var bulkheads = new THREE.Group(); // Individually trimmed geometries like the decks @ferrari212 let bhMat = new THREE.MeshPhongMaterial({ color: 0xcccccc /*this.randomColor()*/, transparent: true, opacity: deckOpacity, side: THREE.DoubleSide }); let bhs = ship.structure.bulkheads; let maxWl = Math.max(...hull.halfBreadths.waterlines) * Depth; //let bhk = Object.keys(bhs); //for (let i = 0; i < bhk.length; i++) { for (let bhk in bhs) { let bh = bhs[bhk]; //bhs[bhk[i]]; let mat = bhMat; let station = hull.getStation(bh.xAft); if (bh.style) { mat = new THREE.MeshPhongMaterial({ color: typeof bh.style.color !== "undefined" ? bh.style.color : 0xcccccc, transparent: true, opacity: typeof bh.style.opacity !== "undefined" ? bh.style.opacity : deckOpacity, side: THREE.DoubleSide }); } let bulkheadGeom = new THREE.PlaneBufferGeometry( maxWl, BOA, station.length - 1, 1 ); let pos = bulkheadGeom.getAttribute("position"); let pa = pos.array; for (let i = 0; i < station.length; i++) { // Check height in order to trim the bulkhead in the deck if (pa[3 * i] < Depth - maxWl / 2) { pa[3 * i + 1] = station[i]; pa[3 * station.length + 3 * i + 1] = -station[i]; } else { pa[3 * i + 1] = pa[3 * station.length + 3 * i + 1] = 0; } } pos.needsUpdate = true; let bulkhead = new THREE.Mesh(bulkheadGeom, mat); bulkhead.name = bhk; //[i]; // The try verification is used to verify if the group affiliation was inserted in the JSON structure, // the affiliation must be decided in the future if it will be incorporate into the main structure of the group // or if there is a better approach to classify it. // @ferrari212 try { bulkhead.group = bh.affiliations.group; } catch (error) { console.warn('Group tag were introduced to bulkhead object'); console.warn(error); } bulkhead.rotation.y = -Math.PI / 2; bulkhead.position.set(bh.xAft, 0, maxWl / 2); bulkheads.add(bulkhead); } this.bulkheads = bulkheads; this.cmContainer.add(bulkheads); //Objects this.materials = {}; this.stlPath = stlPath; let stlManager = new THREE.LoadingManager(); this.stlLoader = new THREE.STLLoader(stlManager); /*stlManager.onLoad = function() { createGUI(materials, deckMat); }*/ this.blocks = new THREE.Group(); this.cmContainer.add(this.blocks); //Default placeholder geometry this.boxGeom = new THREE.BoxBufferGeometry(1, 1, 1); this.boxGeom.translate(0, 0, 0.5); let objects = Object.values(ship.derivedObjects); for (let i = 0; i < objects.length; i++) { this.addObject(objects[i]); } //console.log("Reached end of Ship3D constructor."); } Ship3D.prototype = Object.create(THREE.Group.prototype); Object.assign(Ship3D.prototype, { constructor: Ship3D, addObject: function(object) { let mat; if ( typeof object.style.color !== "undefined" || typeof object.style.opacity !== "undefined" ) { let color = typeof object.style.color !== "undefined" ? object.style.color : this.randomColor(); let opacity = typeof object.style.opacity !== "undefined" ? object.style.opacity : this.objectOpacity; mat = new THREE.MeshPhongMaterial({ color, transparent: true, opacity }); } else { let name = this.stripName(object.id); if (this.materials[name] !== undefined) { mat = this.materials[name]; } else { mat = new THREE.MeshPhongMaterial({ color: this.randomColor(), transparent: true, opacity: this.objectOpacity }); this.materials[name] = mat; } } let bo = object.baseObject; //Position let s = this.ship.designState.getObjectState(object); let x = s.xCentre; let y = s.yCentre; let z = s.zBase; //Small position jitter to avoid z-fighting let n = 0.01 * (2 * Math.random() - 1); x += n; y += n; z += n; //Scale let d = bo.boxDimensions; if (bo.file3D) { let self = this; this.stlLoader.load( this.stlPath + "/" + bo.file3D, function onLoad(geometry) { //Normalize: geometry.computeBoundingBox(); let b = geometry.boundingBox; geometry.translate(-b.min.x, -b.min.y, -b.min.z); geometry.scale( 1 / (b.max.x - b.min.x), 1 / (b.max.y - b.min.y), 1 / (b.max.z - b.min.z) ); //Align with the same coordinate system as placeholder blocks: geometry.translate(-0.5, -0.5, 0); let m = new THREE.Mesh(geometry, mat); m.position.set(x, y, z); m.scale.set(d.length, d.breadth, d.height); m.name = object.id; m.group = bo.affiliations.group != undefined ? bo.affiliations.group : undefined; self.blocks.add(m); }, undefined, function onError() { console.warn( "Error loading STL file " + bo.file3D + ". Falling back on placeholder." ); let m = new THREE.Mesh(this.boxGeom, mat); m.position.set(x, y, z); m.scale.set(d.length, d.breadth, d.height); m.name = object.id; m.group = bo.affiliations.group != undefined ? bo.affiliations.group : undefined; this.blocks.add(m); } ); } else { //Placeholder: let m = new THREE.Mesh(this.boxGeom, mat); m.position.set(x, y, z); m.scale.set(d.length, d.breadth, d.height); m.name = object.id; m.group = bo.affiliations.group != undefined ? bo.affiliations.group : undefined; this.blocks.add(m); } }, //this function is used as a temporary hack to group similar objects by color stripName: function(s) { s = s.replace(/[0-9]/g, ""); s = s.trim(); return s; }, randomColor: function() { let r = Math.round(Math.random() * 0xff); let g = Math.round(Math.random() * 0xff); let b = Math.round(Math.random() * 0xff); return (r << 16) | (g << 8) | b; } }); //Class to contain the geometry of a hull side. //(Should perhaps be replaced by a HullGeometry class, but then //it cannot be a simple subclass of PlaneBufferGeometry.) //After instantiation, stations, waterlines and table can be modified or replaced, //but the data dimensions NxM must remain the same. function HullSideGeometry(stations, waterlines, table) { this.stations = stations; this.waterlines = waterlines; this.table = table; this.N = stations.length; this.M = waterlines.length; //Hull side, in principle Y offsets on an XZ plane: //Even though a plane geometry is usually defined in terms of Z offsets on an XY plane, the order of the coordinates for each vertex is not so important. What is important is to get the topology right. This is ensured by working with the right order of the vertices. THREE.PlaneBufferGeometry.call( this, undefined, undefined, this.N - 1, this.M - 1 ); this.update(); } HullSideGeometry.prototype = Object.create( THREE.PlaneBufferGeometry.prototype ); Object.assign(HullSideGeometry.prototype, { update: function() { let pos = this.getAttribute("position"); let pa = pos.array; const N = this.N; const M = this.M; //loop1: //zs let c = 0; //Iterate over waterlines for (let j = 0; j < M; j++) { //loop2: //xs //iterate over stations for (let i = 0; i < N; i++) { //if (table[j][i] === null) continue;// loop1; pa[c] = this.stations[i]; //x //DEBUG, OK. No attempts to read outside of table /*if(typeof table[j] === "undefined") console.error("table[%d] is undefined", j); else if (typeof table[j][i] === "undefined") console.error("table[%d][%d] is undefined", j, i);*/ //y pa[c + 1] = this.table[j][i]; //y pa[c + 2] = this.waterlines[j]; //z c += 3; } } //console.error("c-pa.length = %d", c-pa.length); //OK, sets all cells //Get rid of nulls by merging their points with the closest non-null point in the same station: /*I am joining some uvs too. Then an applied texture will be cropped, not distorted, where the hull is cropped.*/ let uv = this.getAttribute("uv"); let uva = uv.array; //Iterate over stations for (let i = 0; i < N; i++) { let firstNumberJ; let lastNumberJ; //Iterate over waterlines let j; for (j = 0; j < M; j++) { let y = this.table[j][i]; //If this condition is satisfied (number found), //the loop will be quitted //after the extra logic below: if (y !== null) { firstNumberJ = j; lastNumberJ = j; //copy vector for i,j to positions for all null cells below: let c = firstNumberJ * N + i; let x = pa[3 * c]; let y = pa[3 * c + 1]; let z = pa[3 * c + 2]; let d = c; while (firstNumberJ > 0) { firstNumberJ--; d -= N; pa[3 * d] = x; pa[3 * d + 1] = y; pa[3 * d + 2] = z; uva[2 * d] = uva[2 * c]; uva[2 * d + 1] = uva[2 * c + 1]; } break; } //console.log("null encountered."); } //Continue up the hull (with same j counter), searching for upper number. This does not account for the existence of numbers above the first null encountered. for (; j < M; j++) { let y = this.table[j][i]; if (y === null) { //console.log("null encountered."); break; } //else not null: lastNumberJ = j; } //copy vector for i,j to positions for all null cells above: let c = lastNumberJ * N + i; let x = pa[3 * c]; let y = pa[3 * c + 1]; let z = pa[3 * c + 2]; let d = c; while (lastNumberJ < M - 1) { lastNumberJ++; d += N; pa[3 * d] = x; pa[3 * d + 1] = y; pa[3 * d + 2] = z; uva[2 * d] = uva[2 * c]; uva[2 * d + 1] = uva[2 * c + 1]; } ////////// } //console.log(pa); pos.needsUpdate = true; uv.needsUpdate = true; this.computeVertexNormals(); } }); function Hull3D(hull, design_draft) { THREE.Group.call(this); this.hull = hull; this.group = "Hull3D"; this.design_draft = design_draft !== undefined ? design_draft : 0.5 * hull.attributes.Depth; this.upperColor = typeof hull.style.upperColor !== "undefined" ? hull.style.upperColor : 0x33aa33; this.lowerColor = typeof hull.style.lowerColor !== "undefined" ? hull.style.lowerColor : 0xaa3333; this.opacity = typeof hull.style.opacity !== "undefined" ? hull.style.opacity : 0.5; this.update(); } Hull3D.prototype = Object.create(THREE.Group.prototype); Object.assign(Hull3D.prototype, { //Experimental addition. Broken. addStation: function(p) { const hb = this.hull.halfBreadths; const { index, mu } = Vessel.f.bisectionSearch(hb.stations, p); hb.stations.splice(index, 0, p); for (let i = 0; i < hb.waterlines.length; i++) { hb.table[i].splice(index, 0, 0); } this.update(); }, //Experimental addition addWaterline: function(p) { const hb = this.hull.halfBreadths; const { index, mu } = Vessel.f.bisectionSearch(hb.waterlines, p); hb.waterlines.splice(index, 0, p); hb.table.splice(index, 0, new Array(hb.stations.length).fill(0)); this.update(); }, //or updateGeometries? update: function() { const hull = this.hull; const upperColor = this.upperColor; const lowerColor = this.lowerColor; const design_draft = this.design_draft; const opacity = this.opacity; let LOA = hull.attributes.LOA; let BOA = hull.attributes.BOA; let Depth = hull.attributes.Depth; //None of these are changed during correction of the geometry. let stations = hull.halfBreadths.stations; let waterlines = hull.halfBreadths.waterlines; let table = hull.halfBreadths.table; if (this.hGeom) this.hGeom.dispose(); this.hGeom = new HullSideGeometry(stations, waterlines, table); let N = stations.length; let M = waterlines.length; //Bow cap: let bowPlaneOffsets = hull.getStation(LOA).map(str => str / (0.5 * BOA)); //normalized if (this.bowCapG) this.bowCapG.dispose(); this.bowCapG = new THREE.PlaneBufferGeometry( undefined, undefined, 1, M - 1 ); let pos = this.bowCapG.getAttribute("position"); let pa = pos.array; //constant x-offset yz plane for (let j = 0; j < M; j++) { pa[3 * (2 * j)] = 1; pa[3 * (2 * j) + 1] = bowPlaneOffsets[j]; pa[3 * (2 * j) + 2] = waterlines[j]; pa[3 * (2 * j + 1)] = 1; pa[3 * (2 * j + 1) + 1] = -bowPlaneOffsets[j]; pa[3 * (2 * j + 1) + 2] = waterlines[j]; } pos.needsUpdate = true; //Aft cap: let aftPlaneOffsets = hull.getStation(0).map(str => str / (0.5 * BOA)); //normalized if (this.aftCapG) this.aftCapG.dispose(); this.aftCapG = new THREE.PlaneBufferGeometry( undefined, undefined, 1, M - 1 ); pos = this.aftCapG.getAttribute("position"); pa = pos.array; //constant x-offset yz plane for (let j = 0; j < M; j++) { pa[3 * (2 * j)] = 0; pa[3 * (2 * j) + 1] = -aftPlaneOffsets[j]; pa[3 * (2 * j) + 2] = waterlines[j]; pa[3 * (2 * j + 1)] = 0; pa[3 * (2 * j + 1) + 1] = aftPlaneOffsets[j]; pa[3 * (2 * j + 1) + 2] = waterlines[j]; } pos.needsUpdate = true; //Bottom cap: let bottomPlaneOffsets = hull.getWaterline(0).map(hw => hw / (0.5 * BOA)); //normalized if (this.bottomCapG) this.bottomCapG.dispose(); this.bottomCapG = new THREE.PlaneBufferGeometry( undefined, undefined, N - 1, 1 ); pos = this.bottomCapG.getAttribute("position"); pa = pos.array; //constant z-offset xy plane for (let i = 0; i < N; i++) { pa[3 * i] = stations[i]; pa[3 * i + 1] = -bottomPlaneOffsets[i]; pa[3 * i + 2] = 0; pa[3 * (N + i)] = stations[i]; pa[3 * (N + i) + 1] = bottomPlaneOffsets[i]; pa[3 * (N + i) + 2] = 0; } pos.needsUpdate = true; //Hull material if (!this.hMat) { let phong = THREE.ShaderLib.phong; let commonDecl = "uniform float wlThreshold;uniform vec3 aboveWL; uniform vec3 belowWL;\nvarying float vZ;"; this.hMat = new THREE.ShaderMaterial({ uniforms: THREE.UniformsUtils.merge([ phong.uniforms, { wlThreshold: new THREE.Uniform(0.5), aboveWL: new THREE.Uniform(new THREE.Color()), belowWL: new THREE.Uniform(new THREE.Color()) } ]), vertexShader: commonDecl + phong.vertexShader .replace("main() {", "main() {\nvZ = position.z;") .replace("#define PHONG", ""), fragmentShader: commonDecl + phong.fragmentShader .replace( "vec4 diffuseColor = vec4( diffuse, opacity );", "vec4 diffuseColor = vec4( (vZ>wlThreshold)? aboveWL.rgb : belowWL.rgb, opacity );" ) .replace("#define PHONG", ""), side: THREE.DoubleSide, lights: true, transparent: true }); } this.hMat.uniforms.wlThreshold.value = this.design_draft / Depth; this.hMat.uniforms.aboveWL.value = new THREE.Color(upperColor); this.hMat.uniforms.belowWL.value = new THREE.Color(lowerColor); this.hMat.uniforms.opacity.value = opacity; if (this.port) this.remove(this.port); this.port = new THREE.Mesh(this.hGeom, this.hMat); if (this.starboard) this.remove(this.starboard); this.starboard = new THREE.Mesh(this.hGeom, this.hMat); this.starboard.scale.y = -1; this.add(this.port, this.starboard); //Caps: if (this.bowCap) this.remove(this.bowCap); this.bowCap = new THREE.Mesh(this.bowCapG, this.hMat); if (this.aftCap) this.remove(this.aftCap); this.aftCap = new THREE.Mesh(this.aftCapG, this.hMat); if (this.bottomCap) this.remove(this.bottomCap); this.bottomCap = new THREE.Mesh(this.bottomCapG, this.hMat); this.add(this.bowCap, this.aftCap, this.bottomCap); this.scale.set(LOA, 0.5 * BOA, Depth); } }); return Ship3D; }36:[{"id":"ee03343d3cefa6d9679c0a2fcc917e436fb24c19b6c6d6ec2f5d01da2f12112c71771e5e4db882dd72cad016650a29ba992f8786bd5db576ca391fed86e1dbda","href":"https://static.observableusercontent.com/files/ee03343d3cefa6d9679c0a2fcc917e436fb24c19b6c6d6ec2f5d01da2f12112c71771e5e4db882dd72cad016650a29ba992f8786bd5db576ca391fed86e1dbda","name":"gunnerus.json","type":"application/json","lastModified":1643483275522.377,"size":51661}] 30:{"id":"9ebc01faf17c138f","slug":"section-3-2-gui-controller-interface-list","title":"Section 3.2 - GUI controller interface - Check Box List","thumbnail":"f619b2abd0444a71ea377caaa6ac372aa37eb460b138eedcddc207cf27ec2d6b","access_level":"public","create_time":"$D2020-08-01T09:45:38.536Z","update_time":"$D2022-01-29T19:08:05.093Z","view_time":null,"first_public_time":"$D2020-08-04T06:14:55.104Z","has_unpublished_edits":null,"fork":false,"stars":1,"starred":false,"owner":{"type":"team","id":"d87babdb83b49aab","login":"ferrari212","name":"Felipe Ferrari","avatar_url":"https://avatars-next.observableusercontent.com/9f46888d11f1719173b012c1de36ec52e2071ef6ff70202a1748014cd8f31bbd","tier":"starter_2024"},"version":487,"publish_version":487,"role":null,"authored":false,"authors":[{"type":"individual","id":"a379b02a7775e50b","login":"ferrari212","name":"Felipe Ferrari","avatar_url":"https://avatars-next.observableusercontent.com/9f46888d11f1719173b012c1de36ec52e2071ef6ff70202a1748014cd8f31bbd","tier":null}],"members":[{"type":"individual","id":"a379b02a7775e50b","login":"ferrari212","name":"Felipe Ferrari","avatar_url":"https://avatars-next.observableusercontent.com/9f46888d11f1719173b012c1de36ec52e2071ef6ff70202a1748014cd8f31bbd","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":2,"collection":{"id":"ce744f5722745fd3","slug":"from-hull-to-simulation","title":"From Concept to Simulation","owner":{"id":"d87babdb83b49aab","login":"ferrari212","name":"Felipe Ferrari"}},"type":"notebook","body":{"titling":"auto","title":"Section 3.2 - GUI controller interface - Check Box List","cells":[{"id":0,"value":"md`\n# Section 3.2 - GUI controller interface - Check Box List\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":36,"value":"$32","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":66,"value":"html`\n ${loaderPecentage |\n 0}% *loaded*`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":218,"value":"md`\nThe model above represents the final format developted in this section with the insertion of check box list that allows certains groups of elements being displayed or not. In this section, it will explained each step for creating a check box list which allows this interaction.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":362,"value":"$33","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":383,"value":"$34","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":457,"value":"md`\nOn each element was add the information about the group which is insert as exemplified bellow by the Deck A affiliation. This information helps to identify which elements must have its functionalities suppressed according to the user interaction.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":461,"value":"Gunnerus.structure.decks.Deck_A.affiliations.group","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":225,"value":"md`\n\n### Adjusting the GUI\n\nSimilar to [Section 3.1](https://observablehq.com/@ferrari212/section-3-1-gui-controller-interface), the first step is adding a new folder which the controller will be allocated by the function gui.addFolder(), notice this time the constants which holds the scale interfaces are different with scale_check_box for check box and scale_visualization for the visualization:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":249,"value":"scale_check_box = gui.addFolder(\"Check Box List\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":306,"value":"md`\nThe modelStyle must be modified in a way it comprehend the display of the boxes:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":204,"value":"modelStyle = {\n const modelStructure = {\n model: \"Ship3D\",\n displayOutline: true\n };\n\n return modelStructure;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":274,"value":"md`\n### Functions for Check Box List\n\nWhen the check box is setted to a specific subsystem the user must not be able to have whatever interaction with the elements in the other subgroup, therefore, the function must search in the scene for its childrens, changing its funcionability to prevent or allow the interactions.\n\nThis function must be recursive, because in principle the user are not aware how many childrens layers we have. The function gui.toggleElement() responsible for changing the functionalities can be formulate as following:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":285,"value":"function toggleElement(element, name) {\n if (element.children.lenght == 0) {\n return;\n }\n\n element.children.forEach(child => {\n if (child.group == name) {\n // Verify if it is visible trought the masks layers\n if (child.layers.mask) {\n child.layers.disable(0);\n } else {\n child.layers.enable(0);\n }\n }\n toggleElement(child, name);\n });\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":292,"value":"md`\nNow, we can insert the function in the GUI to verify the scene every time it is changed according to each affiliation group present in the JSON:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":295,"value":"{\n scale_check_box\n .add(modelStyle, \"displayOutline\")\n .onChange(newValue => {\n toggleElement(scene, \"Machinery\");\n })\n .name(\"Machinery\");\n\n scale_check_box\n .add(modelStyle, \"displayOutline\")\n .onChange(newValue => {\n toggleElement(scene, \"Tank\");\n })\n .name(\"Tank\");\n\n scale_check_box\n .add(modelStyle, \"displayOutline\")\n .onChange(newValue => {\n toggleElement(scene, \"Compartment\");\n })\n .name(\"Compartment\");\n\n scale_check_box\n .add(modelStyle, \"displayOutline\")\n .onChange(newValue => {\n toggleElement(scene, \"Deck\");\n })\n .name(\"Deck\");\n\n scale_check_box\n .add(modelStyle, \"displayOutline\")\n .onChange(newValue => {\n toggleElement(scene, \"Bulkheads\");\n })\n .name(\"Bulkheads\");\n\n scale_check_box.open();\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":343,"value":"md`\nThe switch function must also be modified to incorporate a change in scale_check_box.domElement.hidden because the blocks can only be verified if the blocks are shown to the user:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":209,"value":"function switchElement(stringModel) {\n scene.children.forEach(element => {\n var otherName = {\n ModelGLTF: \"Ship3D\",\n Ship3D: \"ModelGLTF\"\n };\n\n if (element.name == otherName[stringModel]) {\n scene.remove(element);\n }\n });\n\n // Switch function\n switch (stringModel) {\n case \"ModelGLTF\":\n scene.add(ModelGLTF);\n scale_check_box.domElement.hidden = true;\n break;\n\n case \"Ship3D\":\n scene.add(ship3D);\n scale_check_box.domElement.hidden = false;\n break;\n\n default:\n break;\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":475,"value":"md`\n

[<< Previous](https://observablehq.com/@ferrari212/section-3-1-gui-controller-interface?collection=@ferrari212/from-hull-to-simulation) || Top || [Next >>](https://observablehq.com/@ferrari212/chapter-4-simulations-and-analysis-principles-for-vessel-j?collection=@ferrari212/from-hull-to-simulation)

\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":142,"value":"ThreDModels = md`### 3D Models`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":482,"value":"Gunnerus = FileAttachment(\"gunnerus.json\").json()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":171,"value":"ship = new Vessel.Ship(Gunnerus)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":174,"value":"ship3D = {\n const ship3D = new Ship3D(ship, {\n shipState: ship.designState.clone(),\n stlPath:\n \"https://shiplab.github.io/vesseljs/examples/specs/STL%20files/Gunnerus\",\n upperColor: 0x33aa33,\n lowerColor: 0xaa3333,\n hullOpacity: 0.5,\n deckOpacity: 0.5,\n objectOpacity: 0.5\n });\n\n ship3D.name = \"Ship3D\";\n scene.add(ship3D);\n return ship3D;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":192,"value":"{\n const boatPath =\n \"https://ferrari212.github.io/vesseljs/examples/specs/GLTF_files/Gunnerus.glb\";\n\n const loaderGLTF = new THREE.GLTFLoader();\n\n loaderGLTF.load(\n boatPath,\n gltf => {\n var shipGLTF = gltf.scene;\n shipGLTF.rotation.x = Math.PI / 2;\n shipGLTF.rotation.y = -Math.PI / 2;\n shipGLTF.position.x = -1;\n shipGLTF.name = \"ModelGLTF\";\n\n if (shipGLTF.material) {\n shipGLTF.material.side = THREE.DoubleSide;\n }\n\n // scene.add(shipGLTF);\n mutable ModelGLTF = shipGLTF;\n },\n xhr => {\n mutable loaderPecentage = (xhr.loaded / 31780028) * 100;\n }\n );\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":196,"value":"mutable ModelGLTF = {\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":198,"value":"md`### GUI`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":201,"value":"scale_visualization = gui.addFolder(\"Visualization parameters\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":207,"value":"scale_visualization\n .add(modelStyle, \"model\", {\n Model: \"ModelGLTF\",\n Blocks: \"Ship3D\"\n })\n .onChange(newValue => {\n switchElement(newValue);\n })\n .name(\"View\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":211,"value":"scale_visualization.open()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":8,"value":"Snippets = md`### Snippets`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":70,"value":"styles = html`\n\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":11,"value":"mutable loaderPecentage = 0","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":13,"value":"scene = new THREE.Scene()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":30,"value":"$35","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":40,"value":"gui = {\n var gui = new dat.GUI();\n gui.domElement.id = 'gui';\n\n return gui;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":465,"value":"md`### Hierarchy Tree`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":386,"value":"diagonal = d3\n .linkHorizontal()\n .x(d => d.y)\n .y(d => d.x)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":388,"value":"tree2 = d3.tree().nodeSize([dx, dy])","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":391,"value":"root = d3.hierarchy({\n name: \"Ship\",\n children: [\n { name: \"Machinery\" },\n { name: \"Tank\" },\n { name: \"Compartments\" },\n {\n name: \"Structure\",\n children: [{ name: \"Deck\", value: 1 }, { name: \"Bulkhead\", value: 1 }]\n }\n ]\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":393,"value":"dx = 20","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":395,"value":"dy = width / 4","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":404,"value":"margin = ({ top: 10, right: 120, bottom: 10, left: 40 })","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":15,"value":"md`### Libraries`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"dat = require('dat.gui')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":19,"value":"THREE = {\n const THREE = (window.THREE = await require(\"three@0.99.0/build/three.min.js\"));\n await require(\"three@0.99.0/examples/js/controls/OrbitControls.js\").catch(\n () => {}\n );\n await require(\"three@0.99.0/examples/js/loaders/STLLoader.js\").catch(\n () => {}\n );\n await require(\"three@0.99.0/examples/js/loaders/GLTFLoader.js\").catch(\n () => {}\n );\n return THREE;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":24,"value":"Vessel = require('ntnu-vessel@0.1.1/vessel.js').catch(() => window[\"Vessel\"])","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":27,"value":"d3 = require(\"d3@5\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":372,"value":"md`### References\n\n**[1] NASA System Engineering Handbook ** – National Aeronautics and Space Adminstration, Washington, D.C.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W36","stdlib":"1"}} 31:"$30:body"