summaryrefslogtreecommitdiff
path: root/gerber/operations.py
diff options
context:
space:
mode:
Diffstat (limited to 'gerber/operations.py')
-rw-r--r--gerber/operations.py126
1 files changed, 126 insertions, 0 deletions
diff --git a/gerber/operations.py b/gerber/operations.py
new file mode 100644
index 0000000..d06876e
--- /dev/null
+++ b/gerber/operations.py
@@ -0,0 +1,126 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# copyright 2015 Hamilton Kibbe <ham@hamiltonkib.be>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+# http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+CAM File Operations
+===================
+**Transformations and other operations performed on Gerber and Excellon files**
+
+"""
+import copy
+
+
+def to_inch(cam_file):
+ """ Convert Gerber or Excellon file units to imperial
+
+ Parameters
+ ----------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ Gerber or Excellon file to convert
+
+ Returns
+ -------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ A deep copy of the source file with units converted to imperial.
+ """
+ cam_file = copy.deepcopy(cam_file)
+ cam_file.to_inch()
+ return cam_file
+
+
+def to_metric(cam_file):
+ """ Convert Gerber or Excellon file units to metric
+
+ Parameters
+ ----------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ Gerber or Excellon file to convert
+
+ Returns
+ -------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ A deep copy of the source file with units converted to metric.
+ """
+ cam_file = copy.deepcopy(cam_file)
+ cam_file.to_metric()
+ return cam_file
+
+
+def offset(cam_file, x_offset, y_offset):
+ """ Offset a Cam file by a specified amount in the X and Y directions.
+
+ Parameters
+ ----------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ Gerber or Excellon file to offset
+
+ x_offset : float
+ Amount to offset the file in the X direction
+
+ y_offset : float
+ Amount to offset the file in the Y direction
+
+ Returns
+ -------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ An offset deep copy of the source file.
+ """
+ cam_file = copy.deepcopy(cam_file)
+ cam_file.offset(x_offset, y_offset)
+ return cam_file
+
+
+def scale(cam_file, x_scale, y_scale):
+ """ Scale a Cam file by a specified amount in the X and Y directions.
+
+ Parameters
+ ----------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ Gerber or Excellon file to scale
+
+ x_scale : float
+ X-axis scale factor
+
+ y_scale : float
+ Y-axis scale factor
+
+ Returns
+ -------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ An scaled deep copy of the source file.
+ """
+ # TODO
+ pass
+
+
+def rotate(cam_file, angle):
+ """ Rotate a Cam file a specified amount about the origin.
+
+ Parameters
+ ----------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ Gerber or Excellon file to rotate
+
+ angle : float
+ Angle to rotate the file in degrees.
+
+ Returns
+ -------
+ cam_file : :class:`gerber.cam.CamFile` subclass
+ An rotated deep copy of the source file.
+ """
+ # TODO
+ pass