update

Readme.md

@@ -19,7 +19,7 @@ To know how to assemble/print this mask, see the [_section on mask assembly and
 
 It is recommanded to apply grease (_prefere food safe vaseline_) arround thread, arround the insuflation mask connector and arround the perimeter of the one way valve to improve the seal.
 
-If you are using a 3D printed (_or DIY_) filter (_as described in [the section bellow](#1-b-filtering-canister)_), change regularly the filtering material - in general activated charcoal - and clean the enclosure if youdon't change it.
+If you are using a 3D printed (_or DIY_) filter (_as described in [the section bellow](#1-b-filter-canister)_), change regularly the filter material - in general activated charcoal - and clean the enclosure if you don't change it.
 
 In general do a fitment check before using the mask : put a piece of plastic (_or your hand_) at the entrance of the filter you are using, and breath in hard. You shouldn't fill air entering you lungs, and the mask should compress to you face under the suction force.
 
@@ -31,7 +31,7 @@ The downside of this method are that firstly these mask tend to deteriorate over
 
 For a mask that directly fit on the face, see the [_section on the older version_](#4-older-version).
 
-### 1.b - Filtering canister
+### 1.b - Filter canister
 
 This mask supports standard 40mm threaded canisters - sometimes also known as "_nato threaded_" canisters - which the standard dimensions are defined in [sources/dimension/nato_thread_spec.png](./sources/dimension/nato_thread_spec.png).
 
@@ -40,7 +40,7 @@ This mask can support two separate canisters, which can be advantageous if you n
 We also provide a 3D printed canister following this standard and compatible with this mask and other standard gaz mask in the [distorsion/3D-printed-parametric-respiratory-one-way-valve](https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-40mm-gaz-mask-canister) repository, which is a submodule of this repository located at [./3D-printed-parametric-respiratory-one-way-valve](./).
 :warning: **WARNING : _Please don't use a 3D printed canister (or even our mask) in life threatening situations !_** :warning: Or at least understand the inner working of gaz mask and test your gaz mask (_especialy its fittment to your face_) before using it.
 
-There is also an older version of such a canister modeled within the file of the [_old gaz mask version_](#4-b-_older-version-_-filtering-canister).
+There is also an older version of such a canister modeled within the file of the [_old gaz mask version_](#4-b-_older-versiosn-_-filter-canister).
 
 There also exist 3D printed adapter from this standard to other standard gaz mask connector if you search on 3D printing site.
 
@@ -85,19 +85,61 @@ You can finally screw a canister or plug to each of the two thread, and you have
 
 ## 3 - Explanation of parameters
 
-_Coming soon !_
+If you want to changes the parameters of this design, you can edit the _Freecad_ file [3Dfiles/gaz_mask_v8.FCStd](./3Dfiles/), which is fully parametric, with parameters present in the **Spreadsheet**.
+
+Parameters are color coded, as is explained in the begining of the **Spreadsheet**.
+
+If you want/need to change parameters, we would suggest you play with them and try to understand the impact of each parameters. We will only explain a small selection of important parameters that you are most likely to have to edit.
+
+If you need to change multiple parametrs, you can right click on the name of the file in freecad "_gaz_mask_v8_" then enable "_skip recompute_" so that you can change every parameters without recomputes, and the re-enable recomputes and right-click on the "_adapter_tube_" body and click "_recompute_".
+
+### 3.a - Structural parameters
+
+_**wall_thickness** :_ \[_default=2.7mm_\] The wall thickness accross the print (_except for the strap attachment point_). Can be tweeked to make the print either stronger or weaker but lighter and faster to print.
+
+_**snap_fit_clearance** :_ \[_default=0.09mm_\] The clearance between two objects that would fit togeteher with difficulty. Also impact the clearance betwen threads.
+
+### 3.b - Geometrical parameters
+
+_**nt_horizontal_angle** and **nt_vertical_angle** :_ \[_default=20° and 30°_\] The former is the horizontal angle away from the two arms of the adapter tube being perfectly parallel, havig such an angle is usefull to bring the center of mass clother to your face. The latter is similarly the vertical angle of the arms of the adapter tube, which is used to lower the center of mass so the adapter tube doesn't want to rotate around the connector of the insuflation mask under the weight of the filter canister. 
+
+### 3.c - Insuflation mask parameters
+
+The mask diameter is standard to 22mm (set yt _**imc_max_outer_diameter**_).
+
+-**imc_length** :_ \[_default=20mm_\] Length of the connector of the insuflation mask. Can be adapted to your specific mask.
+
+### 3.d - Strap holder parameters
+
+_**sh_thickness** :_ \[_default=4mm_\] Thickness of the strap holder. Can be adapted to your material and printing orientation so that you are confident that the strap holder won't break off when wearig the mask.
+
+_**sh_bottom_angle** and **sh_top_angle**:_ \[_default=60° and 25°_\] The former is the horizontal angle between the strap holders at the bottom of the adapter tube, and the latter is the angle of the top strap holders around the arm of the adatper tube.
+
+_**sh_strap_width** and **sh_strap_hole_width**:_ \[_default=15mm and 3mm_\] Width and passage width of the strap holder. Should be adatper to the elastic strap you are using.
+
+### 3.e - One-way valve
+
+Most of the parameters of the one-way valve are described in the readme of the associated repository : [distorsion/3D-printed-parametric-respiratory-one-way-valve](https://git.deuxfleurs.fr/distorsion/3D-printed-parametric-respiratory-one-way-valve).
+
+However we want to describe two parameters, as they are menionned here regarding the input one-way valve and the possibility of having a filter on the exit of the output one-way valve :
+
+_**has_input_owv_1_yes_0_no** :_ \[_default=0_\] If set to **1** rather than **0**, will add the requiered length to screw an input one-way valve.
+
+_**has_output_cover_owv_1_yes_0_no** :_ \[_default=0_\] If set to **1** rather than **0**, will add the requiered length to screw a cap to hold a filter at the exit of the output one-way valve.
 
 ## 4 - Older version
 
-The older version of the mask can be made either to work with standard 40mm cartrdige (as the newer version), or an integrated canister which makes it more confortable to use.
+The older version of the mask - _which was the 5th version_ - can be made either to work with standard 40mm cartrdige (as the newer version), or an integrated canister which makes it more confortable to use.
 
 As this version is not the main supported version, we will not go into detail into explanation, and we will foccus on differences with the latest version.
 
+We didn't put in the directory the _.stl_ files for this version as it would have to be tweeked t be used anyway. You can edit the _Freecad_ file located at [3Dfiles/older_version/gas_mask_v6.FCStd](./3Dfiles/older_version/) and export bodies to _.stl_ to print them.
+
 ### 4.a - _Older version :_ Interfacing with the face
 
 _Coming soon !_
 
-### 4.b - _Older version :_ Filtering canister
+### 4.b - _Older version :_ Filter canister
 
 _Coming soon !_