add doctring

skycatalogs/utils/star_parquet_input.py

@@ -28,6 +28,25 @@ def _index_files(self, input_dir):
             self._files[(imin, imax)] = item
 
     def find_files(self, pixel, nside=32, res_factor=16):
+        """
+        Find the UW input files that cover a given healpixel by sampling the
+        interior of the healpixel and computing the htm indexes at those
+        locations.
+
+        Parameters
+        ----------
+        pixel : int
+            Healpixel id.
+        nside : int
+            Resolution parameter of the healpixel map.
+        res_factor : int
+            Sampling factor of the healpix to ensure coverage of the healpixel
+            by the UW files.
+
+        Returns
+        -------
+        list : List of filenames.
+        """
         corners = np.transpose(healpy.boundaries(nside, pixel))
         subpixels = healpy.query_polygon(nside*res_factor, corners)
         ra, dec = [], []