{"action":"created","comment":{"url":"https://api.github.com/repos/apache/spark/pulls/comments/39433068","id":39433068,"diff_hunk":"@@ -0,0 +1,89 @@\n+/*\n+ * Licensed to the Apache Software Foundation (ASF) under one or more\n+ * contributor license agreements.  See the NOTICE file distributed with\n+ * this work for additional information regarding copyright ownership.\n+ * The ASF licenses this file to You under the Apache License, Version 2.0\n+ * (the \"License\"); you may not use this file except in compliance with\n+ * the License.  You may obtain a copy of the License at\n+ *\n+ *    http://www.apache.org/licenses/LICENSE-2.0\n+ *\n+ * Unless required by applicable law or agreed to in writing, software\n+ * distributed under the License is distributed on an \"AS IS\" BASIS,\n+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n+ * See the License for the specific language governing permissions and\n+ * limitations under the License.\n+ */\n+\n+\n+/**\n+ * Feature transformers\n+ *\n+ * The `ml.feature` package provides common feature transformers that help convert raw data or\n+ * features into more suitable forms for model fitting.\n+ * Most feature transformers are implemented as {@link org.apache.spark.ml.Transformer}}s, which\n+ * transforms one {@link org.apache.spark.sql.DataFrame} into another, e.g.,\n+ * {@link org.apache.spark.feature.HashingTF}.\n+ * Some feature transformers are implemented as {@link org.apache.spark.ml.Estimator}}s, because the\n+ * transformation requires some aggregated information of the dataset, e.g., document\n+ * frequencies in {@link org.apache.spark.ml.feature.IDF}.\n+ * For those feature transformers, calling {@link org.apache.spark.ml.Estimator#fit} is required to\n+ * obtain the model first, e.g., {@link org.apache.spark.ml.feature.IDFModel}, in order to apply\n+ * transformation.\n+ * The transformation is usually done by appending new columns to the input\n+ * {@link org.apache.spark.sql.DataFrame}, so all input columns are carried over.\n+ *\n+ * We try to make each transformer minimal, so it becomes flexible to assemble feature\n+ * transformation pipelines.\n+ * {@link org.apache.spark.ml.Pipeline} can be used to chain feature transformers, and\n+ * {@link org.apache.spark.ml.feature.VectorAssembler} can be used to combine multiple feature\n+ * transformations, for example:\n+ *\n+ * <code>\n+ *   import org.apache.spark.ml.feature.*\n+ *   import org.apache.spark.ml.Pipeline\n+ *\n+ *   // a DataFrame with three columns: id (integer), text (string), and rating (double).\n+ *   DataFrame df = sqlContext.createDataFrame(Arrays.asList(\n+ *     RowFactor.create(0, \"Hi I heard about Spark\", 3.0),\n+ *     RowFactor.create(1, \"I wish Java could use case classes\", 4.0),\n+ *     RowFactor.create(2, \"Logistic regression models are neat\", 4.0)\n+ *   )).toDF(\"id\", \"text\", \"rating\")\n+ *\n+ *   // define feature transformers\n+ *   RegexTokenizer tok = new RegexTokenizer()\n+ *     .setInputCol(\"text\")\n+ *     .setOutputCol(\"words\")\n+ *   StopWordsRemover sw = new StopWordsRemover()\n+ *     .setInputCol(\"words\")\n+ *     .setOutputCol(\"filtered_words\")\n+ *   HashingTF tf = new HashingTF()\n+ *     .setInputCol(\"filtered_words\")\n+ *     .setOutputCol(\"tf\")\n+ *     .setNumFeatures(10000)\n+ *   IDF idf = new IDF()\n+ *     .setInputCol(\"tf\")\n+ *     .setOutputCol(\"tf_idf\")\n+ *   VectorAssembler assembler = new VectorAssembler()\n+ *     .setInputCols(Array(\"tf_idf\", \"rating\"))","path":"mllib/src/main/scala/org/apache/spark/ml/feature/package-info.java","position":68,"original_position":68,"commit_id":"ff9485664ab6c10f915d7a94392e6d2dc71593ed","original_commit_id":"ff9485664ab6c10f915d7a94392e6d2dc71593ed","user":{"login":"mengxr","id":829644,"avatar_url":"https://avatars.githubusercontent.com/u/829644?v=3","gravatar_id":"","url":"https://api.github.com/users/mengxr","html_url":"https://github.com/mengxr","followers_url":"https://api.github.com/users/mengxr/followers","following_url":"https://api.github.com/users/mengxr/following{/other_user}","gists_url":"https://api.github.com/users/mengxr/gists{/gist_id}","starred_url":"https://api.github.com/users/mengxr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mengxr/subscriptions","organizations_url":"https://api.github.com/users/mengxr/orgs","repos_url":"https://api.github.com/users/mengxr/repos","events_url":"https://api.github.com/users/mengxr/events{/privacy}","received_events_url":"https://api.github.com/users/mengxr/received_events","type":"User","site_admin":false},"body":"`Array` is not Java code","created_at":"2015-09-14T19:02:50Z","updated_at":"2015-09-14T19:02:50Z","html_url":"https://github.com/apache/spark/pull/8740#discussion_r39433068","pull_request_url":"https://api.github.com/repos/apache/spark/pulls/8740","_links":{"self":{"href":"https://api.github.com/repos/apache/spark/pulls/comments/39433068"},"html":{"href":"https://github.com/apache/spark/pull/8740#discussion_r39433068"},"pull_request":{"href":"https://api.github.com/repos/apache/spark/pulls/8740"}}},"pull_request":{"url":"https://api.github.com/repos/apache/spark/pulls/8740","id":44895675,"html_url":"https://github.com/apache/spark/pull/8740","diff_url":"https://github.com/apache/spark/pull/8740.diff","patch_url":"https://github.com/apache/spark/pull/8740.patch","issue_url":"https://api.github.com/repos/apache/spark/issues/8740","number":8740,"state":"open","locked":false,"title":"[SPARK-10077][DOCS][STREAMING] Add package info for java of ml/feature","user":{"login":"holdenk","id":59893,"avatar_url":"https://avatars.githubusercontent.com/u/59893?v=3","gravatar_id":"","url":"https://api.github.com/users/holdenk","html_url":"https://github.com/holdenk","followers_url":"https://api.github.com/users/holdenk/followers","following_url":"https://api.github.com/users/holdenk/following{/other_user}","gists_url":"https://api.github.com/users/holdenk/gists{/gist_id}","starred_url":"https://api.github.com/users/holdenk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/holdenk/subscriptions","organizations_url":"https://api.github.com/users/holdenk/orgs","repos_url":"https://api.github.com/users/holdenk/repos","events_url":"https://api.github.com/users/holdenk/events{/privacy}","received_events_url":"https://api.github.com/users/holdenk/received_events","type":"User","site_admin":false},"body":"Should be the same as SPARK-7808 but use Java for the code example.\r\nIt would be great to add package doc for `spark.ml.feature`.","created_at":"2015-09-14T06:07:05Z","updated_at":"2015-09-14T19:02:50Z","closed_at":null,"merged_at":null,"merge_commit_sha":"6f856c1d3624d5da6e96b5ab52f58ad25505dffa","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/apache/spark/pulls/8740/commits","review_comments_url":"https://api.github.com/repos/apache/spark/pulls/8740/comments","review_comment_url":"https://api.github.com/repos/apache/spark/pulls/comments{/number}","comments_url":"https://api.github.com/repos/apache/spark/issues/8740/comments","statuses_url":"https://api.github.com/repos/apache/spark/statuses/ff9485664ab6c10f915d7a94392e6d2dc71593ed","head":{"label":"holdenk:SPARK-10077-JAVA-PACKAGE-DOC-FOR-SPARK.ML.FEATURE","ref":"SPARK-10077-JAVA-PACKAGE-DOC-FOR-SPARK.ML.FEATURE","sha":"ff9485664ab6c10f915d7a94392e6d2dc71593ed","user":{"login":"holdenk","id":59893,"avatar_url":"https://avatars.githubusercontent.com/u/59893?v=3","gravatar_id":"","url":"https://api.github.com/users/holdenk","html_url":"https://github.com/holdenk","followers_url":"https://api.github.com/users/holdenk/followers","following_url":"https://api.github.com/users/holdenk/following{/other_user}","gists_url":"https://api.github.com/users/holdenk/gists{/gist_id}","starred_url":"https://api.github.com/users/holdenk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/holdenk/subscriptions","organizations_url":"https://api.github.com/users/holdenk/orgs","repos_url":"https://api.github.com/users/holdenk/repos","events_url":"https://api.github.com/users/holdenk/events{/privacy}","received_events_url":"https://api.github.com/users/holdenk/received_events","type":"User","site_admin":false},"repo":{"id":17235154,"name":"spark","full_name":"holdenk/spark","owner":{"login":"holdenk","id":59893,"avatar_url":"https://avatars.githubusercontent.com/u/59893?v=3","gravatar_id":"","url":"https://api.github.com/users/holdenk","html_url":"https://github.com/holdenk","followers_url":"https://api.github.com/users/holdenk/followers","following_url":"https://api.github.com/users/holdenk/following{/other_user}","gists_url":"https://api.github.com/users/holdenk/gists{/gist_id}","starred_url":"https://api.github.com/users/holdenk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/holdenk/subscriptions","organizations_url":"https://api.github.com/users/holdenk/orgs","repos_url":"https://api.github.com/users/holdenk/repos","events_url":"https://api.github.com/users/holdenk/events{/privacy}","received_events_url":"https://api.github.com/users/holdenk/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/holdenk/spark","description":"Mirror of Apache Spark","fork":true,"url":"https://api.github.com/repos/holdenk/spark","forks_url":"https://api.github.com/repos/holdenk/spark/forks","keys_url":"https://api.github.com/repos/holdenk/spark/keys{/key_id}","collaborators_url":"https://api.github.com/repos/holdenk/spark/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/holdenk/spark/teams","hooks_url":"https://api.github.com/repos/holdenk/spark/hooks","issue_events_url":"https://api.github.com/repos/holdenk/spark/issues/events{/number}","events_url":"https://api.github.com/repos/holdenk/spark/events","assignees_url":"https://api.github.com/repos/holdenk/spark/assignees{/user}","branches_url":"https://api.github.com/repos/holdenk/spark/branches{/branch}","tags_url":"https://api.github.com/repos/holdenk/spark/tags","blobs_url":"https://api.github.com/repos/holdenk/spark/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/holdenk/spark/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/holdenk/spark/git/refs{/sha}","trees_url":"https://api.github.com/repos/holdenk/spark/git/trees{/sha}","statuses_url":"https://api.github.com/repos/holdenk/spark/statuses/{sha}","languages_url":"https://api.github.com/repos/holdenk/spark/languages","stargazers_url":"https://api.github.com/repos/holdenk/spark/stargazers","contributors_url":"https://api.github.com/repos/holdenk/spark/contributors","subscribers_url":"https://api.github.com/repos/holdenk/spark/subscribers","subscription_url":"https://api.github.com/repos/holdenk/spark/subscription","commits_url":"https://api.github.com/repos/holdenk/spark/commits{/sha}","git_commits_url":"https://api.github.com/repos/holdenk/spark/git/commits{/sha}","comments_url":"https://api.github.com/repos/holdenk/spark/comments{/number}","issue_comment_url":"https://api.github.com/repos/holdenk/spark/issues/comments{/number}","contents_url":"https://api.github.com/repos/holdenk/spark/contents/{+path}","compare_url":"https://api.github.com/repos/holdenk/spark/compare/{base}...{head}","merges_url":"https://api.github.com/repos/holdenk/spark/merges","archive_url":"https://api.github.com/repos/holdenk/spark/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/holdenk/spark/downloads","issues_url":"https://api.github.com/repos/holdenk/spark/issues{/number}","pulls_url":"https://api.github.com/repos/holdenk/spark/pulls{/number}","milestones_url":"https://api.github.com/repos/holdenk/spark/milestones{/number}","notifications_url":"https://api.github.com/repos/holdenk/spark/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/holdenk/spark/labels{/name}","releases_url":"https://api.github.com/repos/holdenk/spark/releases{/id}","created_at":"2014-02-27T03:28:28Z","updated_at":"2015-05-05T13:19:34Z","pushed_at":"2015-09-14T05:50:38Z","git_url":"git://github.com/holdenk/spark.git","ssh_url":"git@github.com:holdenk/spark.git","clone_url":"https://github.com/holdenk/spark.git","svn_url":"https://github.com/holdenk/spark","homepage":null,"size":123398,"stargazers_count":2,"watchers_count":2,"language":"Scala","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":2,"default_branch":"master"}},"base":{"label":"apache:master","ref":"master","sha":"1dc614b874badde0eee60def46fb47f608bc4759","user":{"login":"apache","id":47359,"avatar_url":"https://avatars.githubusercontent.com/u/47359?v=3","gravatar_id":"","url":"https://api.github.com/users/apache","html_url":"https://github.com/apache","followers_url":"https://api.github.com/users/apache/followers","following_url":"https://api.github.com/users/apache/following{/other_user}","gists_url":"https://api.github.com/users/apache/gists{/gist_id}","starred_url":"https://api.github.com/users/apache/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apache/subscriptions","organizations_url":"https://api.github.com/users/apache/orgs","repos_url":"https://api.github.com/users/apache/repos","events_url":"https://api.github.com/users/apache/events{/privacy}","received_events_url":"https://api.github.com/users/apache/received_events","type":"Organization","site_admin":false},"repo":{"id":17165658,"name":"spark","full_name":"apache/spark","owner":{"login":"apache","id":47359,"avatar_url":"https://avatars.githubusercontent.com/u/47359?v=3","gravatar_id":"","url":"https://api.github.com/users/apache","html_url":"https://github.com/apache","followers_url":"https://api.github.com/users/apache/followers","following_url":"https://api.github.com/users/apache/following{/other_user}","gists_url":"https://api.github.com/users/apache/gists{/gist_id}","starred_url":"https://api.github.com/users/apache/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apache/subscriptions","organizations_url":"https://api.github.com/users/apache/orgs","repos_url":"https://api.github.com/users/apache/repos","events_url":"https://api.github.com/users/apache/events{/privacy}","received_events_url":"https://api.github.com/users/apache/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/apache/spark","description":"Mirror of Apache Spark","fork":false,"url":"https://api.github.com/repos/apache/spark","forks_url":"https://api.github.com/repos/apache/spark/forks","keys_url":"https://api.github.com/repos/apache/spark/keys{/key_id}","collaborators_url":"https://api.github.com/repos/apache/spark/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/apache/spark/teams","hooks_url":"https://api.github.com/repos/apache/spark/hooks","issue_events_url":"https://api.github.com/repos/apache/spark/issues/events{/number}","events_url":"https://api.github.com/repos/apache/spark/events","assignees_url":"https://api.github.com/repos/apache/spark/assignees{/user}","branches_url":"https://api.github.com/repos/apache/spark/branches{/branch}","tags_url":"https://api.github.com/repos/apache/spark/tags","blobs_url":"https://api.github.com/repos/apache/spark/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/apache/spark/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/apache/spark/git/refs{/sha}","trees_url":"https://api.github.com/repos/apache/spark/git/trees{/sha}","statuses_url":"https://api.github.com/repos/apache/spark/statuses/{sha}","languages_url":"https://api.github.com/repos/apache/spark/languages","stargazers_url":"https://api.github.com/repos/apache/spark/stargazers","contributors_url":"https://api.github.com/repos/apache/spark/contributors","subscribers_url":"https://api.github.com/repos/apache/spark/subscribers","subscription_url":"https://api.github.com/repos/apache/spark/subscription","commits_url":"https://api.github.com/repos/apache/spark/commits{/sha}","git_commits_url":"https://api.github.com/repos/apache/spark/git/commits{/sha}","comments_url":"https://api.github.com/repos/apache/spark/comments{/number}","issue_comment_url":"https://api.github.com/repos/apache/spark/issues/comments{/number}","contents_url":"https://api.github.com/repos/apache/spark/contents/{+path}","compare_url":"https://api.github.com/repos/apache/spark/compare/{base}...{head}","merges_url":"https://api.github.com/repos/apache/spark/merges","archive_url":"https://api.github.com/repos/apache/spark/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/apache/spark/downloads","issues_url":"https://api.github.com/repos/apache/spark/issues{/number}","pulls_url":"https://api.github.com/repos/apache/spark/pulls{/number}","milestones_url":"https://api.github.com/repos/apache/spark/milestones{/number}","notifications_url":"https://api.github.com/repos/apache/spark/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/apache/spark/labels{/name}","releases_url":"https://api.github.com/repos/apache/spark/releases{/id}","created_at":"2014-02-25T08:00:08Z","updated_at":"2015-09-14T14:06:19Z","pushed_at":"2015-09-14T18:58:47Z","git_url":"git://github.com/apache/spark.git","ssh_url":"git@github.com:apache/spark.git","clone_url":"https://github.com/apache/spark.git","svn_url":"https://github.com/apache/spark","homepage":null,"size":1622381,"stargazers_count":5417,"watchers_count":5417,"language":"Scala","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":4993,"mirror_url":"git://git.apache.org/spark.git","open_issues_count":362,"forks":4993,"open_issues":362,"watchers":5417,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/apache/spark/pulls/8740"},"html":{"href":"https://github.com/apache/spark/pull/8740"},"issue":{"href":"https://api.github.com/repos/apache/spark/issues/8740"},"comments":{"href":"https://api.github.com/repos/apache/spark/issues/8740/comments"},"review_comments":{"href":"https://api.github.com/repos/apache/spark/pulls/8740/comments"},"review_comment":{"href":"https://api.github.com/repos/apache/spark/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/apache/spark/pulls/8740/commits"},"statuses":{"href":"https://api.github.com/repos/apache/spark/statuses/ff9485664ab6c10f915d7a94392e6d2dc71593ed"}}}}