User Manual
User Manual: Pdf
Open the PDF directly: View PDF .
Page Count: 36
Download | |
Open PDF In Browser | View PDF |
Last Update: January 13, 2018 Last Release: Download Here ShipConstructor Community Tools Contents About ShipConstructor Community Tools .................................................................................................... 3 Disclosure of Risks and Liabilities.................................................................................................................. 3 Liability Waiver.............................................................................................................................................. 3 Ways for You to Contribute .......................................................................................................................... 4 Technical Summary ....................................................................................................................................... 5 Installation Procedure................................................................................................................................... 5 Step 1: Install the VBA Module for AutoCAD ............................................................................................ 5 Step 2: Install Microsoft Excel 2010 or Later Version ............................................................................... 6 Step 3: Download and Unzip the Archive with ShipConstructor Community Tools ................................. 6 Step 4: Add *.dvb and *.lsp Files to AutoCAD Startup Suite .................................................................... 6 Step 5: Load User Interface from the Partial Customization File ............................................................. 7 Custom Commands for AutoCAD .................................................................................................................. 9 General Commands .................................................................................................................................. 9 Import UCS List (CTIMPORTUCSLIST) .................................................................................................... 9 Rename UCS List (CTRENAMEUCSLIST) ................................................................................................. 9 Structure Commands .............................................................................................................................. 10 Lightening Hole (CTLIGHTHOLE) ......................................................................................................... 10 Production Commands ........................................................................................................................... 19 Highlight Orphaned Labels (CTLABELHIGHLIGHTORPHANED) ............................................................ 19 Group MarineDrafting Objects (CTMDGROUPOBJECTS) .................................................................... 20 Analysis Commands ................................................................................................................................ 22 Space Bomb (CTSPACEBOMB) ............................................................................................................ 22 Excel Tools................................................................................................................................................... 27 Linear Weight Distributions (CTWeightCalculations.xlsm) ..................................................................... 27 2|Page About ShipConstructor Community Tools ShipConstructor Community Tools (the Tools) is an open-source not-for-profit initiative entirely driven by individual enthusiasts (the Creators) and owned by the Community as a whole. As a legal entity, ShipConstructor Software Inc. (SSI) has no ties with this project. The sole purpose behind ShipConstructor Community Tools is to let people play, experiment and create in a safe environment that promotes innovation, welcomes idea exploration, quick prototyping, collaboration and knowledge sharing. All software code and other materials originating under the Tools are automatically licensed under an open-source licensing agreement according to which the copyright holder provides the rights to study, change, and distribute the product to anyone and for any purpose, including possible commercial and non-commercial uses. All rights are granted free of charge and free of any conditions. For more information on licensing, please refer to the license file included with each release. Disclosure of Risks and Liabilities ShipConstructor Community Tools are created by enthusiasts of unknown qualifications. All tools should be treated as prototypes of highly-experimental nature. Use of Community Tools may irreversibly damage your files. Use of Community Tools may irreversibly corrupt your ShipConstructor project database. Use of Community Tools may lead to other negative consequences resulting in financial losses. Everything is made available “as is” with no guarantee of correctness, future maintenance, continued support or anything at all. Liability Waiver By using ShipConstructor Community Tools, you confirm: That you fully understood inherent dangers and risks; That you use the Tools at your own risk while assuming the full responsibility for your actions; That you free the Creators from all liability for any damages or losses resulting from using ShipConstructor Community Tools; That you waive your right to initiate a legal action against the Creators. You also agree to not hold ShipConstructor Software Inc. (SSI) liable for any negative consequences resulting from use of ShipConstructor Community Tools. 3|Page Ways for You to Contribute There are several possible ways for you to contribute to the development of ShipConstructor Community Tools. If you possess sufficient programming skills, you are very welcome to request access to the GitHub project and write your own extensions for the Community Tools. If you are not a software developer, but a shipbuilding specialist or an engineer we will be happy to listen to your feedback and ideas on developing new tools and improving existing ones. The location for the open-source project: https://github.com/ichudakov/SCCommTools 4|Page Technical Summary ShipConstructor Community Tools are comprised of the following: AutoCAD scripts written in LISP and VBA; AutoCAD partial customization file (*.cuix) that provides some AutoCAD interface; Macro-enabled Excel documents; and General documentation. Presently, the source code behind Community Tools commands does not rely on a direct data exchange with the ShipConstructor project database, and the ShipConstructor API is not used either. As much as possible, all features are designed to rely on native AutoCAD commands and Microsoft Excel functionality alone. The current philosophy behind ShipConstructor Community Tools is to only automate those operations that the user can, theoretically, perform themselves manually inside an AutoCAD drawing or an Excel workbook. This approach is to ensure an additional degree of safety and minimize risks of seriously corrupting your ShipConstructor project. Please note, however, that the above approach is still not a 100% guarantee of safety. Unforeseen issues and unintended software behaviours may still occur. Installation Procedure The installation instructions for ShipConstructor Community Tools are fairly simple, but they may vary depending on your work environment. The detailed instructions in this section are written for individual users who would like to install ShipConstructor Community Tools on their local workstations. In case you are a CAD administrator who organizes work of multiple users, your instructions may be slightly different. There will be some ideas and recommendations shared along the way that you may find helpful. Note that most of the installation steps will only need to be repeated once. Performing a subsequent update of ShipConstructor Community Tools may be as simple as replacing a few files and restarting AutoCAD. Step 1: Install the VBA Module for AutoCAD Install the VBA Module for AutoCAD that is consistent with your current AutoCAD version. Note that each version of AutoCAD requires its own VBA module. The Module can be downloaded at the following link: https://knowledge.autodesk.com/support/autocad/downloads/caas/downloads/content/downloadthe-microsoft-visual-basic-for-applications-module-vba.html 5|Page Step 2: Install Microsoft Excel 2010 or Later Version If you plan on using Community Tools for calculating ship weight distributions you will need to have Microsoft Excel 2010, or later version, installed on your computer. Additionally, it is also recommended that you bring up Microsoft Excel security settings and allow running of VBA macros for macro-enabled workbooks. Step 3: Download and Unzip the Archive with ShipConstructor Community Tools Download the latest version of the ShipConstructor Community Tools archive from its network location. The download link is available on the cover page of this document at the very top. Unzip the files to a folder that will become a permanent location. Note that the folder does not have to be local. If you are a CAD administrator who is organizing the environment for multiple users, you may deploy the Tools to a shared centralized location. This will significantly simplify future updates procedure. Step 4: Add *.dvb and *.lsp Files to AutoCAD Startup Suite Start your AutoCAD. Type APPLOAD in the AutoCAD command line. Under Startup Suite, click Contents… Navigate to the folder where you unzipped the files. 6|Page Add the two files, SCCommTools.dvb and SCCommTools.lsp, to the AutoCAD Startup Suite: Apply all changes. Adding the files to the Startup Suite should immediately load them into your current AutoCAD session. Also, if you restart the application, AutoCAD will be automatically loading these files in the future. Step 5: Load User Interface from the Partial Customization File Type the CUI command in the AutoCAD command line. Select Partial Customization Files in the tree in the upper half of the dialog. 7|Page Right click the selection, and choose Load partial customization file: Navigate to the SCCommTools.cuix file. Click OK to close the dialog. You should notice the new SC Community Tools ribbon tab, menu and toolbar: 8|Page Custom Commands for AutoCAD General Commands Import UCS List (CTIMPORTUCSLIST) The CTIMPORTUCSLIST command imports all User Coordinate Systems (UCS) from an external *.dwg file into the current drawing. If a similarly named UCS already exists in the current drawing, the import for that UCS will be skipped. Rename UCS List (CTRENAMEUCSLIST) The CTRENAMEUCSLIST command does batch-renaming for UCS that reside in the current drawing. Caution should be exercised when using this command as it might significantly change names of multiple UCSs. Restoring the names back to their original state may not be easy. To perform the renaming: Run the CTRENAMEUCSLIST command; Enter the sequence of characters to be replaced in each UCS’s name; Enter a new sequence of characters with which to replace the previous sequence; Complete the operation. 9|Page Structure Commands Lightening Hole (CTLIGHTHOLE) The CTLIGHTHOLE command produces reference geometry such as rounded rectangles represented by closed AutoCAD polylines that can be used for creating some types of lightening holes. The command can be configured to place its output on the _Draft_Cut layer, or any other layer of choice. To create an actual lightening hole, the SCADDOBJECTTOSTRUCTPART command will need to run on the reference geometry. Parameters Lightening holes are created based on realistic engineering principles dealing with structural strength and integrity. Most the control parameters are defined relative to the surrounding structure. Where applicable and as applicable, the definitions are consistent with common Lloyd's and ABS rules. The actual values for the parameters can be adjusted by the user to meet the specific requirements for a particular type of vessel. For example, smaller lightening holes may be preferred for navy vessels while large ones may be more suitable for racing yachts. 10 | P a g e Sample Workflow There are several possible ways to use the Lightening Hole command. As one quick example of using the functionality: Locate a structural web in your drawing and identify its depth and available spacing. Run the CTLIGHTHOLE command. Select the Draw option: 11 | P a g e Select two points on the opposite edges of the web to draw the first reference line measuring the web depth. Note that the reference line does not need to be ideally vertical: Select the next two points to draw the second reference lines to indicate the spacing available. Note that the reference line does not need to be ideally horizontal: Ensure that the Alignment parameter is set to UCS. This will guarantee that the hole is rotated consistently with the current UCS’s axes directions. 12 | P a g e Notice that you can change the Alignment at any time if necessary, but don’t do it now: Choose Options and review other parameters controlling the geometry. Notice the Output Layer for the resulting polyline: Click OK to close the Options dialog. Use Generate to create the closed polyline representing the lightening hole: 13 | P a g e Delete the reference lines unless you need to keep them for some reason: Once the operation is complete, the final result may appear as follows: 14 | P a g e If you dimension the final output, you may be able to see the following: o The hole is positioned in the middle of the structural web and centered relative to the available spacing; o The hole is oriented parallel to the axes of the current UCS; o The hole depth is the percentage of the total web depth specified in the command options; o The hole length equals to the lesser of the two: 1) the web depth, or 2) the percentage of the spacing distance set in the command options; and o The corner radius for the hole is a percentage of the hole depth as per command options. Note that the radius can be increased up to 50% to make the hole even more rounded. Other Ways to Use the Command In the previous example, we drew the two reference lines measuring the web and spacing distance. Sometimes, you may have such lines created ahead of time. If this happens to be the case, you can simply select the lines either before or after running the SCLIGHTHOLE command. 15 | P a g e Note that Web Depth line needs to be selected first and then, the spacing line: The Alignment parameter can be changed so that the hole is aligned relative to the web-depth line instead of the current UCS: 16 | P a g e This option can be handy when placing lightening holes at an angle: Finally, multiple lightening holes can be created in a batch operation. All you need to do is to select multiple pairs of reference lines as an input to the command. Remember that for each pair of lines, the web depth line needs to be selected first: 17 | P a g e After all pairs of reference lines are selected in the correct order, running Generate will produce multiple polylines: 18 | P a g e Production Commands Highlight Orphaned Labels (CTLABELHIGHLIGHTORPHANED) The command highlights all “orphaned” labels that have lost their association with the original BOM table on the current layout. Such labels may happen as a result of the user copying (CTRL+C) and pasting (CTRL+V) labels in a production drawing, which is not a recommended ShipConstructor workflow for labels. The danger of having orphaned labels in your drawing is that they don’t update properly and can be easily mistaken for legitimate labels: 19 | P a g e Group MarineDrafting Objects (CTMDGROUPOBJECTS) This command is for application inside MarineDrafting views containing 2D representations of the 3D model. The command joins isolated bits and pieces of the MarineDrafting geometry into AutoCAD Groups. Currently, there are two options that control the consolidating behaviour: Forming AutoCAD Groups by Part – all bits and pieces of the geometry that belong to the same part become one AutoCAD Group; Forming AutoCAD Groups by Part and Layer – all bits and pieces of the geometry that belong to the same part and reside on the same layer become one AutoCAD group. The benefit of having related 2D geometry consolidated into groups is that it makes performing certain operations much faster and easier. For example, if you decide to delete an entire part from the 2D view, you can do it in one step by deleting the AutoCAD group that joins all bits and pieces of the geometry for that part together. There will be no need to click every single bit of geometry one by one to remove the part. The same applies when you need to remove invisible portions of a part from the drawing. In this case, you can apply grouping by part and by layer and then, simply delete all groups that consolidate geometry on invisible layers. To use the command: Open a MarineDrafting drawing. Run CTMDGROUPOBJECTS. Select all or some MarineDrafting views. If you are selecting some of the views only, please ensure that you click on any geometric object inside that view. Choose the method for grouping objects: Complete the command. Note that after the command has finished, all items affected by the grouping command will be become modified elements in terms of MarineDrafting. There will be some changes in the update behavior for the affected parts. Also all affected geometry will be copied to the invisible SCMD Original layer. More information on the behaviour of modified parts in MarineDrafting views is available from the ShipConstructor product manual. 20 | P a g e To release all groups in the drawing: Run the CTMDGROUPOBJECTS command. Select More… Choose Reset All Groups in Drawing. All groups in all MarineDrafting views will be released. 21 | P a g e Analysis Commands Space Bomb (CTSPACEBOMB) The Space Bomb command calculates the volume of empty space inside an enclosed area. It only works with AutoCAD 3D solids and is only capable of processing one enclosed area at a time. The recommended workflow for using this command is as follows: Create a non-model ShipConstructor drawing where assemble all parts comprising an enclosed area for which an internal volume needs to be estimated. An Output drawing would be a convenient drawing type to use for this purpose: Explode all parts into native 3D solids. Note that because you are not working in the model drawing, this action parts will not affect anything in your project 3D model. If some parts in your 3D model have small holes or cutouts, model additional solids to completely seal off all access to the inner space of the enclosed area, especially from the side faces: Note that for the correct operation of the command is it very important that all openings located on side faces of the 3D model are covered. 22 | P a g e The only holes and cutouts that are not required to be covered are the ones located on the Top and Bottom faces of the enclosed space as long as these holes are planar and parallel to the XY plane in WCS. If in doubt, it will be best to close off the 3D model from all sides. The extra covers can be modeled on separate layers. If you like watching the progress of how the enclosed space gets filled by the Space Bomb command, you can turn off the layer visibility for the extra covers, or anything that obstructs the view: As a final check before running the command, ensure that the drawing Visual Style is set to something that performs fast. The recommended styles are Wireframe or Shaded. You can also turn off all of the fancy graphics settings in AutoCAD display options and set the VIEWRES variable to 1,000, or something close. Do not disable hardware acceleration: 23 | P a g e Run the CTSPACEBOMB command. Modify the parameters as needed: Note that you can manually control the Step Size used by the Space Bomb algorithm, or let the command set the value automatically. 24 | P a g e The smaller step size will cause longer processing times, but the accuracy will be higher. If accuracy is important, it will better to provide the value manually. The auto-step option will determine the step automatically relative to the vertical size of the 3D model. This option is not geared for precision, but it is good for quick estimates. Click the Run button and let the process complete. Depending on the size of the 3D model the processing time may take anywhere from a few seconds to a few hours: The command has its limitations and you should be using common sense when applying it. Trying to run it on the entire bilge area of a large ship may not be such a great idea. It may be better to subdivide it into a few sections. Note that if you realize that the process is likely to take more time than you initially anticipated, you can abort the operation at any moment and restart it with a larger step, perhaps. Once the operation is complete, you will see the Results window. The results will show volumes for empty spaces discovered inside the enclosed 3D model you provided: 25 | P a g e Use the results window to copy and paste the data to anywhere you like. If you accidentally close the results window, you should still be able to retrieve the same details from the AutoCAD command line history, but you may need to scroll the output up. The last option for retrieving the data is that the resulting 3D solids that fills up the empty spaces will remain in your drawing until you delete them. You can select any solid and run MASSPROP on it to get the volume. Note that presence of large solids may slow down your drawing significantly, though. One more thing to mention about the results is that you may notice that volumes in the result records are broken down into “levels”. For a simple 3D model, you should only expect one level of volumes; however, for spaces where nested watertight enclosures are present, there may be more than one level of volumes. For example, there may be watertight a compartment that has a watertight tank inside it with some watertight tubing inside the watertight tank. In this case, you will get three levels for empty spaces: Level 1 - the volume inside the compartment, minus the tank. Level 2 - the volume inside the tank, minus the tubing. Level 3 - the volume inside the tubing. There will also be a sum of all volumes provided in the results. In the end of the day, it will be up to you how to interpret these figures as the tool wouldn’t know. Also, when interpreting the results keep in mind that levels are also identified while looking inwards. 26 | P a g e Excel Tools Linear Weight Distributions (CTWeightCalculations.xlsm) The CTWeightCalculations.xlsm macro-enabled Excel document included with ShipConstructor Community Tools allows you to quickly produce linear weight distributions for your ship along the longitudinal, transverse or vertical directions. Recommended Workflow The recommended workflow for using the tool as follows: For all parts that participate in the weight model, extract your initial data from ShipConstructor or other sources and save it inside a separate Excel file. It does not matter as much what tools you use, or how exactly you create the source document. What matters most, however, is the presence of the required set of ten columns inside the spreadsheet. For each, part that participate in the weight model you must provide the following columns: o Weight o Longitudinal Coordinate for Center of Gravity (LCG) o Transverse Coordinate for Center of Gravity (LCG) o Vertical Coordinate for Center of Gravity (LCG) o Longitudinal Coordinate for Minimum Extent o Transverse Coordinate for Minimum Extent o Vertical Coordinate for Minimum Extent o Longitudinal Coordinate for Maximum Extent o Transverse Coordinate for Maximum Extent o Vertical Coordinate for Maximum Extent 27 | P a g e For example, the below illustration shows an Excel spreadsheet generated with PublisherLT that contains all of the required data, plus some additional columns: Note that the same document could have been produced with the help of ShipConstructor Reports, a direct Microsoft Excel query into the ShipConstructor database or by filling out each piece of data manually. Also note that your ShipConstructor project database may not be the only available source of information. Some data may be added from your ERP system or other Excel documents. Generally speaking, it does not matter where the information is coming from as long as you can provide the minimum required set of parameters for each part. When developing your source Excel spreadsheet with weight data, note that the Weight attribute can mean different things. For instance, it can be the dry weight, wet weight, fluid weight, total weight or some other weight. The important part is to keep all weight information consistent across items in the dataset. Besides the key set of required columns, some additional attributes you may include into your source spreadsheet can be any descriptive properties such as Part Name, Stock Name, Stock Description and more. The benefit of having this additional information inside the spreadsheet is that it helps you to search for and recognize individual parts in the dataset. The source data you provide may be stored on multiple sheets inside a single Microsoft Excel document, or it can be broken down into several Excel workbooks. When working with multiple spreadsheets, it is important to keep names of all columns identical across all sheets and workbooks you supply. Please, make sure that the text recorded in the very top cell of each column is the same for all columns containing similar type of data. Note that the exact wording you may use in column headers is not that important. It is the consistency that matters. For instance, you can choose to name your Weight column such as 28 | P a g e “Weight”, “Weight (kg)”, “W.” or something else. As long as that text does not change across similar columns located on different spreadsheets, the tool will work. Also note that locations of individual columns inside your source spreadsheets are not important either. The Weight column may appear in the first position inside one table and the third position in another. It is the column headers that carry the primary importance. CTWeightCalculations.xlsm will rely on the headers to search for the right data on each sheet. After your source data sheet(s) is compiled, open the CTWeightCalculations.xlsm in Microsoft Excel. Ensure that macros are enabled. In later versions of Microsoft Excel, the macro settings can be located under: File > Options > Trust Center > Trust Center Settings > Macro Settings. Go to the custom CT WEIGHT tab on the ribbon and click the Headers button: You will see the complete list of columns that the CTWeightCalculations.xlsm will attempt to import from your source documents. The columns are listed in the same order in which they should appear at the destination location after the data is transferred. 29 | P a g e You can adjust and rename the headers as required. Basically, you specify which column to search for and transfer from your source location, and how to name these columns after moving the data to your destination location, which is CTWeightCalculations.xlsm. You can see it as a column mapping procedure: Besides setting up the headers, you can also change the relative order in which columns should appear in your destination document, CTWeightCalculations.xlsm. One requirement, however, is that the relative order in which columns appear inside CTWeightCalculations.xlsm should be set prior to importing your first set of data into this document. Finally, you can also add and remove some columns as need be. The only columns you cannot remove are the required attributes. After all headers and columns are set up, close the Headers List dialog. 30 | P a g e Click the Import button located next to the Headers button. Navigate to your source Excel file and select the specific sheet from which the data is to be transferred. Indicate where to put this data inside CTWeightCalculations.xlsm: Click the Import button to continue. The information will be transferred from your source spreadsheet to CTWeightCalculations.xlsm. 31 | P a g e You can think of it as a refined sub-selection from your source dataset. The spreadsheet at the destination location will only contain columns that you requested in the headers list: You can repeat the Import operation as many times as necessary while bringing in more datasets and placing them on separate sheets inside CTWeightCalculations.xlsm. One practical reason for why you may need to import several datasets and store them on separate sheets may be that you are looking to generate different weight curves for Structure, Equipment, Piping and other sections of the ship. You can organize worksheets so that each tab contains parts of one discipline only: Overall, there may be many different reasons for working with a few isolated datasets. 32 | P a g e In some cases, it might be beneficial to add certain sheets manually to CTWeightCalculations.xlsm. For example, you may be looking to enter manual corrections for your weights model to account for parts not represented in ShipConstructor. Or you may be looking to explore various scenarios such as loaded vs. unloaded ship. When creating sheets manually inside CTWeightCalculations.xlsm, please ensure that you arrange columns in the correct order as specified in the Headers List dialog. Once all “refined datasets” are inside CTWeightCalculations.xlsm, click the Distribution button located on the ribbon: 33 | P a g e In the Weight Distribution dialog, set the desired parameters for the distribution: Note that you can pick and choose which individual sheets to factor into the calculation. You may choose to combine all tables into one or treat them as separate datasets. There is an option to include an extra column with Total Weight showing the sum of all weights across all datasets. You can change the distribution direction from Longitudinal to Transverse or Vertical. Finally, there is a number of options to assist you with placing station points along the distribution. 34 | P a g e After you click the Calculate button, a separate unsaved Excel document will be created showing containing the distribution. The new workbook will have two sheets: one with the chart and one with the underlying data: Method for Calculating Weight Distribution Curves According to the calculation method used by CTWeightCalculations.xlsm, each weight distribution curve and its associated data represents a linear weight density function along the chosen direction. For each station point, the function tells you the weight for the section of the ship locked in between the current station point and the next one. The data is presented in absolute units corresponding to the specific length of the interval set between the station points. The figures are not converted into standard units such as tonnes per meter of length. Note that longer intervals will generally result in higher weights per section because the length of each section increases. It is important to mention that all weight-distribution calculations are not precise. All figures are approximate. For each individual part, the tool is only capable of making its best guess about the weight contribution by a given part at a particular section of the ship. All of the approximations are derived from a very limited information about the part such as its weight, geometric extents and the center of gravity location. The way the weight density function is calculated for the individual part along the distribution direction is explained in the illustration below: 35 | P a g e Each part is subdivided at its center of gravity (CG) into two portions assigned with 50% of weight. Then, the 50% of the weight are averaged for each portion of the part between the closest extent and the CG location. For non-uniform parts with an asymmetric center of gravity, their individual weight density function will appear as a step function as shown by the blue line in the illustration above. By knowing the linear weight density function for each individual part and the overlap between the part and the current section of the ship, necessary calculations are made to measure the contribution of that part into the section weight. Ability to Fix Some Parts The weight-distribution calculation algorithm has the capacity to fix individual parts with the center of gravity location that is apparently incorrect. To provide some background on this subject: in ShipConstructor, it is the responsibility of the user to indicate the correct CG location for some part types such as Equipment. Due to the human factor, sometimes, the CG location for Equipment parts may not be specified accurately. There may be other part times similar to equipment in this regard. If the algorithm identifies a part with the CG lying completely outside of the part’s extents, or directly on one of the faces, the algorithm automatically reposition the CG point so that it lies exactly in the middle of the part. The weight of the part will be averaged along its length defined by extents. 36 | P a g e
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : No Page Count : 36 Language : en-CA Tagged PDF : Yes Author : Ilya Chudakov Creator : Microsoft® Word 2013 Create Date : 2018:01:13 21:53:23-08:00 Modify Date : 2018:01:13 21:53:23-08:00 Producer : Microsoft® Word 2013EXIF Metadata provided by EXIF.tools