"
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "visualize_fit(t, xs, ys, xes, yes, x_model, y_model, xe_model, ye_model, mm.name, t_test)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "f7ae3e7f",
+ "metadata": {},
+ "source": [
+ "## 1.3. Example: Parallax Model Fit"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "08eceab5",
+ "metadata": {},
+ "source": [
+ "Parallax model requires some fixed parameters: `ra`, `dec`, `pa`, `obsLocation`, and `t0`.\n",
+ "- `ra` and `dec` are required parameters. \n",
+ "- `pa = 0` by default\n",
+ "- `obsLocation = 'earth'` by default\n",
+ "- `t0 = np.average(t, 1./np.hypot(xe, ye))` by default\n",
+ "\n",
+ "We need to provide the fixed parameters in the `fixed_params_dict`:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 18,
+ "id": "018fc13a",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 1 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 2 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 2 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 1 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"taiutc\" yielded 1 of \"dubious year (Note 4)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n"
+ ]
+ }
+ ],
+ "source": [
+ "mm = Parallax()\n",
+ "fixed_params_dict = {'ra': 0., 'dec': 10., 'pa': 0., 'obsLocation': 'earth'}\n",
+ "params, param_errs = mm.fit(t, x, y, xe, ye, fixed_params_dict)"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 19,
+ "id": "73dafb1f",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 20 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 40 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 40 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 20 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/home/weilingfeng/Software/miniconda3/envs/main/lib/python3.12/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"taiutc\" yielded 20 of \"dubious year (Note 4)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n"
+ ]
+ },
+ {
+ "data": {
+ "image/png": "iVBORw0KGgoAAAANSUhEUgAAA9wAAAHqCAYAAAD27EaEAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjMsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvZiW1igAAAAlwSFlzAAAPYQAAD2EBqD+naQAA71tJREFUeJzs3XeYXGXZ+PHvmV62991kWzpJSIBAYqgJICEg1UJTigIWUAEV5WcBFMXyivTwvioEFAQRCagUCYTQAumkJ5vtvcxO7zPn/P7YZMmStpud2Znd3J/rmuvKnDlzzj07m33OfZ7nuR9F0zQNIYQQQgghhBBCJJQu1QEIIYQQQgghhBBjkSTcQgghhBBCCCFEEkjCLYQQQgghhBBCJIEk3EIIIYQQQgghRBJIwi2EEEIIIYQQQiSBJNxCCCGEEEIIIUQSSMIthBBCCCGEEEIkgSTcQgghhBBCCCFEEkjCLYQQQgghhBBCJIEk3EIMUVVVFddee23/87fffhtFUXj77bdTFtNIW7p0KYqi0NDQkOpQRsxdd92FoihH9N5rr72WqqqqlMYghBBC2nCQNnyopA0XwyUJt0hrexuFvQ+LxcKUKVO4+eab6ezsTHV4KbXvz+a9997b73VN0ygvL0dRFD73uc8d0Tl+9atfsWzZsmFGmlhVVVUoisLZZ599wNf/+Mc/9v9c1q5dO8LRDc+CBQsG/L7v+9ixY8cB35OO35EQQoC04Ycibbi04ZCe35FIPEOqAxBiMH7+859TXV1NKBTivffeY8mSJbzyyits2bIFm82W6vBSymKx8Mwzz3DqqacO2L5y5UpaWlowm81HfOxf/epXfOELX+Diiy8esP0rX/kKl19++bCOPRwWi4UVK1bQ0dFBSUnJgNeefvppLBYLoVAoJbEN1/jx47n33nv3215WVsZPfvITfvSjHw3YfrDvSAgh0oW04Qcnbbi04dKGj32ScItRYfHixZx44okAXH/99eTn53Pffffx0ksvccUVVxzxcVVVJRKJYLFYEhXqiDvvvPN4/vnnefDBBzEYPvkv/cwzzzBnzhx6enoSfk69Xo9er0/4cQfrlFNOYc2aNTz33HN897vf7d/e0tLCu+++yyWXXMILL7yQsviGIzs7my9/+csHfX3f71gIIUYDacMPTtpwacPF2CdDysWodOaZZwJQX18PwP/8z/9w8sknk5+fj9VqZc6cOfzjH//Y732KonDzzTfz9NNPM2PGDMxmM6+99tqQjjEY7777Ll/84hepqKjAbDZTXl7OrbfeSjAY7N+nq6uLwsJCFixYgKZp/dt3796N3W7nsssuG9S5rrjiChwOB2+88Ub/tkgkwj/+8Q+uvPLKA77H7/fzve99j/LycsxmM1OnTuV//ud/BsShKAp+v58nn3yyf0jU3nlvB5v/9eijj/b/XMvKyrjppptwuVwD9lmwYAEzZ85k27ZtLFy4EJvNxrhx4/jtb387qM8LfXfHL730Up555pkB2//2t7+Rm5vLokWLDvi+t956i9NOOw273U5OTg4XXXQR27dv32+/9957j5NOOgmLxcLEiRP53//934PG8te//pU5c+ZgtVrJy8vj8ssvp7m5edCfZSg+Pf/rUN+REEKkK2nDPyFt+CekDZc2fKyShFuMSrW1tQDk5+cD8MADD3D88cfz85//nF/96lcYDAa++MUv8p///Ge/97711lvceuutXHbZZTzwwAP9hTCGcozDef755wkEAnzzm9/koYceYtGiRTz00ENcffXV/fsUFRWxZMkSVq5cyUMPPQT03a2/9tpryczM5NFHHx3Uuaqqqpg/fz5/+9vf+re9+uqruN1uLr/88v321zSNCy+8kD/84Q+ce+653HfffUydOpUf/OAH3Hbbbf37/eUvf8FsNnPaaafxl7/8hb/85S98/etfP2gcd911FzfddBNlZWX8/ve/5/Of/zz/+7//yznnnEM0Gh2wr9Pp5Nxzz2X27Nn8/ve/Z9q0afzwhz/k1VdfHdRnBrjyyitZvXp1/+8C9PUIfOELX8BoNO63//Lly1m0aBFdXV3cdddd3HbbbXzwwQeccsopAy46Nm/ezDnnnNO/33XXXcedd97Jiy++uN8xf/nLX3L11VczefJk7rvvPm655RbefPNNTj/99P0uUgYrHo/T09Mz4OHz+Q6471C/IyGESAfShn9C2nBpw6UNPwpoQqSxJ554QgO05cuXa93d3Vpzc7P27LPPavn5+ZrVatVaWlo0TdO0QCAw4H2RSESbOXOmduaZZw7YDmg6nU7bunXrfuca7DEqKyu1a665pv/5ihUrNEBbsWLFQY+laZp27733aoqiaI2NjQO2X3HFFZrNZtN27dql/e53v9MAbdmyZQf/oeyx92ezZs0a7eGHH9YyMzP7z/vFL35RW7hwYX+8559/fv/7li1bpgHaPffcM+B4X/jCFzRFUbTdu3f3b7Pb7QM+66fPXV9fr2mapnV1dWkmk0k755xztHg83r/fww8/rAHa448/3r/tjDPO0ADtqaee6t8WDoe1kpIS7fOf//xhP/fezxOLxbSSkhLtF7/4haZpmrZt2zYN0FauXDngZ7PXcccdpxUVFWkOh6N/28cff6zpdDrt6quv7t928cUXaxaLZcD3tG3bNk2v12v7/slsaGjQ9Hq99stf/nJAfJs3b9YMBsOA7ddcc41WWVl52M+292fz6cfe7+DOO+/UPv1n+2DfkRBCpJq04Qcnbbi04ZombfjRQnq4xahw9tlnU1hYSHl5OZdffjkZGRm8+OKLjBs3DgCr1dq/r9PpxO12c9ppp7F+/fr9jnXGGWcwffr0/bYP5RiHs++x/H4/PT09nHzyyWiaxoYNGwbs+/DDD5Odnc0XvvAFfvrTn/KVr3yFiy66aEjn+9KXvkQwGOTf//43Xq+Xf//73wcdivbKK6+g1+v5zne+M2D79773PTRNG9Id6r2WL19OJBLhlltuQaf75M/KDTfcQFZW1n49DBkZGQPmOJlMJubOnUtdXd2gz6nX6/nSl77U3yvw9NNPU15ezmmnnbbfvu3t7WzcuJFrr72WvLy8/u2zZs3is5/9LK+88grQd2f69ddf5+KLL6aioqJ/v2OOOWa/IW7//Oc/UVWVL33pSwPuZJeUlDB58mRWrFgx6M+yr6qqKt54440Bj9tvv/2IjiWEEOlA2vBDkzZc2nAxtsnMfTEqPPLII0yZMgWDwUBxcTFTp04d0Cj8+9//5p577mHjxo2Ew+H+7Qda77C6uvqA5xjKMQ6nqamJn/3sZ7z88ss4nc4Br7nd7gHP8/LyePDBB/niF79IcXExDz744JDPV1hYyNlnn80zzzxDIBAgHo/zhS984YD7NjY2UlZWRmZm5oDtxxxzTP/rQ7X3PVOnTh2w3WQyMWHChP2OOX78+P1+rrm5uWzatGlI573yyit58MEH+fjjj3nmmWe4/PLLD/h9HSw+6Pvcr7/+On6/H6/XSzAYZPLkyfvtN3Xq1P5GHaCmpgZN0w64L3DAIXGDYbfbD7pcihBCjEbShh+atOHShouxTRJuMSrMnTu3v8Lpp7377rtceOGFnH766Tz66KOUlpZiNBp54okn9ivIAQPvXB/pMQ4lHo/z2c9+lt7eXn74wx8ybdo07HY7ra2tXHvttaiqut97Xn/9daDvrnxLSws5OTlDOif0NVw33HADHR0dLF68+IiOMVIOVh1V26fgy2DMmzePiRMncsstt1BfX3/QHoFkUFUVRVF49dVXD/h5MjIyRiwWIYRIZ9KGH5604dKGi7FLEm4x6r3wwgtYLBZef/31AWtKPvHEEyN6jL02b97Mrl27ePLJJwcUWNm3Aum+XnvtNf70pz9x++238/TTT3PNNdfw0UcfDXnpiEsuuYSvf/3rfPjhhzz33HMH3a+yspLly5fj9XoH3CHfsWNH/+t7DbZnYO97du7cyYQJE/q3RyIR6uvrk3q394orruCee+7hmGOO4bjjjjtsfJ+2Y8cOCgoKsNvtWCwWrFYrNTU1++336fdOnDgRTdOorq5mypQpw/8gR+hIem+EECJdSBveR9pwacPF2CVzuMWop9frURSFeDzev62hoYFly5aN6DH2PRYMvNOraRoPPPDAfvu6XC6uv/565s6dy69+9Sv+9Kc/sX79en71q18N+bwZGRksWbKEu+66iwsuuOCg+5133nnE43EefvjhAdv/8Ic/oCgKixcv7t9mt9sHVanz7LPPxmQy8eCDDw743H/+859xu92cf/75Q/48g3X99ddz55138vvf//6g+5SWlnLcccfx5JNPDvg8W7Zs4b///S/nnXce0PfdLVq0iGXLltHU1NS/3/bt2/t7MPa69NJL0ev13H333fvd1dc0DYfDkYBPd3iD/Y6EECIdSRveR9pwacPF2CU93GLUO//887nvvvs499xzufLKK+nq6uKRRx5h0qRJg55PlIhj7DVt2jQmTpzI97//fVpbW8nKyuKFF17Ybx4YwHe/+10cDgfLly9Hr9dz7rnncv3113PPPfdw0UUXMXv27CGd+5prrjnsPhdccAELFy7kxz/+MQ0NDcyePZv//ve/vPTSS9xyyy1MnDixf985c+awfPly7rvvPsrKyqiurmbevHn7HbOwsJA77riDu+++m3PPPZcLL7yQnTt38uijj3LSSScNKK6SaJWVldx1112H3e93v/sdixcvZv78+Xzta18jGAzy0EMPkZ2dPeD9d999N6+99hqnnXYa3/rWt4jFYjz00EPMmDFjwO/CxIkTueeee7jjjjtoaGjg4osvJjMzk/r6el588UVuvPFGvv/97yfhEw802O9ICCHSkbThn5A2/OCkDRej2sgWRRdiaA60NMSB/PnPf9YmT56smc1mbdq0adoTTzxxwOUXAO2mm24a1jEGs6TItm3btLPPPlvLyMjQCgoKtBtuuEH7+OOPNUB74oknNE3TtJdeekkDtN///vcDju/xeLTKykpt9uzZWiQSGfbP5tNLimiapnm9Xu3WW2/VysrKNKPRqE2ePFn73e9+p6mqOmC/HTt2aKeffrpmtVoHLG3x6SVF9nr44Ye1adOmaUajUSsuLta++c1vak6nc8A+Z5xxhjZjxoz94hzsshsH+jyfdrCfzfLly7VTTjlFs1qtWlZWlnbBBRdo27Zt2+/9K1eu1ObMmaOZTCZtwoQJ2mOPPXbA3wVN07QXXnhBO/XUUzW73a7Z7XZt2rRp2k033aTt3LlzyJ/tYD+bvQ4Uw8G+IyGESDVpw6UNH8zn+TRpw8VYo2jaECscCCGEEEIIIYQQ4rBkDrcQQgghhBBCCJEEknALIYQQQgghhBBJIAm3EEIIIYQQQgiRBJJwCyGEEEIIIYQQSSAJtxBCCCGEEEIIkQSScAshhBBCCCGEEElgSHUAI0lVVdra2sjMzERRlFSHI4QQ4iimaRper5eysjJ0Orn/fTjShgshhEgng23Hj6qEu62tjfLy8lSHIYQQQvRrbm5m/PjxqQ4j7UkbLoQQIh0drh0/qhLuzMxMoO+HkpWVleJohBBCHM08Hg/l5eX9bZM4NGnDhRBCpJPBtuNHVcK9dwhaVlaWNNZCCCHSggyPHhxpw4UQQqSjw7XjMmlMCCGEEEIIIYRIAkm4hRBCCCGEEEKIJJCEWwghhBBCCCGESIKjag73YKiqSiQSSXUYYgiMRiN6vT7VYQghhEgD8XicaDSa6jDEEEg7LoQYyyTh3kckEqG+vh5VVVMdihiinJwcSkpKpPiQEEIcpTRNo6OjA5fLlepQxBGQdlwIMVZJwr2Hpmm0t7ej1+spLy8/5OLlIn1omkYgEKCrqwuA0tLSFEckhBAiFfYm20VFRdhsNkncRglpx4UQY50k3HvEYjECgQBlZWXYbLZUhyOGwGq1AtDV1UVRUZEMSxNCiGG49957+ec//8mOHTuwWq2cfPLJ/OY3v2Hq1Kn9+4RCIb73ve/x7LPPEg6HWbRoEY8++ijFxcUHPa6madx555388Y9/xOVyccopp7BkyRImT5487Jjj8Xh/sp2fnz/s44mRJe24EGIsk27cPeLxOAAmkynFkYgjsfcmiczbE0KI4Vm5ciU33XQTH374IW+88QbRaJRzzjkHv9/fv8+tt97Kv/71L55//nlWrlxJW1sbl1566SGP+9vf/pYHH3yQxx57jI8++gi73c6iRYsIhULDjnnv3365YT56STsuhBirpIf7U2QI2ugk35sQQiTGa6+9NuD50qVLKSoqYt26dZx++um43W7+/Oc/88wzz3DmmWcC8MQTT3DMMcfw4Ycf8pnPfGa/Y2qaxv33389PfvITLrroIgCeeuopiouLWbZsGZdffnlCYpe2YPSS704IMVZJD3eCBSIxqn70H6p+9B8CkViqwxFCCCGGxe12A5CXlwfAunXriEajnH322f37TJs2jYqKClatWnXAY9TX19PR0THgPdnZ2cybN++g70kVaceFEEIkkvRwCyGEEOKAVFXllltu4ZRTTmHmzJlAX3Eyk8lETk7OgH2Li4vp6Og44HH2bv/0HO9DvSccDhMOh/ufezyeI/0YQgghRMpID3eCxVWt/9+r63sHPE+Ga6+9FkVRUBQFo9FIcXExn/3sZ3n88ceHtLzZ0qVL97t4EkIIcXS76aab2LJlC88+++yIn/vee+8lOzu7/1FeXj4i55V2XAghRCJJwp1Ar21p5+z7VvY/v/aJNZz6m7d4bUt7Us977rnn0t7eTkNDA6+++ioLFy7ku9/9Lp/73OeIxWQ4nBBCiKG7+eab+fe//82KFSsYP358//aSkhIikch+6113dnZSUlJywGPt3d7Z2Tno99xxxx243e7+R3Nz8zA+zeBIOy6EECLRJOFOkNe2tPPNv66n0xMesL3DHeKbf12f1MbabDZTUlLCuHHjOOGEE/h//+//8dJLL/Hqq6+ydOlSAO677z6OPfZY7HY75eXlfOtb38Ln8wHw9ttvc9111+F2u/vvst91110A/OUvf+HEE08kMzOTkpISrrzyyv61MoUQQow9mqZx88038+KLL/LWW29RXV094PU5c+ZgNBp58803+7ft3LmTpqYm5s+ff8BjVldXU1JSMuA9Ho+Hjz766KDvMZvNZGVlDXgkk7TjQgghkkES7gSIqxp3/2sbBxp0tnfb3f/alvRhafs688wz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RJQHDLiJiIiIiIiI8oABNxEREREREVEeMOAmIiIiIiIiygMG3ERERERERER5wICbiIiIiIiIKA8YcBMRERERERHlAQNuIiIiIiIiojxgwE1ERERERESUBwy4iYiIiIiIiPKAATcRERERERFRHmiL3YBCEkIAAILBYJFbQkREc92JvuhE30Snxz6ciIhmksn243Mq4A6FQgCA2traIreEiIgoIxQKweFwFLsZMx77cCIimonO1I9LYg5dWldVFb29vbDZbJAkaVrvFQwGUVtbi66uLtjt9hy1cPbi8coej1n2eMyyw+OVvVweMyEEQqEQqqqqIMuc4XUm7MOLi8csezxm2eHxyh6PWXZyfbwm24/PqRFuWZZRU1OT0/e02+38A88Cj1f2eMyyx2OWHR6v7OXqmHFke/LYh88MPGbZ4zHLDo9X9njMspPL4zWZfpyX1ImIiIiIiIjygAE3ERERERERUR4w4J4ig8GAm2++GQaDodhNKQk8XtnjMcsej1l2eLyyx2M2O/DfMXs8ZtnjMcsOj1f2eMyyU6zjNaeKphEREREREREVCke4iYiIiIiIiPKAATcRERERERFRHjDgJiIiIiIiIsqDORtwb926FWvWrIHNZkNZWRkuu+wy7N+/f9w28Xgc119/PTweD6xWK97znvegv79/7PmXXnoJV155JWpra2EymbBgwQLcdttt497j8ccfhyRJJ936+voKsp+5VKhjBgCJRAL/+q//ivr6ehgMBjQ0NODOO+/M+z7mUqGO10c+8pFT/o0tWrSoIPuZS4X8G/vFL36BZcuWwWw2o7KyEh/96EcxPDyc933MtUIes9tvvx0LFiyAyWTCvHnz8LOf/Szv+5druThew8PDuOiii1BVVQWDwYDa2lrccMMNCAaD497n8ccfx8qVK2EwGNDS0oK77767ELs4Z7Afzw778OyxH88e+/HssA/PXkn242KOuvDCC8Vdd90l9uzZI1588UVxySWXiLq6OhEOh8e2+eQnPylqa2vFtm3bxPPPPy/Wr18vNm7cOPb8T37yE/GZz3xGPP7446K9vV3cc889wmQyie9+97tj2zz22GMCgNi/f784duzY2E1RlILuby4U6pgJIcQ73/lOsW7dOvHwww+LI0eOiKefflo8+eSTBdvXXCjU8fL7/eP+trq6uoTb7RY333xzIXc3Jwp1zJ588kkhy7K47bbbxOHDh8UTTzwhFi1aJN71rncVdH9zoVDH7Pvf/76w2Wzi3nvvFe3t7eJXv/qVsFqt4o9//GNB93e6cnG8RkZGxPe//33x3HPPiaNHj4pHHnlEzJs3T1x55ZVj2xw+fFiYzWaxZcsW8dprr4nvfve7QqPRiIceeqig+zubsR/PDvvw7LEfzx778eywD89eKfbjczbgfrOBgQEBQGzfvl0Ikfnx0+l04te//vXYNnv37hUAxI4dOyZ8n0996lPi/PPPH7t/oqMeHR3NW9uLJV/H7MEHHxQOh0MMDw/nr/FFkK/j9Wa/+93vhCRJ4ujRo7lrfJHk65h9+9vfFk1NTeO2+Z//+R9RXV2d4z0ovHwdsw0bNojPfe5z47bZsmWL2LRpU473oLBydbxuu+02UVNTM3b/C1/4gli0aNG4ba644gpx4YUX5ngP6AT249lhH5499uPZYz+eHfbh2SuFfnzOppS/WSAQAAC43W4AwK5du5BKpbB58+axbebPn4+6ujrs2LHjtO9z4j3eaPny5aisrMTb3vY2PPXUUzlufXHk65j98Y9/xOrVq/Gtb30L1dXVaGtrw+c+9znEYrE87Ulh5Ptv7ISf/OQn2Lx5M+rr63PU8uLJ1zHbsGEDurq68MADD0AIgf7+fvzmN7/BJZdckqc9KZx8HbNEIgGj0ThuG5PJhJ07dyKVSuVyFwoqF8ert7cX999/P84999yxx3bs2DHuPQDgwgsvPO0xp+lhP54d9uHZYz+ePfbj2WEfnr1S6McZcANQVRU33ngjNm3ahMWLFwMA+vr6oNfr4XQ6x21bXl4+4bytp59+Gvfddx/+4R/+YeyxyspK/OAHP8Bvf/tb/Pa3v0VtbS3OO+887N69O2/7Uwj5PGaHDx/Gk08+iT179uB3v/sdvvOd7+A3v/kNPvWpT+Vtf/Itn8frjXp7e/Hggw/i4x//eE7bXwz5PGabNm3CL37xC1xxxRXQ6/WoqKiAw+HA7bffnrf9KYR8HrMLL7wQP/7xj7Fr1y4IIfD888/jxz/+MVKpFIaGhvK2T/k03eN15ZVXwmw2o7q6Gna7HT/+8Y/Hnuvr60N5eflJ7xEMBmdF4DHTsB/PDvvw7LEfzx778eywD89eqfTjDLgBXH/99dizZw/uvffeKb/Hnj17cOmll+Lmm2/GBRdcMPb4vHnz8IlPfAKrVq3Cxo0bceedd2Ljxo249dZbc9H0osnnMVNVFZIk4Re/+AXWrl2LSy65BLfccgt++tOfluyJaj6P1xv99Kc/hdPpxGWXXTblz5kp8nnMXnvtNXz2s5/FV77yFezatQsPPfQQjh49ik9+8pO5aHrR5POYffnLX8bFF1+M9evXQ6fT4dJLL8WHP/xhAIAsl2ZXMt3jdeutt2L37t34wx/+gPb2dmzZsiXHLaTJYj+eHfbh2WM/nj3249lhH569kunHs05Cn2Wuv/56UVNTIw4fPjzu8W3btp1yzlZdXZ245ZZbxj326quvirKyMvEv//Ivk/rMz33uc2L9+vXTancx5fuYXX311aK5uXncY6+99poAIA4cOJCbnSigQv2NqaoqWlpaxI033pizthdLvo/ZVVddJd773veOe+yJJ54QAERvb29udqLACvV3lkwmRVdXl0in02NFWEqteJQQuTleb/Tmv5+zzz5bfPaznx23zZ133insdntO2k+vYz+eHfbh2WM/nj3249lhH569UurH52zAraqquP7660VVVdUpO4ATE+5/85vfjD22b9++kybc79mzR5SVlYnPf/7zk/7szZs3l1wVRSEKd8x++MMfCpPJJEKh0Nhjv//974UsyyIajeZwj/Kr0H9jJwr7vPLKK7nbiQIr1DF797vfLd73vveNe+zpp58WAERPT0+O9qYwivlbds4554yr6FkKcnW83mz79u0CgDhy5IgQIlNsZfHixeO2ufLKK1k0LYfYj2eHfXj22I9nj/14dtiHZ68U+/E5G3Bfd911wuFwiMcff3zcUgxv7Aw++clPirq6OvHoo4+K559/XmzYsEFs2LBh7PlXXnlF+Hw+cdVVV417j4GBgbFtbr31VvH73/9eHDx4ULzyyivis5/9rJBlWTzyyCMF3d9cKNQxC4VCoqamRrz3ve8Vr776qti+fbtobW0VH//4xwu6v9NVqON1wlVXXSXWrVtXkH3Ll0Ids7vuuktotVrx/e9/X7S3t4snn3xSrF69Wqxdu7ag+5sLhTpm+/fvF/fcc484cOCAePbZZ8UVV1wh3G73WMdUKnJxvP7yl7+IO++8U7zyyiviyJEj4s9//rNYsGDBuGqvJ5YT+fznPy/27t0rbr/9di4LlmPsx7PDPjx77Mezx348O+zDs1eK/ficDbgBnPJ21113jW0Ti8XEpz71KeFyuYTZbBbvete7xLFjx8aev/nmm0/5HvX19WPbfPOb3xTNzc3CaDQKt9stzjvvPPHoo48WcE9zp1DHTIhM+f7NmzcLk8kkampqxJYtW0ruynghj5ff7xcmk0n87//+b4H2Lj8Kecz+53/+RyxcuFCYTCZRWVkpPvjBD4ru7u4C7WnuFOqYvfbaa2L58uXCZDIJu90uLr30UrFv374C7mlu5OJ4Pfroo2LDhg3C4XAIo9EoWltbxT//8z+flL722GOPieXLlwu9Xi+amprGfQZNH/vx7LAPzx778eyxH88O+/DslWI/Lh1vOBERERERERHlUOmWpSMiIiIiIiKawRhwExEREREREeUBA24iIiIiIiKiPGDATURERERERJQHDLiJiIiIiIiI8oABNxEREREREVEeMOAmIiIiIiIiygMG3ERERERERER5wICbiE7ykY98BJdddlmxm0FERERTwH6caObQFrsBRFRYkiSd9vmbb74Zt912G4QQBWoRERERTRb7caLSIgl+G4nmlL6+vrH/v++++/CVr3wF+/fvH3vMarXCarUWo2lERER0BuzHiUoLU8qJ5piKioqxm8PhgCRJ4x6zWq0npaKdd955+PSnP40bb7wRLpcL5eXl+NGPfoRIJIJrrrkGNpsNLS0tePDBB8d91p49e3DxxRfDarWivLwcH/rQhzA0NFTgPSYiIpo92I8TlRYG3EQ0KT/96U/h9Xqxc+dOfPrTn8Z1112Hyy+/HBs3bsTu3btxwQUX4EMf+hCi0SgAwO/34y1veQtWrFiB559/Hg899BD6+/vxvve9r8h7QkRENPewHycqDgbcRDQpy5Ytw5e+9CW0trbipptugtFohNfrxbXXXovW1lZ85StfwfDwMF5++WUAwPe+9z2sWLEC3/jGNzB//nysWLECd955Jx577DEcOHCgyHtDREQ0t7AfJyoOFk0joklZunTp2P9rNBp4PB4sWbJk7LHy8nIAwMDAAADgpZdewmOPPXbKeWTt7e1oa2vLc4uJiIjoBPbjRMXBgJuIJkWn0427L0nSuMdOVE1VVRUAEA6H8Y53vAPf/OY3T3qvysrKPLaUiIiI3oz9OFFxMOAmorxYuXIlfvvb36KhoQFaLX9qiIiISgn7caLc4BxuIsqL66+/HiMjI7jyyivx3HPPob29HX/9619xzTXXQFGUYjePiIiIToP9OFFuMOAmoryoqqrCU089BUVRcMEFF2DJkiW48cYb4XQ6Icv86SEiIprJ2I8T5YYkhBDFbgQRERERERHRbMPLU0RERERERER5wICbiIiIiIiIKA8YcBMRERERERHlAQNuIiIiIiIiojxgwE1ERERERESUBwy4iYiIiIiIiPKAATcRERERERFRHjDgJiIiIiIiIsoDBtxEREREREREecCAm4iIiIiIiCgPGHATERERERER5QEDbiIiIiIiIqI8+P/U0OqaNq/eTAAAAABJRU5ErkJggg==",
+ "text/plain": [
+ "
"
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "x_model, y_model, xe_model, ye_model = mm.model(t_test, params, param_errs)\n",
+ "visualize_fit(t, x, y, xe, ye, x_model, y_model, xe_model, ye_model, mm.name, t_test)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5be8fb7e",
+ "metadata": {},
+ "source": [
+ "# 2. Fit Motion Model in StarTable"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3bd8dec7",
+ "metadata": {},
+ "source": [
+ "Examples on `flystar.StarTable.fit_motion_model`. Prepare the data with invalid values:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 20,
+ "id": "aa698e86",
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "t = np.array([0, 1., 2.2, 3.5, 5.]) + 2025.0\n",
+ "\n",
+ "x = np.array([\n",
+ " [0., 0.5, 2.1, 3.2, 8.0], # Increasing 5 Epochs\n",
+ " [10.0, 8.9, 9.2, 7.4, 7.0], # Decreasing 5 Epochs\n",
+ " [2.5, np.nan, 5.2, np.nan, 5.0], # 3 Epochs\n",
+ " [np.nan, 6.2, np.nan, np.nan, 9.2], # 2 Epochs\n",
+ " [np.nan, 2.0, np.nan, np.nan, np.nan], # 1 Epoch\n",
+ " [np.nan, np.nan, np.nan, np.nan, np.nan] # All NaNs\n",
+ "])\n",
+ "\n",
+ "y = np.array([\n",
+ " [10.2, 8.5, 9.1, 10.5, 13.0], # Increasing 5 Epochs\n",
+ " [8.0, 9.9, 8.2, 7.4, 7.0], # Decreasing 5 Epochs\n",
+ " [5.2, np.nan, 4.7, np.nan, 6.0], # 3 Epochs\n",
+ " [np.nan, 1.2, np.nan, np.nan, 3.2], # 2 Epochs\n",
+ " [np.nan, 2.0, np.nan, np.nan, np.nan], # 1 Epoch\n",
+ " [np.nan, np.nan, np.nan, np.nan, np.nan] # All NaNs\n",
+ "])\n",
+ "\n",
+ "xe = np.array([\n",
+ " [0.2, 0.5, 0.3, 0.4, 0.6],\n",
+ " [0.5, 0.2, 0.7, 0.3, 0.2],\n",
+ " [0.5, np.nan, 0.6, np.nan, 0.3],\n",
+ " [np.nan, 0.6, np.nan, np.nan, 0.3],\n",
+ " [np.nan, 0.4, np.nan, np.nan, np.nan],\n",
+ " [np.nan, np.nan, np.nan, np.nan, np.nan]\n",
+ "])\n",
+ "\n",
+ "ye = np.array([\n",
+ " [0.3, 0.2, 0.5, 0.2, 0.4],\n",
+ " [0.2, 0.5, 0.6, 0.4, 0.2],\n",
+ " [0.7, np.nan, 0.5, np.nan, 0.2],\n",
+ " [np.nan, 0.4, np.nan, np.nan, 0.5],\n",
+ " [np.nan, 0.5, np.nan, np.nan, np.nan],\n",
+ " [np.nan, np.nan, np.nan, np.nan, np.nan]\n",
+ "])\n",
+ "\n",
+ "x = np.ma.masked_invalid(x)\n",
+ "y = np.ma.masked_invalid(y)\n",
+ "xe = np.ma.masked_invalid(xe)\n",
+ "ye = np.ma.masked_invalid(ye)\n",
+ "mask = np.ma.getmaskarray(x) | np.ma.getmaskarray(y) | np.ma.getmaskarray(xe) | np.ma.getmaskarray(ye)\n",
+ "\n",
+ "tab = StarTable({\n",
+ " 'x': x,\n",
+ " 'y': y,\n",
+ " 'xe': xe,\n",
+ " 'ye': ye\n",
+ "})\n",
+ "tab.meta['list_times'] = t"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9201897f",
+ "metadata": {},
+ "source": [
+ "There are a 2 ways to specify the desired motion models:\n",
+ "1. Let MotionModel automatically determine which motion model to use among the given `motion_models` list based on the number of valid observations. MotionModel will choose the motion model that has enough observations, i.e. $n_\\text{fit} \\geq n_\\text{params}$. \n",
+ "2. Specify a motion model for each star in the `motion_model_input` column. In case there is not enough observations, MotionModel will \"downgrade\" to a model with less parameters until $n_\\text{fit} \\geq n_\\text{params}$ among all the unique motion models specified in the column.\n",
+ "\n",
+ "Note that when `absolute_sigma=False` and `n_fit == n_params`, we don't have enough degree of freedom to rescale the uncertainties, so the uncertainties will be set to infinity -- the same behavior as `scipy.optimize.curve_fit`. By default `motion_models = [Empty, Fixed, Linear]`. `Empty` and `Fixed` will always be added in the list to handle 0 and 1 point cases. See examples below for details. Let's start with the most basic usage."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e58f429d",
+ "metadata": {},
+ "source": [
+ "## 2.1. Example: Default Fitting"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 21,
+ "id": "02642d3b",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Empty: 0%| | 0/1 [00:00, ?it/s]/home/weilingfeng/Software/flystar/flystar/motion_model.py:119: OptimizeWarning: Empty data cannot be fit. Setting parameters to nan and uncertainties to np.inf.\n",
+ " fit_result = self.run_fit(\n",
+ "Fitting motion model Empty: 100%|██████████| 1/1 [00:00<00:00, 2323.71it/s]\n",
+ "Fitting motion model Fixed: 0%| | 0/1 [00:00, ?it/s]/home/weilingfeng/Software/flystar/flystar/motion_model.py:403: UserWarning: Fixed model has no non-scipy fitter option. Running with scipy.\n",
+ " warnings.warn(\"Fixed model has no non-scipy fitter option. Running with scipy.\")\n",
+ "Fitting motion model Fixed: 100%|██████████| 1/1 [00:00<00:00, 5363.56it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 4/4 [00:00<00:00, 7895.16it/s]\n"
+ ]
+ }
+ ],
+ "source": [
+ "tab.fit_motion_model()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "81059189",
+ "metadata": {},
+ "source": [
+ "Since we do not specify the `motion_models` parameter in the `fit_motion_model` function, the default motion model of `Empty`, `Fixed` and `Linear` will be used. The function automatically determines which motion models among the three to use based on the number of valid observations, i.e., $n_\\text{fit} \\geq n_\\text{params}$:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 38,
+ "id": "a7573e51",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "
StarTable length=6\n",
+ "
\n",
+ "
n_fit
n_required
motion_model_used
\n",
+ "
int64
int64
str20
\n",
+ "
5
2
Linear
\n",
+ "
5
2
Linear
\n",
+ "
3
2
Linear
\n",
+ "
2
2
Linear
\n",
+ "
1
2
Fixed
\n",
+ "
0
2
Empty
\n",
+ "
"
+ ],
+ "text/plain": [
+ "\n",
+ "n_fit n_required motion_model_used\n",
+ "int64 int64 str20 \n",
+ "----- ---------- -----------------\n",
+ " 5 2 Linear\n",
+ " 5 2 Linear\n",
+ " 3 2 Linear\n",
+ " 2 2 Linear\n",
+ " 1 2 Fixed\n",
+ " 0 2 Empty"
+ ]
+ },
+ "execution_count": 38,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "tab['n_required'] = 2\n",
+ "tab[['n_fit', 'n_required', 'motion_model_used']]"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "20470c6e",
+ "metadata": {},
+ "source": [
+ "Next, let's try `absolute_sigma=False`. As mentioned above, we don't have enough degree of freedom to rescale the uncertainties for the forth star. In this case, the parameter uncertainties will be set to infinity, which is the same behavior as `scipy.optimize.curve_fit`. The same `OptmizieWarning` as in `scipy` will be raised."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 21,
+ "id": "26b11593",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Empty: 0%| | 0/1 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:119: OptimizeWarning: Empty data cannot be fit. Setting parameters to nan and uncertainties to np.inf.\n",
+ " fit_result = self.run_fit(\n",
+ "Fitting motion model Empty: 100%|██████████| 1/1 [00:00<00:00, 4524.60it/s]\n",
+ "Fitting motion model Fixed: 0%| | 0/1 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:404: UserWarning: Fixed model has no non-scipy fitter option. Running with scipy.\n",
+ " warnings.warn(\"Fixed model has no non-scipy fitter option. Running with scipy.\")\n",
+ "/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:119: OptimizeWarning: Degree of freedom < 0. Covariance of the parameters could not be estimated. Setting parameter uncertainties to fill value np.inf.\n",
+ " fit_result = self.run_fit(\n",
+ "Fitting motion model Fixed: 100%|██████████| 1/1 [00:00<00:00, 710.30it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 4/4 [00:00<00:00, 4723.32it/s]\n"
+ ]
+ }
+ ],
+ "source": [
+ "tab.fit_motion_model(absolute_sigma=False)"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 22,
+ "id": "a411e006",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "<Column name='vx_err' dtype='float64' length=6>\n",
+ "
\n",
+ "
0.2398025689409276
\n",
+ "
0.07197698078673948
\n",
+ "
0.26723109004421475
\n",
+ "
inf
\n",
+ "
inf
\n",
+ "
inf
\n",
+ "
"
+ ],
+ "text/plain": [
+ "\n",
+ " 0.2398025689409276\n",
+ "0.07197698078673948\n",
+ "0.26723109004421475\n",
+ " inf\n",
+ " inf\n",
+ " inf"
+ ]
+ },
+ "execution_count": 22,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "tab['vx_err']"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "241ab6d6",
+ "metadata": {},
+ "source": [
+ "## 2.2. Example: Specify Motion Models"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "220922c5",
+ "metadata": {},
+ "source": [
+ "Alternatively, one can specify a list of motion models to use, and the function will also automatically determine which model to use for each star depending on the valid observed epochs. In the following example, we specify `Acceleration` model, but **the function will always implicitly add `Empty` and `Fixed`** to handle the 0 or 1 epoch stars."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 23,
+ "id": "a596c8e8",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Acceleration: 0%| | 0/3 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:785: UserWarning: Acceleration model has no non-scipy fitter option. Running with scipy.\n",
+ " warnings.warn(\"Acceleration model has no non-scipy fitter option. Running with scipy.\")\n",
+ "Fitting motion model Acceleration: 100%|██████████| 3/3 [00:00<00:00, 2933.08it/s]\n",
+ "Fitting motion model Empty: 100%|██████████| 1/1 [00:00<00:00, 15141.89it/s]\n",
+ "Fitting motion model Fixed: 100%|██████████| 2/2 [00:00<00:00, 10754.63it/s]\n"
+ ]
+ }
+ ],
+ "source": [
+ "tab.fit_motion_model(motion_models=['Acceleration'])"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 24,
+ "id": "7d66e979",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "
StarTable length=6\n",
+ "
\n",
+ "
n_fit
motion_model_used
\n",
+ "
int64
str20
\n",
+ "
5
Acceleration
\n",
+ "
5
Acceleration
\n",
+ "
3
Acceleration
\n",
+ "
2
Fixed
\n",
+ "
1
Fixed
\n",
+ "
0
Empty
\n",
+ "
"
+ ],
+ "text/plain": [
+ "\n",
+ "n_fit motion_model_used\n",
+ "int64 str20 \n",
+ "----- -----------------\n",
+ " 5 Acceleration\n",
+ " 5 Acceleration\n",
+ " 3 Acceleration\n",
+ " 2 Fixed\n",
+ " 1 Fixed\n",
+ " 0 Empty"
+ ]
+ },
+ "execution_count": 24,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "tab[['n_fit', 'motion_model_used']]"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "188290a9",
+ "metadata": {},
+ "source": [
+ "## 2.3. Example: Specify the `motion_model_input` Column"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "99624463",
+ "metadata": {},
+ "source": [
+ "One can also specify a motion model for each star as a column in the star table. However, the function will \"downgrade\" the model to one with fewer parameters until $n_\\text{fit} \\geq n_\\text{params}$:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 39,
+ "id": "04db5f9e",
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "ra = np.zeros(len(x))\n",
+ "dec = np.zeros(len(x))\n",
+ "pa = np.zeros(len(x))\n",
+ "\n",
+ "motion_model_input = [\n",
+ " 'Acceleration', # Will use Acceleration\n",
+ " 'Parallax', # Will use Parallax\n",
+ " 'Linear', # Will use Linear\n",
+ " 'Acceleration', # Will use Linear, as n_fit = 2 < 3\n",
+ " 'Linear', # Will use Fixed, as n_fit = 1 < 2\n",
+ " 'Fixed' # Will use Empty, as n_fit = 0 < 1\n",
+ "]\n",
+ "tab = StarTable({\n",
+ " 'x': x,\n",
+ " 'y': y,\n",
+ " 'xe': xe,\n",
+ " 'ye': ye,\n",
+ " 'ra': ra,\n",
+ " 'dec': dec,\n",
+ " 'pa': pa,\n",
+ " 'motion_model_input': motion_model_input\n",
+ "})\n",
+ "tab.meta['list_times'] = t"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 40,
+ "id": "2b61fbcf",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Acceleration: 0%| | 0/1 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:785: UserWarning: Acceleration model has no non-scipy fitter option. Running with scipy.\n",
+ " warnings.warn(\"Acceleration model has no non-scipy fitter option. Running with scipy.\")\n",
+ "Fitting motion model Acceleration: 100%|██████████| 1/1 [00:00<00:00, 1086.04it/s]\n",
+ "Fitting motion model Empty: 0%| | 0/1 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:119: OptimizeWarning: Empty data cannot be fit. Setting parameters to nan and uncertainties to np.inf.\n",
+ " fit_result = self.run_fit(\n",
+ "Fitting motion model Empty: 100%|██████████| 1/1 [00:00<00:00, 9258.95it/s]"
+ ]
+ },
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "\n",
+ "Fitting motion model Fixed: 0%| | 0/1 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:404: UserWarning: Fixed model has no non-scipy fitter option. Running with scipy.\n",
+ " warnings.warn(\"Fixed model has no non-scipy fitter option. Running with scipy.\")\n",
+ "Fitting motion model Fixed: 100%|██████████| 1/1 [00:00<00:00, 4405.78it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 2/2 [00:00<00:00, 5302.53it/s]\n",
+ "Fitting motion model Parallax: 0%| | 0/1 [00:00, ?it/s]/Users/weilingfeng/Academic/Software/flystar/flystar/motion_model.py:1002: UserWarning: Parallax model has no non-scipy fitter option. Running with scipy.\n",
+ " warnings.warn(\"Parallax model has no non-scipy fitter option. Running with scipy.\", UserWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 1 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 2 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 2 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 1 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"taiutc\" yielded 1 of \"dubious year (Note 4)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "Fitting motion model Parallax: 100%|██████████| 1/1 [00:00<00:00, 292.33it/s]\n"
+ ]
+ }
+ ],
+ "source": [
+ "tab.fit_motion_model(fixed_params_dict={\n",
+ " 'ra': ra, \n",
+ " 'dec': dec, \n",
+ " 'pa': pa,\n",
+ " 'obsLocation': 'earth'\n",
+ "})"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5a625ccb",
+ "metadata": {},
+ "source": [
+ "Let's check if the actually used motion model is corrected:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 41,
+ "id": "b30ffb16",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "
StarTable length=6\n",
+ "
\n",
+ "
n_fit
n_required
motion_model_input
motion_model_used
\n",
+ "
int64
int64
str12
str12
\n",
+ "
5
3
Acceleration
Acceleration
\n",
+ "
5
3
Parallax
Parallax
\n",
+ "
3
2
Linear
Linear
\n",
+ "
2
3
Acceleration
Linear
\n",
+ "
1
2
Linear
Fixed
\n",
+ "
0
1
Fixed
Empty
\n",
+ "
"
+ ],
+ "text/plain": [
+ "\n",
+ "n_fit n_required motion_model_input motion_model_used\n",
+ "int64 int64 str12 str12 \n",
+ "----- ---------- ------------------ -----------------\n",
+ " 5 3 Acceleration Acceleration\n",
+ " 5 3 Parallax Parallax\n",
+ " 3 2 Linear Linear\n",
+ " 2 3 Acceleration Linear\n",
+ " 1 2 Linear Fixed\n",
+ " 0 1 Fixed Empty"
+ ]
+ },
+ "execution_count": 41,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "all_mm_map = motion_model.motion_model_map()\n",
+ "tab['n_required'] = np.array([all_mm_map[mm].n_params for mm in tab['motion_model_input']], dtype=int)\n",
+ "tab[['n_fit', 'n_required', 'motion_model_input', 'motion_model_used']]"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d4f96fcb",
+ "metadata": {},
+ "source": [
+ "## 2.4. Example: Infer Positions"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c660ec98",
+ "metadata": {},
+ "source": [
+ "Continuing from the previous example: Once we fit the motion models and the parameters are added into the table, we can infer the positions at arbitrary times with `StarTable.infer_positions`"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 42,
+ "id": "095be28f",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 20 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"dtf2d\" yielded 40 of \"dubious year (Note 6)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 40 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"utctai\" yielded 20 of \"dubious year (Note 3)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n",
+ "/Users/weilingfeng/Software/miniconda3/envs/main/lib/python3.13/site-packages/erfa/core.py:133: ErfaWarning: ERFA function \"taiutc\" yielded 20 of \"dubious year (Note 4)\"\n",
+ " warn(f'ERFA function \"{func_name}\" yielded {wmsg}', ErfaWarning)\n"
+ ]
+ }
+ ],
+ "source": [
+ "x_model, y_model, xe_model, ye_model = tab.infer_positions(t_test)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a4df5458",
+ "metadata": {},
+ "source": [
+ "As in `MotionModel.model`, `StarTable.infer_positions` is also vectorized and returns positions and uncertainties in shapes of $(N_\\text{stars}, N_\\text{times})$"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 44,
+ "id": "2f7e8b7a",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "(6, 100)"
+ ]
+ },
+ "execution_count": 44,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "x_model.shape"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 29,
+ "id": "7aab0868",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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eTabRTabLX9/5MgRnHXWWfUPmoiIyEWVzNcrKuC2bRtHjx5FJBKBpml13VYikcDq1atx6NAhRKNRh0Z45uNxqx6PWfV4zGrD41Y9p4+ZUgrJZBK9vb3Q9aW162t4eBjDw8MLXmdwcBB+v3/W5UeOHEFfXx/27NmD8847b9H7cnK+BvjcrgWPWW143KrHY1Y9HrPaOHncqpmvV1RKua7rjq8YRKNRPtFrwONWPR6z6vGY1YbHrXpOHrNYLObI7Titvb0d7e3tNf3uvn37AAA9PT0VXd+N+Rrgc7sWPGa14XGrHo9Z9XjMauPUcat0vl5RATcRERG568knn8SePXvw9re/HbFYDE8//TRuueUWXHHFFejv72/28IiIiBqKATcRERE5xjRN7Nq1C3fddRey2SwGBgZwww034FOf+lSzh0ZERNRwDLhrZJom7rjjDpim2eyhLCs8btXjMasej1lteNyqx2M2244dO7Bnz55mD2Ma/p2qx2NWGx636vGYVY/HrDbNOm4rqmgaERERERERUaMsrRKoRERERERERGcIBtxERERERERELmDATUREREREROSCFRtw33PPPXjTm96ESCSCzs5OvP/978cLL7ww7TpKKdx5553o7e1FIBDA2972Nvz2t78t//z06dP4xCc+gU2bNiEYDKK/vx9/8Rd/gbGxsWm3Mzg4CE3Tpn3cdtttDXmcTmvkcQOA//zP/8R5552HQCCA9vZ2XHXVVa4/Rqc16pj99Kc/nfU8K308/fTTDXu8Tmnkc+3FF1/ElVdeifb2dkSjUVx00UV49NFHG/I4ndTIY/bMM8/g3e9+N1paWtDW1oY//dM/xfj4eEMep9OcOG4A8LGPfQzr1q1DIBBAR0cHrrzySuzfv3/adUZGRnDttdciFoshFovh2muvxejoqNsPcdnjnF09zte14ZxdPc7XteGcXb1lO1+rFeo973mPeuihh9RvfvMb9eyzz6r3vve9qr+/X42Pj5ev87nPfU5FIhH13e9+Vz333HPq6quvVj09PSqRSCillHruuefUVVddpR5++GF14MAB9V//9V9qw4YN6gMf+MC0+xoYGFB33323GhoaKn8kk8mGPl6nNPK4fec731HxeFx95StfUS+88ILav3+/+va3v93Qx+uERh2zbDY77Tk2NDSkrr/+ejU4OKhs2274465XI59r69ev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rHrhhRfUX/3VXymv16ueffbZpjz2WjXyufalL31J7d27V73wwgvqy1/+sgoEAuof//EfG/6YneDEcXv55ZfVZz/7WfXLX/5Svfbaa+qJJ55QV155pWptbVXHjx8v385ll12mtm3bpp588kn15JNPqrPPPpttwSrAObt6nK9rwzm7epyva8M5u3rLdb5esQE3gDk/HnroofJ1bNtWd9xxh+ru7lamaaqLL75YPffcc+WfP/roo/PezsGDB5VSSu3du1edd955KhaLKb/frzZt2qTuuOMONTEx0eBH7IxGHTelpEXGX/7lX6rOzk4ViUTUu971LvWb3/ymgY/WGY08Zkop9aEPfUhdeOGFDXp07mnkcXv66afVpZdeqlpbW1UkElHnn3+++uEPf9jAR+uMRh6za6+9VrW2tiqfz6e2bdumvvnNbzbwkTrLieN25MgRdfnll6vOzk7l9XpVX1+f+vCHPzyrfcipU6fUNddcoyKRiIpEIuqaa65RIyMjDXqkyxfn7Opxvq4N5+zqcb6uDefs6i3X+VorDp6IiIiIiIiIHLRi93ATERERERERuYkBNxEREREREZELGHATERERERERuYABNxEREREREZELGHATERERERERuYABNxEREREREZELGHATERERERERuYABNxEREREREZELGHAT0YLuvPNObN++vdnDICIiogVwviZamjSllGr2IIioOTRNW/Dnf/Inf4Ivf/nLyGazaGtra9CoiIiIaCrO10TLFwNuohXs2LFj5a937dqFv/u7v8MLL7xQviwQCCAWizVjaERERFTE+Zpo+WJKOdEK1t3dXf6IxWLQNG3WZTNT1D7ykY/g/e9/Pz772c+iq6sLLS0tuOuuu5DP5/HXf/3XaG1tRV9fH77+9a9Pu68jR47g6quvRjweR1tbG6688kq8+uqrjX3AREREyxDna6LliwE3EVXtJz/5CY4ePYrHH38c9957L+688068733vQzwexy9+8QvceOONuPHGG3Ho0CEAQCqVwtvf/naEw2E8/vjj+PnPf45wOIzLLrsMlmU1+dEQERGdmThfEzUfA24iqlprayv+6Z/+CZs2bcJHP/pRbNq0CalUCp/+9KexYcMG3H777fD5fPjv//5vAMC3vvUt6LqOBx98EGeffTY2b96Mhx56CK+//jp++tOfNvfBEBERnaE4XxM1n6fZAyCi5WfLli3Q9cnzdV1dXdi6dWv5e8Mw0NbWhhMnTgAA9u7diwMHDiASiUy7nUwmg5dffrkxgyYiIlphOF8TNR8DbiKqmtfrnfa9pmlzXmbbNgDAtm3s3LkT//qv/zrrtjo6OtwbKBER0QrG+Zqo+RhwE5HrduzYgV27dqGzsxPRaLTZwyEiIqI5cL4mch73cBOR66655hq0t7fjyiuvxM9+9jMcPHgQjz32GG6++WYcPny42cMjIiIicL4mcgMDbiJyXTAYxOOPP47+/n5cddVV2Lx5Mz760Y8inU7zDDoREdESwfmayHmaUko1exBEREREREREZxqucBMRERERERG5gAE3ERERERERkQsYcBMRERERERG5gAE3ERERERERkQsYcBMRERERERG5gAE3ERERERERkQsYcBMRERERERG5gAE3ERERERERkQsYcBMRERERERG5gAE3ERERERERkQsYcBMRERERERG5gAE3ERERERERkQv+f8ZqD6VV4nMSAAAAAElFTkSuQmCC",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "visualize_fit(t, x, y, xe, ye, x_model, y_model, xe_model, ye_model, mm.name, t_test)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "12bb0136",
+ "metadata": {},
+ "source": [
+ "## 2.5. Speed Test"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "43fd87c5",
+ "metadata": {},
+ "source": [
+ "Speed test for the most commonly used Linear model. As the `use_scipy=False` option for the Linear model uses the [matrix multiplication solution](https://en.wikipedia.org/wiki/Weighted_least_squares#Solution), it is extremely fast at fewer epochs: "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 30,
+ "id": "de576a47",
+ "metadata": {},
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Fitting 10 epochs...\n"
+ ]
+ },
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:01<00:00, 6350.75it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:00<00:00, 25802.05it/s]\n"
+ ]
+ },
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Fitting 31 epochs...\n"
+ ]
+ },
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:01<00:00, 6184.77it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:00<00:00, 23908.79it/s]\n"
+ ]
+ },
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Fitting 100 epochs...\n"
+ ]
+ },
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:01<00:00, 6347.19it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:00<00:00, 14309.49it/s]\n"
+ ]
+ },
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Fitting 316 epochs...\n"
+ ]
+ },
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:01<00:00, 5023.37it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:03<00:00, 3288.47it/s]\n"
+ ]
+ },
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "Fitting 1000 epochs...\n"
+ ]
+ },
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [00:02<00:00, 4314.91it/s]\n",
+ "Fitting motion model Linear: 100%|██████████| 10000/10000 [01:19<00:00, 125.47it/s]\n"
+ ]
+ }
+ ],
+ "source": [
+ "import time\n",
+ "N = 10000\n",
+ "dims = np.logspace(1, 3, 5, dtype=int)\n",
+ "rng = np.random.default_rng(42)\n",
+ "\n",
+ "scipy_times = []\n",
+ "analytic_times = []\n",
+ "\n",
+ "for dim in dims:\n",
+ " print(f'Fitting {dim} epochs...')\n",
+ " t = np.linspace(2025.0, 2030.0, dim)\n",
+ " x = rng.random((N, dim))\n",
+ " y = rng.random((N, dim))\n",
+ " xe = rng.uniform(0, 0.2, size=(N, dim))\n",
+ " ye = rng.uniform(0, 0.2, size=(N, dim))\n",
+ " tab = StarTable({\n",
+ " 'x': x,\n",
+ " 'y': y,\n",
+ " 'xe': xe,\n",
+ " 'ye': ye\n",
+ " })\n",
+ " tab.meta['list_times'] = t\n",
+ " \n",
+ " start = time.time()\n",
+ " tab.fit_motion_model(use_scipy=True)\n",
+ " end = time.time()\n",
+ " scipy_times.append(end - start)\n",
+ " \n",
+ " start = time.time()\n",
+ " tab.fit_motion_model(use_scipy=False)\n",
+ " end = time.time()\n",
+ " analytic_times.append(end - start)\n",
+ "\n",
+ "scipy_times = np.array(scipy_times)\n",
+ "analytic_times = np.array(analytic_times)\n",
+ " "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 31,
+ "id": "3d2a8457",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "280"
+ ]
+ },
+ "execution_count": 31,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "# Collect memory garbage data\n",
+ "import gc\n",
+ "gc.collect()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "06442faf",
+ "metadata": {},
+ "source": [
+ "Let's visualize the performance:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 32,
+ "id": "03d53769",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "image/png": "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",
+ "text/plain": [
+ ""
+ ]
+ },
+ "metadata": {},
+ "output_type": "display_data"
+ }
+ ],
+ "source": [
+ "fig, ax = plt.subplots()\n",
+ "ax.plot(dims, N / scipy_times, marker='o', label='Scipy Curve Fit')\n",
+ "ax.plot(dims, N / analytic_times, marker='o', color='C3', label='Motion Model Analytic')\n",
+ "ax.set_xscale('log')\n",
+ "ax.set_xlabel('Number of Epochs')\n",
+ "ax.set_ylabel('Stars Fit per Second')\n",
+ "ax.set_title(f'Motion Model Fitting Performance of {N} Stars')\n",
+ "ax.legend()\n",
+ "plt.show()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "ea672ab4",
+ "metadata": {},
+ "source": [
+ "It can be seen that for epochs < 200, the analytic solution is faster than scipy, and vice versa for > 300 epochs."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "main",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.12.9"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/flystar/align.py b/flystar/align.py
index db37954..a99d354 100755
--- a/flystar/align.py
+++ b/flystar/align.py
@@ -1,41 +1,63 @@
-import numpy as np
-from flystar import match
-from flystar import transforms
-from flystar import plots
-from flystar.starlists import StarList
-from flystar.startables import StarTable
-from flystar import motion_model
-from astropy.table import Table, Column, vstack
-import datetime
-import copy
import os
+import gc
import pdb
+import copy
import time
-import warnings
import pickle
+import warnings
+import datetime
+import numpy as np
+import matplotlib.pyplot as plt
+from tqdm import tqdm
+from . import match, transforms, plots, motion_model
+from .starlists import StarList
+from .startables import StarTable
+from .motion_model import Empty, Fixed
+from astropy.table import Table, Column, vstack
from astropy.utils.exceptions import AstropyUserWarning
+
class MosaicSelfRef(object):
- def __init__(self, list_of_starlists, ref_index=0, iters=2,
- dr_tol=[1, 1], dm_tol=[2, 1],
- outlier_tol=[None, None],
- trans_args=[{'order': 2}, {'order': 2}],
- init_order=1,
- mag_trans=True, mag_lim=None, trans_weights=None, vel_weights='var',
- trans_input=None, trans_class=transforms.PolyTransform,
- calc_trans_inverse=False,
- init_guess_mode='miracle', iter_callback=None,
- default_motion_model='Fixed',
- motion_model_dict = {},
- use_scipy=True,
- absolute_sigma=False,
- save_path=None,
- verbose=True):
+ def __init__(
+ self,
+ list_of_starlists,
+ starlist_vertices=None,
+ # Alignment parameters
+ ref_index=0,
+ iters=2,
+ dr_tol=[1, 1],
+ dm_tol=[2, 1],
+ outlier_tol=None,
+ # Transformation parameters
+ trans_class=transforms.PolyTransform,
+ trans_args=[{'order': 2}, {'order': 2}],
+ trans_input=None,
+ trans_weighting=None,
+ init_order=1,
+ init_guess_mode='miracle',
+ briteN=None,
+ calc_trans_inverse=False,
+ # Magnitude parameters
+ mag_trans=True,
+ mag_lim=None,
+ # Motion model parameters
+ motion_models=['Empty', 'Fixed'],
+ # motion_model_for_new_star=None,
+ fixed_params_dict=None,
+ vel_weighting='var',
+ use_scipy=True,
+ absolute_sigma=False,
+ # Advanced options
+ iter_callback=None,
+ save_path=None,
+ prefix_name='msr',
+ verbose=True
+ ):
"""
- Make a mosaic object by passing in a list of starlists and then running fit().
+ Make a mosaic object by passing in a list of starlists and then running fit().
Required Parameters
- ----------
+ -------------------
list_of_starlists : array of StarList objects
An array or list of flystar.starlists.StarList objects (which are Astropy Tables).
There should be one for each starlist and they must contain 'x', 'y', and 'm' columns.
@@ -43,24 +65,28 @@ def __init__(self, list_of_starlists, ref_index=0, iters=2,
Note that there is an optional weights column called 'w'. If this column exists
in any of the lists, it will be queried to determine if an individual star can be
used to derive the transformations between starlists. This is the most flexible way
- to allow you to determine, as a function of time and star, which ones are good enough
- in the transformation. Note that just because it can be used (i.e. w_in=1),
- doesn't meant that it will be used. The mag limits and outliers still take precedence.
- Note also that the weights that go into the transformation are
+ to allow you to determine, as a function of time and star, which ones are good enough
+ in the transformation. Note that just because it can be used (i.e. w_in=1),
+ doesn't meant that it will be used. The mag limits and outliers still take precedence.
+ Note also that the weights that go into the transformation are
star_list['w'] * ref_list['w'] * weight_from_keyword (see the weights parameter)
for those stars not trimmed out by the other criteria.
Optional Parameters
- ----------
+ -------------------
+ starlist_vertices : list or array
+ A list or array of polygon vertices coordinates for each starlist. Initial guess will only use stars in overlapping regions defined by these polygons.
+ Shape of (N_lists, N_vertices, 2) in the format of [[x1, y1], [x2, y2], ..., [xN, yN]] for each starlist, by default None
+
ref_index : int
The index of the reference epoch. (default = 0). Note that this is the reference
- list only for the first iteration. Subsequent iterations will utilize the sigma-clipped
- mean of the positions from all the starlists.
+ list only for the first iteration. Subsequent iterations will utilize the sigma-clipped
+ mean of the positions from all the starlists.
iters : int
- The number of iterations used in the matching and transformation. TO DO: INNER/OUTER?
+ The number of iterations used in the matching and transformation. TO DO: INNER/OUTER?
dr_tol : list or array
The delta-radius (dr) tolerance for matching in units of the reference coordinate system.
@@ -68,73 +94,80 @@ def __init__(self, list_of_starlists, ref_index=0, iters=2,
dm_tol : list or array
The delta-magnitude (dm) tolerance for matching in units of the reference coordinate system.
- This is a list of dm values, one for each iteration of matching/transformation.
+ This is a list of dm values, one for each iteration of matching/transformation.
outlier_tol : list or array
- The outlier tolerance (in units of sigma) for rejecting outlier stars.
+ The outlier tolerance (in units of sigma) for rejecting outlier stars.
This is a list of tol values, one for each iteration of matching/transformation.
+ If not provided, will be None for each iteration.
- mag_trans : boolean
- If true, this will also calculate and (temporarily) apply a zeropoint offset to
- magnitudes in each list to bring them into a common magnitude system. This is
- essential for matching (with finite dm_tol) starlists of different filters or
- starlists that are not photometrically calibrated. Note that the final_table columns
- of 'm', 'm0', and 'm0_err' will contain the transformed magnitudes while the
- final_table column 'm_orig' will contain the original un-transformed magnitudes.
- If mag_trans = False, then no such zeropoint offset it applied at any point.
+ trans_class : transforms.Transform2D object (or subclass)
+ The transform class that will be used to when deriving the optimal
+ transformation parameters between each list and the reference list.
- mag_lim : array
- If different from None, it indicates the minimum and maximum magnitude
- on the catalogs for finding the transformations. Note, if you want specify the mag_lim
- separately for each list and each iteration, you need to pass in a 2D array that
- has shape (N_lists, 2).
+ trans_args : dictionary
+ A dictionary (or a list of dictionaries) containing any extra keywords that are needed
+ in the transformation object. For instance, "order". Note that if a list is passed in,
+ then the transformation argument (i.e. order) will be changed for every iteration in
+ iters.
+
+ trans_input : array or list of transform objects
+ def = None. If not None, then this should contain an array or list of transform
+ objects that will be used as the initial guess in the alignment and matching.
- trans_weights : str
+ trans_weighting : str
Either None (def), 'both,var', 'list,var', or 'ref,var' depending on whether you want
to weight by the positional uncertainties (variances) in the individual starlists, or also with
the uncertainties in the reference frame itself. Note weighting only works when there
are positional uncertainties availabe. Other options include 'both,std', 'list,std', 'list,var'.
-
- vel_weights : str
- Either 'var' (def) or 'std', depending on whether you want to weight the motion model
- fits by the variance or standard deviation of the position data
- trans_input : array or list of transform objects
- def = None. If not None, then this should contain an array or list of transform
- objects that will be used as the initial guess in the alignment and matching.
+ init_order : int
+ The order of the initial transformation used for the first iteration.
- trans_class : transforms.Transform2D object (or subclass)
- The transform class that will be used to when deriving the optimal
- transformation parameters between each list and the reference list.
+ init_guess_mode : string
+ If no initial transformations are passed in via the trans_input keyword, then we have
+ to make the initial transformation and matching blindly. We can do this in a couple of
+ different ways. Options are 'miracle' or 'name' (see trans_initial_guess() for more details).
- trans_args : dictionary
- A dictionary (or a list of dictionaries) containing any extra keywords that are needed
- in the transformation object. For instance, "order". Note that if a list is passed in,
- then the transformation argument (i.e. order) will be changed for every iteration in
- iters.
+ briteN : int
+ If init_guess_mode is 'miracle', this is the number of brightest stars to use in the miracle match.
+ Default is min(50, len(star_list)).
- calc_trans_inverse: boolean
+ calc_trans_inverse: boolean
If true, then calculate the inverse transformation (from reference to starlist)
in addition to the normal transformation (from starlist to reference). The inverse
calculation is calculated by switching the order to the positions in match_and_transform.
The inverse transformations are saved in self.trans_list_inverse.
-
self.trans_list_inverse doesn't exist if calc_trans_inverse == False
- init_guess_mode : string
- If no initial transformations are passed in via the trans_input keyword, then we have
- to make the initial transformation and matching blindly. We can do this in a couple of
- different ways. Options are 'miracle' or 'name' (see trans_initial_guess() for more details).
+ mag_trans : boolean
+ If true, this will also calculate and (temporarily) apply a zeropoint offset to
+ magnitudes in each list to bring them into a common magnitude system. This is
+ essential for matching (with finite dm_tol) starlists of different filters or
+ starlists that are not photometrically calibrated. Note that the final_table columns
+ of 'm', 'm0', and 'm0_err' will contain the transformed magnitudes while the
+ final_table column 'm_orig' will contain the original un-transformed magnitudes.
+ If mag_trans = False, then no such zeropoint offset it applied at any point.
- iter_callback : None or function
- A function to call (that accepts a StarTable object and an iteration number)
- at the end of every iteration. This can be used for plotting or printing state.
+ mag_lim : array
+ If different from None, it indicates the minimum and maximum magnitude
+ on the catalogs for finding the transformations. Note, if you want specify the mag_lim
+ separately for each list and each iteration, you need to pass in a 2D array that
+ has shape (N_lists, 2).
- default_motion_model : string
- Name of motion model to use for new or unassigned stars
+ motion_models : list of MotionModel or str, optional
+ Motion models or their names to use for new or unassigned stars
- motion_model_dict : None or dict
- Dict of motion model name keys (strings) and corresponding MotionModel object values
+ motion_model_for_new_star : str or MotionModel, optional
+ Motion model or its name for newly added stars in the ref table. Used in add_rows_for_new_stars().
+ If None, the most complex motion model in motion_models will be used, by default None.
+
+ fixed_params_dict : None or dict
+ Dictionary of motion model fixed parameters, e.g., ra, dec, pa, obsLocation, t0, etc. See motion_model classes for details.
+
+ vel_weighting : str
+ Either 'var' (def) or 'std', depending on whether you want to weight the motion model
+ fits by the variance or standard deviation of the position data
use_scipy : bool, optional
If True, use scipy.optimize.curve_fit for velocity fitting. If False, use linear
@@ -144,74 +177,119 @@ def = None. If not None, then this should contain an array or list of transform
If True, the velocity fit will use absolute errors in the data. If False, relative
errors will be used, by default False.
+ iter_callback : None or function
+ A function to call (that accepts a StarTable object and an iteration number)
+ at the end of every iteration. This can be used for plotting or printing state.
+
save_path : str, optional
Path to save the MosaicSelfRef object as a pickle file.
-
- verbose : int (0 to 9, inclusive)
+
+ prefix_name : str, optional
+ Prefix for the file names, including PREFIX_input.log, PREFIX.pkl, PREFIX_ref_table.fits.
+
+ verbose : bool or int (0 to 9, inclusive)
Controls the verbosity of print statements. (0 least, 9 most verbose).
For backwards compatibility, 0 = False, 9 = True.
(Note: technically right now no checks on whether the number is an integer or not...)
Example
- ----------
- msc = align.MosaicToRef(list_of_starlists, iters=1,
+ -------
+ mtr = align.MosaicToRef(list_of_starlists, iters=1,
dr_tol=[0.1], dm_tol=[5],
outlier_tol=[None], mag_lim=[13, 21],
trans_class=transforms.PolyTransform,
trans_args=[{'order': 1}],
weights='both,std',
init_guess_mode='miracle', verbose=False)
- msc.fit()
+ mtr.fit()
# Access a list of all the transformation parameters:
- trans_list = msc.trans_list
+ trans_list = mtr.trans_list
# Access the fully-combined reference table.
- stars_table = msc.ref_table
+ stars_table = mtr.ref_table
# Plot the magnitude of the first star vs. time:
- # Overplot the mean magnitude.
+ # Overplot the mean magnitude.
plt.plot(stars_table['t'][0, :], stars_table['m'][0, :], 'k.')
- plt.axhline(stars_table['m0'][0])
+ plt.axhline(stars_table['m0'][0])
# Plot the X position of the first star vs. time:
# Overplot the best-fit proper motion.
times = stars_table['t'][0, :]
plt.errorbar(times, stars_table['x'][0, :], yerr=stars_table['xe'][0, :])
- plt.axhline(stars_table['x0'][0] + stars_table['vx'][0]*(times - stars_table['t0'][0]))
-
+ plt.axhline(stars_table['x0'][0] + stars_table['vx'][0]*(times - stars_table['t0'][0]))
"""
self.star_lists = list_of_starlists
+ self.starlist_vertices = starlist_vertices
self.ref_index = ref_index
self.iters = iters
self.dr_tol = dr_tol
self.dm_tol = dm_tol
- self.outlier_tol = outlier_tol
self.trans_args = trans_args
self.init_order = init_order
self.mag_trans = mag_trans
self.mag_lim = mag_lim
- self.trans_weights = trans_weights
- self.vel_weights = vel_weights
+ self.trans_weighting = trans_weighting
+ self.vel_weighting = vel_weighting
self.trans_input = trans_input
self.trans_class = trans_class
self.calc_trans_inverse = calc_trans_inverse
- self.motion_model_dict = motion_model_dict
self.use_scipy = use_scipy
self.absolute_sigma = absolute_sigma
- self.default_motion_model = default_motion_model
+ self.fixed_params_dict = fixed_params_dict
self.init_guess_mode = init_guess_mode
+ self.briteN = briteN
self.iter_callback = iter_callback
self.save_path = save_path
+ self.prefix_name = prefix_name
self.verbose = verbose
+ if self.starlist_vertices is not None:
+ import shapely
+ self.reflist_polygon = shapely.make_valid(shapely.Polygon(self.starlist_vertices[self.ref_index]))
+ else:
+ self.reflist_polygon = None
+
+ # Check x and y are 1d
+ for ii in range(len(self.star_lists)):
+ if self.star_lists[ii]['x'].ndim != 1 or self.star_lists[ii]['y'].ndim != 1:
+ raise ValueError(f"StarList at index {ii} has x and y that are not 1D. x.ndim={self.star_lists[ii]['x'].ndim}, y.ndim={self.star_lists[ii]['y'].ndim}. Please flatten these columns to be 1D.")
+
+ if outlier_tol is None:
+ self.outlier_tol = [None] * self.iters
+ else:
+ self.outlier_tol = outlier_tol
+
+ all_mm_map = motion_model.motion_model_map()
+ if all(isinstance(mm, str) for mm in motion_models):
+ assert all(mm in all_mm_map.keys() for mm in motion_models), f"All motion model names must be in {list(all_mm_map.keys())}"
+ mm_names = motion_models
+ motion_models = [all_mm_map[mm] for mm in motion_models]
+ else:
+ mm_names = [mm.name for mm in motion_models]
+ if 'Empty' not in mm_names:
+ motion_models.append(all_mm_map['Empty'])
+ if 'Fixed' not in mm_names:
+ motion_models.append(all_mm_map['Fixed'])
+
+ # Sort by increasing n_params
+ motion_models = sorted(motion_models, key=lambda mm: mm.n_params)
+ self.motion_models = motion_models
+
+ # if motion_model_for_new_star is None:
+ # self.motion_model_for_new_star = self.motion_models[-1]
+ # elif isinstance(motion_model_for_new_star, str):
+ # assert motion_model_for_new_star in all_mm_map.keys(), f"motion_model_for_new_star must be in {list(all_mm_map.keys())}"
+ # self.motion_model_for_new_star = all_mm_map[motion_model_for_new_star]
+
# For backwards compatibility.
- if self.verbose is True:
- self.verbose = 9
- if self.verbose is False:
- self.verbose = 0
-
+ # if self.verbose is True:
+ # self.verbose = 9
+ # if self.verbose is False:
+ # self.verbose = 0
+
self.N_lists = len(self.star_lists)
# Hard-coded values:
@@ -233,45 +311,40 @@ def = None. If not None, then this should contain an array or list of transform
# is passed in, replicate for all star lists, all loop iterations.
##########
self.setup_trans_info()
-
- # Make sure the motion models are ready
- self.motion_model_dict = motion_model.validate_motion_model_dict(self.motion_model_dict,
- StarTable(), self.default_motion_model)
-
return
def fix_iterable_conditions(self):
if not np.iterable(self.dr_tol):
self.dr_tol = np.repeat(self.dr_tol, self.iters)
- assert len(self.dr_tol) == self.iters
+ assert len(self.dr_tol) == self.iters, f'len(dr_tol)={len(self.dr_tol)} != iters={self.iters}'
if not np.iterable(self.dm_tol):
self.dm_tol = np.repeat(self.dm_tol, self.iters)
- assert len(self.dm_tol) == self.iters
+ assert len(self.dm_tol) == self.iters, f'len(dm_tol)={len(self.dm_tol)} != iters={self.iters}'
if not np.iterable(self.outlier_tol):
self.outlier_tol = np.repeat(self.outlier_tol, self.iters)
- assert len(self.outlier_tol) == self.iters
+ assert len(self.outlier_tol) == self.iters, f'len(outlier_tol)={len(self.outlier_tol)} != iters={self.iters}'
if self.mag_lim is None:
self.mag_lim = np.repeat([[None, None]], len(self.star_lists), axis=0)
- elif (len(self.mag_lim) == 2):
+ elif (len(self.mag_lim) == 2) and (np.ndim(self.mag_lim) == 1):
self.mag_lim = np.repeat([self.mag_lim], len(self.star_lists), axis=0)
assert len(self.mag_lim) == len(self.star_lists)
return
-
-
+
+
def fit(self):
"""
Using the current parameter settings, match and transform all the lists
to a reference position. Note in the first pass, the reference position
is just the specified input reference starlist. In subsequent iterations,
- this is updated.
+ this is updated.
The ultimate outcome is the creation of self.ref_table. This reference
table will contain "averaged" quantites as well as a big 2D array of all
- the matched original and transformed quantities.
+ the matched original and transformed quantities.
Averaged columns on ref_table:
x0
@@ -283,6 +356,45 @@ def fit(self):
additional motion_model columns
"""
+ # Setup save_path:
+ if self.save_path:
+ if not os.path.exists(os.path.dirname(self.save_path)):
+ os.makedirs(os.path.dirname(self.save_path))
+
+ # Save input params
+ input_filename = f'{self.prefix_name}_input.txt'
+ input_dict = {
+ 'ref_index': self.ref_index,
+ 'iters': self.iters,
+ 'dr_tol': self.dr_tol,
+ 'dm_tol': self.dm_tol,
+ 'outlier_tol': self.outlier_tol,
+ 'trans_class': self.trans_class,
+ 'trans_args': self.trans_args,
+ 'trans_input': self.trans_input,
+ 'trans_weighting': self.trans_weighting,
+ 'init_order': self.init_order,
+ 'init_guess_mode': self.init_guess_mode,
+ 'calc_trans_inverse': self.calc_trans_inverse,
+ 'mag_trans': self.mag_trans,
+ 'mag_lim': self.mag_lim,
+ 'motion_models': self.motion_models,
+ 'fixed_params_dict': self.fixed_params_dict,
+ 'vel_weighting': self.vel_weighting,
+ 'use_scipy': self.use_scipy,
+ 'absolute_sigma': self.absolute_sigma,
+ 'iter_callback': self.iter_callback,
+ 'save_path': self.save_path,
+ 'prefix_name': self.prefix_name,
+ 'verbose': self.verbose
+ }
+ if self.save_path is not None:
+ if not os.path.exists(self.save_path):
+ os.makedirs(self.save_path)
+ with open(os.path.join(self.save_path, input_filename), 'w') as file:
+ for key, value in input_dict.items():
+ file.write(f'{key}:\t{value}\n')
+
##########
# Setup a reference table to store data. It will contain:
# x0, y0, m0 -- the running average of positions: 1D
@@ -290,7 +402,7 @@ def fit(self):
# x_orig, y_orig, m_orig, (opt. errors) -- the transformed errors for the lists: 2D
# w, w_orig (optiona) -- the input and output weights of stars in transform: 2D
##########
- self.ref_table = self.setup_ref_table_from_starlist(self.star_lists[self.ref_index],motion_model_used='Fixed')
+ self.ref_table = self.setup_ref_table_from_starlist(self.star_lists[self.ref_index])
# Save the reference index to the meta data on the reference list.
self.ref_table.meta['ref_list'] = self.ref_index
@@ -300,8 +412,8 @@ def fit(self):
#
##########
for nn in range(self.iters):
-
- # If we are on subsequent iterations, remove matching results from the
+
+ # If we are on subsequent iterations, remove matching results from the
# prior iteration. This leaves aggregated (1D) columns alone.
if nn > 0:
self.reset_ref_values()
@@ -315,10 +427,10 @@ def fit(self):
print("**********")
# ALL the action is in here. Match and transform the stack of starlists.
- # This updates trans objects and the ref_table.
+ # This updates trans objects and the ref_table.
self.match_and_transform(self.mag_lim[self.ref_index],
self.dr_tol[nn], self.dm_tol[nn], self.outlier_tol[nn],
- self.trans_args[nn])
+ self.trans_args[nn], nn)
# Clean up the reference table
# Find where stars are detected.
@@ -326,18 +438,19 @@ def fit(self):
### Drop all stars that have 0 detections.
idx = np.where((self.ref_table['n_detect'] == 0))[0]
- print(' *** Getting rid of {0:d} out of {1:d} junk sources'.format(len(idx), len(self.ref_table)))
+ if self.verbose:
+ print(' *** Getting rid of {0:d} out of {1:d} junk sources'.format(len(idx), len(self.ref_table)))
self.ref_table.remove_rows(idx)
if self.iter_callback != None:
self.iter_callback(self.ref_table, nn)
-
+
##########
#
# Re-do all matching given final transformations.
# No trimming this time.
- # First rest the reference table 2D values.
+ # First rest the reference table 2D values.
##########
self.reset_ref_values(exclude=['used_in_trans'])
@@ -352,39 +465,75 @@ def fit(self):
##########
# Clean up output table.
- #
+ #
##########
# Find where stars are detected.
if self.verbose > 0:
print('')
print(' Preparing the reference table...')
-
+
self.ref_table.detections()
### Drop all stars that have 0 detections.
idx = np.where((self.ref_table['n_detect'] == 0))[0]
- print(' *** Getting rid of {0:d} out of {1:d} junk sources'.format(len(idx), len(self.ref_table)))
+ if self.verbose:
+ print(f' *** Getting rid of {len(idx):d} out of {len(self.ref_table):d} junk sources')
self.ref_table.remove_rows(idx)
if self.iter_callback != None:
self.iter_callback(self.ref_table, nn)
-
- if self.save_path:
- with open(self.save_path, 'wb') as file:
+
+ # Add times into ref_table meta data
+ # complete_times = np.array([np.unique(col[~np.isnan(col)])[0] for col in self.ref_table['t'].T])
+ all_epochs = get_all_epochs(self.ref_table)
+ self.ref_table.meta['list_times'] = list(all_epochs)
+
+ # Update chi2 values in ref table, as motion_model_used may have changed
+ x_inferred, y_inferred, _, _ = self.ref_table.infer_positions(all_epochs)
+ # Ensure x_inferred and y_inferred is 2D for chi2 calculation
+ if x_inferred.ndim == 1:
+ x_inferred = x_inferred[:, np.newaxis]
+ if y_inferred.ndim == 1:
+ y_inferred = y_inferred[:, np.newaxis]
+ chi2_x_2d = ((self.ref_table['x'] - x_inferred) / self.ref_table['xe'])**2
+ chi2_y_2d = ((self.ref_table['y'] - y_inferred) / self.ref_table['ye'])**2
+ chi2_x = np.nansum(chi2_x_2d, axis=1)
+ chi2_y = np.nansum(chi2_y_2d, axis=1)
+ chi2_x[~np.isfinite(chi2_x_2d).any(axis=1)] = np.nan
+ chi2_y[~np.isfinite(chi2_y_2d).any(axis=1)] = np.nan
+ self.ref_table['chi2_x'] = chi2_x
+ self.ref_table['chi2_y'] = chi2_y
+
+ if self.save_path is not None:
+ filename = f'{self.prefix_name}.pkl'
+ with open(os.path.join(self.save_path, filename), 'wb') as file:
pickle.dump(self, file)
+ # Using pickle here because nan in a fits file is auto-converted to a masked value in astropy.io.fits.open()
+ filename = f'{self.prefix_name}_ref_table.pkl'
+ with open(os.path.join(self.save_path, filename), 'wb') as file:
+ pickle.dump(self.ref_table, file)
+
+ if self.verbose > 0:
+ print('===================================')
+ print('========== Done with fit ==========')
+ print('===================================')
return
- def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_args):
+ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_args, nn=None):
"""
Given some reference list of positions, loop through all the starlists
transform and match them.
"""
+ if self.starlist_vertices is not None:
+ import shapely
for ii in range(len(self.star_lists)):
if self.verbose > 0:
msg = ' Matching catalog {0} / {1} with {2:d} stars'
msg2 = ' {0:8s} < {1:0.3f}'
print(" ")
print(" **********")
+ if nn is not None:
+ print(f" Iteration {nn+1} / {self.iters}")
print(msg.format((ii + 1), len(self.star_lists), len(self.star_lists[ii])))
print(msg2.format('dr', dr_tol))
print(msg2.format('|dm|', dm_tol))
@@ -407,18 +556,29 @@ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_ar
### Initial match and transform: 1st order (if we haven't already).
if trans is None:
# Only use "use_in_trans" reference stars, even for initial guessing.
- keepers = np.where(ref_list['use_in_trans'] == True)[0]
-
- trans = trans_initial_guess(ref_list[keepers], star_list_orig_trim, self.trans_args[0], self.motion_model_dict,
- mode=self.init_guess_mode,
- order=self.init_order,
- verbose=self.verbose,
- mag_trans=self.mag_trans)
+ keepers = ref_list['use_in_trans']
+ trans = trans_initial_guess(
+ ref_list=ref_list[keepers],
+ star_list=star_list_orig_trim,
+ trans_args=self.trans_args[0],
+ mode=self.init_guess_mode,
+ order=self.init_order,
+ briteN=self.briteN,
+ polygon_reflist=self.reflist_polygon,
+ polygon_starlist=shapely.Polygon(self.starlist_vertices[ii]) if self.starlist_vertices is not None else None,
+ buffer=dr_tol,
+ motion_models=self.motion_models,
+ fixed_params_dict=self.fixed_params_dict,
+ mag_trans=self.mag_trans,
+ verbose=self.verbose
+ )
+ if np.isnan(trans.px.parameters).any() or np.isnan(trans.py.parameters).any():
+ raise ValueError(f"Initial transformation contains NaN parameters. trans.px={trans.px.parameters}, trans.py={trans.py.parameters}.")
if self.mag_trans:
star_list_T.transform_xym(trans) # trimmed, transformed
else:
- star_list_T.transform_xy(trans)
+ star_list_T.transform_xy(trans)
# Match stars between the transformed, trimmed lists.
idx1, idx2, dr, dm = match.match(star_list_T['x'], star_list_T['y'], star_list_T['m'],
@@ -430,31 +590,30 @@ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_ar
# Outlier rejection
if outlier_tol != None:
- keepers = self.outlier_rejection_indices(star_list_T[idx1], ref_list[idx2],
- outlier_tol)
+ keepers = self.outlier_rejection_indices(star_list_T[idx1], ref_list[idx2], outlier_tol, verbose=self.verbose)
if self.verbose > 1:
- print( ' Rejected ', len(idx1) - len(keepers), ' outliers.' )
-
+ print( ' Rejected ', len(idx1) - sum(keepers), ' outliers.' )
+
idx1 = idx1[keepers]
idx2 = idx2[keepers]
# Only use stars specified by "use_in_trans" column.
if 'use_in_trans' in ref_list.colnames:
- keepers = np.where(ref_list[idx2]['use_in_trans'] == True)[0]
-
+ keepers = ref_list[idx2]['use_in_trans']
+
if self.verbose > 1:
- print( ' Rejected ', len(idx1) - len(keepers), ' with use_in_trans=False.' )
-
+ print( ' Rejected ', len(idx1) - sum(keepers), ' with use_in_trans=False.' )
+
idx1 = idx1[keepers]
idx2 = idx2[keepers]
# Determine weights in the fit.
weight = self.get_weights_for_lists(ref_list[idx2], star_list_T[idx1])
- # Derive the best-fit transformation parameters.
+ # Derive the best-fit transformation parameters.
if self.verbose > 1:
print( ' Using ', len(idx1), ' stars in transformation.' )
- trans = self.trans_class.derive_transform(star_list_orig_trim['x'][idx1], star_list_orig_trim['y'][idx1],
+ trans = self.trans_class.derive_transform(star_list_orig_trim['x'][idx1], star_list_orig_trim['y'][idx1],
ref_list['x'][idx2], ref_list['y'][idx2],
**trans_args,
m=star_list_orig_trim['m'][idx1], mref=ref_list['m'][idx2],
@@ -492,7 +651,7 @@ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_ar
ml='m_lis_T', mr='m_ref',
dx='dx_mpix', dy='dy_mpix', dm='dm',
xo='x_orig', yo='y_orig', mo='m_orig'))
-
+
fmt = '{nr:20s} {n:20s} {xl:9.5f} {xr:9.5f} {yl:9.5f} {yr:9.5f} {ml:6.2f} {mr:6.2f} '
fmt += '{dx:7.2f} {dy:7.2f} {dm:6.2f} {xo:9.5f} {yo:9.5f} {mo:6.2f}'
for foo in range(len(idx1)):
@@ -502,38 +661,43 @@ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_ar
print(fmt.format(nr=star_r['name'], n=star_s['name'], xl=star_t['x'], xr=star_r['x'],
yl=star_t['y'], yr=star_r['y'],
ml=star_t['m'], mr=star_r['m'],
- dx=(star_t['x'] - star_r['x']) * 1e3,
+ dx=(star_t['x'] - star_r['x']) * 1e3,
dy=(star_t['y'] - star_r['y']) * 1e3,
dm=(star_t['m'] - star_r['m']),
xo=star_s['x'], yo=star_s['y'], mo=star_s['m']))
-
+
idx_lis, idx_ref, dr, dm = match.match(star_list_T['x'], star_list_T['y'], star_list_T['m'],
ref_list['x'], ref_list['y'], ref_list['m'],
dr_tol=dr_tol, dm_tol=dm_tol, verbose=self.verbose)
-
+
if self.verbose > 1:
print( ' Match 2: After trans, found ', len(idx_lis), ' matches out of ', len(star_list_T),
'. If match count is low, check dr_tol, dm_tol.' )
## Make plot, if desired
- plots.trans_positions(ref_list, ref_list[idx_ref], star_list_T, star_list_T[idx_lis],
- fileName='{0}'.format(star_list_T['t'][0]))
-
+ if self.save_path:
+ plots.trans_positions(ref_list, ref_list[idx_ref], star_list_T, star_list_T[idx_lis],
+ save_path=os.path.join(self.save_path, f"Transformed_Positions_{ii}_{star_list_T['t'][0]}.png"),
+ show_plot=False)
### Update the observed (but transformed) values in the reference table.
self.update_ref_table_from_list(star_list, star_list_T, ii, idx_ref, idx_lis, idx2)
### Update the "average" values to be used as the reference frame for the next list.
- keep_ref_orig = (self.update_ref_orig==False) or (self.update_ref_orig=='atend') or (self.update_ref_orig=='periter' and ii<(len(self.star_lists)-1))
- if keep_ref_orig and ii<(len(self.star_lists)-1):
- keep_orig = np.where(self.ref_table['ref_orig'] | np.isnan(self.ref_table['x'][:,ii]))[0]
+ keep_ref_orig = (self.update_ref_orig==False) or (self.update_ref_orig=='atend') or (self.update_ref_orig=='periter' and ii<(len(self.star_lists) - 1))
+ if keep_ref_orig and ii < (len(self.star_lists) - 1):
+ keep_orig = self.ref_table['ref_orig'] | np.isnan(self.ref_table['x'][:,ii])
elif keep_ref_orig:
- keep_orig = np.where(self.ref_table['ref_orig'])[0]
- elif ii<(len(self.star_lists)-1):
- keep_orig = np.where(np.isnan(self.ref_table['x'][:,ii]))[0]
+ keep_orig = self.ref_table['ref_orig']
+ elif ii < (len(self.star_lists) - 1):
+ keep_orig = np.isnan(self.ref_table['x'][:,ii])
else:
keep_orig=None
self.update_ref_table_aggregates(keep_orig=keep_orig)
-
+
+ # Update ref list polygon
+ if self.starlist_vertices is not None:
+ self.reflist_polygon = shapely.make_valid(self.reflist_polygon.union(shapely.Polygon(self.starlist_vertices[ii])))
+
# Print out some metrics
if self.verbose > 0:
msg1 = ' {0:2s} (mean and std) for {1:10s}: {2:8.5f} +/- {3:8.5f}'
@@ -544,7 +708,7 @@ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_ar
# Calculate the residuals just for those used in the transformation
used = np.where(self.ref_table['used_in_trans'][:, ii] == True)[0]
used_good = used[ np.where(np.isin(used, idx_ref) == True)[0] ]
-
+
dr_u = np.hypot(self.ref_table['x'][used_good, ii] - ref_list['x'][used_good],
self.ref_table['y'][used_good, ii] - ref_list['y'][used_good])
dm_u = np.abs(self.ref_table['m'][used_good, ii] - ref_list['m'][used_good])
@@ -552,9 +716,9 @@ def match_and_transform(self, ref_mag_lim, dr_tol, dm_tol, outlier_tol, trans_ar
print(msg1.format('dm', 'trans stars', dm_u.mean(), dm_u.std()))
print(' Used {0:d} trans ref stars.'.format(len(used)))
print(' Dropped {0:d} matches after transform.'.format(len(used) - len(used_good)))
-
+ gc.collect() # clean up memory after each iteration
return
-
+
def setup_trans_info(self):
""" Setup transformation info into a usable format.
@@ -567,7 +731,7 @@ def setup_trans_info(self):
trans_args = self.trans_args
N_lists = len(self.star_lists)
iters = self.iters
-
+
trans_list = [None for ii in range(N_lists)]
if trans_input != None:
trans_list = [trans_input[ii] for ii in range(N_lists)]
@@ -583,20 +747,21 @@ def setup_trans_info(self):
# Add inverse trans list, if desired
if self.calc_trans_inverse:
- trans_list_inverse = [None for ii in range(N_lists)]
+ trans_list_inverse = [None] * N_lists
self.trans_list_inverse = trans_list_inverse
return
- def setup_ref_table_from_starlist(self, star_list, motion_model_used=None):
- """
+ def setup_ref_table_from_starlist(self, star_list):
+ """
Start with the reference list.... this will change and grow
over time, so make a copy that we will keep updating.
The reference table will contain one column for every named
array in the original reference star list.
"""
col_arrays = {}
- motion_model_col_names = motion_model.get_all_motion_model_param_names(with_errors=True, with_fixed=True) + ['m0','m0_err','use_in_trans', 'motion_model_input', 'motion_model_used']
+
+ motion_model_col_names = motion_model.all_motion_model_param_names(with_errors=True, with_fixed=True) + ['m0','m0_err','use_in_trans', 'motion_model_input', 'motion_model_used']
for col_name in star_list.colnames:
if col_name == 'name':
# The "name" column will be 1D; but we will also add a "name_in_list" column.
@@ -605,20 +770,20 @@ def setup_ref_table_from_starlist(self, star_list, motion_model_used=None):
else:
new_col_name = col_name
- # Make every column's 2D arrays except "name" and those
+ # Make every column's 2D arrays per star except "name" and those
# columns used for the motion model.
if col_name in motion_model_col_names:
col_arrays[new_col_name] = star_list[col_name].data
else:
- new_col_data = np.array([star_list[col_name].data]).T
+ new_col_data = star_list[col_name].data[:, None]
col_arrays[new_col_name] = new_col_data
# Use the columns from the ref list to make the ref_table.
ref_table = StarTable(**col_arrays)
-
+
# Make new columns to hold original values. These will be copies
# of the old columns and will only include x, y, m, xe, ye, me.
- # The columns we have already created will hold transformed values.
+ # The columns we have already created will hold transformed values.
trans_col_names = ['x', 'y', 'm', 'xe', 'ye', 'me', 'w']
for tt in range(len(trans_col_names)):
old_name = trans_col_names[tt]
@@ -630,19 +795,18 @@ def setup_ref_table_from_starlist(self, star_list, motion_model_used=None):
# Make sure ref_table has the necessary x0, y0, m0 and associated
# error columns. If they don't exist, then add them as a copy of
- # the original x,y,m etc columns.
+ # the original x,y,m etc columns.
new_cols_arr = ['x0', 'y0', 'm0']
orig_cols_arr = ['x', 'y', 'm']
ref_cols = ref_table.keys()
- for ii in range(len(new_cols_arr)):
- if not new_cols_arr[ii] in ref_cols:
+ for new_col, orig_col in zip(new_cols_arr, orig_cols_arr):
+ if new_col not in ref_cols:
# Some munging to convert data shape from (N,1) to (N,),
# since these are all 1D cols
- vals = np.transpose(np.array(ref_table[orig_cols_arr[ii]]))[0]
+ vals = np.array(ref_table[orig_col]).flatten()
# Now add to ref_table
- new_col = Column(vals, name=new_cols_arr[ii])
- ref_table.add_column(new_col)
+ ref_table.add_column(vals, name=new_col)
# Do the same thing for the x0e, y0e, m0e columns, but
# ONLY IF THEY ALREADY EXIST IN REF_TABLE! Otherwise,
@@ -651,64 +815,63 @@ def setup_ref_table_from_starlist(self, star_list, motion_model_used=None):
# work later on.
new_err_cols = ['x0_err', 'y0_err', 'm0_err']
orig_err_cols = ['xe', 'ye', 'me']
- for ii in range(len(new_err_cols)):
+ for new_err_col, orig_err_col in zip(new_err_cols, orig_err_cols):
# If the orig col name (e.g. xe) is in the ref_table, but the new col name
# (e.g. x0e) doesn't exist, then add the x0e column as a duplicate of xe.
- if (orig_err_cols[ii] in ref_cols) & (not new_err_cols[ii] in ref_cols):
+ if (orig_err_col in ref_cols) and (new_err_col not in ref_cols):
# Some munging to convert data shape from (N,1) to (N,),
# since these are all 1D cols
- vals = np.transpose(np.array(ref_table[orig_err_cols[ii]]))[0]
+ vals = np.transpose(np.array(ref_table[orig_err_col]))[0]
# Now add to ref_table
- new_col = Column(vals, name=new_err_cols[ii])
- ref_table.add_column(new_col)
- elif (not orig_err_cols[ii] in ref_cols) & (not new_err_cols[ii] in ref_cols):
+ ref_table.add_column(vals, name=new_err_col)
+ elif (orig_err_col not in ref_cols) and (new_err_col not in ref_cols):
# If neither the orig_err_col or new_err_col is in the ref_table, put in the
# new_err_cols as an array of zeros
vals = np.zeros(len(ref_table))
- new_col = Column(vals, name=new_err_cols[ii])
- ref_table.add_column(new_col)
+ ref_table.add_column(vals, name=new_err_col)
# Final check: ref_table should now have x0, y0, m0, x0e, y0e, and m0e columns
# This is necessary for later steps, even if the columns are just zeros.
final_new_cols = np.concatenate((new_cols_arr, new_err_cols))
for ii in final_new_cols:
- assert ii in ref_table.keys()
-
+ assert ii in ref_table.keys(), f"ref_table is missing necessary column {ii}."
+
# Make sure we have a column to indicate whether each star
# CAN BE USED in the transformation. This will be 1D
if 'use_in_trans' not in ref_table.colnames:
- new_col = Column(np.ones(len(ref_table), dtype=bool), name='use_in_trans')
- ref_table.add_column(new_col)
+ ref_table.add_column(np.ones(len(ref_table), dtype=bool), name='use_in_trans')
# Make sure we have a column to indicate whether each star
# IS USED in the transformation. This will be 2D
if 'used_in_trans' not in ref_table.colnames:
- new_col = Column(np.zeros([len(ref_table),1], dtype=bool), name='used_in_trans')
- ref_table.add_column(new_col)
-
+ ref_table.add_column(np.zeros([len(ref_table), 1], dtype=bool), name='used_in_trans')
+
# Keep track of whether this is an original reference star.
- col_ref_orig = Column(np.ones(len(ref_table), dtype=bool), name='ref_orig')
- ref_table.add_column(col_ref_orig)
+ ref_table.add_column(np.ones(len(ref_table), dtype=bool), name='ref_orig')
# Now reset the original values to invalids... they will be filled in
# at later times. Preserve content only in the columns: name, x0, y0, m0 (and 0e).
# Note that these are all the 1D columsn.
for col_name in ref_table.colnames:
if len(ref_table[col_name].data.shape) == 2: # Find the 2D columns
ref_table._set_invalid_list_values(col_name, -1)
-
+
if 'motion_model_input' not in ref_table.colnames:
- ref_table.add_column(Column(np.repeat(self.default_motion_model, len(ref_table)), name='motion_model_input'))
- if 'motion_model_used' not in ref_table.colnames:
- if motion_model_used is None:
- ref_table.add_column(Column(np.repeat(self.default_motion_model, len(ref_table)), name='motion_model_used'))
- else:
- ref_table.add_column(Column(np.repeat(motion_model_used, len(ref_table)), name='motion_model_used'))
+ ref_table.add_column(np.repeat(self.motion_models[-1].name, len(ref_table)), name='motion_model_input')
+ # FIXME: Why do we need to set motion_model_used here before fitting?
+ # if 'motion_model_used' not in ref_table.colnames:
+ # # Order self.motion_models by decreasing n_params
+ # sorted_mms = sorted(self.motion_models, key=lambda mm: mm.n_params, reverse=True)
+ # # Save the most complex motion model that can infer the positions with the existing columns.
+ # for mm in sorted_mms:
+ # if all([_ in ref_table.colnames for _ in mm.fit_param_names]) and all([_ in ref_table.colnames for _ in mm.fixed_param_names]):
+ # ref_table.add_column(np.repeat(mm.name, len(ref_table)), name='motion_model_used')
+ # break
return ref_table
def apply_mag_lim_via_use_in_trans(self, ref_list, ref_mag_lim):
- """Set the use_in_trans flag to False for any star in the
- star list that falls beyond the magnitude limits.
+ """Set the use_in_trans flag to False for any star in the
+ star list that falls beyond the magnitude limits.
This should really only be applied to reference star lists.
"""
@@ -719,21 +882,20 @@ def apply_mag_lim_via_use_in_trans(self, ref_list, ref_mag_lim):
else:
mcol = 'm'
- no_use = np.where((ref_list[mcol] < ref_mag_lim[0]) |
- (ref_list[mcol] >= ref_mag_lim[1]))
+ no_use = (ref_list[mcol] < ref_mag_lim[0]) | (ref_list[mcol] >= ref_mag_lim[1])
ref_list['use_in_trans'][no_use] = False
-
+
return
def outlier_rejection_indices(self, star_list, ref_list, outlier_tol, verbose=True):
"""
Determine the outliers based on the residual positions between two different
- starlists and some threshold (in sigma). Return the indices of the stars
- to keep (that shouldn't be rejected as outliers).
+ starlists and some threshold (in sigma). Return the indices of the stars
+ to keep (that shouldn't be rejected as outliers).
Note that we assume that the star_list and ref_list are already transformed and
- matched.
+ matched.
Parameters
----------
@@ -744,8 +906,8 @@ def outlier_rejection_indices(self, star_list, ref_list, outlier_tol, verbose=Tr
starlist with 'x0', 'y0'
outlier_tol : float
- Number of sigma inside which we keep stars and outside of which we
- reject stars as outliers.
+ Number of sigma inside which we keep stars and outside of which we
+ reject stars as outliers.
Optional Parameters
--------------------
@@ -753,8 +915,8 @@ def outlier_rejection_indices(self, star_list, ref_list, outlier_tol, verbose=Tr
Returns
----------
- keepers : nd.array
- The indicies of the stars to keep.
+ keepers : boolean array
+ The boolean array of the stars to keep.
"""
# Optionally propogate the reference positions forward in time.
xref = ref_list['x']
@@ -766,11 +928,11 @@ def outlier_rejection_indices(self, star_list, ref_list, outlier_tol, verbose=Tr
resid_on_old_trans = np.hypot(x_resid_on_old_trans, y_resid_on_old_trans)
threshold = outlier_tol * resid_on_old_trans.std()
- keepers = np.where(resid_on_old_trans < threshold)[0]
+ keepers = resid_on_old_trans < threshold
if verbose:
msg = ' Outlier Rejection: Keeping {0:d} of {1:d}'
- print(msg.format(len(keepers), len(resid_on_old_trans)))
+ print(msg.format(sum(keepers), len(resid_on_old_trans)))
return keepers
@@ -779,7 +941,7 @@ def update_ref_table_from_list(self, star_list, star_list_T, ii, idx_ref, idx_li
Inputs
----------
star_list : StarList
- The original star list.
+ The original star list.
star_list_T : StarList
The original star list now transformed into the reference coordinate system.
@@ -794,7 +956,7 @@ def update_ref_table_from_list(self, star_list, star_list_T, ii, idx_ref, idx_li
The indices of the matched targets in the origin starlist (epoch).
idx_ref_in_trans : np.array dtype=int
- The indices in the reference table (self.ref_table).
+ The indices in the reference table (self.ref_table).
"""
### Update the reference table for matched stars.
# Add the matched stars to the reference table.
@@ -802,94 +964,135 @@ def update_ref_table_from_list(self, star_list, star_list_T, ii, idx_ref, idx_li
if ((self.ref_table['x'].shape[1] != len(self.star_lists)) and
(ii != self.ref_index) and
(ii >= self.ref_table['x'].shape[1])):
-
+
self.ref_table.add_starlist()
-
+
copy_over_values(self.ref_table, star_list, star_list_T, ii, idx_ref, idx_lis)
self.ref_table['used_in_trans'][idx_ref_in_trans, ii] = True
### Add the unmatched stars and grow the size of the reference table.
- self.ref_table, idx_lis_new, idx_ref_new = add_rows_for_new_stars(self.ref_table, star_list, idx_lis,
- default_motion_model=self.default_motion_model)
+ self.ref_table, idx_lis_new, idx_ref_new = add_rows_for_new_stars(
+ self.ref_table,
+ star_list,
+ idx_lis,
+ # motion_model_name=self.motion_model_for_new_star.name
+ motion_model_name=self.motion_models[-1].name,
+ fixed_params_dict=self.fixed_params_dict
+ )
+
if len(idx_ref_new) > 0:
if self.verbose > 0:
print(' Adding {0:d} new stars to the reference table.'.format(len(idx_ref_new)))
-
+
copy_over_values(self.ref_table, star_list, star_list_T, ii, idx_ref_new, idx_lis_new)
# Copy the single-epoch values to the aggregate (only for new stars).
self.ref_table['x0'][idx_ref_new] = star_list_T['x'][idx_lis_new]
self.ref_table['y0'][idx_ref_new] = star_list_T['y'][idx_lis_new]
self.ref_table['m0'][idx_ref_new] = star_list_T['m'][idx_lis_new]
-
+
self.ref_table['name'] = update_old_and_new_names(self.ref_table, ii, idx_ref_new)
if self.use_ref_new == True:
self.ref_table['use_in_trans'][idx_ref_new] = True
else:
self.ref_table['use_in_trans'][idx_ref_new] = False
-
+
return
-
- def update_ref_table_aggregates(self, keep_orig=None, n_boot=0):
- """
- Average positions or fit velocities.
+
+ def update_ref_table_aggregates(self, keep_orig=None, n_boot=0, seed=None):
+ """ Average positions or fit velocities.
Average magnitudes.
Calculate bootstrap errors if desired.
- Update the use_in_trans values as needed. TODO: ????
+ Update the use_in_trans values as needed. TODO: ????.
Updates aggregate columns in self.ref_table in place.
+
+
+ Parameters
+ ----------
+ keep_orig : array-like of bool, optional
+ Boolean array indicating which stars to keep original values for, by default None
+ n_boot : int, optional
+ Number of bootstrap iterations, by default 0
+ seed : int, optional
+ Random seed for reproducible bootstrap results, by default None
+
"""
# Keep track of the original reference values.
# In certain cases, we will NOT update these.
- if keep_orig is not None:
+ if (keep_orig is not None) and (sum(keep_orig) > 0):
vals_orig = {}
vals_orig['m0'] = self.ref_table['m0'][keep_orig]
vals_orig['m0_err'] = self.ref_table['m0_err'][keep_orig]
- motion_model_class_names = self.ref_table['motion_model_input'].tolist()
+ # Collect all motion model parameter names
+ motion_model_class_names = []
+ if 'motion_model_input' in self.ref_table.keys():
+ motion_model_class_names += self.ref_table['motion_model_input'].tolist()
if 'motion_model_used' in self.ref_table.keys():
motion_model_class_names += self.ref_table['motion_model_used'][keep_orig].tolist()
vals_orig['motion_model_used'] = self.ref_table['motion_model_used'][keep_orig]
- motion_model_col_names = motion_model.get_list_motion_model_param_names(motion_model_class_names, with_errors=True, with_fixed=True)
+ vals_orig['n_params'] = self.ref_table['n_params'][keep_orig]
+ # vals_orig['n_fit'] = self.ref_table['n_fit'][keep_orig]
+ motion_model_col_names = motion_model.motion_model_param_names(motion_model_class_names, with_errors=True, with_fixed=True)
for mm in motion_model_col_names:
- if mm in self.ref_table.keys():
+ if f'{mm}_mm' in self.ref_table.keys():
+ vals_orig[mm] = self.ref_table[mm][keep_orig]
+ elif mm in self.ref_table.keys():
vals_orig[mm] = self.ref_table[mm][keep_orig]
- fit_star_idxs = [idx for idx in range(len(self.ref_table)) if idx not in keep_orig]
+ fit_star_idxs = ~keep_orig
else:
fit_star_idxs = None
- #pdb.set_trace()
- # Figure out whether motion fits are necessary
- all_fixed = np.all(self.ref_table['motion_model_input']=='Fixed')
- if all_fixed:
+
+ if ('motion_model_input' in self.ref_table.keys()) and np.all(self.ref_table['motion_model_input']=='Fixed'):
+ # self.ref_table.fit_motion_models(
+ # motion_models=['Fixed'],
+ # weighting=self.vel_weighting,
+ # use_scipy=self.use_scipy,
+ # absolute_sigma=self.absolute_sigma,
+ # verbose=self.verbose
+ # )
weighted_xy = ('xe' in self.ref_table.colnames) and ('ye' in self.ref_table.colnames)
weighted_m = ('me' in self.ref_table.colnames)
self.ref_table.combine_lists_xym(weighted_xy=weighted_xy, weighted_m=weighted_m)
else:
- # Combine positions with a velocity fit.
- self.ref_table.fit_velocities(bootstrap=n_boot,
- verbose=self.verbose,
- show_progress=(self.verbose>0),
- default_motion_model=self.default_motion_model,
- select_stars=fit_star_idxs,
- motion_model_dict=self.motion_model_dict,
- weighting=self.vel_weights,
- use_scipy=self.use_scipy,
- absolute_sigma=self.absolute_sigma)
-
+ self.ref_table.fit_motion_models(
+ motion_models=self.motion_models,
+ fixed_params_dict=self.fixed_params_dict,
+ weighting=self.vel_weighting,
+ use_scipy=self.use_scipy,
+ absolute_sigma=self.absolute_sigma,
+ select_stars=fit_star_idxs,
+ bootstrap=n_boot,
+ seed=seed,
+ verbose=self.verbose
+ )
# Combine (transformed) magnitudes
if 'me' in self.ref_table.colnames:
weights_col = None
else:
weights_col = 'me'
self.ref_table.combine_lists('m', weights_col=weights_col, ismag=True)
+
+ # if (keep_orig is not None) and (sum(keep_orig) > 0):
+ # Determine motion_model_used for keep_orig stars
+ # Filter possible motion models based on available columns
+ motion_model_used, n_params = determine_motion_model(self.ref_table, self.motion_models, self.fixed_params_dict)
+
+ # Assign the determined motion models
+ # self.ref_table['motion_model_used'][keep_orig] = motion_model_used
+ self.ref_table['motion_model_used'] = Column(motion_model_used, name='motion_model_used', dtype='U20')
+ # self.ref_table['n_fit'] = Column(n_params, name='n_fit', dtype=int)
+ self.ref_table['n_params'] = Column(n_params, name='n_params', dtype=int)
+
# Replace the originals if we are supposed to keep them fixed.
- if keep_orig is not None:
+ if (keep_orig is not None) and (sum(keep_orig) > 0):
for val in vals_orig.keys():
self.ref_table[val][keep_orig] = vals_orig[val]
return
-
+
def get_weights_for_lists(self, ref_list, star_list):
if 'xe' in ref_list.colnames:
var_xref = ref_list['xe']**2
@@ -897,7 +1100,7 @@ def get_weights_for_lists(self, ref_list, star_list):
else:
var_xref = 0.0
var_yref = 0.0
-
+
if 'xe' in star_list.colnames:
var_xlis = star_list['xe']**2
var_ylis = star_list['ye']**2
@@ -905,19 +1108,19 @@ def get_weights_for_lists(self, ref_list, star_list):
var_xlis = 0.0
var_ylis = 0.0
- if self.trans_weights != None:
- if self.trans_weights == 'both,var':
+ if self.trans_weighting != None:
+ if self.trans_weighting == 'both,var':
weight = 1.0 / (var_xref + var_xlis + var_yref + var_ylis)
- if self.trans_weights == 'both,std':
+ if self.trans_weighting == 'both,std':
weight = 1.0 / np.sqrt(var_xref + var_xlis + var_yref + var_ylis)
- if self.trans_weights == 'ref,var':
+ if self.trans_weighting == 'ref,var':
weight = 1.0 / (var_xref + var_yref)
- if self.trans_weights == 'ref,std':
+ if self.trans_weighting == 'ref,std':
weight = 1.0 / np.sqrt(var_xref + var_yref)
- if self.trans_weights == 'list,var':
+ if self.trans_weighting == 'list,var':
weight = 1.0 / (var_xlis + var_ylis)
- if self.trans_weights == 'list,std':
- weight = 1.0 / np.sqrt(var_xlis, var_ylis)
+ if self.trans_weighting == 'list,std':
+ weight = 1.0 / np.sqrt(var_xlis + var_ylis)
else:
weight = None
@@ -936,16 +1139,20 @@ def get_weights_for_lists(self, ref_list, star_list):
# Fix bad weights:
weight[bad] = 0.0
+ if weight is not None and np.all(weight == 0.0):
+ # Catch the case where all weights were bad.
+ weight = None
+
return weight
-
+
def match_lists(self, dr_tol, dm_tol):
"""
Using the existing trans objects, match all the starlists to the
- reference starlist (self.ref_table), propogated to the appropriate epoch.
+ reference starlist (self.ref_table), propogated to the appropriate epoch.
No trimming of stars.
- No new transformations derived.
+ No new transformations derived.
The resulting matched values will be used to update self.ref_table
"""
@@ -957,16 +1164,16 @@ def match_lists(self, dr_tol, dm_tol):
star_list_T.transform_xym(self.trans_list[ii])
else:
star_list_T.transform_xy(self.trans_list[ii])
-
- xref, yref = get_pos_at_time(star_list_T['t'][0], self.ref_table, self.motion_model_dict)
+
+ xref, yref = infer_positions(star_list_T['t'][0], self.ref_table, self.motion_models, self.fixed_params_dict)
mref = self.ref_table['m0']
idx_lis, idx_ref, dr, dm = match.match(star_list_T['x'], star_list_T['y'], star_list_T['m'],
xref, yref, mref,
dr_tol=dr_tol, dm_tol=dm_tol, verbose=self.verbose)
-
+
if self.verbose > 0:
- fmt = 'Matched {0:5d} out of {1:5d} stars in list {2:2d} [dr = {3:7.4f} +/- {4:6.4f}, dm = {5:5.2f} +/- {6:4.2f}'
+ fmt = 'Matched {0:5d} out of {1:5d} stars in list {2:2d} [dr = {3:7.4f} ± {4:6.4f}, dm = {5:5.2f} ± {6:4.2f}]'
print(fmt.format(len(idx_lis), len(star_list_T), ii, dr.mean(), dr.std(), dm.mean(), dm.std()))
copy_over_values(self.ref_table, self.star_lists[ii], star_list_T, ii, idx_ref, idx_lis)
@@ -976,7 +1183,7 @@ def match_lists(self, dr_tol, dm_tol):
def get_ref_list_from_table(self, epoch):
"""
Convert the averaged quantites in self.ref_table into a StarList object
- appropriate for the specified epoch.
+ appropriate for the specified epoch.
Columns in resulting reference list will include:
name
@@ -988,25 +1195,20 @@ def get_ref_list_from_table(self, epoch):
me (optional)
use_in_trans (optional)
"""
- # Reference stars will be named.
+ # Reference stars will be named.
name = self.ref_table['name']
+ # Calculate x, y, xe, ye
- if ('motion_model_used' in self.ref_table.colnames):
- x,y,xe,ye = self.ref_table.get_star_positions_at_time(epoch, self.motion_model_dict, allow_alt_models=True)
- else:
- # No velocities... just used average positions.
- x = self.ref_table['x0']
- y = self.ref_table['y0']
-
- if 'x0_err' in self.ref_table.colnames:
- xe = self.ref_table['x0_err']
- ye = self.ref_table['y0_err']
- else:
- xe = None
- ye = None
+ if 'motion_model_used' not in self.ref_table.colnames:
+ motion_model_used, n_params = determine_motion_model(self.ref_table, self.motion_models, self.fixed_params_dict)
+ self.ref_table['motion_model_used'] = Column(motion_model_used, name='motion_model_used', dtype='U20')
+ # self.ref_table['n_fit'] = Column(n_params, name='n_fit', dtype=int)
+ self.ref_table['n_params'] = Column(n_params, name='n_params', dtype=int)
+
+ x, y, xe, ye = self.ref_table.infer_positions(epoch, fixed_params_dict=self.fixed_params_dict)
m = self.ref_table['m0']
-
+
if 'm0_err' in self.ref_table.colnames:
me = self.ref_table['m0_err']
else:
@@ -1036,32 +1238,32 @@ def reset_ref_values(self, exclude=None):
"""
Reset all the 2D arrays in the reference table. This is the action
we take at the beginning of each new iteration. We don't preserve matching
- results from the prior iterations.
+ results from the prior iterations.
"""
# All 2D columns should be reset.
for col_name in self.ref_table.colnames:
if (exclude != None) and (col_name in exclude):
continue
-
+
if len(self.ref_table[col_name].data.shape) == 2: # Find the 2D columns
# Loop through epochs for this array.
for cc in range(self.ref_table[col_name].shape[1]):
self.ref_table._set_invalid_list_values(col_name, cc)
return
-
- def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_bootstrap=True, weighting='var', use_scipy=True, absolute_sigma=False, show_progress=True, update_errors=False):
+
+ def calc_bootstrap_errors(self, n_boot=100, seed=None, boot_epochs_min=-1, calc_vel_in_bootstrap=True, update_errors=False, verbose=True):
"""
Function to calculate bootstrap errors for the transformations as well
as the proper motions. For each iteration, this will:
- 1) Draw full-size bootstrap w/replacement sample from reference stars in
+ 1) Draw full-size bootstrap w/replacement sample from reference stars in
ref_table and re-calculate the transformations for each epoch
2) Apply transformation to all stars in each epoch
- If calc_vel_in_bootstraps:
+ If calc_vel_in_bootstrap:
3) For each star, draw full-size boostrap sample w/replacement from epochs
4) Calculate proper motion for each star using resampled epochs
-
+
The saved outputs will be: x_trans, y_trans, m_trans (transformed postions/mags),
as well as the proper motion fit parameters.
@@ -1075,46 +1277,45 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
MosaicToRef object after the complete match_and_transform process
n_boot: int, must be greater than 0
- Number of bootstrap iterations when calculating transformations and the proper motion.
+ Number of bootstrap iterations when calculating transformations and the proper motion.
PM bootstrap is only done for final proper motion
calculation (e.g., not for each iteration of the starlist for matching)
+ seed: int, optional
+ Random seed for reproducible bootstrap results.
+
boot_epochs_min: int or -1
- In order to be included in bootstrap analysis, non-reference stars must be detected in
- at least boot_epochs_min epochs. If boot_epochs_min = -1, then all stars will
+ In order to be included in bootstrap analysis, non-reference stars must be detected in
+ at least boot_epochs_min epochs. If boot_epochs_min = -1, then all stars will
be included in the analysis, regardless of the number of epochs detected.
For stars that fail boot_epochs_min criteria, np.nan is used
calc_vel_in_bootstrap: boolean
- If true, do bootstrap sample w/ replacement over the epochs and calculate
+ If true, do bootstrap sample w/ replacement over the epochs and calculate
stellar proper motions, as well as the bootstrap over reference stars
- to calculate positional alignment errors. If false, only
+ to calculate positional alignment errors. If false, only
calculate position alignment errors.
-
- weighting: str
- 'var' or 'std' weighting for velocity fitting, by default 'var'. If 'var', use the variance of the residuals to weight the fit.
- If 'std', use the standard deviation of the residuals to weight the fit.
-
- absolute_sigma: boolean
- If True, use the absolute sigma in the velocity fitting. If False, use the relative sigma, by default False.
-
+
update_errors: boolean
If True, save the starlist errors as xe_list, bootstrap errors as xe_boot, and their quad sum as xe (and likewise for ye and me). If False (default), leave the starlist errors in place as xe and bootstrap errors as xe_boot.
-
+
+ verbose: boolean
+ Print verbose information or not, by default True
+
Output:
------
New columns will be added to self.ref_table:
'xe_boot', 2D column: bootstrap x pos uncertainties due to transformation for each epoch
'ye_boot', 2D column: bootstrap y pos uncertainties due to transformation for each epoch
'me_boot', 2D column: bootstrap mag uncertainties due to transformation for each epoch
-
+
If calc_vel_in_bootstrap:
'_err_boot', 1D column: bootstrap uncertainties in for motion model fit
For stars that fail boot_epochs_min criteria, np.nan is used
"""
# First, assert than n_boot > 0
- assert n_boot > 0
+ assert n_boot > 0, f'{n_boot=} is not possive!'
ref_table = copy.deepcopy(self.ref_table)
n_epochs = len(ref_table['x'][0])
@@ -1130,9 +1331,9 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
t0_arr = t0_arr[idx_good]
else:
idx_good = np.arange(0, len(ref_table), 1)
-
+
#idx_ref = np.where(ref_table['use_in_trans'] == True)
-
+
# Initialize sums for output
x_boot_sum = np.zeros((len(ref_table['x']), n_epochs))
x2_boot_sum = np.zeros((len(ref_table['x']), n_epochs))
@@ -1140,34 +1341,41 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
y2_boot_sum = np.zeros((len(ref_table['x']), n_epochs))
m_boot_sum = np.zeros((len(ref_table['x']), n_epochs))
m2_boot_sum = np.zeros((len(ref_table['x']), n_epochs))
-
+
# Set up motion model parameters
- motion_model_list = ['Fixed', self.default_motion_model]
if 'motion_model_used' in ref_table.keys():
- motion_model_list += ref_table['motion_model_used'].tolist()
+ motion_model_list = np.unique(ref_table['motion_model_used']).tolist()
elif 'motion_model_input' in ref_table.keys():
- motion_model_list += ref_table['motion_model_input'].tolist()
- motion_col_list = motion_model.get_list_motion_model_param_names(np.unique(motion_model_list).tolist(), with_errors=False, with_fixed=False)
+ motion_model_list = np.unique(ref_table['motion_model_input']).tolist()
+
+ if 'Empty' not in motion_model_list:
+ motion_model_list.append('Empty')
+ if 'Fixed' not in motion_model_list:
+ motion_model_list.append('Fixed')
+
+ motion_col_list = motion_model.motion_model_param_names(motion_model_list, with_errors=False, with_fixed=False)
if calc_vel_in_bootstrap:
motion_boot_sum = {}
motion2_boot_sum = {}
for col in motion_col_list:
motion_boot_sum[col] = np.zeros((len(ref_table['x'])))
motion2_boot_sum[col] = np.zeros((len(ref_table['x'])))
- motion_boot_min_epochs = np.max([self.motion_model_dict[mod].n_pts_req
- for mod in np.unique(motion_model_list)])
+
+ all_mm_map = motion_model.motion_model_map()
+ motion_model_list = [all_mm_map[mm_name] for mm_name in motion_model_list]
+ motion_boot_min_epochs = np.max([mm.n_params for mm in motion_model_list])
### IF MEMORY PROBLEMS HERE:
### DEFINE MEAN, STD VARIABLES AND BUILD THEM RATHER THAN SAVING FULL ARRAY
### DECREASE PRECISION ON ARRAYS (32 bit instead of 64: dtype=np.float32)
### AT SOME POINT, NEED TO CONVERT BACK (LOOK UP HOW TO DO THIS CAREFULLY)
- t1 = time.time()
- for ii in range(n_boot):
+ rng = np.random.default_rng(seed)
+ for ii in tqdm(range(n_boot), desc='Bootstrap iterations', disable=not verbose):
# Recalculate transformations using bootstrap sample of
# reference stars. Use a loop for each epoch here, so we
# can handle case where different reference stars are used
# in different epochs
-
+
# Initialize data arrays
x_trans_arr = np.ones((len(ref_table['x']), n_epochs)) * -999
y_trans_arr = np.ones((len(ref_table['x']), n_epochs)) * -999
@@ -1175,13 +1383,13 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
xe_trans_arr = np.ones((len(ref_table['x']), n_epochs)) * -999
ye_trans_arr = np.ones((len(ref_table['x']), n_epochs)) * -999
me_trans_arr = np.ones((len(ref_table['x']), n_epochs)) * -999
-
+
for jj in range(n_epochs):
# Extract bootstrap sample of matched reference stars for this epoch
#good = np.where(~np.isnan(ref_table['x_orig'][idx_ref][:,jj]))
good = np.where( (ref_table['used_in_trans'][:,jj] == True) & (~np.isnan(ref_table['x_orig'][:,jj])) )
- samp_idx = np.random.choice(good[0], len(good[0]), replace=True)
-
+ samp_idx = rng.choice(good[0], len(good[0]), replace=True)
+
# Get reference star positions in particular epoch from ref_list.
t_epoch = t_arr[jj]
ref_orig = self.get_ref_list_from_table(t_epoch)[idx_good]
@@ -1215,10 +1423,10 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
# Sanity check: makes sure names match between ref_boot and starlist_boot,
# since they need to line up
assert np.all(ref_boot['name'] == starlist_boot['name'])
-
+
# Calculate weights based on weights keyword. If weights desired, will need to
# make starlist objects for this
- if self.trans_weights != None:
+ if self.trans_weighting != None:
# In order for weights calculation to work, we need to apply a transformation
# to the star_list_T so it is in the same units as ref_boot. So, we'll apply
# the final transformation for the epoch to get close enough for the
@@ -1228,11 +1436,11 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
starlist_boot_T.transform_xym(self.trans_list[jj])
else:
starlist_boot_T.transform_xy(self.trans_list[jj])
-
+
weight = self.get_weights_for_lists(ref_boot, starlist_boot_T)
else:
weight = None
-
+
# Recalculate transformation
trans = self.trans_class.derive_transform(starlist_boot['x'], starlist_boot['y'],
ref_boot['x'], ref_boot['y'],
@@ -1240,7 +1448,6 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
m=starlist_boot['m'], mref=ref_boot['m'],
weights=weight, mag_trans=self.mag_trans)
#print(jj)
- #pdb.set_trace()
# Apply transformation to *all* orig positions in this epoch. Need to make a new
# FLYSTAR starlist object with the original positions for this. We don't
@@ -1257,7 +1464,7 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
starlist_T.transform_xym(trans)
else:
starlist_T.transform_xy(trans)
-
+
# Add output to pos arrays
x_trans_arr[:,jj] = starlist_T['x']
y_trans_arr[:,jj] = starlist_T['y']
@@ -1265,7 +1472,7 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
xe_trans_arr[:,jj] = starlist_T['xe']
ye_trans_arr[:,jj] = starlist_T['ye']
me_trans_arr[:,jj] = starlist_T['me']
-
+
x_boot_sum += x_trans_arr
x2_boot_sum += x_trans_arr**2
y_boot_sum += y_trans_arr
@@ -1273,21 +1480,21 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
if self.mag_trans:
m_boot_sum += m_trans_arr
m2_boot_sum += m_trans_arr**2
-
- t2 = time.time()
+
+ # t2 = time.time()
#print('=================================================')
#print('Time to do {0} epochs: {1}s'.format(n_epochs, t2-t1))
#print('=================================================')
-
+
# Finally, calculate proper motions for this bootstrap iteration
# for each star, if desired. Draw a full-sample bootstrap over the epochs
# for each star, and then run it through the startable fit_velocities machinery
if calc_vel_in_bootstrap:
- boot_idx = np.random.choice(np.arange(0, n_epochs, 1), size=n_epochs)
+ boot_idx = rng.choice(np.arange(0, n_epochs, 1), size=n_epochs)
while len(np.unique(boot_idx)) < motion_boot_min_epochs:
- boot_idx = np.random.choice(np.arange(0, n_epochs, 1), size=n_epochs)
+ boot_idx = rng.choice(np.arange(0, n_epochs, 1), size=n_epochs)
t_boot = t_arr[boot_idx]
-
+
star_table = StarTable(name=ref_table['name'],
x=x_trans_arr[:,boot_idx],
y=y_trans_arr[:,boot_idx],
@@ -1301,12 +1508,19 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
# Now, do proper motion calculation, making sure to fix t0 to the
# orig value (so we can get a reasonable error on x0, y0)
- star_table.fit_velocities(
- fixed_t0=t0_arr,
- default_motion_model=self.default_motion_model,
- motion_model_dict=self.motion_model_dict,
+ if self.fixed_params_dict is None:
+ fixed_params_dict = {'t0': t0_arr}
+ elif 't0' not in self.fixed_params_dict.keys():
+ fixed_params_dict = self.fixed_params_dict.copy()
+ fixed_params_dict['t0'] = t0_arr
+
+ star_table.fit_motion_models(
+ motion_models=self.motion_models,
+ fixed_params_dict=fixed_params_dict,
+ weighting=self.vel_weighting,
use_scipy=self.use_scipy,
- absolute_sigma=self.absolute_sigma
+ absolute_sigma=self.absolute_sigma,
+ verbose=self.verbose
)
# Save proper motion fit results to output arrays
@@ -1316,7 +1530,7 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
# Quick check to make sure bootstrap calc was valid: output t0 should be
# same as input t0_arr, since we used fixed_t0 option
- assert np.sum(abs(star_table['t0'] - t0_arr) == 0)
+ np.testing.assert_array_equal(star_table['t0'], t0_arr)
#t3 = time.time()
#print('=================================================')
@@ -1347,43 +1561,59 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
data_dict = {'xe_boot': x_err_b, 'ye_boot': y_err_b, 'me_boot': m_err_b}
for col in motion_col_list:
data_dict[col+'_err_boot'] = motion_data_err[col]
-
+
for ff in col_heads_2D:
col = Column(np.ones((len(self.ref_table), n_epochs)), name=ff)
col.fill(np.nan)
-
+
col[idx_good] = data_dict[ff]
self.ref_table.add_column(col)
-
- # Calculate chi^2 with bootstrap positional errors
- x_pred, y_pred, _, _ = self.ref_table.get_star_positions_at_time(t_arr, self.motion_model_dict, allow_alt_models=True)
+
+ # # Calculate chi^2 with bootstrap positional errors
+ # # Determine which motion model to use:
+ # motion_model_list = sorted(motion_model_list, key=lambda mm: mm.n_params)
+ # mm_n_params = np.sort([mm.n_params for mm in motion_model_list])
+
+ # required_params = [all_mm_map[mm_name].n_params for mm_name in self.ref_table['motion_model_input']]
+ # mm_digitized = np.digitize(
+ # x=np.minimum(np.array(self.ref_table['n_detect']), required_params),
+ # bins=mm_n_params
+ # ) - 1
+ # self.ref_table['motion_model_used'] = np.array([motion_model_list[d].name for d in mm_digitized], dtype='U20')
+
+
+ x_pred, y_pred, _, _ = self.ref_table.infer_positions(t_arr, fixed_params_dict=self.fixed_params_dict)
+ if np.ndim(x_pred) == 1:
+ x_pred = x_pred[:, np.newaxis]
+ if np.ndim(y_pred) == 1:
+ y_pred = y_pred[:, np.newaxis]
xe_comb = np.hypot(self.ref_table['xe'], self.ref_table['xe_boot'])
ye_comb = np.hypot(self.ref_table['ye'], self.ref_table['ye_boot'])
- data_dict['chi2_x_boot'] = np.nansum((self.ref_table['x']-x_pred)**2/(xe_comb)**2,axis=1)
- data_dict['chi2_y_boot'] = np.nansum((self.ref_table['y']-y_pred)**2/(ye_comb)**2,axis=1)
+ data_dict['chi2_x_boot'] = np.nansum((self.ref_table['x'] - x_pred)**2 / xe_comb**2, axis=1)
+ data_dict['chi2_y_boot'] = np.nansum((self.ref_table['y'] - y_pred)**2 / ye_comb**2, axis=1)
for ff in ['chi2_x_boot', 'chi2_y_boot']:
col = Column(np.ones(len(self.ref_table)), name=ff)
col.fill(np.nan)
-
+
col[idx_good] = data_dict[ff][idx_good]
self.ref_table.add_column(col)
# Now handle the velocities, if they were calculated
if calc_vel_in_bootstrap:
col_heads_1D = [col+'_err_boot' for col in motion_col_list]
-
+
for ff in col_heads_1D:
col = Column(np.ones(len(self.ref_table)), name=ff)
col.fill(np.nan)
-
+
col[idx_good] = data_dict[ff]
self.ref_table.add_column(col)
- #pdb.set_trace()
-
- print('===============================')
- print('Done with bootstrap')
- print('===============================')
-
+
+ if verbose:
+ print('===================================')
+ print('======= Done with bootstrap =======')
+ print('===================================')
+
if update_errors:
self.ref_table['xe_list'] = self.ref_table['xe']
self.ref_table['ye_list'] = self.ref_table['ye']
@@ -1394,37 +1624,62 @@ def calc_bootstrap_errors(self, n_boot=100, boot_epochs_min=-1, calc_vel_in_boot
print("Saved starlist errors to xe_list and added xe_boot to xe in quadrature.")
print("The same was done for ye and me.")
-
+ if self.save_path is not None:
+ with open(os.path.join(self.save_path, self.prefix_name+'_bootstrap.pkl'), 'wb') as file:
+ pickle.dump(self, file)
+ with open(os.path.join(self.save_path, self.prefix_name+'_ref_table_bootstrap.pkl'), 'wb') as file:
+ pickle.dump(self.ref_table, file)
+
return
-
+
class MosaicToRef(MosaicSelfRef):
- def __init__(self, ref_list, list_of_starlists, iters=2,
- dr_tol=[1, 1], dm_tol=[2, 1],
- outlier_tol=[None, None],
- trans_args=[{'order': 2}, {'order': 2}],
- init_order=1,
- mag_trans=True, mag_lim=None, ref_mag_lim=None,
- trans_weights=None, vel_weights='var',
- trans_input=None,
- trans_class=transforms.PolyTransform,
- calc_trans_inverse=False,
- use_ref_new=False,
- update_ref_orig=False,
- init_guess_mode='miracle',
- iter_callback=None,
- default_motion_model='Fixed',
- motion_model_dict={},
- use_scipy=True,
- absolute_sigma=False,
- save_path=None,
- verbose=True):
+ def __init__(
+ self,
+ ref_list,
+ list_of_starlists,
+ reflist_vertex=None,
+ starlist_vertices=None,
+ # Alignment parameters
+ iters=2,
+ dr_tol=[1, 1],
+ dm_tol=[2, 1],
+ outlier_tol=None,
+ # Reference behavior (MosiacToRef specific)
+ use_ref_new=False,
+ update_ref_orig=False,
+ # Transformation parameters
+ trans_class=transforms.PolyTransform,
+ trans_args=[{'order': 2}, {'order': 2}],
+ trans_input=None,
+ trans_weighting=None,
+ init_order=1,
+ init_guess_mode='miracle',
+ briteN=None,
+ calc_trans_inverse=False,
+ # Magnitude parameters
+ mag_trans=True,
+ mag_lim=None,
+ ref_mag_lim=None,
+ # Motion model parameters
+ motion_models=['Empty', 'Fixed'],
+ # motion_model_for_new_star=None,
+ fixed_params_dict=None,
+ vel_weighting='var',
+ use_scipy=True,
+ absolute_sigma=False,
+ # Advanced options
+ iter_callback=None,
+ save_path=None,
+ prefix_name='mtr',
+ verbose=True
+ ):
"""
Required Parameters
- ----------
+ -------------------
ref_list : StarList object
- Can optionally have velocities. All starlists will be aligned to this one.
+ Can optionally have velocities. All starlists will be aligned to this one.
list_of_starlists : array of StarList objects
An array or list of flystar.starlists.StarList objects (which are Astropy Tables).
@@ -1433,20 +1688,28 @@ def __init__(self, ref_list, list_of_starlists, iters=2,
Note that there is an optional weights column called 'w'. If this column exists
in any of the lists, it will be queried to determine if an individual star can be
used to derive the transformations between starlists. This is the most flexible way
- to allow you to determine, as a function of time and star, which ones are good enough
- in the transformation. Note that just because it can be used (i.e. w_in=1),
- doesn't meant that it will be used. The mag limits and outliers still take precedence.
- Note also that the weights that go into the transformation are
+ to allow you to determine, as a function of time and star, which ones are good enough
+ in the transformation. Note that just because it can be used (i.e. w_in=1),
+ doesn't meant that it will be used. The mag limits and outliers still take precedence.
+ Note also that the weights that go into the transformation are
star_list['w'] * ref_list['w'] * weight_from_keyword (see the weights parameter)
- for those stars not trimmed out by the other criteria.
+ for those stars not trimmed out by the other criteria.
Optional Parameters
----------
+ reflist_vertex : array
+ An array of polygon vertices coordinates for the reference starlist. Initial guess will only use stars in overlapping regions defined by these polygons.
+ Shape of (N_vertices, 2) in the format of [[x1, y1], [x2, y2], ..., [xN, yN]] for the reference starlist, by default None
+
+ starlist_vertices : list or array
+ A list or array of polygon vertices coordinates for each starlist. Initial guess will only use stars in overlapping regions defined by these polygons.
+ Shape of (N_lists, N_vertices, 2) in the format of [[x1, y1], [x2, y2], ..., [xN, yN]] for each starlist, by default None
+
iters : int
- The number of iterations used in the matching and transformation. TO DO: INNER/OUTER?
+ The number of iterations used in the matching and transformation. TO DO: INNER/OUTER?
dr_tol : list or array
The delta-radius (dr) tolerance for matching in units of the reference coordinate system.
@@ -1454,100 +1717,103 @@ def __init__(self, ref_list, list_of_starlists, iters=2,
dm_tol : list or array
The delta-magnitude (dm) tolerance for matching in units of the reference coordinate system.
- This is a list of dm values, one for each iteration of matching/transformation.
+ This is a list of dm values, one for each iteration of matching/transformation.
outlier_tol : list or array
- The outlier tolerance (in units of sigma) for rejecting outlier stars.
+ The outlier tolerance (in units of sigma) for rejecting outlier stars.
This is a list of tol values, one for each iteration of matching/transformation.
- mag_trans : boolean
- If true, this will also calculate and (temporarily) apply a zeropoint offset to
- magnitudes in each list to bring them into a common magnitude system. This is
- essential for matching (with finite dm_tol) starlists of different filters or
- starlists that are not photometrically calibrated. Note that the final_table columns
- of 'm', 'm0', and 'm0_err' will contain the transformed magnitudes while the
- final_table column 'm_orig' will contain the original un-transformed magnitudes.
- If mag_trans = False, then no such zeropoint offset it applied at any point.
-
- mag_lim : array
- If different from None, it indicates the minimum and maximum magnitude
- on the catalogs for finding the transformations. Note, if you want specify the mag_lim
- separately for each list and each iteration, you need to pass in a 2D array that
- has shape (N_lists, 2).
+ use_ref_new : boolean
+ Each pass, new stars are matched and added to the ref_table. However, we don't
+ necessarily want to use these in the reference frame in subsequent passes.
+ If True, then the new stars will be used in later passes/iterations.
+ If False, then the new stars will be carried, but not used in the transformation.
+ We determine which stars to use through setting a boolean use_in_trans flag.
- ref_mag_lim : array
- If different from None, it indicates the minimum and maximum magnitude
- on the reference catalog for finding the transformations.
+ update_ref_orig : boolean or str
+ Should we update the reference values (position, velocity, t0) after each starlist
+ is transformed in each iteration?
- trans_weights : str
- Either None (def), 'both,var', 'list,var', or 'ref,var' depending on whether you want
- to weight by the positional uncertainties (variances) in the individual starlists, or also with
- the uncertainties in the reference frame itself. Note weighting only works when there
- are positional uncertainties availabe. Other options include 'both,std', 'list,std', 'list,var'.
-
- vel_weights : str
- Either 'var' (def) or 'std', depending on whether you want to weight the motion model
- fits by the variance or standard deviation of the position data
+ False if you want to get into an absolute reference frame and are using Gaia data.
+ True if you want to use the reference list as more of an initial guess.
+ 'periter' if you want to align all the starlists, then calculate the velocity.
- trans_input : array or list of transform objects
- def = None. If not None, then this should contain an array or list of transform
- objects that will be used as the initial guess in the alignment and matching.
+ Note that this only impacts the stars that are in the original reference list... the
+ newly identified stars that end up in ref_table will always be updated; but not always
+ used for transformation fitting.
trans_class : transforms.Transform2D object (or subclass)
The transform class that will be used to when deriving the optimal
- transformation parameters between each list and the reference list.
+ transformation parameters between each list and the reference list.
trans_args : dictionary
- A dictionary (or a list of dictionaries) containing any extra keywords that are needed
- in the transformation object. For instance, "order". Note that if a list is passed in,
+ A dictionary (or a list of dictionaries) containing any extra keywords that are needed
+ in the transformation object. For instance, "order". Note that if a list is passed in,
then the transformation argument (i.e. order) will be changed for every iteration in
iters.
+ trans_input : array or list of transform objects
+ def = None. If not None, then this should contain an array or list of transform
+ objects that will be used as the initial guess in the alignment and matching.
+
+ trans_weighting : str
+ Either None (def), 'both,var', 'list,var', or 'ref,var' depending on whether you want
+ to weight by the positional uncertainties (variances) in the individual starlists, or also with
+ the uncertainties in the reference frame itself. Note weighting only works when there
+ are positional uncertainties availabe. Other options include 'both,std', 'list,std', 'list,var'.
+
init_order: int
Polynomial transformation order to use for initial guess transformation.
Order=1 should be used in most cases, but sometimes higher order is needed
+ init_guess_mode : string
+ If no initial transformations are passed in via the trans_input keyword, then we have
+ to make the initial transformation and matching blindly. We can do this in a couple of
+ different ways. Options are 'miracle' or 'name' (see trans_initial_guess() for more details).
+
+ briteN : int
+ If init_guess_mode is 'miracle', this is the number of brightest stars to use in the miracle match.
+ Default is min(50, len(star_list)).
+
calc_trans_inverse: boolean
If true, then calculate the inverse transformation (from reference to starlist)
in addition to the normal transformation (from starlist to reference). The inverse
calculation is calculated by switching the order to the positions in match_and_transform.
The inverse transformations are saved in self.trans_list_inverse.
-
self.trans_list_inverse doesn't exist if calc_trans_inverse == False
- update_ref_orig : boolean or str
- Should we update the reference values (position, velocity, t0) after each starlist
- is transformed in each iteration?
+ mag_trans : boolean
+ If true, this will also calculate and (temporarily) apply a zeropoint offset to
+ magnitudes in each list to bring them into a common magnitude system. This is
+ essential for matching (with finite dm_tol) starlists of different filters or
+ starlists that are not photometrically calibrated. Note that the final_table columns
+ of 'm', 'm0', and 'm0_err' will contain the transformed magnitudes while the
+ final_table column 'm_orig' will contain the original un-transformed magnitudes.
+ If mag_trans = False, then no such zeropoint offset it applied at any point.
- False if you want to get into an absolute reference frame and are using Gaia data.
- True if you want to use the reference list as more of an initial guess.
- 'periter' if you want to align all the starlists, then calculate the velocity.
+ mag_lim : array
+ If different from None, it indicates the minimum and maximum magnitude
+ on the catalogs for finding the transformations. Note, if you want specify the mag_lim
+ separately for each list and each iteration, you need to pass in a 2D array that
+ has shape (N_lists, N_iters).
- Note that this only impacts the stars that are in the original reference list... the
- newly identified stars that end up in ref_table will always be updated; but not always
- used for transformation fitting.
+ ref_mag_lim : array
+ If different from None, it indicates the minimum and maximum magnitude
+ on the reference catalog for finding the transformations.
- use_ref_new : boolean
- Each pass, new stars are matched and added to the ref_table. However, we don't
- necessarily want to use these in the reference frame in subsequent passes.
- If True, then the new stars will be used in later passes/iterations.
- If False, then the new stars will be carried, but not used in the transformation.
- We determine which stars to use through setting a boolean use_in_trans flag.
+ motion_models : list of str or MotionModel objects
+ List of motion model names (strings) or MotionModel objects to use
- init_guess_mode : string
- If no initial transformations are passed in via the trans_input keyword, then we have
- to make the initial transformation and matching blindly. We can do this in a couple of
- different ways. Options are 'miracle' or 'name' (see trans_initial_guess() for more details).
+ motion_model_for_new_star : str or MotionModel, optional
+ Motion model or its name for newly added stars in the ref table. Used in add_rows_for_new_stars().
+ If None, the most complex motion model in motion_models will be used, by default None.
- iter_callback : None or function
- A function to call (that accepts a StarTable object and an iteration number)
- at the end of every iteration. This can be used for plotting or printing state.
-
- default_motion_model : string
- Name of motion model to use for new or unassigned stars
-
- motion_model_dict : None or dict
- Dict of motion model name keys (strings) and corresponding MotionModel object values
+ fixed_params_dict : None or dict
+ Dictionary of fixed parameters for motion models
+
+ vel_weighting : str
+ Either 'var' (def) or 'std', depending on whether you want to weight the motion model
+ fits by the variance or standard deviation of the position data
use_scipy : bool, optional
If True, use scipy.optimize.curve_fit for velocity fitting. If False, use linear algebra fitting, by default True.
@@ -1555,12 +1821,21 @@ def = None. If not None, then this should contain an array or list of transform
absolute_sigma : bool, optional
If True, the velocity fit will use absolute errors in the data. If False, relative errors will be used, by default False.
+ iter_callback : None or function
+ A function to call (that accepts a StarTable object and an iteration number)
+ at the end of every iteration. This can be used for plotting or printing state.
+
save_path : str, optional
Path to save the MosaicToRef object as a pickle file.
+ verbose : bool or int (0 to 9, inclusive)
+ Controls the verbosity of print statements. (0 least, 9 most verbose).
+ For backwards compatibility, 0 = False, 9 = True.
+ (Note: technically right now no checks on whether the number is an integer or not...)
+
Example
- ----------
- msc = align.MosaicToRef(my_gaia, list_of_starlists, iters=1,
+ -------
+ mtr = align.MosaicToRef(my_gaia, list_of_starlists, iters=1,
dr_tol=[0.1], dm_tol=[5],
outlier_tol=[None], mag_lim=[13, 21],
trans_class=transforms.PolyTransform,
@@ -1570,45 +1845,84 @@ def = None. If not None, then this should contain an array or list of transform
mag_trans=False,
weights='both,std',
init_guess_mode='miracle', verbose=False)
- msc.fit()
+ mtr.fit()
# Access a list of all the transformation parameters:
- trans_list = msc.trans_list
+ trans_list = mtr.trans_list
# Access the fully-combined reference table.
- stars_table = msc.ref_table
+ stars_table = mtr.ref_table
# Plot the magnitude of the first star vs. time:
- # Overplot the mean magnitude.
+ # Overplot the mean magnitude.
plt.plot(stars_table['t'][0, :], stars_table['m'][0, :], 'k.')
- plt.axhline(stars_table['m0'][0])
+ plt.axhline(stars_table['m0'][0])
# Plot the X position of the first star vs. time:
# Overplot the best-fit proper motion.
times = stars_table['t'][0, :]
plt.errorbar(times, stars_table['x'][0, :], yerr=stars_table['xe'][0, :])
- plt.axhline(stars_table['x0'][0] + stars_table['vx'][0]*(times - stars_table['t0'][0]))
+ plt.axhline(stars_table['x0'][0] + stars_table['vx'][0]*(times - stars_table['t0'][0]))
"""
- super().__init__(list_of_starlists, ref_index=-1, iters=iters,
- dr_tol=dr_tol, dm_tol=dm_tol,
- outlier_tol=outlier_tol, trans_args=trans_args,
- init_order=init_order,
- mag_trans=mag_trans, mag_lim=mag_lim,
- trans_weights=trans_weights, vel_weights=vel_weights,
- trans_input=trans_input, trans_class=trans_class,
- calc_trans_inverse=calc_trans_inverse,
- default_motion_model = default_motion_model,
- init_guess_mode=init_guess_mode,
- iter_callback=iter_callback,
- motion_model_dict=motion_model_dict,
- verbose=verbose, use_scipy=use_scipy,
- absolute_sigma=absolute_sigma, save_path=save_path)
-
+ super().__init__(
+ list_of_starlists,
+ # Alignment parameters
+ ref_index=-1,
+ iters=iters,
+ dr_tol=dr_tol,
+ dm_tol=dm_tol,
+ outlier_tol=outlier_tol,
+ # Transformation parameters
+ trans_class=trans_class,
+ trans_args=trans_args,
+ trans_input=trans_input,
+ trans_weighting=trans_weighting,
+ init_order=init_order,
+ init_guess_mode=init_guess_mode,
+ briteN=briteN,
+ calc_trans_inverse=calc_trans_inverse,
+ # Magnitude parameters
+ mag_trans=mag_trans,
+ mag_lim=mag_lim,
+ # Motion model parameters
+ motion_models=motion_models,
+ # motion_model_for_new_star=motion_model_for_new_star,
+ fixed_params_dict=fixed_params_dict,
+ vel_weighting=vel_weighting,
+ use_scipy=use_scipy,
+ absolute_sigma=absolute_sigma,
+ # Advanced options
+ iter_callback=iter_callback,
+ save_path=save_path,
+ prefix_name=prefix_name,
+ verbose=verbose
+ )
+
+ self.starlist_vertices = starlist_vertices
self.ref_list = copy.deepcopy(ref_list)
self.ref_mag_lim = ref_mag_lim
self.update_ref_orig = update_ref_orig
self.use_ref_new = use_ref_new
+ if reflist_vertex is not None:
+ import shapely
+ self.reflist_polygon = shapely.make_valid(shapely.Polygon(reflist_vertex))
+ else:
+ self.reflist_polygon = None
+
+ # If motion_model_used in columns but params columns are missing, raise a warning and remove motion_model_used column to avoid confusion.
+ # if 'motion_model_used' in self.ref_list.colnames:
+ # motion_model_params = motion_model.motion_model_param_names(np.unique(self.ref_list['motion_model_used']), with_errors=False, with_fixed=True)
+ # missing_params = [param for param in motion_model_params if (param not in self.ref_list.colnames) and (f'{param}_err' not in self.ref_list.colnames) and (param not in self.fixed_params_dict.keys())]
+ # if len(missing_params) > 0:
+ # warnings.warn("Warning: 'motion_model_used' column found in ref_list, but the following motion model parameter columns are missing: " + ", ".join(missing_params) + ". Removing 'motion_model_used' column to avoid confusion.")
+ # self.ref_list.remove_column('motion_model_used')
+
+ # If motion_model_used in columns, remove it and raise a warning, since it will only be determined after the fit.
+ if 'motion_model_used' in self.ref_list.colnames:
+ warnings.warn("Warning: 'motion_model_used' column found in ref_list. This column will be determined after the fit, so it is being removed from the input ref_list to avoid confusion.")
+ self.ref_list.remove_column('motion_model_used')
+
# Do some temporary clean up of the reference list.
if ('x' not in self.ref_list.colnames) and ('x0' in self.ref_list.colnames):
self.ref_list['x'] = self.ref_list['x0']
@@ -1622,24 +1936,20 @@ def = None. If not None, then this should contain an array or list of transform
self.ref_list['me'] = self.ref_list['m0_err']
if ('t' not in self.ref_list.colnames) and ('t0' in self.ref_list.colnames):
self.ref_list['t'] = self.ref_list['t0']
-
- # Make sure the motion models are ready
- self.motion_model_dict = motion_model.validate_motion_model_dict(self.motion_model_dict,
- self.ref_list, self.default_motion_model)
return
-
+
def fit(self):
"""
Using the current parameter settings, match and transform all the lists
to a reference position. Note in the first pass, the reference position
is just the specified input reference starlist. In subsequent iterations,
- this is (optionally) updated.
+ this is (optionally) updated.
The ultimate outcome is the creation of self.ref_table. This reference
table will contain "averaged" quantites as well as a big 2D array of all
- the matched original and transformed quantities.
+ the matched original and transformed quantities.
Averaged columns on ref_table:
x0
@@ -1652,27 +1962,70 @@ def fit(self):
"""
# Create a log file of the parameters used in the fit.
- with open('MosaicToRef_input_params.log', 'w',) as _log:
- logger(_log, 'Parameters used for fit: ', self.verbose)
- logger(_log, '------------------------- ', self.verbose)
- logger(_log, ' dr_tol = ' + str(self.dr_tol), self.verbose)
- logger(_log, ' dm_tol = ' + str(self.dm_tol), self.verbose)
- logger(_log, ' outlier_tol = ' + str(self.outlier_tol), self.verbose)
- logger(_log, ' trans_args = ' + str(self.trans_args), self.verbose)
- logger(_log, ' mag_trans = ' + str(self.mag_trans), self.verbose)
- logger(_log, ' mag_lim = ' + str(self.mag_lim), self.verbose)
- logger(_log, ' ref_mag_lim = ' + str(self.ref_mag_lim), self.verbose)
- logger(_log, ' trans_weights = ' + str(self.trans_weights), self.verbose)
- logger(_log, ' vel_weights = ' + str(self.vel_weights), self.verbose)
- logger(_log, ' trans_input = ' + str(self.trans_input), self.verbose)
- logger(_log, ' trans_class = ' + str(self.trans_class), self.verbose)
- logger(_log, ' calc_trans_inverse = ' + str(self.calc_trans_inverse), self.verbose)
- logger(_log, ' use_ref_new = ' + str(self.use_ref_new), self.verbose)
- logger(_log, ' default_motion_model = ' + str(self.default_motion_model), self.verbose)
- logger(_log, ' update_ref_orig = ' + str(self.update_ref_orig), self.verbose)
- logger(_log, ' init_guess_mode = ' + str(self.init_guess_mode), self.verbose)
- logger(_log, ' iter_callback = ' + str(self.iter_callback), self.verbose)
- logger(_log, '-------------------------\n', self.verbose)
+ # Setup save_path:
+ if self.save_path:
+ if not os.path.exists(os.path.dirname(self.save_path)):
+ os.makedirs(os.path.dirname(self.save_path))
+
+ # Save input params
+ input_filename = f'{self.prefix_name}_input.txt'
+ input_dict = {
+ 'iters': self.iters,
+ 'dr_tol': self.dr_tol,
+ 'dm_tol': self.dm_tol,
+ 'outlier_tol': self.outlier_tol,
+ 'use_ref_new': self.use_ref_new,
+ 'update_ref_orig': self.update_ref_orig,
+ 'trans_class': self.trans_class,
+ 'trans_args': self.trans_args,
+ 'trans_input': self.trans_input,
+ 'trans_weighting': self.trans_weighting,
+ 'init_order': self.init_order,
+ 'init_guess_mode': self.init_guess_mode,
+ 'calc_trans_inverse': self.calc_trans_inverse,
+ 'mag_trans': self.mag_trans,
+ 'mag_lim': self.mag_lim,
+ 'ref_mag_lim': self.ref_mag_lim,
+ 'motion_models': self.motion_models,
+ 'fixed_params_dict': self.fixed_params_dict,
+ 'vel_weighting': self.vel_weighting,
+ 'use_scipy': self.use_scipy,
+ 'absolute_sigma': self.absolute_sigma,
+ 'iter_callback': self.iter_callback,
+ 'save_path': self.save_path,
+ 'prefix_name': self.prefix_name,
+ 'verbose': self.verbose
+ }
+ if self.save_path is not None:
+ if not os.path.exists(self.save_path):
+ os.makedirs(self.save_path)
+ with open(os.path.join(self.save_path, input_filename), 'w') as file:
+ for key, value in input_dict.items():
+ file.write(f'{key}:\t{value}\n')
+
+
+ # if self.save_path is not None:
+ # with open(f'{os.path.dirname(self.save_path)}/MosaicToRef_input_params.log', 'w',) as _log:
+ # logger(_log, 'Parameters used for fit: ', self.verbose)
+ # logger(_log, '------------------------- ', self.verbose)
+ # logger(_log, ' dr_tol = ' + str(self.dr_tol), self.verbose)
+ # logger(_log, ' dm_tol = ' + str(self.dm_tol), self.verbose)
+ # logger(_log, ' outlier_tol = ' + str(self.outlier_tol), self.verbose)
+ # logger(_log, ' trans_args = ' + str(self.trans_args), self.verbose)
+ # logger(_log, ' mag_trans = ' + str(self.mag_trans), self.verbose)
+ # logger(_log, ' mag_lim = ' + str(self.mag_lim), self.verbose)
+ # logger(_log, ' ref_mag_lim = ' + str(self.ref_mag_lim), self.verbose)
+ # logger(_log, ' trans_weighting = ' + str(self.trans_weighting), self.verbose)
+ # logger(_log, ' vel_weighting = ' + str(self.vel_weighting), self.verbose)
+ # logger(_log, ' trans_input = ' + str(self.trans_input), self.verbose)
+ # logger(_log, ' trans_class = ' + str(self.trans_class), self.verbose)
+ # logger(_log, ' calc_trans_inverse = ' + str(self.calc_trans_inverse), self.verbose)
+ # logger(_log, ' use_ref_new = ' + str(self.use_ref_new), self.verbose)
+ # logger(_log, ' motion_models = ' + str([mm.name for mm in self.motion_models]), self.verbose)
+ # logger(_log, ' update_ref_orig = ' + str(self.update_ref_orig), self.verbose)
+ # logger(_log, ' init_guess_mode = ' + str(self.init_guess_mode), self.verbose)
+ # logger(_log, ' iter_callback = ' + str(self.iter_callback), self.verbose)
+ # logger(_log, '-------------------------\n', self.verbose)
##########
@@ -1690,8 +2043,7 @@ def fit(self):
#
##########
for nn in range(self.iters):
-
- # If we are on subsequent iterations, remove matching results from the
+ # If we are on subsequent iterations, remove matching results from the
# prior iteration. This leaves aggregated (1D) columns alone.
if nn > 0:
self.reset_ref_values()
@@ -1703,13 +2055,13 @@ def fit(self):
print('Starting iter {0:d} with ref_table shape:'.format(nn), self.ref_table['x'].shape)
print("**********")
print("**********")
-
+
# ALL the action is in here. Match and transform the stack of starlists.
- # This updates trans objects and the ref_table.
+ # This updates trans objects and the ref_table.
self.match_and_transform(self.ref_mag_lim,
self.dr_tol[nn], self.dm_tol[nn], self.outlier_tol[nn],
- self.trans_args[nn])
-
+ self.trans_args[nn], nn)
+
# Clean up the reference table
# Find where stars are detected.
self.ref_table.detections()
@@ -1737,43 +2089,216 @@ def fit(self):
print("**********")
self.match_lists(self.dr_tol[-1], self.dm_tol[-1])
- keep_ref_orig = (self.update_ref_orig==False)
- if keep_ref_orig:
- keep_orig = np.where(self.ref_table['ref_orig'])[0]
- else:
+ if self.update_ref_orig:
keep_orig=None
+ else:
+ keep_orig = self.ref_table['ref_orig']
self.update_ref_table_aggregates(keep_orig=keep_orig)
##########
# Clean up output table.
- #
+ #
##########
# Find where stars are detected.
if self.verbose > 0:
- print('')
print(' Preparing the reference table...')
-
+
self.ref_table.detections()
### Drop all stars that have 0 detections.
- idx = np.where((self.ref_table['n_detect'] == 0) & (self.ref_table['ref_orig'] == False))[0]
- print(' *** Getting rid of {0:d} out of {1:d} junk sources'.format(len(idx), len(self.ref_table)))
+ idx = np.where((self.ref_table['n_detect'] == 0))[0] # & (self.ref_table['ref_orig'] == False))[0]
+ if self.verbose:
+ print(' *** Getting rid of {0:d} out of {1:d} junk sources'.format(len(idx), len(self.ref_table)))
self.ref_table.remove_rows(idx)
if self.iter_callback != None:
self.iter_callback(self.ref_table, nn)
- if self.save_path:
- with open(self.save_path, 'wb') as file:
+ # Add times into ref_table meta data
+ all_epochs = get_all_epochs(self.ref_table)
+ self.ref_table.meta['list_times'] = all_epochs
+
+ # Update chi2 values in ref table, as motion_model_used may have changed
+ x_inferred, y_inferred, _, _ = self.ref_table.infer_positions(all_epochs, fixed_params_dict=self.fixed_params_dict)
+ # Convert x_inferred and y_inferred to 2D arrays if they are 1D (i.e. if only one epoch), so that the chi2 calculation works correctly.
+ if x_inferred.ndim == 1:
+ x_inferred = x_inferred[:, np.newaxis]
+ if y_inferred.ndim == 1:
+ y_inferred = y_inferred[:, np.newaxis]
+ chi2_x_2d = ((self.ref_table['x'] - x_inferred) / self.ref_table['xe'])**2
+ chi2_y_2d = ((self.ref_table['y'] - y_inferred) / self.ref_table['ye'])**2
+ chi2_x = np.nansum(chi2_x_2d, axis=1)
+ chi2_y = np.nansum(chi2_y_2d, axis=1)
+ chi2_x[~np.isfinite(chi2_x_2d).any(axis=1)] = np.nan
+ chi2_y[~np.isfinite(chi2_y_2d).any(axis=1)] = np.nan
+ self.ref_table['chi2_x'] = chi2_x
+ self.ref_table['chi2_y'] = chi2_y
+
+ if self.save_path is not None:
+ filename = f'{self.prefix_name}.pkl'
+ with open(os.path.join(self.save_path, filename), 'wb') as file:
pickle.dump(self, file)
+ # Using pickle here because nan in a fits file is auto-converted to a masked value in astropy.io.fits.open()
+ filename = f'{self.prefix_name}_ref_table.pkl'
+ with open(os.path.join(self.save_path, filename), 'wb') as file:
+ pickle.dump(self.ref_table, file)
+
+ if self.verbose > 0:
+ print('===================================')
+ print('========== Done with fit ==========')
+ print('===================================')
return
+# TODO: This is sometimes run on a startable, not a starlist, at least as currently used
+def infer_positions(t, startable, motion_models=None, fixed_params_dict=None, return_errors=False):
+ """
+ Take a startable, check to see if it has motion/velocity columns.
+ If it does, then propagate the positions forward in time
+ to the desired epoch. If no motion/velocities exist, then just
+ use ['x0', 'y0'] or ['x', 'y']
+
+ Parameters
+ ----------
+ t : float
+ The time to propagate to. Usually in decimal years;
+ but it should be in the same units
+ as the 't0' column in starlist.
+ startable : StarTable
+ Startable that needs to be inferred.
+ motion_models : list of MotionModel classes or strings
+ The motion models to check for in the startable
+ return_errors : boolean
+ Whether to return the inferred position errors. If True, then the function returns x, y, xe, ye. If False, then it just returns x, y, by default False.
+
+ Returns
+ -------
+ x, y, (xe, ye) : tuple
+ Inferred position (and errors) at time t
+ """
+ if ('motion_model_used' in startable.colnames):
+ x, y, xe, ye = startable.infer_positions(t, fixed_params_dict=fixed_params_dict)
+ if return_errors:
+ return x, y, xe, ye
+ else:
+ return x, y
+
+ # Convert motion_models from strings to MotionModel classes if needed.
+ if motion_models is None:
+ # Setting the default to None to avoid mutable default argument issue
+ # See https://stackoverflow.com/questions/15189245/assigning-class-variable-as-default-value-to-class-method-argument
+ motion_models = [Empty, Fixed]
+ all_mm_map = motion_model.motion_model_map()
+ if all(isinstance(mm, str) for mm in motion_models):
+ mm_names = motion_models
+ motion_models = [all_mm_map[mm] for mm in motion_models]
+ else:
+ mm_names = [mm.name for mm in motion_models]
+
+ # Always add Empty and Fixed in motion models
+ if 'Fixed' not in mm_names:
+ motion_models.insert(0, Fixed)
+ if 'Empty' not in mm_names:
+ motion_models.insert(0, Empty)
+
+ # Otherwise, infer positions using the most complex motion model with the existing columns, until it reaches Fixed or Empty
+ # Sort motion models inversely by mm.n_params
+ motion_models = sorted(motion_models, key=lambda mm: mm.n_params, reverse=True)
+ for mm in motion_models:
+ if mm.name == 'Empty':
+ x = startable['x']
+ y = startable['y']
+ return x, y
+
+ required_columns = mm.fit_param_names + mm.fixed_param_names
+ if all([param in startable.colnames for param in required_columns]):
+ # Check if the values are finite for non-string columns in the required columns for this motion model. If not, skip to the next motion model.
+ if not all([np.isfinite(startable[param]).all() for param in required_columns if startable[param].dtype.kind in 'if']):
+ continue
+
+ # If we have error columns for all fit parameters, then use them in the model inference. Otherwise, just use the fit parameters without errors.
+ x, y = mm().model(
+ t=t,
+ fit_params=np.array([startable[param] for param in mm.fit_param_names]).T,
+ fixed_params_dict={param: startable[param] for param in mm.fixed_param_names}
+ )
+ break
+
+ return x, y
+
+ # # If no motion model, check for velocities
+ # elif ('vx' in startable.colnames) and ('vy' in startable.colnames) and (np.isfinite(startable['vx']).all()) and (np.isfinite(startable['vy']).all()):
+ # x = startable['x0'] + startable['vx'] * (t - startable['t0'])
+ # y = startable['y0'] + startable['vy'] * (t - startable['t0'])
+
+ # # If no velocities, try fitted positon
+ # elif ('x0' in startable.colnames) and ('y0' in startable.colnames) and (np.isfinite(startable['x0']).all()) and (np.isfinite(startable['y0']).all()):
+ # x = startable['x0']
+ # y = startable['y0']
+ # # Otherwise, use measured position
+ # else:
+ # x = startable['x']
+ # y = startable['y']
+ # return x, y
+
+def determine_motion_model(startable, motion_models=None, fixed_params_dict=None):
+ """Determine motion model used in star table based on the finite model parameter columns
+
+ Parameters
+ ----------
+ startable : startable
+ Startable with motion model parameter columns
+ motion_models : list of MotionModel or str, optional
+ List of motion model classes or their names to select from.
+ If None, all available motion models will be considered, by default None
+ fixed_params_dict : dict, optional
+ Dictionary of fixed parameters, by default None
+
+ Returns
+ -------
+ motion_model_used : list
+ List of motion model used for each star
+ n_params : list
+ List of n parameters per direction for each star
+ """
+
+ if motion_models is None:
+ motion_models = motion_model.MotionModel.__subclasses__()
+ elif all(isinstance(mm, str) for mm in motion_models):
+ all_mm_map = motion_model.motion_model_map()
+ motion_models = [all_mm_map[mm] for mm in motion_models]
+
+ if fixed_params_dict is None:
+ fixed_params_dict = {}
+
+ motion_models_possible = []
+ for mm in motion_models:
+ required_columns = mm.fit_param_names + mm.fixed_param_names
+ req_col_in_table = [col for col in required_columns if (col in startable.colnames)]
+ req_col_in_dict = [col for col in required_columns if (col in fixed_params_dict.keys())]
+ if all((col in startable.colnames) or (col in fixed_params_dict.keys()) for col in required_columns):
+ motion_models_possible.append((mm, req_col_in_table, req_col_in_dict))
+
+ # Check if values are finite for required columns in possible motion models
+ motion_model_used = []
+ n_params = []
+
+ for k in range(len(startable)):
+ for mm, req_col_in_table, req_col_in_dict in motion_models_possible[::-1]:
+ # If requested column in table/fixed_params dict is numeric, check if values are finite.
+ if all(np.isfinite(startable[col][k]) for col in req_col_in_table if np.issubdtype(startable[col].dtype, np.number)) \
+ and all(np.isfinite(fixed_params_dict[col]) for col in req_col_in_dict if np.issubdtype(np.array(fixed_params_dict[col]).dtype, np.number)):
+ motion_model_used.append(mm.name)
+ n_params.append(mm.n_params)
+ break
+ return motion_model_used, n_params
+
+
def get_all_epochs(t):
"""
Helper function to get times of all epochs from a ref table.
- This is required because our previous approach
- of simply taking the time array of the star with the most detections
- fails for mosaicked catalogs, because it is then possible that
+ This is required because our previous approach
+ of simply taking the time array of the star with the most detections
+ fails for mosaicked catalogs, because it is then possible that
no star is detected in all fields.
"""
nepochs = len(t['t'][0])
@@ -1790,17 +2315,17 @@ def get_all_epochs(t):
all_epochs = np.array(all_epochs)
return all_epochs
-
-def setup_ref_table_from_starlist(star_list):
- """
+
+def setup_ref_table_from_starlist(star_list, motion_models):
+ """
Start with the reference list.... this will change and grow
over time, so make a copy that we will keep updating.
The reference table will contain one columne for every named
array in the original reference star list.
"""
col_arrays = {}
- motion_model_col_names = motion_model.get_all_motion_model_param_names(with_errors=True)
+ motion_model_col_names = motion_model.motion_model_param_names(motion_models, with_errors=True)
for col_name in star_list.colnames:
if col_name == 'name':
# The "name" column will be 1D; but we will also add a "name_in_list" column.
@@ -1808,7 +2333,7 @@ def setup_ref_table_from_starlist(star_list):
new_col_name = "name_in_list"
else:
new_col_name = col_name
-
+
# Make every column's 2D arrays except "name" and those
# columns used for the motion model.
if col_name in motion_model_col_names:
@@ -1822,7 +2347,7 @@ def setup_ref_table_from_starlist(star_list):
# Make new columns to hold original values. These will be copies
# of the old columns and will only include x, y, m, xe, ye, me.
- # The columns we have already created will hold transformed values.
+ # The columns we have already created will hold transformed values.
trans_col_names = ['x', 'y', 'm', 'xe', 'ye', 'me', 'w']
for tt in range(len(trans_col_names)):
old_name = trans_col_names[tt]
@@ -1834,32 +2359,30 @@ def setup_ref_table_from_starlist(star_list):
# Make sure ref_table has the necessary x0, y0, m0 and associated
# error columns. If they don't exist, then add them as a copy of
- # the original x,y,m etc columns.
+ # the original x,y,m etc columns.
new_cols_arr = ['x0', 'x0_err', 'y0', 'y0_err', 'm0', 'm0_err']
orig_cols_arr = ['x', 'xe', 'y', 'ye', 'm', 'me']
assert len(new_cols_arr) == len(orig_cols_arr)
ref_cols = ref_table.keys()
- for ii in range(len(new_cols_arr)):
- if not new_cols_arr[ii] in ref_cols:
+ for new_col, orig_col in zip(new_cols_arr, orig_cols_arr):
+ if new_col not in ref_cols:
# Some munging to convert data shape from (N,1) to (N,),
# since these are all 1D cols
- vals = np.transpose(np.array(ref_table[orig_cols_arr[ii]]))[0]
+ vals = np.array(ref_table[orig_col]).flatten()
# Now add to ref_table
- new_col = Column(vals, name=new_cols_arr[ii])
- ref_table.add_column(new_col)
-
+ ref_table.add_column(vals, name=new_col)
+
if 'use_in_trans' not in ref_table.colnames:
- new_col = Column(np.ones(len(ref_table), dtype=bool), name='use_in_trans')
- ref_table.add_column(new_col)
-
+ ref_table.add_column(np.ones(len(ref_table), dtype=bool), name='use_in_trans')
+
# Now reset the original values to invalids... they will be filled in
# at later times. Preserve content only in the columns: name, x0, y0, m0 (and 0e).
- # Note that these are all the 1D columsn.
+ # Note that these are all the 1D columns.
for col_name in ref_table.colnames:
if len(ref_table[col_name].data.shape) == 2: # Find the 2D columns
- ref_table._set_invalid_list_values(col_name, -1)
+ ref_table._set_invalid_list_values(col_name, -1)
return ref_table
@@ -1869,14 +2392,14 @@ def copy_over_values(ref_table, star_list, star_list_T, idx_epoch, idx_ref, idx_
into the reference table we carry around and that is the final output product.
Copy only those values for stars that match.
- Copy all columns that are in both ref_table and star_list_T.
+ Copy all columns that are in both ref_table and star_list_T.
Copy all columns that are also in star_list but copy them into
_orig.
Parameters
----------
ref_table : StarTable
The table we will be copying values into. Note the columns with the appropriate
- names and dimensions must already exist.
+ names and dimensions must already exist.
star_list : StarList
The astropy table to copy values from. These should be untransformed (orig) values.
star_list_T : StarList
@@ -1903,7 +2426,7 @@ def reset_ref_values(ref_table):
"""
Reset all the 2D arrays in the reference table. This is the action
we take at the beginning of each new iteration. We don't preserve matching
- results from the prior iterations.
+ results from the prior iterations.
"""
# All 2D columns should be reset.
for col_name in ref_table.colnames:
@@ -1911,25 +2434,27 @@ def reset_ref_values(ref_table):
# Loop through epochs for this array.
for cc in range(ref_table[col_name].shape[1]):
ref_table._set_invalid_list_values(col_name, cc)
-
+
return
-def add_rows_for_new_stars(ref_table, star_list, idx_lis, default_motion_model='Fixed'):
+def add_rows_for_new_stars(ref_table, star_list, idx_list, motion_model_name='Fixed', fixed_params_dict=None):
"""
- For each star that is in star_list and NOT in idx_list, make a
- new row in the reference table. The values will be empty (None, NAN, etc.).
+ For each star that is in star_list and NOT in idx_list, make a
+ new row in the reference table. The values will be empty (None, NAN, etc.).
Parameters
----------
ref_table : StarTable
The reference table that the rows will be added to.
-
star_list : StarList
The starlist that will be used to estimate how many new stars there are.
-
- idx_lis : array or list
+ idx_list : array or list
The indices of the non-new stars (those that matched already). The complement
of this array will be used as the new stars.
+ motion_model_name : str
+ The motion model name to assign to the new stars.
+ fixed_params_dict : dict
+ The default fixed parameters to assign to the new stars.
Returns
----------
@@ -1938,40 +2463,58 @@ def add_rows_for_new_stars(ref_table, star_list, idx_lis, default_motion_model='
idx_lis_new : list
The list of indices into the star_list object for the "new" stars.
idx_ref_new : list
- The list of indices into the ref_table object for the "new" stars.
+ The list of indices into the ref_table object for the "new" stars.
"""
last_star_idx = len(ref_table)
idx_lis_orig = np.arange(len(star_list))
- idx_lis_new = np.array(list(set(idx_lis_orig) - set(idx_lis)))
+ idx_lis_new = np.array(list(set(idx_lis_orig) - set(idx_list)))
+ N_newstars = len(idx_lis_new)
+
+ mm_map = motion_model.motion_model_map()
+ mm = mm_map[motion_model_name]
- if len(idx_lis_new) > 0:
+ # Add optional fixed params default values into fixed params dict, prioritizing values in fixed_params_dict
+ if fixed_params_dict is not None:
+ fixed_params_dict.update({k: v for k, v in mm.optional_fixed_params.items() if k not in fixed_params_dict})
+ else:
+ fixed_params_dict = mm.optional_fixed_params.copy()
+
+ if N_newstars > 0:
col_arrays = {}
for col_name in ref_table.colnames:
new_col_name = col_name
-
- if ref_table[col_name].dtype == np.dtype('float'):
+
+ if col_name in fixed_params_dict.keys():
+ new_col_empty = fixed_params_dict[col_name]
+ elif col_name=='n_params':
+ new_col_empty = mm.n_params
+ elif col_name=='motion_model_input':
+ new_col_empty = motion_model_name
+ elif col_name=='motion_model_used':
+ new_col_empty = 'Empty'
+ elif ref_table[col_name].dtype == np.dtype('float'):
new_col_empty = np.nan
elif ref_table[col_name].dtype == np.dtype('int'):
new_col_empty = -1
elif ref_table[col_name].dtype == np.dtype('bool'):
new_col_empty = False
- elif col_name=='motion_model_input':
- new_col_empty = default_motion_model
- elif col_name=='motion_model_used':
- new_col_empty = 'Fixed'
else:
new_col_empty = np.nan
-
+
if len(ref_table[col_name].shape) == 1:
- new_col_shape = len(idx_lis_new)
+ new_col_shape = N_newstars
else:
- new_col_shape = [len(idx_lis_new), ref_table[col_name].shape[1]]
+ new_col_shape = [N_newstars, ref_table[col_name].shape[1]]
+
+ new_col_data = Column(
+ data=np.tile(new_col_empty, new_col_shape),
+ name=col_name,
+ dtype=ref_table[col_name].dtype
+ )
- new_col_data = Column(data=np.tile(new_col_empty, new_col_shape),
- name=col_name, dtype=ref_table[col_name].dtype)
col_arrays[new_col_name] = new_col_data
ref_table_new = StarTable(**col_arrays)
@@ -1982,7 +2525,7 @@ def add_rows_for_new_stars(ref_table, star_list, idx_lis, default_motion_model='
ref_table = vstack([ref_table, ref_table_new])
idx_ref_new = np.arange(last_star_idx, len(ref_table))
-
+
return ref_table, idx_lis_new, idx_ref_new
"""
@@ -1990,7 +2533,7 @@ def add_rows_for_new_stars(ref_table, star_list, idx_lis, default_motion_model='
"""
def calc_mag_avg_all_stars(d):
- # Determine how many stars there are.
+ # Determine how many stars there are.
N_stars = len(d)
# Determine how many epochs there are.
@@ -2032,7 +2575,7 @@ def initial_align(table1, table2, briteN=100,
y: y position
xe: error in x position
ye: error in y position
-
+
vx: proper motion in x direction
vy proper motion in y direction
vxe: error in x proper motion
@@ -2040,11 +2583,11 @@ def initial_align(table1, table2, briteN=100,
m: magnitude
me: magnitude error
-
+
t0: linear motion time zero point
use: specify use in transformation
-
+
Parameters:
----------
@@ -2072,7 +2615,7 @@ def initial_align(table1, table2, briteN=100,
Output:
------
Transformation object
-
+
"""
# Extract necessary information from tables (x, y, m)
x1 = table1['x']
@@ -2120,7 +2663,7 @@ def transform_and_match(table1, table2, transform, dr_tol=1.0, dm_tol=None, verb
starlist file positions.
-transform: transformation object
-
+
-verbose: bool, optional
Prints on screen information on the matching
@@ -2191,7 +2734,7 @@ def find_transform(table1, table1_trans, table2, transModel=transforms.PolyTrans
if weights=='starlist', we only use postion error in transformed starlist.
if weights=='reference', we only use position error in reference starlist.
if weights==None, we don't use weights.
-
+
verbose: bool (default=True)
Prints on screen information on the matching
@@ -2207,7 +2750,7 @@ def find_transform(table1, table1_trans, table2, transModel=transforms.PolyTrans
(transModel != transforms.LegTransform) ):
print(( '{0} not supported yet!'.format(transModel)))
return
-
+
# Extract *untransformed* coordinates from starlist 1
# and the matching coordinates from starlist 2
x1 = table1['x']
@@ -2285,7 +2828,7 @@ def find_transform_new(table1_mat, table2_mat,
if weights = 'both' or 'starlist' then the positions in table 1 are first transformed
using the transInit object. This is necessary if the plate scales are very different
between the table 1 and the reference list.
-
+
verbose: bool (default=True)
Prints on screen information on the matching
@@ -2298,7 +2841,7 @@ def find_transform_new(table1_mat, table2_mat,
if ( (transModel != transforms.four_paramNW) & (transModel != transforms.PolyTransform) ):
print(( '{0} not supported yet!'.format(transModel)))
return
-
+
# Extract *untransformed* coordinates from starlist 1
# and the matching coordinates from starlist 2
x1 = table1_mat['x']
@@ -2315,10 +2858,10 @@ def find_transform_new(table1_mat, table2_mat,
if transInit != None:
table1T_mat = table1_mat.copy()
- table1T_mat = transform_by_object(table1T_mat, transInit)
+ table1T_mat = transform_from_object(table1T_mat, transInit)
- x1e = table1T_mag['xe']
- y1e = table1T_mag['ye']
+ x1e = table1T_mat['xe']
+ y1e = table1T_mat['ye']
# Calculate weights as to user specification
if weights == 'both':
@@ -2386,7 +2929,7 @@ def write_transform(transform, starlist, reference, N_trans, deltaMag=0, restric
outFile: string (default: 'outTrans.txt')
Name of output text file
-
+
Output:
------
txt file with the file name outFile
@@ -2394,7 +2937,7 @@ def write_transform(transform, starlist, reference, N_trans, deltaMag=0, restric
# Extract info about transformation
trans_name = transform.__class__.__name__
trans_order = transform.order
-
+
# Extract X, Y coefficients from transform
if trans_name == 'four_paramNW':
Xcoeff = transform.px
@@ -2403,12 +2946,11 @@ def write_transform(transform, starlist, reference, N_trans, deltaMag=0, restric
Xcoeff = transform.px.parameters
Ycoeff = transform.py.parameters
else:
- print(( '{0} not yet supported!'.format(transType)))
- return
-
+ raise Exception(f'{trans_name} not yet supported!')
+
# Write output
_out = open(outFile, 'w')
-
+
# Write the header. DO NOT CHANGE, HARDCODED IN JAVA ALIGN
_out.write('## Date: {0}\n'.format(datetime.date.today()) )
_out.write('## File: {0}, Reference: {1}\n'.format(starlist, reference) )
@@ -2421,7 +2963,7 @@ def write_transform(transform, starlist, reference, N_trans, deltaMag=0, restric
_out.write('## N_trans: {0}\n'.format(N_trans))
_out.write('## Delta Mag: {0}\n'.format(deltaMag))
_out.write('{0:16s} {1:16s}\n'.format('# Xcoeff', 'Ycoeff'))
-
+
# Write the coefficients such that the orders are together as defined in
# documentation. This is a pain because PolyTransform output is weird.
# (see astropy Polynomial2D documentation)
@@ -2432,12 +2974,12 @@ def write_transform(transform, starlist, reference, N_trans, deltaMag=0, restric
# CODE TO GET INDICIES
N = trans_order - 1
idx_list = list()
-
+
# when trans_order=1, N=0
idx_list.append(0)
idx_list.append(1)
idx_list.append(N+2)
-
+
if trans_order >= 2:
for k in range(2, N+2):
idx_list.append(k)
@@ -2458,7 +3000,7 @@ def write_transform(transform, starlist, reference, N_trans, deltaMag=0, restric
_out.close()
-
+
return
@@ -2472,7 +3014,7 @@ def transform_from_file(starlist, transFile):
are present in starlist.
WARNING: THIS CODE WORKS FOR POLYTRANSFORM
-
+
Parameters:
----------
starlist: astropy table
@@ -2502,8 +3044,8 @@ def transform_from_file(starlist, transFile):
# Do transform
transform = transforms.PolyTransform(order, Xcoeff, Ycoeff)
return transform_from_object(starlist, transform)
-
-
+
+
def transform_from_object(starlist, transform):
"""
@@ -2512,7 +3054,7 @@ def transform_from_object(starlist, transform):
if they are present in starlits. If a more complex motion_model is
implemented, the motion parameters are set to nan, as we need the full time
series to refit.
-
+
Parameters:
----------
starlist: astropy table
@@ -2534,7 +3076,7 @@ def transform_from_object(starlist, transform):
keys = list(starlist.keys())
# Check to see if velocities or motion_model are present in starlist.
- vel = ('vx' in keys)and ~("motion_model_input" in keys)
+ vel = ('vx' in keys) and ("motion_model_input" not in keys)
mot = ("motion_model_input" in keys)
# If the only motion models used are Fixed and Linear, we can still transform velocities.
if mot:
@@ -2546,11 +3088,11 @@ def transform_from_object(starlist, transform):
if len(motion_models_unique)==0:
vel=True
mot=False
-
+
# Prior code before motion_model implementation
# Can still be used as shortcut for Linear+Fixed motion_model only
err = 'xe' in keys
-
+
# Extract needed information from starlist
x = starlist_f['x']
y = starlist_f['y']
@@ -2571,7 +3113,7 @@ def transform_from_object(starlist, transform):
vy = starlist_f['vy']
vxe = starlist_f['vx_err']
vye = starlist_f['vy_err']
-
+
# calculate the transformed position and velocity
x_new, y_new, xe_new, ye_new = position_transform_from_object(x, y, xe, ye, transform)
@@ -2584,7 +3126,7 @@ def transform_from_object(starlist, transform):
starlist_f['y'] = y_new
starlist_f['xe'] = xe_new
starlist_f['ye'] = ye_new
-
+
if vel:
starlist_f['x0'] = x0_new
starlist_f['y0'] = y0_new
@@ -2594,15 +3136,15 @@ def transform_from_object(starlist, transform):
starlist_f['vy'] = vy_new
starlist_f['vx_err'] = vxe_new
starlist_f['vy_err'] = vye_new
-
+
# For more complicated motion_models,
# we can't easily transform them, set the values to nans and refit later.
if mot:
- motion_model_params = motion_model.get_all_motion_model_param_names()
+ motion_model_params = motion_model.motion_model_param_names()
for param in motion_model_params:
if param in keys:
starlist_f[param] = np.nan
-
+
return starlist_f
@@ -2615,7 +3157,7 @@ def position_transform_from_object(x, y, xe, ye, transform):
- x, y: original position
- xe, ye: original position error
- transform: transformation object from astropy.modeling.models.polynomial2D
-
+
Outpus:
- x_new, y_new: transformed position
- xe_new, ye_new: transformed position error
@@ -2632,8 +3174,8 @@ def position_transform_from_object(x, y, xe, ye, transform):
order = transform.order
else:
txt = 'Transform not yet supported by position_transform_from_object'
- raise StandardError(txt)
-
+ raise Exception(txt)
+
# How the transformation is applied depends on the type of transform.
# This can be determined by the length of Xcoeff, Ycoeff
N = order - 1
@@ -2657,7 +3199,7 @@ def position_transform_from_object(x, y, xe, ye, transform):
for j in range(1, N+2-i):
sub = int(2*N + 2 + j + (2*N+2-i) * (i-1)/2.)
y_new += Ycoeff[sub] * (x**i) * (y**j)
-
+
"""
THIS IS WRONG BELOW! - NOTE: I don't think this is wrong any more
@@ -2667,7 +3209,7 @@ def position_transform_from_object(x, y, xe, ye, transform):
Should be doing:
((A**2 + B**2 + C**2) * xe**2)
"""
-
+
# xe_new & ye_new in (x,y,xe,ye)
xe_new = 0
temp1 = 0
@@ -2715,11 +3257,11 @@ def velocity_transform_from_object(x0, y0, x0e, y0e, vx, vy, vxe, vye, transform
- x0, y0, x0e, y0e: original position and position error
- vx, vy, vxe, vye: original velocity and velocity error
- transform: transformation object from astropy.modeling.models.polynomial2D
-
+
Outpus:
- vx_new, vy_new, vxe_new, vye_new: transformed velocity and velocity error
"""
-
+
# Read transformation: Extract X, Y coefficients from transform
if transform.__class__.__name__ == 'four_paramNW':
Xcoeff = transform.px
@@ -2731,8 +3273,8 @@ def velocity_transform_from_object(x0, y0, x0e, y0e, vx, vy, vxe, vye, transform
order = transform.order
else:
txt = 'Transform not yet supported by velocity_transform_from_object'
- raise StandardError(txt)
-
+ raise Exception(txt)
+
# How the transformation is applied depends on the type of transform.
# This can be determined by the length of Xcoeff, Ycoeff
N = order - 1
@@ -2793,7 +3335,7 @@ def velocity_transform_from_object(x0, y0, x0e, y0e, vx, vy, vxe, vye, transform
for i in range(1, N+1):
for j in range(1, N+2-i):
sub = 2*N + 2 + j + (2*N+2-i) * (i-1)/2.
- temp3 += i * Xcoeff[int(sub)] * (x0**(i-1)) * (y0**j)
+ temp3 += i * Xcoeff[int(sub)] * (x0**(i-1)) * (y0**j)
for j in range(1, N+2):
temp4 += j * Xcoeff[N+1+j] * (y0**(j-1))
@@ -2836,7 +3378,7 @@ def velocity_transform_from_object(x0, y0, x0e, y0e, vx, vy, vxe, vye, transform
for i in range(1, N+1):
for j in range(1, N+2-i):
sub = 2*N + 2 + j + (2*N+2-i) * (i-1)/2.
- temp3 += i * Ycoeff[int(sub)] * (x0**(i-1)) * (y0**j)
+ temp3 += i * Ycoeff[int(sub)] * (x0**(i-1)) * (y0**j)
for j in range(1, N+2):
temp4 += j * Ycoeff[N+1+j] * (y0**(j-1))
@@ -2867,7 +3409,7 @@ def check_trans_input(list_of_starlists, trans_input, mag_trans):
if trans_input != None:
assert len(trans_input) == len(list_of_starlists)
- if mag_trans:
+ if mag_trans:
for ii in range(len(trans_input)):
if trans_input[ii] != None:
try:
@@ -2876,33 +3418,50 @@ def check_trans_input(list_of_starlists, trans_input, mag_trans):
print('Missing trans.mag_offset on trans_input[{0:d}].'.format(ii))
print('Setting mag_offset = 0 and dm_tol[0] = 100 and hoping for the best!!')
trans_input[ii].mag_offset = 0.0
-
+
return
-def trans_initial_guess(ref_list, star_list, trans_args, motion_model_dict, mode='miracle',
- ignore_contains='star', verbose=True, n_req_match=3,
- mag_trans=True, order=1):
+def trans_initial_guess(
+ ref_list,
+ star_list,
+ trans_args,
+ mode='miracle',
+ order=1,
+ briteN=None,
+ n_req_match=3,
+ polygon_reflist=None,
+ polygon_starlist=None,
+ buffer=0,
+ motion_models=None,
+ fixed_params_dict=None,
+ ignore_contains='star',
+ mag_trans=True,
+ verbose=True
+):
"""
Take two starlists and perform an initial matching and transformation.
This function will grow with time to handle difference types of initial
guess transformations (triangle matching, match by name, etc.). For now it
- is just blind triangle matching on the brightest 50 stars.
+ is just blind triangle matching on the brightest 50 stars.
"""
warnings.filterwarnings('ignore', category=AstropyUserWarning)
-
+ if motion_models is None:
+ motion_models = []
+
+ # Match by name
if mode == 'name':
# First trim the two lists down to only those that don't contain
# the "ignore_contains" string.
- idx_r = np.flatnonzero(np.char.find(ref_list['name'], ignore_contains) == -1)
- idx_s = np.flatnonzero(np.char.find(star_list['name'], ignore_contains) == -1)
+ idx_r = np.flatnonzero(np.char.find(ref_list['name'].astype(str), ignore_contains) == -1)
+ idx_s = np.flatnonzero(np.char.find(star_list['name'].astype(str), ignore_contains) == -1)
# Match the star names
name_matches, ndx_r, ndx_s = np.intersect1d(ref_list['name'][idx_r],
star_list['name'][idx_s],
assume_unique=True,
return_indices=True)
-
+
x1m = star_list['x'][idx_s][ndx_s]
y1m = star_list['y'][idx_s][ndx_s]
m1m = star_list['m'][idx_s][ndx_s]
@@ -2911,31 +3470,47 @@ def trans_initial_guess(ref_list, star_list, trans_args, motion_model_dict, mode
m2m = ref_list['m'][idx_r][ndx_r]
N = len(x1m)
- else:
- # Default is miracle match.
- briteN = min(50, len(star_list))
+ # Default is miracle match.
+ elif mode == 'miracle':
+ if briteN is None:
+ briteN = min(50, len(star_list))
+ else:
+ assert (type(briteN) == int) and (briteN > 0), f'briteN must be a positive integer, but got {briteN}.'
# If there are velocities in the reference list, use them.
# We assume velocities are in the same units as the positions.
- xref, yref = get_pos_at_time(star_list['t'][0], ref_list, motion_model_dict)
+ xref, yref = infer_positions(star_list['t'][0], ref_list, motion_models, fixed_params_dict=fixed_params_dict)
if 'm' in ref_list.colnames:
mref = ref_list['m']
else:
mref = ref_list['m0']
-
- N, x1m, y1m, m1m, x2m, y2m, m2m = match.miracle_match_briteN(star_list['x'],
- star_list['y'],
- star_list['m'],
- xref,
- yref,
- mref,
- briteN)
-
- err_msg = 'Failed to find more than '+str(n_req_match)
- err_msg += ' (only ' + str(len(x1m)) + ') matches, giving up.'
- assert len(x1m) >= n_req_match, err_msg
+
+ N, x1m, y1m, m1m, x2m, y2m, m2m = match.miracle_match_briteN(
+ star_list['x'],
+ star_list['y'],
+ star_list['m'],
+ xref,
+ yref,
+ mref,
+ briteN,
+ polygon_reflist,
+ polygon_starlist,
+ buffer=buffer
+ )
+ else:
+ raise ValueError(f'flystar.align.trans_initial_guess: Unknown mode: {mode}. Must be one of ["name", "miracle"].')
+
+ if len(x1m) < n_req_match:
+ fig, ax = plt.subplots()
+ ax.scatter(star_list['x'], star_list['y'], s=1, label='star_list')
+ ax.scatter(xref, yref, s=1, label='ref_list')
+ ax.legend()
+ ax.set_aspect('equal')
+ plt.show()
+ raise AssertionError(f'Failed to find more than {n_req_match} (only {len(x1m)}) matches, giving up.')
+
if verbose > 1:
- print('initial_guess: {0:d} stars matched between starlist and reference list'.format(N))
+ print('Initial_guess: {0:d} stars matched between starlist and reference list'.format(N))
# Calculate position transformation based on matches
if ('order' in trans_args) and (trans_args['order'] == 0):
@@ -2952,12 +3527,15 @@ def trans_initial_guess(ref_list, star_list, trans_args, motion_model_dict, mode
trans.mag_offset = np.mean(m2m - m1m)
else:
trans.mag_offset = 0
-
+
if verbose > 1:
- print('init guess: ', trans.px.parameters, trans.py.parameters)
+ print('Initial guess:')
+ print(f'{trans.px.parameters=}')
+ print(f'{trans.py.parameters=}')
+ print(f'{trans.mag_offset=}')
warnings.filterwarnings('default', category=AstropyUserWarning)
-
+
return trans
@@ -2967,7 +3545,7 @@ def update_old_and_new_names(ref_table, list_index, idx_ref_new):
new_name_len_max = 0
for ss in idx_ref_new:
- new_name = '{0:3d}_{1:s}'.format(list_index, ref_table['name_in_list'][ss, list_index])
+ new_name = f"{list_index:3d}_{str(ref_table['name_in_list'][ss, list_index]):s}"
new_names.append(new_name)
new_name_len_max = max(new_name_len_max, len(new_name))
@@ -2979,15 +3557,15 @@ def update_old_and_new_names(ref_table, list_index, idx_ref_new):
all_names = old_names.astype('U{0:d}'.format(new_name_len_max))
else:
all_names = old_names
-
+
all_names[idx_ref_new] = new_names
-
+
return all_names
def copy_and_rename_for_ref(star_list):
"""
Make a deep copy of the starlist and rename the columns to include
- "0". This only applies to x, y, m and xe, ye, me (if they exist)
+ "0". This only applies to x, y, m and xe, ye, me (if they exist)
columns.
Input
@@ -3010,7 +3588,7 @@ def copy_and_rename_for_ref(star_list):
if 'w' in star_list.colnames:
old_cols += ['w']
new_cols += ['w']
-
+
ref_list = copy.deepcopy(star_list)
for ii in range(len(old_cols)):
@@ -3018,51 +3596,51 @@ def copy_and_rename_for_ref(star_list):
return ref_list
-def outlier_rejection_indices(star_list, ref_list, outlier_tol, verbose=True):
+def outlier_rejection_indices(star_list, ref_list, outlier_tol, motion_models, fixed_params_dict=None, verbose=True):
"""
Determine the outliers based on the residual positions between two different
- starlists and some threshold (in sigma). Return the indices of the stars
- to keep (that shouldn't be rejected as outliers).
+ starlists and some threshold (in sigma). Return the indices of the stars
+ to keep (that shouldn't be rejected as outliers).
Note that we assume that the star_list and ref_list are already transformed and
- matched.
+ matched.
Parameters
----------
star_list : StarList
starlist with 'x', 'y'
-
ref_list : StarList
starlist with 'x0', 'y0'
-
outlier_tol : float
- Number of sigma inside which we keep stars and outside of which we
- reject stars as outliers.
-
- Optional Parameters
- --------------------
- verbose : boolean
+ Number of sigma inside which we keep stars and outside of which we
+ reject stars as outliers.
+ motion_models : list of motion_model objects
+ The motion models to use in the star_list
+ fixed_params_dict : dict or None, optional
+ Dictionary of fixed parameters for motion models, by default None
+ verbose : bool, optional
+ If True, print information about the outlier rejection process, by default True
Returns
----------
- keepers : nd.array
- The indicies of the stars to keep.
+ keepers : bool array
+ The boolean array of the stars to keep.
"""
# Optionally propogate the reference positions forward in time.
- xref, yref = get_pos_in_time(star_list['t'][0], ref_list)
-
+ xref, yref = infer_positions(star_list['t'][0], ref_list, motion_models, fixed_params_dict=fixed_params_dict)
+
# Residuals
x_resid_on_old_trans = star_list['x'] - xref
y_resid_on_old_trans = star_list['y'] - yref
resid_on_old_trans = np.hypot(x_resid_on_old_trans, y_resid_on_old_trans)
threshold = outlier_tol * resid_on_old_trans.std()
- keepers = np.where(resid_on_old_trans < threshold)[0]
+ keepers = resid_on_old_trans < threshold
if verbose > 0:
msg = ' Outlier Rejection: Keeping {0:d} of {1:d}'
- print(msg.format(len(keepers), len(resid_on_old_trans)))
-
+ print(msg.format(sum(keepers), len(resid_on_old_trans)))
+
return keepers
def setup_trans_info(trans_input, trans_args, N_lists, iters):
@@ -3082,12 +3660,12 @@ def setup_trans_info(trans_input, trans_args, N_lists, iters):
if type(trans_args) == dict:
tmp = trans_args
trans_args = [tmp for ii in range(iters)]
-
+
return trans_list, trans_args
def apply_mag_lim(star_list, mag_lim):
- """ Apply a magnitude limit to the list. If no magnitude limit is
- specified, then return a copy of the list. This works on a
+ """ Apply a magnitude limit to the list. If no magnitude limit is
+ specified, then return a copy of the list. This works on a
reference list (with 'm0') or a star_list ('m') with 'm0' taking
priority.
@@ -3106,7 +3684,7 @@ def apply_mag_lim(star_list, mag_lim):
mcol = 'm'
conditions = {}
-
+
cond_key = '{0:s}_min'.format(mcol)
conditions[cond_key] = mag_lim[0]
@@ -3124,7 +3702,7 @@ def get_weighting_scheme(weights, ref_list, star_list):
else:
var_xref = 0.0
var_yref = 0.0
-
+
if 'xe' in star_list.colnames:
var_xlis = star_list['xe']**2
var_ylis = star_list['ye']**2
@@ -3155,41 +3733,9 @@ def get_weighting_scheme(weights, ref_list, star_list):
return weight
-# TODO: This is sometimes run on a startable, not a starlist, at least as currently used
-def get_pos_at_time(t, starlist, motion_model_dict):
- """
- Take a starlist, check to see if it has motion/velocity columns.
- If it does, then propogate the positions forward in time
- to the desired epoch. If no motion/velocities exist, then just
- use ['x0', 'y0'] or ['x', 'y']
-
- Inputs
- ----------
- t_array : float
- The time to propogate to. Usually in decimal years;
- but it should be in the same units
- as the 't0' column in starlist.
- """
- # Check for motion model
- if 'motion_model_used' in starlist.colnames:
- x,y,xe,ye = starlist.get_star_positions_at_time(t, motion_model_dict, allow_alt_models=True)
- # If no motion model, check for velocities
- elif ('vx' in starlist.colnames) and ('vy' in starlist.colnames):
- x = starlist['x0'] + starlist['vx']*(t-starlist['t0'])
- y = starlist['y0'] + starlist['vy']*(t-starlist['t0'])
- # If no velocities, try fitted positon
- elif ('x0' in starlist.colnames) and ('y0' in starlist.colnames):
- x = starlist['x0']
- y = starlist['y0']
- # Otherwise, use measured position
- else:
- x = starlist['x']
- y = starlist['y']
-
- return (x, y)
def logger(logfile, message, verbose = 9):
if verbose > 4:
print(message)
logfile.write(message + '\n')
- return
+ return
\ No newline at end of file
diff --git a/flystar/analysis.py b/flystar/analysis.py
index 3121458..7deaa36 100644
--- a/flystar/analysis.py
+++ b/flystar/analysis.py
@@ -1,17 +1,11 @@
import numpy as np
import pylab as plt
-from flystar import starlists
-from flystar import startables
-from flystar import align
-from flystar import match
-from flystar import transforms
+from . import starlists, match
from astropy import table
from astropy.table import Table, Column
from astropy.coordinates import SkyCoord
from astropy import units as u
from astropy.wcs import WCS
-from astroquery.gaia import Gaia
-from astroquery.mast import Observations, Catalogs
import pdb, copy
import math
from scipy.stats import f
@@ -35,13 +29,14 @@ def query_gaia(ra, dec, search_radius=30.0, table_name='gaiadr3'):
Dec. in degrees in the format such as '-29:00:28.0'
search_radius : float
- The search radius in arcseconds.
+ The search radius in arcseconds.
Optional Input
--------------
table_name : string
Options are 'gaiadr2' or 'gaiaedr3'
"""
+ from astroquery.gaia import Gaia
target_coords = SkyCoord(ra, dec, unit=(u.hourangle, u.deg), frame='icrs')
ra = target_coords.ra.degree
dec = target_coords.dec.degree
@@ -49,11 +44,12 @@ def query_gaia(ra, dec, search_radius=30.0, table_name='gaiadr3'):
search_radius *= u.arcsec
Gaia.ROW_LIMIT = 50000
- gaia_job = Gaia.cone_search_async(target_coords, search_radius, table_name = table_name + '.gaia_source')
+ gaia_job = Gaia.cone_search_async(target_coords, radius=search_radius, table_name=table_name + '.gaia_source')
gaia = gaia_job.get_results()
#Change new 'SOURCE_ID' column header back to lowercase 'source_id' so all subsequent functions still work:
- gaia['SOURCE_ID'].name = 'source_id'
+ if 'SOURCE_ID' in gaia.colnames:
+ gaia.rename_column('SOURCE_ID', 'source_id')
return gaia
@@ -107,13 +103,13 @@ def check_gaia_parallaxes(ra,dec,search_radius=10.0,table_name='gaiadr3',target=
plt.yscale('log')
plt.tight_layout()
plt.savefig('gaiaplx'+file_ext+'.png')
-
+
def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2, pi_err_limit=0.4, default_motion_model='Linear'):
"""
Take a Gaia table (from astroquery) and produce a new table with a tangential projection
- and shift such that the origin is centered on the target of interest.
- Convert everything into arcseconds and name columns such that they are
+ and shift such that the origin is centered on the target of interest.
+ Convert everything into arcseconds and name columns such that they are
ready for FlyStar input.
Inputs
@@ -130,7 +126,7 @@ def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2,
target_coords = SkyCoord(ra, dec, unit=(u.hourangle, u.deg), frame='icrs')
ra = target_coords.ra.degree # in decimal degrees
dec = target_coords.dec.degree # in decimal degrees
-
+
cos_dec = np.cos(np.radians(dec))
x = (gaia['ra'] - ra) * cos_dec * 3600.0 # arcsec
y = (gaia['dec'] - dec) * 3600.0 # arcsec
@@ -149,7 +145,7 @@ def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2,
gaia_new['vy'] = gaia['pmdec'].data / 1e3
gaia_new['vx_err'] = gaia['pmra_error'].data / 1e3
gaia_new['vy_err'] = gaia['pmdec_error'].data / 1e3
-
+
gaia_new['t0'] = gaia['ref_epoch'].data
gaia_new['source_id'] = gaia['source_id'].data.astype('S19')
@@ -159,7 +155,7 @@ def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2,
gaia_new['vy'][idx] = 0.0
gaia_new['vx_err'][idx] = 0.0
gaia_new['vy_err'][idx] = 0.0
-
+
gaia_new['m'] = gaia['phot_g_mean_mag']
gaia_new['me'] = 1.09/gaia['phot_g_mean_flux_over_error']
gaia_new['pi'] = gaia['parallax'].data*1e-3
@@ -171,7 +167,7 @@ def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2,
gaia_new['vx_err'][idx] = 0.0
gaia_new['vy'][idx] = 0.0
gaia_new['vy_err'][idx] = 0.0
-
+
# Cut out stars with high plx error and set motion models
idx = np.where((gaia_new['pi_err']>(pi_err_limit/1e3)) | (gaia['parallax'].mask == True))[0]
gaia_new['pi'][idx] = 0.0
@@ -190,9 +186,13 @@ def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2,
gaia_new['motion_model_input'] = 'Fixed'
gaia_new['motion_model_used'] = 'Fixed'
gaia_new['n_params'] = 1
+ elif default_motion_model=='Empty':
+ gaia_new['motion_model_input'] = 'Empty'
+ gaia_new['motion_model_used'] = 'Empty'
+ gaia_new['n_params'] = 0
else:
print("Invalid motion model",default_motion_model,"- none assigned")
-
+
#macy additions to try to fix wild magnitude values
#gaia_new['ruwe'] = gaia['ruwe']
#try:
@@ -228,9 +228,9 @@ def prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=None, match_dr_max=0.2,
print('Found match for: ', targ_names[idx], ' - ',gaia_new['source_id'][i_gaia])
return gaia_new
-
+
def run_flystar():
-
+
test_file = '/u/jlu/work/microlens/OB150211/a_2018_10_19/a_ob150211_2018_10_19/lis/stars_matched2.fits'
t = Table.read(test_file)
@@ -262,39 +262,39 @@ def run_flystar():
ym_t = y0 + vy * (t - t0)
# Model distorted positions
-
-
+
+
return
def project_gaia(gaia, epoch, ra, dec):
"""
Take the Gaia measurements, forward them in time, and then convert them into a tangential projection.
-
+
Inputs
----------
epoch : float (year)
The decimal year to project the measurement to. Note that we use 365.25 days per year.
-
+
ra : float (deg)
The right ascension (J2000) in decimal degrees of the center of the field.
-
+
dec : float (deg)
The declination (J2000) in decimal degrees of the center of the field.
-
+
"""
t0 = gaia['ref_epoch']
x0 = (gaia['ra'] - ra) * np.cos(np.radians(dec)) * 3600.0 # Arcsec
y0 = (gaia['dec'] - dec) * 3600.0
x0e = gaia['ra_error'] / 1.0e3 # arcsec, already in alpha* (multiplied by cos(delta))
y0e = gaia['dec_error'] / 1.0e3 # arcsec
-
-
+
+
vx = gaia['pmra'] / 1.0e3 # arcsec / yr
- vy = gaia['pmdec'] / 1.0e3
+ vy = gaia['pmdec'] / 1.0e3
vxe = gaia['pmra_error'] / 1.0e3 # arcsec / yr
vye = gaia['pmdec_error'] / 1.0e3
-
+
# Modify any vx/vy, etc. that are zero and make a regular (unmasked) numpy array.
vx[vx.mask] = 0.0
vy[vy.mask] = 0.0
@@ -304,29 +304,29 @@ def project_gaia(gaia, epoch, ra, dec):
vy = np.array(vy)
vxe = np.array(vxe)
vye = np.array(vye)
-
+
dt = epoch - t0
x_now = (x0 + (vx * dt)) * -1.0 # Switch to a left-handed coordinate system, like detector pixels.
y_now = (y0 + (vy * dt))
xe_now = np.hypot(x0e, vxe*dt)
ye_now = np.hypot(y0e, vye*dt)
-
+
# Format as a starlist
- gaia_lis = starlists.StarList(name=gaia['source_id'],
+ gaia_lis = starlists.StarList(name=gaia['source_id'],
x=x_now, y=y_now, m=gaia['phot_g_mean_mag'],
xe=xe_now, ye=ye_now, me=1.0/gaia['phot_g_mean_flux_over_error'])
-
+
# Duplicate columns to 'x_avg', etc. Needed for initial guessing.
gaia_lis['x_avg'] = gaia_lis['x']
gaia_lis['y_avg'] = gaia_lis['y']
- gaia_lis['m_avg'] = gaia_lis['m']
-
+ gaia_lis['m_avg'] = gaia_lis['m']
+
return gaia_lis
def rename_after_flystar(star_tab, label_dat_file, new_copy=True, dr_tol=0.05, dm_tol=0.3, verbose=False):
"""
- Take a StarTable output from FlyStar MosaicToRef that has been
+ Take a StarTable output from FlyStar MosaicToRef that has been
aligned into R.A. and Dec. (usually by way of Gaia). Align
the output to a label.dat file for this source and rename
everything.
@@ -354,20 +354,20 @@ def rename_after_flystar(star_tab, label_dat_file, new_copy=True, dr_tol=0.05, d
x_lab[ndx_lab[ii]], star_tab['x0'][ndx_star[ii]],
y_lab[ndx_lab[ii]], star_tab['y0'][ndx_star[ii]],
m_lab[ndx_lab[ii]], star_tab['m0'][ndx_star[ii]]))
-
+
print('Temporary shift transformations: ')
print(' dm = {0:8.4f} +/- {1:8.4f}'.format(dm.mean(), dm.std()))
print(' dx = {0:8.4f} +/- {1:8.4f}'.format(dx.mean(), dx.std()))
print(' dy = {0:8.4f} +/- {1:8.4f}'.format(dy.mean(), dy.std()))
-
+
m_lab = label_tab['m'] + dm.mean()
x_lab += dx.mean()
y_lab += dy.mean()
-
+
# Now that we are in a common coordinate and magnitude
# system, lets match the whole lists by coordinates.
- idx_lab, idx_star, dr, dm = match.match(x_lab, y_lab, m_lab,
+ idx_lab, idx_star, dr, dm = match.match(x_lab, y_lab, m_lab,
star_tab['x0'], star_tab['y0'], star_tab['m0'],
dr_tol=dr_tol, dm_tol=dm_tol, verbose=verbose)
#print('idx_lab:')
@@ -375,7 +375,7 @@ def rename_after_flystar(star_tab, label_dat_file, new_copy=True, dr_tol=0.05, d
# print(label_tab["name"][idx_lab[iii]], star_tab["name"][idx_star[iii]])
print('Renaming {0:d} out of {1:d} stars'.format(len(idx_lab), len(star_tab)))
-
+
# Make a copy of the table, UNLESS, the user specifies.
if new_copy:
new_tab = copy.deepcopy(star_tab)
@@ -385,9 +385,9 @@ def rename_after_flystar(star_tab, label_dat_file, new_copy=True, dr_tol=0.05, d
# copy over the original names... don't overwrite (this could mean data loss)
if 'name_orig' not in new_tab.colnames:
new_tab.add_column(Column(star_tab['name'].data, name='name_orig'))
-
+
new_tab['name'][idx_star] = label_tab[idx_lab]['name']
-
+
return new_tab
def pick_good_ref_stars(star_tab, r_cut=None, m_cut=None, p_err_cut=None, pm_err_cut=None, name_cut=None, reset=True):
@@ -432,9 +432,9 @@ def pick_good_ref_stars(star_tab, r_cut=None, m_cut=None, p_err_cut=None, pm_err
def startable_subset(tab, idx, mag_trans=True, mag_trans_orig=False):
"""
- Input is MosaicToRef table from alignment of multiple filters,
+ Input is MosaicToRef table from alignment of multiple filters,
such that the astrometry is combined but the photometry is not.
- This function is used to separate out a selected filter from the
+ This function is used to separate out a selected filter from the
combined astrometry + uncombined photometry table.
"""
# Multiples: ['x', 'y', 'm', 'name_in_list', 'xe', 'ye', 'me', 't',
@@ -466,7 +466,7 @@ def startable_subset(tab, idx, mag_trans=True, mag_trans_orig=False):
# Update the original table.
if mag_trans_orig:
tab['m'][:,idx[ii]] += mag_offset
-
+
return new_tab
@@ -476,13 +476,13 @@ def startable_subset(tab, idx, mag_trans=True, mag_trans_orig=False):
def calc_chi2(ref_mat, starlist_mat, transform, errs='both'):
"""
- calculate the chi2 and reduced chi2 of the position
+ calculate the chi2 and reduced chi2 of the position
between two matched starlists.
Input:
ref_mat: astropy table
Reference starlist only containing matched stars that were used in the
transformation. Standard column headers are assumed.
-
+
starlist_mat: astropy table
Transformed starlist only containing the matched stars used in
the transformation. Standard column headers are assumed.
@@ -522,7 +522,7 @@ def calc_chi2(ref_mat, starlist_mat, transform, errs='both'):
elif errs == 'starlist':
xerr = starlist_mat['xe']
yerr = starlist_mat['ye']
-
+
# For both X and Y, calculate chi-square. Combine arrays to get combined
# chi-square
@@ -530,11 +530,11 @@ def calc_chi2(ref_mat, starlist_mat, transform, errs='both'):
chi_sq_y = diff_y**2. / yerr**2.
chi_sq = np.append(chi_sq_x, chi_sq_y)
-
+
# Calculate degrees of freedom in transformation
num_mod_params = calc_nparam(transform)
deg_freedom = len(chi_sq) - num_mod_params
-
+
# Calculate reduced chi-square
chi_sq = np.sum(chi_sq)
chi_sq_red = chi_sq / deg_freedom
@@ -551,7 +551,7 @@ def calc_nparam(transformation):
nparam = 4
elif transformation.__class__.__name__ == 'PolyTransform':
order = transformation.order
- nparam = (order+1) * (order+2)
+ nparam = (order+1) * (order+2)
return nparam
def calc_F(red_chi2_1, red_chi2_2, v1, v2):
@@ -572,24 +572,24 @@ def calc_F(red_chi2_1, red_chi2_2, v1, v2):
for 1st order polynomial fitting:
x' = a0 + a1*x + a2*y
y' = b0 + b1*x + b2*y
- v1 = 2*N1 - 2*3 (2*: because x and y direction)
+ v1 = 2*N1 - 2*3 (2*: because x and y direction)
red_chi2_1 = chi2/v1
for 2nd order polynomial fitting:
x' = a0 + a1*x + a2*y + a3*x**2 + a4*y**2 + a5*x*y
y' = b0 + b1*x + b2*y + b3*x**2 + b4*y**2 + b5*x*y
- v1 = 2*N1 - 2*6
+ v1 = 2*N1 - 2*6
red_chi2_2 = chi2/v2
calc_F(red_chi2_1, red_chi2_2, v1, v2)
-
+
***Note***
- * make sure the first model is the simple model
+ * make sure the first model is the simple model
and the second model is the more complicated model
- * the return value represents the probability that
+ * the return value represents the probability that
the first model is better than the second model, in other words,
the small P means the more colicated model is needed.
the large P means the simple model is good enough.
- * normally, the P value will increase from model1->model2, to
- model2->model3, to model3->model4. The user can decide a
+ * normally, the P value will increase from model1->model2, to
+ model2->model3, to model3->model4. The user can decide a
critical value (eg, 0.7) to find the proper model.
"""
diff --git a/flystar/archive_io.py b/flystar/archive_io.py
index 88de5cb..2177e40 100755
--- a/flystar/archive_io.py
+++ b/flystar/archive_io.py
@@ -1,9 +1,9 @@
import pickle
-# Need to add these functions to a utility .py file rather than storing them in general structure.
+# Need to add these functions to a utility .py file rather than storing them in general structure.
def open_archive(file_name):
"""
- Helper function to open archived files.
+ Helper function to open archived files.
"""
with open(file_name, 'rb') as file_archive:
file_dict = pickle.load(file_archive)
@@ -11,7 +11,7 @@ def open_archive(file_name):
def save_archive(file_name, save_data):
"""
- Helper function to archive a file.
+ Helper function to archive a file.
"""
with open(file_name, 'wb') as outfile:
pickle.dump(save_data, outfile, protocol=pickle.HIGHEST_PROTOCOL)
diff --git a/flystar/examples.py b/flystar/examples.py
index 8059562..0165cb3 100644
--- a/flystar/examples.py
+++ b/flystar/examples.py
@@ -1,11 +1,5 @@
-from flystar import transforms
-from flystar import match
-from flystar import align
-from flystar import starlists
-from flystar import plots
import numpy as np
-import copy
-import pdb
+from . import transforms, match, align, starlists, plots
def align_example(labelFile, reference, transModel=transforms.four_paramNW, order=1, N_loop=2,
@@ -38,7 +32,7 @@ def align_example(labelFile, reference, transModel=transforms.four_paramNW, orde
dr_tol: float (default = 1.0)
The search radius for the matching algorithm, in the same units as the
starlist file positions.
-
+
dm_tol: float or None
If float, sets the maximum magnitude difference allowed in matching
between label.dat and starlist. Note that this should be set to
@@ -54,10 +48,10 @@ def align_example(labelFile, reference, transModel=transforms.four_paramNW, orde
outFile: string (default = 'outTrans.txt')
Name of output ascii file which contains the transform parameters.
-
+
Output:
------
-
+
"""
# Read in label.dat file and reference starlist, changing columns to their
# standard column headers/epochs/orientations
@@ -72,7 +66,7 @@ def align_example(labelFile, reference, transModel=transforms.four_paramNW, orde
# Apply intial transformation to label.dat (for error weighting purposes below)
label_trans = align.transform_from_object(label, trans)
-
+
# Use transformation to match starlists, then recalculate transformation.
# Iterate on this as many times as desired
for i in range(N_loop):
@@ -80,10 +74,10 @@ def align_example(labelFile, reference, transModel=transforms.four_paramNW, orde
trans,
dr_tol=dr_tol,
dm_tol=dm_tol)
-
+
trans, N_trans = align.find_transform(label[idx_label],
label_trans[idx_label],
- starlist_mat[idx_starlist],
+ starlist[idx_starlist],
transModel=transModel,
order=order, weights=weights)
@@ -91,14 +85,14 @@ def align_example(labelFile, reference, transModel=transforms.four_paramNW, orde
# Write final transform in java align format
print('Write transform to {0}'.format(outFile))
align.write_transform(trans, labelFile, reference, N_trans, outFile=outFile)
-
+
# Test transform: apply final transformation to label.dat
label_trans2 = align.transform(label, outFile)
# Make diagnostic plots
-
+
return
-
+
def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order=1, N_loop=2,
dr_tol=1.0, dm_tol=None, briteN=100, weights=None, restrict=False,
@@ -131,7 +125,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
dr_tol: float (default = 1.0)
The search radius for the matching algorithm, in the same units as the
starlist file positions.
-
+
dm_tol: float or None (default = None)
If float, sets the maximum magnitude difference allowed in matching
between label.dat and starlist. Note that this should be set to
@@ -143,7 +137,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
weights: string (default=None)
if weights=='both', we use both position error and velocity error in transformed
- starlist and reference starlist as uncertanties. And weights is the reciprocal
+ starlist and reference starlist as uncertanties. And weights is the reciprocal
of this uncertanty.
if weights=='starlist', we only use postion error and velocity error in transformed
starlist as uncertainty.
@@ -156,7 +150,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
outFile: string (default = 'outTrans.txt')
Name of output ascii file which contains the transform parameters.
-
+
Output:
------
outFile is written containing the tranformation coefficients
@@ -170,11 +164,11 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
positions and the label.dat positions after transformation.
-Positions_quiver.png: Quiver plot showing the difference between reference
- positions and transformed label.dat positions as a function of location.
-
+ positions and transformed label.dat positions as a function of location.
+
-Magnitude_hist.png: Histogram of the difference between the reference list
magnitude and label.dat magnitude for matched stars.
-
+
"""
# Read in label.dat file and reference starlist, changing columns to their
# standard column headers/epochs/orientations
@@ -192,10 +186,10 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
# Perform blind matching of 100 brightest stars and calculate initial transform
trans = align.initial_align(label_r, starlist, briteN, transformModel=transModel,
order=order)
-
+
# Apply transformation to label.dat file, for weighting purposes.
label_trans = align.transform_from_object(label, trans)
-
+
# Use transformation to match starlists, then recalculate transformation.
# Iterate on this as many times as desired
for i in range(N_loop):
@@ -223,7 +217,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
print('Write transform to {0}'.format(outFile))
align.write_transform(trans, labelFile, reference, N_trans, deltaMag=delta_m,
restrict=restrict, weights=weights, outFile=outFile)
-
+
# Test transform: apply to label.dat, make diagnostic plots
label_trans2 = align.transform_from_file(label, outFile)
@@ -241,7 +235,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
label_trans2[idx_label], xlim=xlim, ylim=ylim)
# Histogram of difference in transformed and reference positions for
- # matched stars
+ # matched stars
plots.pos_diff_hist(starlist[idx_starlist], label_trans2[idx_label])
# Histogram of difference in transformed and reference positions for
@@ -250,7 +244,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
plots.pos_diff_err_hist(starlist[idx_starlist], label_trans2[idx_label],
trans, errs='both', bin_width=0.5, xlim=[-6,6])
- # Histogram of difference in the magnitudes for the matched stars
+ # Histogram of difference in the magnitudes for the matched stars
plots.mag_diff_hist(starlist[idx_starlist], label_trans2[idx_label])
# Quiver plot showing difference between transformed and reference
@@ -260,7 +254,7 @@ def align_Arches(labelFile, reference, transModel=transforms.four_paramNW, order
ylim=ylim, outlier_reject=None)
print('Done with plots')
- print('Done with plots')
+ print('Done with plots')
return
@@ -274,7 +268,7 @@ def align_gc(starFile, refFile, transModel=transforms.PolyTransform, order=1, N_
Parameters:
-----------
starFile: string
- Starlist we would like to transform into the reference frame, eg:label.dat
+ Starlist we would like to transform into the reference frame, eg:label.dat
refFile: string
Starlist that defines the reference frame.
@@ -312,7 +306,7 @@ def align_gc(starFile, refFile, transModel=transforms.PolyTransform, order=1, N_
"""
#----------------------------------------------
- # Read in starlist and reference
+ # Read in starlist and reference
#----------------------------------------------
# starlist has postion & postion err
ref = starlists.read_starlist(refFile, error=True)
@@ -400,7 +394,7 @@ def align_starlists(starlist, ref, transModel=transforms.PolyTransform, order=2,
Parameters:
-----------
starlist: Table
- Starlist we would like to transform into the reference frame, eg:label.dat
+ Starlist we would like to transform into the reference frame, eg:label.dat
ref: Table
Starlist that defines the reference frame.
@@ -433,7 +427,7 @@ def align_starlists(starlist, ref, transModel=transforms.PolyTransform, order=2,
outFile: string('outTrans.txt')
the name of the output transformation file
"""
-
+
#--------------------------------------------------
# Initial transformation with brightest briteN stars
#--------------------------------------------------
diff --git a/flystar/match.py b/flystar/match.py
index d7c391e..241d334 100644
--- a/flystar/match.py
+++ b/flystar/match.py
@@ -1,23 +1,20 @@
+import copy
+import itertools
import numpy as np
-from flystar import starlists, transforms, startables, align
+import matplotlib.pyplot as plt
+from . import starlists, transforms, startables
from collections import Counter
-from scipy.spatial import cKDTree as KDT
-from astropy.table import Column, Table
-import itertools
-import copy
-import scipy.signal
-from scipy.spatial import distance
-import math
-import pdb
+from astropy.table import Column
+from scipy.spatial import KDTree as KDT
-def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
- Nbins_vmax=200, Nbins_angle=360,verbose=False):
+def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
+ polygon1=None, polygon2=None, buffer=0, Nbins_vmax=200, Nbins_angle=360,verbose=False):
"""
Take two input starlists and select the brightest stars from
each. Then perform a triangle matching algorithm along the lines of
Groth 1986.
-
+
For every possible triangle (combination of 3 stars) in a starlist,
compute the ratio of two sides and the angle between those sides.
These quantities are invariant under scale and rotation transformations.
@@ -30,23 +27,115 @@ def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
and brightness uncertainties, the more bigger the bin sizes should really
be. But this isn't well tested.
"""
-
+
if verbose:
print( '')
print( ' miracle_match_briteN: use brightest {0}'.format(Nbrite))
print( ' miracle_match_briteN: ')
print( ' miracle_match_briteN: ')
+ xin1 = np.array(xin1)
+ yin1 = np.array(yin1)
+ min1 = np.array(min1)
+ xin2 = np.array(xin2)
+ yin2 = np.array(yin2)
+ min2 = np.array(min2)
+
+ if (polygon1 is not None) and (polygon2 is not None):
+ import shapely
+ points1 = shapely.points(xin1, yin1)
+ points2 = shapely.points(xin2, yin2)
+ overlap = polygon1.intersection(polygon2).buffer(buffer)
+ in_poly1 = shapely.contains(overlap, points1)
+ in_poly2 = shapely.contains(overlap, points2)
+ xin1 = xin1[in_poly1]
+ yin1 = yin1[in_poly1]
+ min1 = min1[in_poly1]
+ xin2 = xin2[in_poly2]
+ yin2 = yin2[in_poly2]
+ min2 = min2[in_poly2]
+ # else:
+ # # Only look for matches within overlapping minimum-bounding-boxes of the 2 lists
+ # valid1 = (np.isfinite(xin1)) & (np.isfinite(yin1)) & (np.isfinite(min1))
+ # valid2 = (np.isfinite(xin2)) & (np.isfinite(yin2)) & (np.isfinite(min2))
+ # if (sum(valid1) < Nbrite) or (sum(valid2) < Nbrite):
+ # raise ValueError(
+ # f'Not enough valid stars to find matches! Need at least {Nbrite} valid stars.\n' +
+ # f'Valid stars in list 1: {sum(valid1)}\n' +
+ # f'Valid stars in list 2: {sum(valid2)}\n'
+ # )
+
+ # xin1 = xin1[valid1]
+ # yin1 = yin1[valid1]
+ # min1 = min1[valid1]
+ # xin2 = xin2[valid2]
+ # yin2 = yin2[valid2]
+ # min2 = min2[valid2]
+
+ # xmin1, xmax1 = np.min(xin1), np.max(xin1)
+ # ymin1, ymax1 = np.min(yin1), np.max(yin1)
+ # xmin2, xmax2 = np.min(xin2), np.max(xin2)
+ # ymin2, ymax2 = np.min(yin2), np.max(yin2)
+
+ # # Find the overlapping minimum bounding box
+ # x_overlap = (max(xmin1, xmin2), min(xmax1, xmax2))
+ # y_overlap = (max(ymin1, ymin2), min(ymax1, ymax2))
+ # if x_overlap[0] >= x_overlap[1] or y_overlap[0] >= y_overlap[1]:
+ # fig, ax = plt.subplots()
+ # ax.scatter(xin1, yin1, s=1, label='List 1')
+ # ax.scatter(xin2, yin2, s=1, label='List 2')
+ # ax.set_aspect('equal')
+ # ax.legend()
+ # plt.show()
+ # raise ValueError('The two star lists do not have an overlapping region!')
+
+ # # Select overlapping regions
+ # in_overlap1 = (xin1 >= x_overlap[0]) & (xin1 <= x_overlap[1]) & (yin1 >= y_overlap[0]) & (yin1 <= y_overlap[1])
+ # in_overlap2 = (xin2 >= x_overlap[0]) & (xin2 <= x_overlap[1]) & (yin2 >= y_overlap[0]) & (yin2 <= y_overlap[1])
+ # if sum(in_overlap1) < Nbrite or sum(in_overlap2) < Nbrite:
+ # raise ValueError(
+ # 'Not enough stars in the overlapping region to find matches!\n' +
+ # f'Stars in overlap for list 1: {sum(in_overlap1)}\n' +
+ # f'Stars in overlap for list 2: {sum(in_overlap2)}\n'
+ # )
+
+ # from matplotlib.patches import Rectangle
+ # fig, ax = plt.subplots()
+ # polygon1 = Rectangle((xmin1, ymin1), xmax1-xmin1, ymax1-ymin1, fill=True, edgecolor='C0', facecolor='C0', alpha=0.5, label='MBB List 1')
+ # polygon2 = Rectangle((xmin2, ymin2), xmax2-xmin2, ymax2-ymin2, fill=True, edgecolor='C2', facecolor='C2', alpha=0.5, label='MBB List 2')
+ # polygon_overlap = Rectangle((x_overlap[0], y_overlap[0]), x_overlap[1]-x_overlap[0], y_overlap[1]-y_overlap[0], fill=True, edgecolor='red', facecolor='C3', alpha=0.5, label='Overlap Region')
+ # ax.scatter(xin1, yin1, s=1, label='List 1')
+ # ax.scatter(xin2, yin2, s=1, label='List 2')
+ # ax.add_patch(polygon1)
+ # ax.add_patch(polygon2)
+ # ax.add_patch(polygon_overlap)
+ # ax.set_aspect('equal')
+ # ax.legend()
+ # plt.show()
+
+ # xin1 = xin1[in_overlap1]
+ # yin1 = yin1[in_overlap1]
+ # min1 = min1[in_overlap1]
+ # xin2 = xin2[in_overlap2]
+ # yin2 = yin2[in_overlap2]
+ # min2 = min2[in_overlap2]
+
# Get/check the lengths of the two starlists
nin1 = len(xin1)
nin2 = len(xin2)
if (nin1 < Nbrite) or (nin2 < Nbrite):
- print(( 'You need at least {0} to '.format(Nbrite)))
- print( 'find the matches...')
- print(( 'NIN1: ', nin1))
- print(( 'NIN2: ', nin2))
- return (0, None, None, None, None, None, None)
+ raise ValueError(
+ f'Not enough stars in the overlapping region to find matches! Need at least {Nbrite} valid stars.\n' +
+ f'Stars in overlap for list 1: {nin1}\n' +
+ f'Stars in overlap for list 2: {nin2}\n'
+ )
+ # print(f'WARNING: You need at least {Nbrite} to find the matches...')
+ # print(f'NIN1: {nin1}')
+ # print(f'NIN2: {nin2}')
+ # # Nbrite = min(nin1, nin2)
+ # # print(f'Updating Nbrite to {Nbrite}...')
+ # return (0, None, None, None, None, None, None)
# Take the Nbrite brightest stars from each list and order by brightness.
if verbose:
@@ -55,7 +144,7 @@ def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
print( ' miracle_match_briteN: ')
x1, y1, m1 = order_by_brite(xin1, yin1, min1, Nbrite, verbose=verbose)
x2, y2, m2 = order_by_brite(xin2, yin2, min2, Nbrite, verbose=verbose)
-
+
####################
#
# Triangle Matching
@@ -111,7 +200,6 @@ def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
idx2_vmax_hist = idx2_vmax_hist[good_idx2]
idx2_angl_hist = idx2_angl_hist[good_idx2]
-
##########
# Possible Matches
##########
@@ -125,7 +213,7 @@ def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
# Now vote for all stars in the triangles that have possible matches (same vmax, angle)
# between the first and second lists.
votes = np.zeros((Nbrite, Nbrite))
-
+
matches = np.where(stars_in1_matches2[:,0] >= 0)[0]
match_stars1 = stars_in1_matches2[matches,:]
match_stars2 = stars_in_tri2[matches,:]
@@ -138,7 +226,7 @@ def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
add_votes(votes, match_stars1[:,0], match_stars2[:,0])
add_votes(votes, match_stars1[:,1], match_stars2[:,1])
add_votes(votes, match_stars1[:,2], match_stars2[:,2])
-
+
##########
# Find matching triangles with most votes (and that pass threshold)
##########
@@ -166,7 +254,6 @@ def miracle_match_briteN(xin1, yin1, min1, xin2, yin2, min2, Nbrite,
x1_mat = x1[votes_sdx[0, good]]
y1_mat = y1[votes_sdx[0, good]]
m1_mat = m1[votes_sdx[0, good]]
-
return len(x1_mat), x1_mat, y1_mat, m1_mat, x2_mat, y2_mat, m2_mat
@@ -207,8 +294,8 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
if one is found that is the best match in both brightness and positional offsets
(closest in both), then the match is made. Otherwise,
their is a conflict and no match is returned for the star.
-
-
+
+
Parameters
x1 : array-like
X coordinate in the first catalog
@@ -230,9 +317,9 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
How close in delta-magnitude a match has to be to count as a match.
If None, then any delta-magnitude is allowed.
verbose : bool or int, optional
- Prints on screen information on the matching. Higher verbose values
+ Prints on screen information on the matching. Higher verbose values
(up to 9) provide more detail.
-
+
Returns
-------
idx1 : int array
@@ -245,27 +332,27 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
Distance between the matches.
dm : float array
Delta-mag between the matches. (m1 - m2)
-
+
"""
-
+
x1 = np.array(x1, copy=False)
y1 = np.array(y1, copy=False)
m1 = np.array(m1, copy=False)
x2 = np.array(x2, copy=False)
y2 = np.array(y2, copy=False)
m2 = np.array(m2, copy=False)
-
+
if x1.shape != y1.shape:
raise ValueError('x1 and y1 do not match!')
if x2.shape != y2.shape:
raise ValueError('x2 and y2 do not match!')
-
+
# Setup coords1 pairs and coords 2 pairs
# this is equivalent to, but faster than just doing np.array([x1, y1])
coords1 = np.empty((x1.size, 2))
coords1[:, 0] = x1
coords1[:, 1] = y1
-
+
# this is equivalent to, but faster than just doing np.array([x1, y1])
coords2 = np.empty((x2.size, 2))
coords2[:, 0] = x2
@@ -283,7 +370,7 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
#KDTree handling of NaNs throws error in scipy v1.10.1 and newer.
#Replace NaNs in coords2 with zero (0). -SKT
kdt = KDT(np.where(np.isfinite(coords2), coords2, 0), balanced_tree=False)
-
+
# This returns the number of neighbors within the specified
# radius. We will use this to find those stars that have no or one
# match and deal with them easily. The more complicated conflict
@@ -293,7 +380,6 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
# What is the largest number of matches we have for a given star?
Nmatch_max = Nmatch.max()
-
# Loop through and handle all the different numbers of matches.
# This turns out to be the most efficient so we can use numpy
# array operations. Remember, skip the Nmatch=0 objects... they
@@ -306,7 +392,7 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
if nn == 1:
i2_nn = np.array([i2_match[mm][0] for mm in i1_nn])
- if dm_tol != None:
+ if dm_tol is not None:
dm = np.abs(m1[i1_nn] - m2[i2_nn])
keep = dm < dm_tol
idxs1[i1_nn[keep]] = i1_nn[keep]
@@ -327,10 +413,10 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
x2_nn = x2[i2_tmp]
y2_nn = y2[i2_tmp]
m2_nn = m2[i2_tmp]
- dr = np.abs(x1_nn - x2_nn, y1_nn - y2_nn)
+ dr = np.hypot(x1_nn - x2_nn, y1_nn - y2_nn)
dm = np.abs(m1_nn - m2_nn)
- if dm_tol != None:
+ if dm_tol is not None:
# Don't even consider stars that exceed our
# delta-mag threshold.
dr_msk = np.ma.masked_where(dm > dm_tol, dr)
@@ -379,7 +465,7 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
# Assume the duplicates are confused first... see if we
# can resolve the confusion below.
keep[dups] = False
-
+
dm_dups = m1[idxs1[dups]] - m2[idxs2[dups]]
dr_dups = np.hypot(x1[idxs1[dups]] - x2[idxs2[dups]], y1[idxs1[dups]] - y2[idxs2[dups]])
@@ -391,7 +477,7 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
if dm_min == dr_min:
keep[dups[dm_min]] = True
else:
- if verbose:
+ if verbose > 3:
print(' confused, dropping star at',x2[idxs2[dups]][0],y2[idxs2[dups]][0])
@@ -400,12 +486,12 @@ def match(x1, y1, m1, x2, y2, m2, dr_tol, dm_tol=None, verbose=True):
idxs2 = idxs2[keep]
dr = dr[keep]
dm = dm[keep]
-
+
return idxs1, idxs2, dr, dm
def calc_triangles_vmax_angle(x, y):
idx = np.arange(len(x), dtype=np.int16)
-
+
# Option 1 -- this takes 0.217 seconds for 50 objects
# t1 = time.time()
# combo_iter1 = itertools.combinations(idx1, 3)
@@ -414,53 +500,53 @@ def calc_triangles_vmax_angle(x, y):
# print( 'Finished Option 1: ', t2 - t1)
# print( combo_idx1_1.shape)
# print( combo_idx1_1)
-
+
# Option 2 -- this takes 0.016 seconds for 50 objects
combo_iter = itertools.combinations(idx, 3)
combo_dt = np.dtype('i2,i2,i2')
combo_idx_tmp = np.fromiter(combo_iter, dtype=combo_dt)
combo_idx = combo_idx_tmp.view(np.int16).reshape(-1, 3)
-
+
ii0 = combo_idx[:,0]
ii1 = combo_idx[:,1]
ii2 = combo_idx[:,2]
-
+
dxab = x[ii1] - x[ii0]
dyab = y[ii1] - y[ii0]
dxac = x[ii2] - x[ii0]
dyac = y[ii2] - y[ii0]
-
+
dab = np.hypot(dxab, dyab)
dac = np.hypot(dxac, dyac)
-
+
dmax = np.max([dab, dac], axis=0)
dmin = np.min([dab, dac], axis=0)
-
+
vmax = dmin ** 2 / dmax ** 2
vmax[dab < dac] *= -1
-
+
vdprod = dxab * dxac + dyab * dyac
vcprod = dxab * dyac - dyab * dxac
-
+
angle = np.degrees( np.arctan2( vdprod, vcprod) )
angle[angle < 0] += 360.0
angle[angle > 360] -= 360.0
-
+
return combo_idx, vmax, angle
def add_votes(votes, match1, match2):
# Construct a histogram of how often a bin is matched... then add the delta
flat_idx = np.ravel_multi_index((match1, match2), dims=votes.shape)
-
+
# extract the unique indices and their position
unique_idx, idx_idx = np.unique(flat_idx, return_inverse=True)
-
+
# aggregate the repeated indices
deltas = np.bincount(idx_idx)
-
+
# Sum them to the array
votes.flat[unique_idx] += deltas
-
+
return
@@ -517,7 +603,7 @@ def generic_match(sl1, sl2, init_mode='triangle',
init_mode
verbose : bool, optional
Prints on screen information on the matching
-
+
Returns
-------
transf : Transform2D
@@ -526,16 +612,17 @@ def generic_match(sl1, sl2, init_mode='triangle',
Startable of the two matched catalogs
"""
-
+ from . import align
+
# Check the input StarLists and transform them into astropy Tables
if not isinstance(sl1, starlists.StarList):
raise TypeError("The first catalog has to be a StarList")
if not isinstance(sl2, starlists.StarList):
raise TypeError("The second catalog has to be a StarList")
-
+
# Find the initial transformation
if init_mode == 'triangle': # Blind triangles method
-
+
# Prepare the reduced starlists for matching
sl1_cut = copy.deepcopy(sl1)
sl2_cut = copy.deepcopy(sl2)
@@ -545,21 +632,21 @@ def generic_match(sl1, sl2, init_mode='triangle',
y_min=xy_match[6], y_max=xy_match[7])
sl1_cut.restrict_by_value(m_min=m_match[0], m_max=m_match[1])
sl2_cut.restrict_by_value(m_min=m_match[2], m_max=m_match[3])
-
+
# Find the transformation
# TODO: test 'initial_align' with StarList input
transf = align.initial_align(sl1_cut, sl2_cut, briteN=n_bright,
transformModel=model, order=order_dr[0]) #order_dr[i_loop][0] ?
-
+
elif init_mode == 'match_name': # Name match
sl1_idx_init, sl2_idx_init, _ = starlists.restrict_by_name(sl1, sl2)
transf = model(sl2['x'][sl2_idx_init], sl2['y'][sl2_idx_init],
sl1['x'][sl1_idx_init], sl1['y'][sl1_idx_init],
order=int(order_dr[0][0]))
-
+
elif init_mode == 'load': # Load a transformation file
transf = transforms.Transform2D.from_file(kwargs['transf_file'])
-
+
else: # None of the above
raise TypeError("Unrecognized initial matching method")
@@ -568,20 +655,24 @@ def generic_match(sl1, sl2, init_mode='triangle',
sl2_match = copy.deepcopy(sl2)
sl1_match.restrict_by_value(m_min=m_match[0], m_max=m_match[1])
sl2_match.restrict_by_value(m_min=m_match[2], m_max=m_match[3])
-
+
# Refine the transformation
if sigma_match:
order_dr_len = len(order_dr)
-
+
for i_loop in range(sigma_match[1]):
order_dr = np.vstack((np.array(order_dr), np.array(order_dr[-1])))
-
+
for i_loop in range(len(order_dr)):
-
+
# Transform and match the catalog to the reference frame
# sl2_idx, sl1_idx = align.transform_and_match(sl2_match, sl1_match, transf,
# dr_tol=order_dr[i_loop][1],
# verbose=verbose)
+ import matplotlib.pyplot as plt
+ plt.clf()
+ plt.plot(sl1_match['x'], sl1_match['y'], 'x', ms=10)
+ plt.plot(sl2_match['x'], sl2_match['y'], 'o')
sl2_idx, sl1_idx = align.transform_and_match(sl2_match, sl1_match, transf,
dr_tol=order_dr[1],
@@ -589,7 +680,7 @@ def generic_match(sl1, sl2, init_mode='triangle',
# Transform the catalog to the reference frame
sl2_transf_match = align.transform_from_object(sl2_match, transf)
-
+
# Sigma-rejection
if sigma_match and (i_loop >= order_dr_len):
resid = np.sqrt((sl1_match['x'][sl1_idx] -
@@ -598,29 +689,29 @@ def generic_match(sl1, sl2, init_mode='triangle',
sl2_transf_match['y'][sl2_idx])**2)
sl1_idx = sl1_idx[resid <= (sigma_match[0] * np.std(resid))]
sl2_idx = sl2_idx[resid <= (sigma_match[0] * np.std(resid))]
-
+
# Test section to observe the matching catalogs before refining the transformation
"""
from matplotlib import pyplot
-
+
_, axarr = pyplot.subplots(nrows=1, ncols=1, figsize=(10,10))
axarr.scatter(sl1_match['x'][sl1_idx], sl1_match['y'][sl1_idx])
xlim = axarr.get_xlim()
ylim = axarr.get_ylim()
-
+
_, axarr = pyplot.subplots(nrows=1, ncols=1, figsize=(10, 10))
axarr.scatter(sl2_transf_match['x'][sl2_idx], sl2_transf_match['y'][sl2_idx])
axarr.set_xlim(xlim)
axarr.set_ylim(ylim)
"""
-
+
# Find a better transformation
transf, _ = align.find_transform(sl2_match[sl2_idx],
sl2_transf_match[sl2_idx],
sl1_match[sl1_idx], transModel=model,
order=order_dr[0], verbose=verbose)
# order=int(order_dr[i_loop][0]), verbose=verbose)
-
+
# This section was used for testing transformations with normalized
# coordinates. Only several catalogs had reduced residuals when using
# high order polynomials (>3), some of them became unstable
@@ -639,15 +730,15 @@ def generic_match(sl1, sl2, init_mode='triangle',
sl1_match_norm, transModel=model,
order=poly_order, verbose=verbose)
c_exp = np.zeros(len(transf.px._parameters))
-
+
for i_c in range(len(transf.px._parameters)):
c_exp[i_c] = int(transf.px._param_names[i_c][1:].split('_')[0]) +\
int(transf.px._param_names[i_c][1:].split('_')[1])
-
+
c_corr = mm ** (1 - c_exp)
transf.px._parameters = transf.px._parameters * c_corr
transf.py._parameters = transf.py._parameters * c_corr"""
-
+
# Do the final transformation and matching using
sl2_idx, sl1_idx = align.transform_and_match(sl2, sl1, transf, dr_tol=dr_final,
verbose=verbose)
@@ -662,10 +753,10 @@ def generic_match(sl1, sl2, init_mode='triangle',
# ep_name=np.column_stack((np.array(sl1['name'][sl1_idx]), np.array(sl2_transf['name'][sl2_idx]))),
# list_times=[sl1.meta['list_time'], sl2.meta['list_time']],
# list_names=[sl1.meta['list_name'], sl2.meta['list_name']])
-
+
for col in sl1.colnames:
if col in sl2.colnames:
if col not in ['name', 'x', 'y', 'm']:
st.add_column(Column(np.column_stack((np.array(sl1[col][sl1_idx]),np.array(sl2_transf[col][sl2_idx]))), name=col))
-
+
return transf, st
diff --git a/flystar/motion_model.py b/flystar/motion_model.py
index 0b86d07..d4750bc 100644
--- a/flystar/motion_model.py
+++ b/flystar/motion_model.py
@@ -1,72 +1,91 @@
import numpy as np
from abc import ABC
-import pdb
from flystar import parallax
from astropy.time import Time
-from scipy.optimize import curve_fit
+from scipy.optimize import curve_fit, OptimizeWarning
import warnings
class MotionModel(ABC):
- # Number of data points required to fit model
- n_pts_req = 0
- # Degrees of freedom for model
- n_params = 0
+ name = "MotionModel"
# Fit paramters: Shared fit parameters
- fitter_param_names = []
+ fit_param_names = []
+ n_fit_params = len(fit_param_names)
+ # Number of fit parameters/required observations in each direction
+ n_params = int((n_fit_params + 1) / 2)
- # Fixed parameters: These are parameters that are required for the model, but are not
+ # Fixed parameters: These are parameters that are required for the model, but are not
# fit quantities. For example, RA and Dec in a parallax model.
fixed_param_names = []
+ required_fixed_param_names = []
+ optional_fixed_params = {}
+
fixed_meta_data = []
# Non-fit paramters: Custom paramters that will not be fit.
# These parameters should be derived from the fit parameters and
# they must exist as a variable on the model object
- optional_param_names = []
def __init__(self, *args, **kwargs):
"""
- Make a motion model object. This object defines the fitter and fixed parameters,
- and if needed stores metadata such as RA and Dec for Parallax,
- for the given motion model and contains functions to fit these values to data
- and apply the values to compute expected positions at given times. Each instance
- corresponds to a given motion model, not an individual star, and thus the fit
- values are only input/returned in functions and not stored in the object.
+ Make a motion model object. This object defines the fit and fixed parameters,
+ and contains functions to fit the model to data and infer positions at given times.
+ Each instance corresponds to a given motion model, not an individual star,
+ and thus the fit values are only input/returned in functions, not stored in the object.
"""
return
- def get_pos_at_time(self, params, t):
- """
- Position calculator for a single star using a given motion model and input
- model parameters and times.
- """
- #return x, y
- pass
-
- def get_batch_pos_at_time(self, t):
- """
- Position calculator for a set of stars using a given motion model and input
- model parameters and times.
- """
- #return x, y, x_err, y_err
- pass
-
- def run_fit(self, t, x, y, xe, ye, t0, weighting='var',
- use_scipy=True, absolute_sigma=True):
- """
- Run a single fit of the data to the motion model and return the best parameters.
- This function is used by the overall fit_motion_model function once for a basic fit
- or several times for a bootstrap fit.
+ def _check_param_dimensions(self, fit_params, fit_params_errs, fixed_params_dict):
+ """Check that parameters is either a scalar or length of N_stars
+
+ Parameters
+ ----------
+ fit_params: array-like
+ Fit parameters, shape (N_fit_params,) or (n_stars, N_fit_params)
+ fit_params_errs: array-like
+ Errors of fit parameters, shape (N_fit_params,) or (n_stars, N_fit_params)
+ fixed_params_dict : dict
+ Dictionary of fixed parameters
"""
+ N_stars = fit_params.shape[0] if fit_params.ndim > 1 else 1
+ if fit_params_errs is not None:
+ assert fit_params_errs.shape == fit_params.shape, "fit_params and fit_params_errs must have the same shape!"
+
+ if fixed_params_dict is not None:
+ for key, value in fixed_params_dict.items():
+ # assert key in fixed_params_dict, f"Missing fixed parameter {key} in fixed_params_dict!"
+ value = fixed_params_dict[key]
+ if np.isscalar(value):
+ continue
+ else:
+ assert len(value) == N_stars, f"Length of fixed parameter {key} must be either 1 or N_stars={N_stars}!"
+
+ def model_fit(self, dt):
+ return np.full_like(dt, np.nan)
+
+ def model(self, t, fit_params, fit_param_errs=None, fixed_params_dict=None):
+ self._check_param_dimensions(fit_params, fit_param_errs, fixed_params_dict)
+ if fit_param_errs is None:
+ return np.full_like(t, np.nan), np.full_like(t, np.nan)
+ return np.full_like(t, np.nan), np.full_like(t, np.nan), np.full_like(t, np.inf), np.full_like(t, np.inf)
+
+ def run_fit(
+ self, t, x, y, xe, ye,
+ fixed_params_dict=None,
+ weighting='var',
+ use_scipy=True,
+ absolute_sigma=True,
+ params_guess=None,
+ fill_value=np.nan,
+ return_chi2=False,
+ verbose=True
+ ):
# Run a single fit (used both for overall fit + bootstrap iterations)
- pass
-
- def get_weights(self, xe, ye, weighting='var'):
- """
- Get the weights for each data point for fitting. Options are 'var' (default)
- and 'std'.
- """
+ if return_chi2:
+ return np.full(self.n_fit_params, fill_value), np.full(self.n_fit_params, np.inf), np.nan, np.nan
+ return np.full(self.n_fit_params, fill_value), np.full(self.n_fit_params, np.inf)
+
+ def calc_weights(self, xe, ye, weighting='var'):
if weighting=='std':
return 1./xe, 1./ye
elif weighting=='var':
@@ -74,488 +93,1210 @@ def get_weights(self, xe, ye, weighting='var'):
else:
warnings.warn("Invalid weighting, using default weighting scheme var.", UserWarning)
return 1./xe**2, 1./ye**2
-
- def scale_errors(self, errs, weighting='var'):
- """
- Rescale the fit result errors as needed, according to the weighting scheme used.
+
+ def fit(
+ self, t, x, y, xe, ye,
+ fixed_params_dict=None,
+ weighting='var',
+ use_scipy=True,
+ absolute_sigma=True,
+ fill_value=np.nan,
+ params_guess=None,
+ return_chi2=False,
+ bootstrap=0,
+ seed=None,
+ verbose=True
+ ):
+ """Fit stellar motion parameters
+
+ Parameters
+ ----------
+ t : array-like
+ Times of measurements
+ x : array-like
+ x-coordinates
+ y : array-like
+ y-coordinates
+ xe : array-like
+ Uncertainty of x
+ ye : array-like
+ Uncertainty of y
+ fixed_params_dict : dict, optional
+ Dictionary of fixed parameters, see each motion model's fixed_param_names for details, by default None
+ weighting : str, optional
+ Use standard error weighting ('std': w=1/xe, 1/ye) or variance weighting ('var': w=1/xe**2, 1/ye**2), by default 'var'
+ use_scipy : bool, optional
+ Use scipy for optimization. Otherwise, use linear algebraic solution (Linear model only), which is faster for < 300 epochs, by default True
+ absolute_sigma : bool, optional
+ Absolute sigma. See scipy.optimize.curve_fit for details, by default True
+ fill_value : float, optional
+ Fill value for parameters when not enough data points to fit model, by default np.nan
+ params_guess : array-like, optional
+ Initial guess for the fit parameters used in scipy curve_fit, by default None
+ return_chi2 : bool, optional
+ Return chi^2 values along with parameters and uncertainties in params, param_errs, chi2_x, chi2_y, by default False
+ bootstrap : int, optional
+ Bootstrapping uncertainties, by default 0
+ seed : int, optional
+ Seed for the random number generator, by default None
+ verbose : bool, optional
+ Print warning messages, by default True
+
+ Returns
+ -------
+ params, param_errs(, chi2_x, chi2_y)
+ Parameters, uncertainties, and chi squares if return_chi2 is True. The corresponding parameter names are in self.fit_param_names.
"""
- if weighting=='std':
- return np.array(errs)**2
- elif weighting=='var':
- return errs
+ assert np.ndim(t) == np.ndim(x) == np.ndim(y) == np.ndim(xe) == np.ndim(ye) == 1, "Input arrays must be 1D! Motion model can only fit individual stars"
+ assert len(t) == len(x) == len(y) == len(xe) == len(ye), "Input arrays must have the same length!"
+
+ if not verbose:
+ warnings.filterwarnings("ignore", category=OptimizeWarning)
+
+ fit_result = self.run_fit(
+ t, x, y, xe, ye,
+ fixed_params_dict=fixed_params_dict,
+ weighting=weighting,
+ use_scipy=use_scipy,
+ absolute_sigma=absolute_sigma,
+ fill_value=fill_value,
+ params_guess=params_guess,
+ return_chi2=return_chi2,
+ verbose=verbose
+ )
+
+ if return_chi2:
+ params, param_errs, chi2_x, chi2_y = fit_result
else:
- warnings.warn("Invalid weighting, using default weighting scheme var.", UserWarning)
- return errs
+ params, param_errs = fit_result
+
+
+ # Bootstrap errors
+ n_obs = len(t)
+
+ if (bootstrap > 0) and (n_obs > self.n_params):
+ rng = np.random.default_rng(seed)
+ edx = np.arange(n_obs, dtype=int)
+ # Precompute All Bootstrap Draws at Once
+ # Ensure there are enough unique points in each bootstrap sample
+ bdx_unique = np.stack([
+ rng.choice(edx, size=self.n_params, replace=False)
+ for _ in range(bootstrap)
+ ])
+ # Draw with replacement for the rest
+ bdx_extra = np.stack([
+ rng.choice(edx, size=n_obs - self.n_params, replace=True)
+ for _ in range(bootstrap)
+ ])
+ bdx_all = np.hstack((bdx_unique, bdx_extra))
- def fit_motion_model(self, t, x, y, xe, ye, t0, bootstrap=0, weighting='var',
- use_scipy=True, absolute_sigma=True):
- """
- Fit the input positions on the sky and errors
- to determine new parameters for this motion model (MM).
- Best-fit parameters will be returned along with uncertainties.
- Optionally, bootstrap error estimation can be performed.
- """
- params, param_errs = self.run_fit(t, x, y, xe, ye, t0=t0, weighting=weighting,
- use_scipy=use_scipy, absolute_sigma=absolute_sigma)
-
- if bootstrap>0 and len(x)>(self.n_pts_req):
- edx = np.arange(len(x), dtype=int)
bb_params = []
bb_params_errs = []
- for bb in range(bootstrap):
- bdx = np.random.choice(edx, len(x))
- while len(np.unique(bdx))= 0
+ # Calculate weighted average position
+ x_wt, y_wt = self.calc_weights(xe, ye, weighting=weighting)
+ x_wt_norm = x_wt / np.sum(x_wt)
+ y_wt_norm = y_wt / np.sum(y_wt)
+ x0 = np.average(x, weights=x_wt)
+ x0e = (np.sum(x_wt_norm**2 * xe**2))**0.5 # Error propagation
+ y0 = np.average(y, weights=y_wt)
+ y0e = (np.sum(y_wt_norm**2 * ye**2))**0.5 # Error propagation
+
+ params = np.array([x0, y0])
+ param_errors = np.array([x0e, y0e])
+
+ if (not absolute_sigma) or return_chi2:
+ chi2x, chi2y = self.calc_chi2(t, x, y, xe, ye, params)
+
+ if not absolute_sigma:
+ if degree_of_freedom > 0:
+ reduced_chi2x = chi2x / degree_of_freedom
+ reduced_chi2y = chi2y / degree_of_freedom
+
+ param_errors[0] *= reduced_chi2x**0.5
+ param_errors[1] *= reduced_chi2y**0.5
+ else:
+ # degree_of_freedom == 0, as < 0 case already handled above
+ warnings.warn(
+ f'Degree of freedom < 0. Covariance of the parameters could not be estimated. Setting parameter uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ # Set parameter uncertainties to np.inf, same behavior as scipy.optimize.curve_fit
+ param_errors = np.full_like(param_errors, np.inf)
+
+ if return_chi2:
+ return params, param_errors, chi2x, chi2y
else:
- x_wt, y_wt = self.get_weights(xe,ye, weighting=weighting)
- x0 = np.average(x, weights=x_wt)
- x0e = np.sqrt(np.average((x-x0)**2,weights=x_wt))
- y0 = np.average(y, weights=y_wt)
- y0e = np.sqrt(np.average((y-y0)**2,weights=y_wt))
-
- params = [x0, y0]
- param_errors = [x0e, y0e]
-
- return params, param_errors
-
+ return params, param_errors
+
class Linear(MotionModel):
"""
A 2D linear motion model for a star on the sky.
"""
- n_pts_req = 2
- n_params=2
- fitter_param_names = ['x0', 'vx', 'y0', 'vy']
- fixed_param_names = ['t0']
-
+ name = "Linear"
+ fit_param_names = ['x0', 'vx', 'y0', 'vy']
+ required_fixed_param_names = ['t0']
+ optional_fixed_params = {}
+ fixed_param_names = required_fixed_param_names + list(optional_fixed_params.keys())
+
+ n_fit_params = len(fit_param_names)
+ # Number of fit parameters/required observations in each direction
+ n_params = int((n_fit_params + 1) / 2)
+
def __init__(self, **kwargs):
-
# Must call after setting parameters.
# This checks for proper parameter formatting.
super().__init__()
return
-
- def get_pos_at_time(self, fit_params, fixed_params, t):
- fit_params_dict = dict(zip(self.fitter_param_names, fit_params))
- fixed_params_dict = dict(zip(self.fixed_param_names, fixed_params))
- dt = t-fixed_params_dict['t0']
- return fit_params_dict['x0'] + fit_params_dict['vx']*dt, fit_params_dict['y0'] + fit_params_dict['vy']*dt
-
- def get_batch_pos_at_time(self, t, x0=[],vx=[], y0=[],vy=[], t0=[],
- x0_err=[],vx_err=[], y0_err=[],vy_err=[], **kwargs):
- if hasattr(t, "__len__"):
- dt = t-t0[:,np.newaxis]
- x = x0[:,np.newaxis] + dt*vx[:,np.newaxis]
- y = y0[:,np.newaxis] + dt*vy[:,np.newaxis]
- x_err = np.hypot(x0_err[:,np.newaxis], vx_err[:,np.newaxis]*dt)
- y_err = np.hypot(y0_err[:,np.newaxis], vy_err[:,np.newaxis]*dt)
+
+ def model_fit(self, dt, x0, v):
+ """Linear motion model fit function
+
+ Parameters
+ ----------
+ dt : array-like
+ Time offset, shape (N_times,)
+ x0 : float or array-like
+ Initial position, shape (N_stars,) or scalar
+ v : float or array-like
+ Velocity, shape (N_stars,) or scalar
+
+ Returns
+ -------
+ x : array-like
+ Predicted position(s)
+ """
+ return x0 + v * dt
+
+ def model(self, t, fit_params, fit_param_errs=None, fixed_params_dict=None):
+ """Model positions (and uncertainties, if fit_param_errs is provided) at time t of Linear model.
+
+ Parameters
+ ----------
+ t : float or array-like
+ Time(s) at which to evaluate the model
+ fit_params : array-like
+ x0, vx, y0, vy in shape (N_fit_params,) or (N_stars, N_fit_params)
+ fit_param_errs : array-like, optional
+ Uncertainties of fit parameters in shape (N_fit_params,) or (N_stars, N_fit_params), by default None
+ fixed_params_dict : dict
+ t0, shape (1,) or (N_stars,)
+
+ Returns
+ -------
+ x, y (, xe, ye)
+ Predicted positions (and uncertainties, if fit_param_errs is provided) with shape (N_stars, N_times), or (N_times,) if N_stars=1, or (N_stars,) if N_times=1
+ """
+ if fixed_params_dict is None:
+ fixed_params_dict = self.fixed_params_dict
+ assert 't0' in fixed_params_dict, "Fixed parameter t0 is required for Linear model."
+ self._check_param_dimensions(fit_params, fit_param_errs, fixed_params_dict)
+
+ t = np.atleast_1d(t)
+ fit_params = np.atleast_2d(fit_params) # (N_stars, N_fit_params)
+
+ N_stars = fit_params.shape[0]
+ N_times = len(t)
+
+ x0, vx, y0, vy = fit_params.T # Each shape (N_stars,)
+ t0 = np.atleast_1d(fixed_params_dict['t0']) # Shape (N_stars,) or (1,)
+
+ if N_times == N_stars:
+ # Assume each time corresponds to each star, so N_times = 1
+ dt = t - t0 # Shape (N_stars,)
+ dt = dt[:, np.newaxis] # Shape (N_stars, 1)
+ N_times = 1
else:
- dt = t-t0
- x = x0 + dt*vx
- y = y0 + dt*vy
- x_err = np.hypot(x0_err, vx_err*dt)
- y_err = np.hypot(y0_err, vy_err*dt)
- return x,y,x_err,y_err
-
- def run_fit(self, t, x, y, xe, ye, t0, weighting='var', params_guess=None,
- use_scipy=True, absolute_sigma=True):
- dt = t-t0
- x_wt, y_wt = self.get_weights(xe,ye, weighting=weighting)
+ dt = t[np.newaxis, :] - t0[:, np.newaxis] # Shape (N_stars, N_times)
+
+ x = self.model_fit(dt, x0[:, np.newaxis], vx[:, np.newaxis]) # Shape (N_stars, N_times)
+ y = self.model_fit(dt, y0[:, np.newaxis], vy[:, np.newaxis]) # Shape (N_stars, N_times)
+
+ if N_stars == 1 or N_times == 1:
+ # If only one star, return flattened arrays
+ x = x.flatten()
+ y = y.flatten()
+
+ if fit_param_errs is None:
+ return x, y
+
+ fit_param_errs = np.atleast_2d(fit_param_errs) # (N_stars, N_fit_params)
+ x0_err, vx_err, y0_err, vy_err = fit_param_errs.T # Each shape (N_stars,)
+ x_err = np.hypot(x0_err[:, np.newaxis], vx_err[:, np.newaxis] * dt) # Shape (N_stars, N_times)
+ y_err = np.hypot(y0_err[:, np.newaxis], vy_err[:, np.newaxis] * dt) # Shape (N_stars, N_times)
+
+ if N_stars == 1 or N_times == 1:
+ # If only one star, return flattened arrays
+ x_err = x_err.flatten()
+ y_err = y_err.flatten()
+ return x, y, x_err, y_err
+
+ def run_fit(
+ self, t, x, y, xe, ye,
+ fixed_params_dict=None,
+ weighting='var',
+ use_scipy=True,
+ absolute_sigma=True,
+ params_guess=None,
+ fill_value=np.nan,
+ return_chi2=False,
+ verbose=True
+ ):
+ if fixed_params_dict is None:
+ fixed_params_dict = {}
+ if 't0' not in fixed_params_dict:
+ # Default t0 to weighted average time
+ fixed_params_dict['t0'] = np.average(t, weights=1./np.hypot(xe, ye))
+ self.fixed_params_dict = fixed_params_dict
+ t0 = np.atleast_1d(fixed_params_dict['t0'])
+ t = np.atleast_1d(t)
+ x = np.atleast_1d(x)
+ y = np.atleast_1d(y)
+ xe = np.atleast_1d(xe)
+ ye = np.atleast_1d(ye)
+
+ n_obs = len(t)
+ degree_of_freedom = n_obs - self.n_params
+ # Not enough data points to fit model
+ if degree_of_freedom < 0:
+ warnings.warn(
+ f'Not enough data points to fit model. Setting parameters to {fill_value} and uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ params = np.full(self.n_fit_params, fill_value)
+ param_errors = np.full(self.n_fit_params, np.inf)
+ if return_chi2:
+ return params, param_errors, np.nan, np.nan
+ else:
+ return params, param_errors
+
+ # degree_of_freedom >= 0
+ dt = t - t0
+ x_wt, y_wt = self.calc_weights(xe, ye, weighting=weighting)
if params_guess is None:
- params_guess = [x.mean(),0.0,y.mean(),0.0]
-
- # Handle 2-data point case
- if len(np.unique(dt))==2:
- if len(x)>2: # Catch case where bootstrap sends only 2 unique epochs
- _,idx=np.unique(dt, return_index=True)
- dt = dt[idx]
- x = x[idx]
- y = y[idx]
- xe = xe[idx]
- ye = ye[idx]
- dx = np.diff(x)[0]
- dy = np.diff(y)[0]
- dt_diff = np.diff(dt)[0]
- vx = dx / dt_diff
- vy = dy / dt_diff
- # TODO: still not sure about the error handling here
- x0 = x[0] - dt[0]*vx # np.average(x, weights=x_wt) #
- y0 = y[0] - dt[0]*vy # np.average(y, weights=y_wt) #
- x0e = np.abs(dx) / 2**0.5 # np.sqrt(np.sum(xe**2)/2) #
- y0e = np.abs(dy) / 2**0.5 # np.sqrt(np.sum(ye**2)/2) #
- vxe = 0.0 #np.abs(vx) * np.sqrt(np.sum(xe**2/x**2))
- vye = 0.0 #np.abs(vy) * np.sqrt(np.sum(ye**2/y**2))
-
+ params_guess = [x.mean(), 0., y.mean(), 0.]
+
+ if use_scipy:
+ x_opt, x_cov, x_info, x_msg, x_ier = curve_fit(self.model_fit, dt, x, p0=np.array(params_guess[:2]), sigma=1/x_wt**0.5, absolute_sigma=absolute_sigma, full_output=True)
+ y_opt, y_cov, y_info, y_msg, y_ier = curve_fit(self.model_fit, dt, y, p0=np.array(params_guess[2:]), sigma=1/y_wt**0.5, absolute_sigma=absolute_sigma, full_output=True)
+ x0, vx = x_opt
+ y0, vy = y_opt
+ x0e, vxe = np.sqrt(x_cov.diagonal())
+ y0e, vye = np.sqrt(y_cov.diagonal())
+ params = np.array([x0, vx, y0, vy])
+ param_errors = np.array([x0e, vxe, y0e, vye])
+ if return_chi2:
+ # chi2_x, chi2_y = self.calc_chi2(t, x, y, xe, ye, params, fixed_params_dict)
+ chi2_x = np.sum(x_info['fvec']**2)
+ chi2_y = np.sum(y_info['fvec']**2)
+ return params, param_errors, chi2_x, chi2_y
+ else:
+ return params, param_errors
+
+ # Linear algebraic solution
+ # Use https://en.wikipedia.org/wiki/Weighted_least_squares#Solution_scheme
+ X_mat_t = np.vander(dt, 2)
+
+ # x calculation
+ W_mat_x = np.diag(x_wt)
+ XTWX_mat_x = X_mat_t.T @ W_mat_x @ X_mat_t # Shape (2, 2)
+ pcov_x = np.linalg.pinv(XTWX_mat_x) # Covariance Matrix
+ popt_x = pcov_x @ X_mat_t.T @ W_mat_x @ x # Linear Solution
+
+ # Singular matrix (not enough unique times): Fill uncertainty with Inf.
+ if np.linalg.matrix_rank(XTWX_mat_x) < 2:
+ warnings.warn(
+ f'Singular matrix. Covariance of the parameters could not be estimated. Setting parameter uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ perr_x = np.full_like(popt_x, np.inf)
+ else:
+ perr_x = np.sqrt(np.diag(pcov_x)) # Uncertainty of Linear Solution
+
+ # y calculation
+ W_mat_y = np.diag(y_wt)
+ XTWX_mat_y = X_mat_t.T @ W_mat_y @ X_mat_t # Shape (2, 2)
+ pcov_y = np.linalg.pinv(XTWX_mat_y) # Covariance Matrix
+ popt_y = pcov_y @ X_mat_t.T @ W_mat_y @ y # Linear Solution
+
+ # Singular matrix (not enough unique times): Fill uncertainty with Inf.
+ if np.linalg.matrix_rank(XTWX_mat_y) < 2:
+ warnings.warn(
+ f'Singular matrix. Covariance of the parameters could not be estimated. Setting parameter uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ perr_y = np.full_like(popt_y, np.inf)
else:
- if use_scipy:
- def linear(t, c0, c1):
- return c0 + c1*t
- x_opt, x_cov = curve_fit(linear, dt, x, p0=np.array(params_guess[:2]), sigma=1/np.sqrt(x_wt), absolute_sigma=absolute_sigma)
- y_opt, y_cov = curve_fit(linear, dt, y, p0=np.array(params_guess[2:]), sigma=1/np.sqrt(y_wt), absolute_sigma=absolute_sigma)
- x0, vx = x_opt
- y0, vy = y_opt
- x0e, vxe = np.sqrt(x_cov.diagonal())
- y0e, vye = np.sqrt(y_cov.diagonal())
- x0e, vxe, y0e, vye = self.scale_errors([x0e, vxe, y0e, vye], weighting=weighting)
+ perr_y = np.sqrt(np.diag(pcov_y)) # Uncertainty of Linear Solution
+
+ # prepare values to return
+ vx, x0 = popt_x
+ vy, y0 = popt_y
+ vxe, x0e = perr_x
+ vye, y0e = perr_y
+
+ params = np.array([x0, vx, y0, vy])
+ param_errors = np.array([x0e, vxe, y0e, vye])
+
+ # Does not use get_chi2 to accelerate calculation
+ if return_chi2 or (not absolute_sigma):
+ residual_x = x - X_mat_t @ popt_x
+ residual_y = y - X_mat_t @ popt_y
+
+ chi2_x = residual_x.T @ W_mat_x @ residual_x
+ chi2_y = residual_y.T @ W_mat_y @ residual_y
+
+ if not absolute_sigma:
+ if degree_of_freedom > 0:
+ reduced_chi2_x = chi2_x / degree_of_freedom
+ reduced_chi2_y = chi2_y / degree_of_freedom
+
+ param_errors[0:2] *= reduced_chi2_x**0.5
+ param_errors[2:4] *= reduced_chi2_y**0.5
+
else:
- # Use https://en.wikipedia.org/wiki/Weighted_least_squares#Solution scheme
- x = np.array(x)
- y = np.array(y)
- dt = np.array(dt)
- X_mat_t = np.vander(dt, 2)
- # x calculation
- W_mat_x = np.diag(x_wt)
- XTWX_mat_x = X_mat_t.T @ W_mat_x @ X_mat_t
- pcov_x = np.linalg.inv(XTWX_mat_x) # Covariance Matrix
- popt_x = pcov_x @ X_mat_t.T @ W_mat_x @ x # Linear Solution
- perr_x = np.sqrt(np.diag(pcov_x)) # Uncertainty of Linear Solution
- # y calculation
- W_mat_y = np.diag(y_wt)
- XTWX_mat_y = X_mat_t.T @ W_mat_y @ X_mat_t
- pcov_y = np.linalg.inv(XTWX_mat_y) # Covariance Matrix
- popt_y = pcov_y @ X_mat_t.T @ W_mat_y @ y # Linear Solution
- perr_y = np.sqrt(np.diag(pcov_y)) # Uncertainty of Linear Solution
- # prepare values to return
- x0, vx = popt_x[1], popt_x[0]
- y0, vy = popt_y[1], popt_y[0]
- x0e, vxe = perr_x[1], perr_x[0]
- y0e, vye = perr_y[1], perr_y[0]
- x0e, vxe, y0e, vye = self.scale_errors([x0e, vxe, y0e, vye], weighting=weighting)
-
- params = [x0, vx, y0, vy]
- param_errors = [x0e, vxe, y0e, vye]
- return params, param_errors
-
-
+ # degree_of_freedom == 0, as < 0 case already handled above
+ warnings.warn(
+ f'Degree of freedom < 0. Covariance of the parameters could not be estimated. Setting parameter uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ # Set parameter uncertainties to np.inf, same behavior as scipy.optimize.curve_fit
+ param_errors = np.full_like(param_errors, np.inf)
+
+ if return_chi2:
+ return params, param_errors, chi2_x, chi2_y
+ else:
+ return params, param_errors
+
class Acceleration(MotionModel):
"""
A 2D accelerating motion model for a star on the sky.
"""
- n_pts_req = 4 # TODO: consider special case for 3 pts
- n_params=3
- fitter_param_names = ['x0', 'vx0', 'ax', 'y0', 'vy0', 'ay']
- fixed_param_names = ['t0']
-
- def __init__(self, x0=0, vx0=0, ax=0, y0=0, vy0=0, ay=0, t0=None,
- x0_err=0, vx0_err=0, ax_err=0, y0_err=0, vy0_err=0, ay_err=0, **kwargs):
+ name = "Acceleration"
+ fit_param_names = ['x0', 'vx0', 'ax', 'y0', 'vy0', 'ay']
+ required_fixed_param_names = ['t0']
+ optional_fixed_params = {}
+ fixed_param_names = required_fixed_param_names + list(optional_fixed_params.keys())
+
+ n_fit_params = len(fit_param_names)
+ # Number of required observations in each direction
+ n_params = int((n_fit_params + 1) / 2)
+
+ def __init__(self):
# Must call after setting parameters.
# This checks for proper parameter formatting.
super().__init__()
return
-
- def get_pos_at_time(self, fit_params, fixed_params, t):
- fit_params_dict = dict(zip(self.fitter_param_names, fit_params))
- fixed_params_dict = dict(zip(self.fixed_param_names, fixed_params))
- dt = t-fixed_params_dict['t0']
- x = fit_params_dict['x0'] + fit_params_dict['vx0']*dt + 0.5*fit_params_dict['ax']*dt**2
- y = fit_params_dict['y0'] + fit_params_dict['vy0']*dt + 0.5*fit_params_dict['ay']*dt**2
- return x, y
-
- def get_batch_pos_at_time(self,t,
- x0=[],vx0=[],ax=[], y0=[],vy0=[],ay=[], t0=[],
- x0_err=[],vx0_err=[],ax_err=[], y0_err=[],vy0_err=[],ay_err=[], **kwargs):
- if hasattr(t, "__len__"):
- dt = t-t0[:,np.newaxis]
- x = x0[:,np.newaxis] + dt*vx0[:,np.newaxis] + 0.5*dt**2*ax[:,np.newaxis]
- y = y0[:,np.newaxis] + dt*vy0[:,np.newaxis] + 0.5*dt**2*ay[:,np.newaxis]
- x_err = np.sqrt(x0_err[:,np.newaxis]**2 + (vx0_err[:,np.newaxis]*dt)**2 + (0.5*ax_err[:,np.newaxis]*dt**2)**2)
- y_err = np.sqrt(y0_err[:,np.newaxis]**2 + (vy0_err[:,np.newaxis]*dt)**2 + (0.5*ay_err[:,np.newaxis]*dt**2)**2)
+
+ def model_fit(self, t, x0, v0, a):
+ """Model positions at time t of Acceleration model.
+
+ Parameters
+ ----------
+ t : float or array-like
+ Time(s) at which to evaluate the model
+ x0 : float or array-like
+ Initial position(s)
+ v0 : float or array-like
+ Initial velocity(ies)
+ a : float or array-like
+ Acceleration(s)
+
+ Returns
+ -------
+ float or array-like
+ Model positions at time t of Acceleration model
+ """
+ return x0 + v0*t + 0.5*a*t**2
+
+ def model(self, t, fit_params, fit_param_errs=None, fixed_params_dict=None):
+ """Model positions (and uncertainties, if fit_param_errs is provided) at time t of Acceleration model.
+
+ Parameters
+ ----------
+ t : float or array-like
+ Time(s) at which to evaluate the model
+ fit_params : array-like
+ x0, vx, ax, y0, vy, ay in shape (N_fit_params,) or (N_stars, N_fit_params)
+ fit_param_errs : array-like, optional
+ Fit parameter uncertainties with shape (N_stars, N_fit_params) or (N_fit_params,), by default None
+ fixed_params_dict : dict
+ t0, shape (1,) or (N_stars,)
+
+ Returns
+ -------
+ x, y (, xe, ye)
+ Predicted positions (and uncertainties, if fit_param_errs is provided) with shape (N_stars, N_times), or (N_times,) if N_stars=1, or (N_stars,) if N_times=1
+ """
+ if fixed_params_dict is None:
+ fixed_params_dict = self.fixed_params_dict
+ assert 't0' in fixed_params_dict, "Fixed parameter t0 is required for Acceleration model."
+ self._check_param_dimensions(fit_params, fit_param_errs, fixed_params_dict)
+
+ t = np.atleast_1d(t)
+ fit_params = np.atleast_2d(fit_params) # (N_stars, N_fit_params)
+
+ N_stars = fit_params.shape[0]
+ N_times = len(t)
+
+ x0, vx0, ax, y0, vy0, ay = fit_params.T # Each shape (N_stars,)
+ t0 = np.atleast_1d(fixed_params_dict['t0']) # Shape (N_stars,) or (1,)
+
+ if N_times == N_stars:
+ # Assume each time corresponds to each star, so N_times = 1
+ dt = t - t0 # Shape (N_stars,)
+ dt = dt[:, np.newaxis] # Shape (N_stars, 1)
+ N_times = 1
else:
- dt = t-t0
- x = x0 + dt*vx0 + 0.5*dt**2*ax
- y = y0 + dt*vy0 + 0.5*dt**2*ay
- x_err = np.sqrt(x0_err**2 + (vx0_err*dt)**2 + (0.5*ax_err*dt**2)**2)
- y_err = np.sqrt(y0_err**2 + (vy0_err*dt)**2 + (0.5*ay_err*dt**2)**2)
- return x,y,x_err,y_err
-
- def run_fit(self, t, x, y, xe, ye, t0, weighting='var', params_guess=None,
- use_scipy=True, absolute_sigma=True):
+ dt = t[np.newaxis, :] - t0[:, np.newaxis] # Shape (N_stars, N_times)
+
+ x = self.model_fit(dt, x0[:, np.newaxis], vx0[:, np.newaxis], ax[:, np.newaxis]) # Shape (N_stars, N_times)
+ y = self.model_fit(dt, y0[:, np.newaxis], vy0[:, np.newaxis], ay[:, np.newaxis]) # Shape (N_stars, N_times)
+
+ if N_stars == 1 or N_times == 1:
+ # If only one star, return flattened arrays
+ x = x.flatten()
+ y = y.flatten()
+
+ if fit_param_errs is None:
+ return x, y
+
+ fit_param_errs = np.atleast_2d(fit_param_errs) # (N_stars, N_fit_params)
+ x0_err, vx0_err, ax_err, y0_err, vy0_err, ay_err = fit_param_errs.T
+ x_err = np.sqrt(x0_err[:, np.newaxis]**2 + (vx0_err[:, np.newaxis] * dt)**2 + (0.5 * ax_err[:, np.newaxis] * dt**2)**2) # Shape (N_stars, N_times)
+ y_err = np.sqrt(y0_err[:, np.newaxis]**2 + (vy0_err[:, np.newaxis] * dt)**2 + (0.5 * ay_err[:, np.newaxis] * dt**2)**2) # Shape (N_stars, N_times)
+
+ if N_stars == 1 or N_times == 1:
+ # If only one star, return flattened arrays
+ x_err = x_err.flatten()
+ y_err = y_err.flatten()
+
+ return x, y, x_err, y_err
+
+
+ def run_fit(
+ self, t, x, y, xe, ye,
+ fixed_params_dict=None,
+ weighting='var',
+ use_scipy=True,
+ absolute_sigma=True,
+ params_guess=None,
+ fill_value=np.nan,
+ return_chi2=False,
+ verbose=True
+ ):
+ if fixed_params_dict is None:
+ fixed_params_dict = {}
+ if 't0' not in fixed_params_dict:
+ # Default t0 to weighted average time
+ fixed_params_dict['t0'] = np.average(t, weights=1./np.hypot(xe, ye))
+ self.fixed_params_dict = fixed_params_dict
+ t0 = np.atleast_1d(fixed_params_dict['t0'])
+ t = np.atleast_1d(t)
+ x = np.atleast_1d(x)
+ y = np.atleast_1d(y)
+ xe = np.atleast_1d(xe)
+ ye = np.atleast_1d(ye)
+
if not use_scipy:
- Warning("Acceleration model has no non-scipy fitter option. Running with scipy.")
- dt = t-t0
- x_wt, y_wt = self.get_weights(xe,ye, weighting=weighting)
+ if verbose:
+ warnings.warn("Acceleration model has no non-scipy fitter option. Running with scipy.")
+
+ n_obs = len(t)
+ degree_of_freedom = n_obs - self.n_params
+ # Not enough data points to fit model
+ if degree_of_freedom < 0:
+ warnings.warn(
+ f'Not enough data points to fit model. Setting parameters to {fill_value} and uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ params = np.full(self.n_fit_params, fill_value)
+ param_errors = np.full(self.n_fit_params, np.inf)
+ if return_chi2:
+ return params, param_errors, np.nan, np.nan
+ else:
+ return params, param_errors
+
+ # degree_of_freedom >= 0
+ dt = t - t0
+ x_wt, y_wt = self.calc_weights(xe,ye, weighting=weighting)
if params_guess is None:
- params_guess = [x.mean(),0.0,0.0,y.mean(),0.0,0.0]
-
- def accel(t, c0,c1,c2):
- return c0 + c1*t + 0.5*c2*t**2
-
- x_opt, x_cov = curve_fit(accel, dt, x, p0=np.array(params_guess[:3]), sigma=1/x_wt**0.5, absolute_sigma=True)
- y_opt, y_cov = curve_fit(accel, dt, y, p0=np.array(params_guess[3:]), sigma=1/y_wt**0.5, absolute_sigma=True)
- x0 = x_opt[0]
- y0 = y_opt[0]
- vx0 = x_opt[1]
- vy0 = y_opt[1]
- ax = x_opt[2]
- ay = y_opt[2]
-
+ # Initial guess for velocity:
+ idx_first, idx_last = np.argmin(t), np.argmax(t)
+ t_span = t[idx_last] - t[idx_first]
+ params_guess = [x.mean(), (x[idx_last] - x[idx_first]) / t_span, 0., y.mean(), (y[idx_last] - y[idx_first]) / t_span, 0.]
+
+ x_opt, x_cov, x_info, x_msg, x_ier = curve_fit(self.model_fit, dt, x, p0=np.array(params_guess[:3]), sigma=1/x_wt**0.5, absolute_sigma=absolute_sigma, full_output=True)
+ y_opt, y_cov, y_info, y_msg, y_ier = curve_fit(self.model_fit, dt, y, p0=np.array(params_guess[3:]), sigma=1/y_wt**0.5, absolute_sigma=absolute_sigma, full_output=True)
+ x0, vx0, ax = x_opt
+ y0, vy0, ay = y_opt
x0e, vx0e, axe = np.sqrt(x_cov.diagonal())
y0e, vy0e, aye = np.sqrt(y_cov.diagonal())
- x0e, vx0e, axe, y0e, vy0e, aye = self.scale_errors([x0e, vx0e, axe, y0e, vy0e, aye], weighting=weighting)
- params = [x0, vx0, ax, y0, vy0, ay]
- param_errors = [x0e, vx0e, axe, y0e, vy0e, aye]
-
- return params, param_errors
+ params = np.array([x0, vx0, ax, y0, vy0, ay])
+ param_errors = np.array([x0e, vx0e, axe, y0e, vy0e, aye])
+ if return_chi2:
+ # chi2_x, chi2_y = self.calc_chi2(t, x, y, xe, ye, params, fixed_params_dict)
+ chi2_x = np.sum(x_info['fvec']**2)
+ chi2_y = np.sum(y_info['fvec']**2)
+ return params, param_errors, chi2_x, chi2_y
+ else:
+ return params, param_errors
class Parallax(MotionModel):
"""
Motion model for linear proper motion + parallax
-
- Requires RA & Dec (J2000) for parallax calculation.
+
+ Requires RA and Dec J2000 (degrees) for parallax calculation.
Optional PA is counterclockwise offset of the image y-axis from North.
Optional obs parameter describes observer location, default is 'earth'.
"""
- n_pts_req = 4
- n_params=3
- fitter_param_names = ['x0', 'vx', 'y0', 'vy', 'pi']
- fixed_param_names = ['t0']
- fixed_meta_data = ['RA','Dec','PA','obs']
-
- def __init__(self, RA, Dec, PA=0.0, obs='earth', **kwargs):
- self.RA = RA
- self.Dec = Dec
- self.PA = PA
- self.obs = obs
- self.plx_vector_cached = None
+ name = "Parallax"
+ fit_param_names = ['x0', 'vx', 'y0', 'vy', 'pi']
+ required_fixed_param_names = ['t0', 'ra', 'dec']
+ optional_fixed_params = {'pa': 0., 'obsLocation': 'earth'}
+ fixed_param_names = required_fixed_param_names + list(optional_fixed_params.keys())
+
+
+ n_fit_params = len(fit_param_names)
+ # Number of required observations in each direction
+ n_params = int((n_fit_params + 1) / 2)
+
+ def __init__(self):
+ super().__init__()
+ self.pvec_cached = None # Cache for parallax vector
+ self.t_mjd_cached = None # Cache for times corresponding to cached parallax vector
return
-
- def get_parallax_vector(self, t_mjd):
- recalc_plx = True
- if self.plx_vector_cached is not None:
- if hasattr(t_mjd, "__len__"):
- if list(t_mjd) == list(self.plx_vector_cached[0]):
- pvec = self.plx_vector_cached[1:]
- recalc_plx = False
- elif all([t_mjd_i in self.plx_vector_cached[0] for t_mjd_i in t_mjd]):
- pvec_idxs = [np.argwhere(self.plx_vector_cached[0]==t_mjd_i)[0][0] for t_mjd_i in t_mjd]
- pvec = [self.plx_vector_cached[1][pvec_idxs], self.plx_vector_cached[2][pvec_idxs]]
- recalc_plx = False
- elif t_mjd in self.plx_vector_cached[0]:
- idx = np.where(t_mjd==self.plx_vector_cached[0])[0][0]
- pvec = np.array([self.plx_vector_cached[1][idx], self.plx_vector_cached[2][idx]])
- recalc_plx = False
- if recalc_plx:
- pvec = parallax.parallax_in_direction(self.RA, self.Dec, t_mjd, obsLocation=self.obs, PA=self.PA).T
- if hasattr(t_mjd, "__len__"):
- self.plx_vector_cached = [t_mjd, pvec[0], pvec[1]]
+
+ def calc_parallax_vector(self, t_mjd, ra, dec, pa=0., obsLocation='earth'):
+ """Calculate parallax vector of shape (N_stars, 2, N_times)
+
+ Parameters
+ ----------
+ t_mjd : array-like
+ Time array in mjd
+ ra : float or array-like
+ Right ascension(s) in degrees
+ dec : float or array-like
+ Declination(s) in degrees
+ pa : float or array-like, optional
+ Position angle(s) of image y-axis from North in degrees, by default 0.
+ obsLocation : str, optional
+ Observer location, by default 'earth'
+
+ Returns
+ -------
+ pvec
+ Parallax vector of shape (N_stars, 2, N_times)
+ """
+ if self.pvec_cached is not None:
+ t_mjd = np.atleast_1d(t_mjd)
+ t_mjd_cached = self.t_mjd_cached
+ if np.array_equal(t_mjd, t_mjd_cached):
+ # If cached values match input times, return cached values
+ return self.pvec_cached
+
+ elif all(np.isin(t_mjd, t_mjd_cached)):
+ # If all input times are in cached values, return those
+ # Calculate pvec_idxs such that t_mjd_cached[ pvec_idxs ] == t_mjd
+ pvec_idxs = np.array([np.where(t_mjd_cached == t_mjd_i)[0][0] for t_mjd_i in t_mjd])
+ pvec = self.pvec_cached[:, :, pvec_idxs]
+ return pvec
+
+ pvec = parallax.parallax_in_direction(ra, dec, t_mjd, obsLocation=obsLocation, pa=pa) # Shape (N_stars, 2, N_times)
+ # self.plx_vector_cached = [t_mjd, pvec]
+ self.t_mjd_cached = t_mjd
+ self.pvec_cached = pvec
return pvec
-
- def get_pos_at_time(self, fit_params, fixed_params, t):
- fit_params_dict = dict(zip(self.fitter_param_names, fit_params))
- fixed_params_dict = dict(zip(self.fixed_param_names, fixed_params))
- dt = t-fixed_params_dict['t0']
-
- t_mjd = Time(t, format='decimalyear', scale='utc').mjd
- pvec = self.get_parallax_vector(t_mjd)
- pvec_x = np.reshape(pvec[0], t.shape)
- pvec_y = np.reshape(pvec[1], t.shape)
- x = fit_params_dict['x0'] + fit_params_dict['vx']*dt + fit_params_dict['pi']*pvec_x
- y = fit_params_dict['y0'] + fit_params_dict['vy']*dt + fit_params_dict['pi']*pvec_y
- return x, y
-
- def get_batch_pos_at_time(self, t,
- x0=[],vx=[], y0=[],vy=[], pi=[], t0=[],
- x0_err=[],vx_err=[], y0_err=[],vy_err=[], pi_err=[], **kwargs):
- t_mjd = Time(t, format='decimalyear', scale='utc').mjd
- pvec = self.get_parallax_vector(t_mjd)
- if hasattr(t, "__len__"):
- dt = t-t0[:,np.newaxis]
- x = x0[:,np.newaxis] + dt*vx[:,np.newaxis] + pi[:,np.newaxis]*pvec[0].T
- y = y0[:,np.newaxis] + dt*vy[:,np.newaxis] + pi[:,np.newaxis]*pvec[1].T
- try:
- x_err = np.sqrt(x0_err[:,np.newaxis]**2 + (vx_err[:,np.newaxis]*dt)**2 + (pi_err[:,np.newaxis]*pvec[0].T)**2)
- y_err = np.sqrt(y0_err[:,np.newaxis]**2 + (vy_err[:,np.newaxis]*dt)**2 + (pi_err[:,np.newaxis]*pvec[1].T)**2)
- except:
- x_err,y_err = [],[]
+
+ def model_fit(self, dt, x0, vx, y0, vy, pi):
+ """Model positions at time t of Parallax model.
+
+ Parameters
+ ----------
+ dt : float or array-like
+ Time(s) at which to evaluate the model
+ x0 : float or array-like
+ Initial position(s)
+ vx : float or array-like
+ Velocity(ies)
+ y0 : float or array-like
+ Initial position(s)
+ vy : float or array-like
+ Velocity(ies)
+ pi : float or array-like
+ Parallax factor(s)
+
+ Returns
+ -------
+ x_result, y_result : array-like
+ Model positions at time t of Parallax model, shape (N_stars, N_times)
+ """
+ # x0, vx, y0, vy, pi are all shape (N_stars, N_times)
+ x_result = x0 + vx * dt + pi * self.pvec[:, 0, :] # Parallax contribution in x direction
+ y_result = y0 + vy * dt + pi * self.pvec[:, 1, :] # Parallax contribution in y direction
+ return x_result, y_result
+
+ def _model_fit(self, dt, x0, vx, y0, vy, pi):
+ """Wrapper for model_fit to return concatenated results for scipy fitting."""
+ x_result, y_result = self.model_fit(dt, x0, vx, y0, vy, pi)
+ # scipy.optimize.curve_fit expects a 1D output array with the same length
+ # as the input ydata. For single-star fits, intermediate broadcasting can
+ # yield arrays with shape (1, N_times); flatten to avoid M=1 interpretation.
+ return np.hstack([np.ravel(x_result), np.ravel(y_result)]) # Shape (2*N_times,)
+
+ def model(self, t, fit_params, fit_param_errs=None, fixed_params_dict=None):
+ """Model positions (and uncertainties, if fit_param_errs is provided) at time t of Parallax model.
+
+ Parameters
+ ----------
+ t : float or array-like
+ Times at which to evaluate the model
+ fit_params : array-like
+ x0, vx, y0, vy, pi in shape (N_fit_params,) or (N_stars, N_fit_params)
+ fit_param_errs : array-like, optional
+ Uncertainties in fit parameters, by default None
+ fixed_params : dict
+ - t0, shape (N_stars,) or (1,).
+ - ra, shape (N_stars,) or (1,).
+ - dec, shape (N_stars,) or (1,).
+ - pa, optional, shape (N_stars,) or (1,), by default 0.
+ - obsLocation, optional, string, by default 'earth'
+
+ Returns
+ -------
+ x, y (, xe, ye)
+ Predicted positions (and uncertainties, if fit_param_errs is provided) with shape (N_stars, N_times), or (N_times,) if N_stars=1, or (N_stars,) if N_times=1
+ """
+ if fixed_params_dict is None:
+ fixed_params_dict = self.fixed_params_dict
+ assert all([_ in fixed_params_dict for _ in ['t0', 'ra', 'dec']]), "Fixed parameters t0, ra, and dec are required for Parallax model."
+ self._check_param_dimensions(fit_params, fit_param_errs, fixed_params_dict)
+
+ t = np.atleast_1d(t)
+ fit_params = np.atleast_2d(fit_params) # (N_stars, N_fit_params)
+
+ N_stars = fit_params.shape[0]
+ N_times = len(t)
+
+ x0, vx, y0, vy, pi = fit_params.T # Each shape (N_stars,)
+ t0 = np.atleast_1d(fixed_params_dict['t0']) # Shape (N_stars,) or (1,)
+ ra = np.atleast_1d(fixed_params_dict['ra'])
+ dec = np.atleast_1d(fixed_params_dict['dec'])
+ pa = np.atleast_1d(fixed_params_dict.get('pa', 0.0))
+ obsLocation = fixed_params_dict.get('obsLocation', 'earth')
+
+ # TODO: vectorize parallax.parallax_in_direction to handle multiple obsLocation?
+ assert isinstance(obsLocation, str) or (np.unique(obsLocation).size == 1), "obsLocation must be a single string for all stars at this time."
+ if not isinstance(obsLocation, str):
+ obsLocation = np.unique(obsLocation)[0]
+
+
+ if N_times == N_stars:
+ # Assume each time corresponds to each star, so N_times = 1
+ dt = t - t0 # Shape (N_stars,)
+ dt = dt[:, np.newaxis] # Shape (N_stars, 1)
+ N_times = 1
else:
- dt = t-t0
- x = x0 + dt*vx + pi*pvec[0]
- y = y0 + dt*vy + pi*pvec[1]
- try:
- x_err = np.sqrt(x0_err**2 + (vx_err*dt)**2 + (pi_err*pvec[0])**2)
- y_err = np.sqrt(y0_err**2 + (vy_err*dt)**2 + (pi_err*pvec[1])**2)
- except:
- x_err,y_err = [],[]
- return x,y,x_err,y_err
-
- def run_fit(self, t, x, y, xe, ye, t0, weighting='var', params_guess=None,
- use_scipy=True, absolute_sigma=True):
+ dt = t[np.newaxis, :] - t0[:, np.newaxis] # Shape (N_stars, N_times)
+
+ t_mjd = Time(t, format='decimalyear', scale='utc').mjd # Shape (N_times,)
+ self.pvec = self.calc_parallax_vector(t_mjd, ra, dec, pa=pa, obsLocation=obsLocation) # Shape (N_stars, 2, N_times)
+ x, y = self.model_fit(dt, x0[:, np.newaxis], vx[:, np.newaxis], y0[:, np.newaxis], vy[:, np.newaxis], pi[:, np.newaxis]) # Shape (N_stars, N_times)
+
+ if N_stars == 1 or N_times == 1:
+ # If only one star, return flattened arrays
+ x = x.flatten()
+ y = y.flatten()
+
+ if fit_param_errs is None:
+ return x, y
+
+ fit_param_errs = np.atleast_2d(fit_param_errs) # (N_stars, N_fit_params)
+ x0_err, vx_err, y0_err, vy_err, pi_err = fit_param_errs.T
+ x_err = np.sqrt(x0_err[:, np.newaxis]**2 + (vx_err[:, np.newaxis] * dt)**2 + (pi_err[:, np.newaxis] * self.pvec[:, 0, :])**2) # Shape (N_stars, N_times)
+ y_err = np.sqrt(y0_err[:, np.newaxis]**2 + (vy_err[:, np.newaxis] * dt)**2 + (pi_err[:, np.newaxis] * self.pvec[:, 1, :])**2) # Shape (N_stars, N_times)
+
+ if N_stars == 1 or N_times == 1:
+ # If only one star, return flattened arrays
+ x_err = x_err.flatten()
+ y_err = y_err.flatten()
+ return x, y, x_err, y_err
+
+
+ def run_fit(
+ self, t, x, y, xe, ye,
+ fixed_params_dict,
+ weighting='var',
+ use_scipy=True,
+ absolute_sigma=True,
+ params_guess=None,
+ fill_value=np.nan,
+ return_chi2=False,
+ verbose=True
+ ):
if not use_scipy:
- Warning("Parallax model has no non-scipy fitter option. Running with scipy.")
+ if verbose:
+ warnings.warn("Parallax model has no non-scipy fitter option. Running with scipy.", UserWarning)
+
+ assert all([k in fixed_params_dict for k in ['ra', 'dec']]), "Parallax model requires 'ra' and 'dec' in fixed_params."
+ t = np.atleast_1d(t)
+
+ if 't0' not in fixed_params_dict:
+ # Default t0 to weighted average time
+ fixed_params_dict['t0'] = np.average(t, weights=1./np.hypot(xe, ye))
+ if 'obsLocation' not in fixed_params_dict:
+ fixed_params_dict['obsLocation'] = 'earth'
+ self.fixed_params_dict = fixed_params_dict
+ t0 = np.atleast_1d(fixed_params_dict['t0'])
+ ra = np.atleast_1d(fixed_params_dict['ra'])
+ dec = np.atleast_1d(fixed_params_dict['dec'])
+ pa = np.atleast_1d(fixed_params_dict.get('pa', 0.0))
+ obsLocation = fixed_params_dict['obsLocation']
+
+ n_fit = len(t)
+ degree_of_freedom = n_fit - self.n_params
+ # Not enough data points to fit model
+ if degree_of_freedom < 0:
+ warnings.warn(
+ f'Not enough data points to fit model. Setting parameters to {fill_value} and uncertainties to np.inf.',
+ OptimizeWarning, stacklevel=2
+ )
+ params = np.full(self.n_fit_params, fill_value)
+ param_errors = np.full(self.n_fit_params, np.inf)
+ if return_chi2:
+ return params, param_errors, np.nan, np.nan
+ else:
+ return params, param_errors
+
+ # degree_of_freedom >= 0
t_mjd = Time(t, format='decimalyear', scale='utc').mjd
- pvec = self.get_parallax_vector(t_mjd)
- x_wt, y_wt = self.get_weights(xe,ye, weighting=weighting)
- def fit_func(use_t, x0,vx, y0,vy, pi):
- x_res = x0 + vx*(use_t-t0) + pi*pvec[0]
- y_res = y0 + vy*(use_t-t0) + pi*pvec[1]
- return np.hstack([x_res, y_res])
+ self.pvec = self.calc_parallax_vector(t_mjd, ra, dec, pa=pa, obsLocation=obsLocation) # Shape (2, N_times)
+ x_wt, y_wt = self.calc_weights(xe, ye, weighting=weighting)
+
# Initial guesses, x0,y0 as x,y averages;
# vx,vy as average velocity if first and last points are perfectly measured;
- # pi for 10 pc disance
+ # pi for 10 pc distance
if params_guess is None:
idx_first, idx_last = np.argmin(t), np.argmax(t)
- params_guess = [x.mean(),(x[idx_last]-x[idx_first])/(t[idx_last]-t[idx_first]),
- y.mean(),(y[idx_last]-y[idx_first])/(t[idx_last]-t[idx_first]), 0.1]
- res = curve_fit(fit_func, t, np.hstack([x,y]),
- p0=params_guess, sigma = 1.0/np.hstack([x_wt,y_wt]))
- x0,vx,y0,vy,pi = res[0]
- x0_err,vx_err,y0_err,vy_err,pi_err = self.scale_errors(np.sqrt(np.diag(res[1])), weighting=weighting)
-
- params = [x0, vx, y0, vy, pi]
- param_errors = [x0_err, vx_err, y0_err, vy_err, pi_err]
- return params, param_errors
-
-
-def validate_motion_model_dict(motion_model_dict, startable, default_motion_model):
- """
- Check that everything is set up properly for motion models to run and their
- required metadata.
- """
+ t_span = t[idx_last] - t[idx_first]
+ params_guess = np.array([
+ x.mean(), (x[idx_last] - x[idx_first]) / t_span,
+ y.mean(), (y[idx_last] - y[idx_first]) / t_span,
+ 0.1
+ ])
- # Collect names of all motion models that might get used.
- all_motion_model_names = ['Fixed']
- if default_motion_model is not None:
- all_motion_model_names.append(default_motion_model)
- if 'motion_model_input' in startable.columns:
- all_motion_model_names += np.unique(startable['motion_model_input']).tolist()
- if 'motion_model_used' in startable.columns:
- all_motion_model_names += np.unique(startable['motion_model_used']).tolist()
- all_motion_model_names = np.unique(all_motion_model_names)
-
- # Check whether all motion models are in the dict, and if not, try to add them
- # here or raise an error.
- for mm in all_motion_model_names:
- if mm not in motion_model_dict:
- mm_obj = eval(mm)
- if len(mm_obj.fixed_meta_data)>0:
- raise ValueError(f"Cannot use {mm} motion model without required metadata. Please initialize with required metadata and provide in motion_model_dict.")
- else:
- motion_model_dict[mm] = mm_obj()
- warnings.warn(f"Using default model/fitter for {mm}.", UserWarning)
+ # Convert weights to 1-sigma uncertainties for curve_fit.
+ # calc_weights returns w = 1/sigma^2 for 'var' and w = 1/sigma for 'std'.
+ if weighting == 'std':
+ sigma_x = 1.0 / x_wt
+ sigma_y = 1.0 / y_wt
+ else:
+ sigma_x = 1.0 / np.sqrt(x_wt)
+ sigma_y = 1.0 / np.sqrt(y_wt)
- return motion_model_dict
-
+ popt, pcov, infodict, mesg, ier = curve_fit(
+ self._model_fit, t - t0, np.hstack([x, y]),
+ p0=params_guess, sigma=np.hstack([sigma_x, sigma_y]),
+ absolute_sigma=absolute_sigma, full_output=True
+ )
+ x0, vx, y0, vy, pi = popt
+ x0_err, vx_err, y0_err, vy_err, pi_err = np.sqrt(pcov.diagonal())
-def get_one_motion_model_param_names(motion_model_name, with_errors=True, with_fixed=True):
- """
- Get all the motion model parameters for a given motion_model_name.
- Optionally, include fixed and error parameters (included by default).
- """
- mod = eval(motion_model_name)
- list_of_parameters = []
- list_of_parameters += getattr(mod, 'fitter_param_names')
- if with_fixed:
- list_of_parameters += getattr(mod, 'fixed_param_names')
- if with_errors:
- list_of_parameters += [par+'_err' for par in getattr(mod, 'fitter_param_names')]
- return list_of_parameters
+ params = np.array([x0, vx, y0, vy, pi])
+ param_errors = np.array([x0_err, vx_err, y0_err, vy_err, pi_err])
+ if return_chi2:
+ # chi2_x, chi2_y = self.calc_chi2(t, x, y, xe, ye, params, fixed_params_dict)
+ chi2_x = np.sum(infodict['fvec'][:len(t)]**2)
+ chi2_y = np.sum(infodict['fvec'][len(t):]**2)
+ return params, param_errors, chi2_x, chi2_y
+ else:
+ return params, param_errors
-def get_list_motion_model_param_names(motion_model_list, with_errors=True, with_fixed=True):
- """
- Get all the motion model parameters for all models given in motion_model_list.
- Optionally, include fixed and error parameters (included by default).
+
+def motion_model_param_names(motion_models, with_errors=True, with_fixed=True):
+ """Get the motion model parameter names from a list of MotionModels.
+
+ Parameters
+ ----------
+ motion_models : MotionModel, str, or list of MotionModels/strings.
+ Motion model to query parameter names from. If str, should be the name of a MotionModel class.
+ with_errors : bool, optional
+ Add uncertainty names with '_err' suffix or not, by default True
+ with_fixed : bool, optional
+ Add fixed param names with '_fixed' suffix or not, by default True
+
+ Returns
+ -------
+ list
+ List of all unique parameter names across all motion models
"""
list_of_parameters = []
- all_motion_models = [eval(mm) for mm in np.unique(motion_model_list).tolist()]
- for aa in range(len(all_motion_models)):
- param_names = getattr(all_motion_models[aa], 'fitter_param_names')
- param_fixed_names = getattr(all_motion_models[aa], 'fixed_param_names')
- param_err_names = [par+'_err' for par in param_names]
- list_of_parameters += param_names
+ def list_add(name):
+ if name not in list_of_parameters:
+ list_of_parameters.append(name)
+
+ motion_models = np.atleast_1d(motion_models)
+ mm_map = motion_model_map()
+ for mm in motion_models:
+ if isinstance(mm, str):
+ mm = mm_map[mm]
+ for param in mm.fit_param_names:
+ # Fitter params
+ list_add(param)
+ # Error params
+ if with_errors:
+ list_add(param + '_err')
+ # Fixed params
if with_fixed:
- list_of_parameters += param_fixed_names
- if with_errors:
- list_of_parameters += param_err_names
-
- return np.unique(list_of_parameters).tolist()
+ for param in mm.fixed_param_names:
+ list_add(param)
+ return list_of_parameters
-def get_all_motion_model_param_names(with_errors=True, with_fixed=True):
- """
- Get all the motion model parameters for all models defined in this module.
- Optionally, include fixed and error parameters (included by default).
+def all_motion_model_param_names(with_errors=True, with_fixed=True):
+ """Get all motion model parameter names from all available MotionModels.
+
+ Parameters
+ ----------
+ with_errors : bool, optional
+ Add uncertainty names with '_err' suffix or not, by default True
+ with_fixed : bool, optional
+ Add fixed param names with '_fixed' suffix or not, by default True
+
+ Returns
+ -------
+ list
+ List of all unique parameter names across all motion models
"""
- list_of_parameters = []
- all_motion_models = MotionModel.__subclasses__()
- for aa in range(len(all_motion_models)):
- param_names = getattr(all_motion_models[aa], 'fitter_param_names')
- param_fixed_names = getattr(all_motion_models[aa], 'fixed_param_names')
- param_err_names = [par+'_err' for par in param_names]
+ return motion_model_param_names(MotionModel.__subclasses__(), with_errors=with_errors, with_fixed=with_fixed)
- list_of_parameters += param_names
- if with_fixed:
- list_of_parameters += param_fixed_names
- if with_errors:
- list_of_parameters += param_err_names
-
- return np.unique(list_of_parameters).tolist()
-
+def motion_model_map():
+ """Get a dictionary mapping motion model names to MotionModel classes.
+
+ Returns
+ -------
+ mm_map : dict
+ Dictionary mapping motion model names to MotionModel classes.
+ """
+ mm_map = dict(
+ [(mm.__name__, mm) for mm in MotionModel.__subclasses__()]
+ )
+ # Sort by required epochs
+ mm_map = dict(sorted(mm_map.items(), key=lambda item: item[1].n_params))
+ return mm_map
\ No newline at end of file
diff --git a/flystar/parallax.py b/flystar/parallax.py
index 4792ec6..1605060 100755
--- a/flystar/parallax.py
+++ b/flystar/parallax.py
@@ -23,44 +23,64 @@
# Default cache size is 1 GB
cache_memory.reduce_size()
-@cache_memory.cache()
-def parallax_in_direction(RA, Dec, mjd, obsLocation='earth', PA=0):
+# @cache_memory.cache()
+def parallax_in_direction(ra, dec, mjd, obsLocation='earth', pa=0.):
"""
- | R.A. in degrees. (J2000)
- | Dec. in degrees. (J2000)
- | MJD
- | PA in degrees. (counterclockwise offset of the image y-axis from North)
-
- Equations following MulensModel.
+ Calculate the parallax vector in a given direction following MulensModel.
+
+ Parameters
+ ----------
+ RA : float or array-like
+ Right Ascension in degrees. (J2000)
+ Dec : float or array-like
+ Declination in degrees. (J2000)
+ mjd : float or array-like
+ Modified Julian Date.
+ obsLocation : str, optional
+ Observer location, by default 'earth'.
+ PA : float, optional
+ Position angle in degrees (counterclockwise offset of the image y-axis from North), by default 0.
+
+ Returns
+ -------
+ pvec : ndarray
+ Parallax vector components, shape of (N_stars, 2, N_times), where the second dimension corresponds to the x or y components.
"""
- #print('parallax_in_direction: len(t) = ', len(mjd))
-
# Munge inputs into astropy format.
- times = Time(mjd + 2400000.5, format='jd', scale='tdb')
- coord = SkyCoord(RA, Dec, unit=(units.deg, units.deg))
-
- direction = coord.cartesian.xyz.value
+ # times = Time(mjd + 2400000.5, format='jd', scale='tdb')
+ ra = np.atleast_1d(ra)
+ dec = np.atleast_1d(dec)
+ mjd = np.atleast_1d(mjd)
+ pa = np.atleast_1d(pa)
+ times = Time(mjd, format='mjd', scale='tdb') # convert to TDB
+ coord = SkyCoord(ra, dec, unit=(units.deg, units.deg)) # Shape (N_stars,)
+
+ directions = coord.cartesian.xyz.value.T # Shape (N_stars, 3)
north = np.array([0., 0., 1.])
- _east_projected = np.cross(north, direction) / np.linalg.norm(np.cross(north, direction))
- _north_projected = np.cross(direction, _east_projected) / np.linalg.norm(np.cross(direction, _east_projected))
+ # Cross product of each star with north vector
+ _east_projected = np.cross(north, directions)
+ _east_projected /= np.linalg.norm(_east_projected, axis=1)[:, np.newaxis] # Shape (N_stars, 3)
+ _north_projected = np.cross(directions, _east_projected)
+ _north_projected /= np.linalg.norm(_north_projected, axis=1)[:, np.newaxis] # Shape (N_stars, 3)
- obs_pos = get_observer_barycentric(obsLocation, times)
- sun_pos = get_body_barycentric(body='sun', time=times)
+ obs_pos = get_observer_barycentric(obsLocation, times) # Shape (N_times,)
+ sun_pos = get_body_barycentric(body='sun', time=times) # Shape (N_times,)
sun_obs_pos = sun_pos - obs_pos
- pos = sun_obs_pos.xyz.T.to(units.au)
+ pos = sun_obs_pos.xyz.T.to(units.au).value # Shape (N_times, 3)
+ # Broadcast pos to (N_stars, 3, N_times) and take dot product with east and north unit vectors to get components in those directions.
+ pos = np.broadcast_to(pos.T, (directions.shape[0], 3, pos.shape[0])) # Shape (N_stars, 3, N_times)
+
+ e = np.einsum('sdt,sd->st', pos, _east_projected) # Shape (N_stars, N_times)
+ n = np.einsum('sdt,sd->st', pos, _north_projected) # Shape (N_stars, N_times)
- e = np.dot(pos, _east_projected)
- n = np.dot(pos, _north_projected)
-
# Rotate frame e,n->x,y accounting for PA
- PA_rad = np.pi/180.0 * PA
- x = -e.value*np.cos(PA_rad) + n.value*np.sin(PA_rad)
- y = e.value*np.sin(PA_rad) + n.value*np.cos(PA_rad)
-
- pvec = np.array([x, y]).T
-
+ pa = np.deg2rad(pa) # shape (N_stars,)
+ x = -e * np.cos(pa[:, np.newaxis]) + n * np.sin(pa[:, np.newaxis]) # Shape (N_stars, N_times)
+ y = e * np.sin(pa[:, np.newaxis]) + n * np.cos(pa[:, np.newaxis]) # Shape (N_stars, N_times)
+ # pvec Shape (N_stars, 2, N_times)
+ pvec = np.stack((x, y), axis=1)
return pvec
@@ -144,6 +164,4 @@ def get_observer_barycentric(body, times, min_ephem_step=1, velocity=False):
if velocity:
return (obs_pos, obs_vel)
else:
- return obs_pos
-
-
+ return obs_pos
\ No newline at end of file
diff --git a/flystar/plots.py b/flystar/plots.py
index 2d65b2c..7213174 100755
--- a/flystar/plots.py
+++ b/flystar/plots.py
@@ -1,21 +1,20 @@
-from flystar import analysis, motion_model, startables
-import pylab as py
-import pylab as plt
+import pdb
+import math
+import astropy
+import matplotlib
import numpy as np
import matplotlib.mlab as mlab
-import matplotlib
-from matplotlib import colors
-import matplotlib.cm as cm
+import matplotlib.pyplot as plt
+import matplotlib.colors as mcolors
+from matplotlib import cm
from scipy.stats import chi2
-from scipy.optimize import curve_fit
from scipy.stats import norm
-import pdb
-import math
-import astropy
-from astropy.table import Table
+from scipy.optimize import curve_fit
from astropy.io import ascii
-from astropy.coordinates import SkyCoord
from astropy import units as u
+from astropy.table import Table
+from astropy.coordinates import SkyCoord
+from . import motion_model, startables
####################################################
# Code for making diagnostic plots for astrometry
@@ -23,8 +22,8 @@
####################################################
-def trans_positions(ref, ref_mat, starlist, starlist_mat, xlim=None, ylim=None, fileName=None,
- equal_axis=True, root='./'):
+def trans_positions(ref, ref_mat, starlist, starlist_mat, xlim=None, ylim=None,
+ equal_axis=True, save_path=None, show_plot=True):
"""
Plot positions of stars in reference list and the transformed starlist,
in reference list coordinates. Stars used in the transformation are
@@ -40,7 +39,7 @@ def trans_positions(ref, ref_mat, starlist, starlist_mat, xlim=None, ylim=None,
transformation. Standard column headers are assumed.
starlist: astropy table
- Transformed starist with the reference starlist coordinates.
+ Transformed starlist with the reference starlist coordinates.
Standard column headers are assumed
starlist_mat: astropy table
@@ -51,35 +50,41 @@ def trans_positions(ref, ref_mat, starlist, starlist_mat, xlim=None, ylim=None,
If not None, sets the xmin and xmax limit of the plot
ylim: None or list/array [ymin, ymax]
- If not None, sets the ymin and ymax limit of the plot
+ If not None, sets the ymin and ymax limit of the plot
equal_axis: boolean
If true, make axes equal. True by default
-
+
+ save_path: string
+ Path to save the figure to. Default is None
+
+ show_plot: boolean
+ If true, show the plot. Default is True
+
"""
- py.figure(figsize=(10,10))
- py.clf()
- py.plot(ref['x'], ref['y'], 'g+', ms=5, label='Reference')
- py.plot(starlist['x'], starlist['y'], 'rx', ms=5, label='starlist')
- py.plot(ref_mat['x'], ref_mat['y'], color='skyblue', marker='s', ms=10, alpha=0.3,
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ plt.plot(ref['x'], ref['y'], 'g+', ms=5, label='Reference')
+ plt.plot(starlist['x'], starlist['y'], 'rx', ms=5, label='starlist')
+ plt.plot(ref_mat['x'], ref_mat['y'], color='skyblue', marker='s', ms=10, alpha=0.3,
linestyle='None', label='Matched Reference')
- py.plot(starlist_mat['x'], starlist_mat['y'], color='darkblue', marker='s', ms=5, alpha=0.3,
+ plt.plot(starlist_mat['x'], starlist_mat['y'], color='darkblue', marker='s', ms=5, alpha=0.3,
linestyle='None', label='Matched starlist')
- py.xlabel('X position (Reference Coords)')
- py.ylabel('Y position (Reference Coords)')
- py.legend(numpoints=1)
- py.title('Label.dat Positions After Transformation')
+ plt.xlabel('X position (Reference Coords)')
+ plt.ylabel('Y position (Reference Coords)')
+ plt.legend(numpoints=1)
+ plt.title('Label.dat Positions After Transformation')
if xlim != None:
- py.axis([xlim[0], xlim[1], ylim[0], ylim[1]])
+ plt.axis([xlim[0], xlim[1], ylim[0], ylim[1]])
if equal_axis:
- py.axis('equal')
- if fileName!=None:
- #py.savefig(root + fileName[3:8] + 'Transformed_positions_' + '.png')
- py.savefig(root + 'Transformed_positions_{0}'.format(fileName) + '.png')
- else:
- py.savefig(root + 'Transformed_positions.png')
+ plt.axis('equal')
- py.close()
+ if save_path:
+ plt.savefig(save_path, dpi=300)
+ if show_plot:
+ plt.show()
+ else:
+ plt.close()
return
@@ -93,10 +98,10 @@ def pos_diff_hist(ref_mat, starlist_mat, nbins=25, bin_width=None, xlim=None, fi
ref_mat: astropy table
Reference starlist only containing matched stars that were used in the
transformation. Standard column headers are assumed.
-
+
starlist_mat: astropy table
Transformed starlist only containing the matched stars used in
- the transformation. Standard column headers are assumed.
+ the transformation. Standard column headers are assumed.
nbins: int
Number of bins used in histogram, regardless of data range. This is
@@ -108,7 +113,7 @@ def pos_diff_hist(ref_mat, starlist_mat, nbins=25, bin_width=None, xlim=None, fi
xlim: None or [xmin, xmax]
If not none, set the X range of the plot
-
+
"""
diff_x = ref_mat['x'] - starlist_mat['x']
diff_y = ref_mat['y'] - starlist_mat['y']
@@ -120,23 +125,23 @@ def pos_diff_hist(ref_mat, starlist_mat, nbins=25, bin_width=None, xlim=None, fi
max_range = max([max(diff_x), max(diff_y)])
bins = np.arange(min_range, max_range+bin_width, bin_width)
-
- py.figure(figsize=(10,10))
- py.clf()
- py.hist(diff_x, histtype='step', bins=bins, color='blue', label='X')
- py.hist(diff_y, histtype='step', bins=bins, color='red', label='Y')
- py.xlabel('Reference Position - starlist Position')
- py.ylabel('N stars')
- py.title('Position Differences for matched stars')
+
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ plt.hist(diff_x, histtype='step', bins=bins, color='blue', label='X')
+ plt.hist(diff_y, histtype='step', bins=bins, color='red', label='Y')
+ plt.xlabel('Reference Position - starlist Position')
+ plt.ylabel('N stars')
+ plt.title('Position Differences for matched stars')
if xlim != None:
- py.xlim([xlim[0], xlim[1]])
- py.legend()
+ plt.xlim([xlim[0], xlim[1]])
+ plt.legend()
if fileName != None:
- py.savefig(root + fileName[3:8] + 'Positions_hist_' + '.png')
+ plt.savefig(root + fileName[3:8] + 'Positions_hist_' + '.png', dpi=300)
else:
- py.savefig(root + 'Positions_hist.png')
+ plt.savefig(root + 'Positions_hist.png', dpi=300)
- py.close()
+ plt.close()
return
def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None, errs='both', xlim=None,
@@ -154,7 +159,7 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
ref_mat: astropy table
Reference starlist only containing matched stars that were used in the
transformation. Standard column headers are assumed.
-
+
starlist_mat: astropy table
Transformed starlist only containing the matched stars used in
the transformation. Standard column headers are assumed.
@@ -185,9 +190,10 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
outlier: float (default = 10)
Defines how many sigma away from 0 a star must be in order to be considered
- an outlier.
-
+ an outlier.
+
"""
+ from . import analysis
diff_x = ref_mat['x'] - starlist_mat['x']
diff_y = ref_mat['y'] - starlist_mat['y']
@@ -201,7 +207,7 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
elif errs == 'starlist':
xerr = starlist_mat['xe']
yerr = starlist_mat['ye']
-
+
# Calculate ratio between differences and the combined error. This is
# what we will plot
ratio_x = diff_x / xerr
@@ -209,7 +215,7 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
# Identify non-outliers, within +/- sigma away from 0
good = np.where( (np.abs(ratio_x) < outlier) & (np.abs(ratio_y) < outlier) )
-
+
"""
# For both X and Y, calculate chi-square. Combine arrays to get combined
# chi-square
@@ -217,11 +223,11 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
chi_sq_y = diff_y**2. / yerr**2.
chi_sq = np.append(chi_sq_x, chi_sq_y)
-
+
# Calculate degrees of freedom in transformation
num_mod_params = calc_nparam(transform)
deg_freedom = len(chi_sq) - num_mod_params
-
+
# Calculate reduced chi-square
chi_sq_red = np.sum(chi_sq) / deg_freedom
"""
@@ -233,13 +239,13 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
starlist_mat[good],
transform,
errs=errs)
-
+
num_mod_params = analysis.calc_nparam(transform)
#-------------------------------------------#
# Plotting
#-------------------------------------------#
-
+
# Set the binning as per user input
bins = nbins
if bin_width != None:
@@ -247,52 +253,52 @@ def pos_diff_err_hist(ref_mat, starlist_mat, transform, nbins=25, bin_width=None
max_range = max([max(ratio_x), max(ratio_y)])
bins = np.arange(min_range, max_range+bin_width, bin_width)
-
- py.figure(figsize=(10,10))
- py.clf()
- n_x, bins_x, p = py.hist(ratio_x, histtype='step', bins=bins, color='blue',
+
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ n_x, bins_x, p = plt.hist(ratio_x, histtype='step', bins=bins, color='blue',
label='X', density=True, linewidth=2)
- n_y, bins_y, p = py.hist(ratio_y, histtype='step', bins=bins, color='red',
+ n_y, bins_y, p = plt.hist(ratio_y, histtype='step', bins=bins, color='red',
label='Y', density=True, linewidth=2)
# Overplot a Gaussian, as well
mean = 0
sigma = 1
x = np.arange(-6, 6, 0.1)
- py.plot(x, norm.pdf(x,mean,sigma), 'g-', linewidth=2)
-
+ plt.plot(x, norm.pdf(x,mean,sigma), 'g-', linewidth=2)
+
# Annotate reduced chi-sqared values in plot: with outliers
- xstr = '$\chi^2_r$ = {0}'.format(np.round(chi_sq_red, decimals=3))
- py.annotate(xstr, xy=(0.3, 0.77), xycoords='figure fraction', color='black')
+ xstr = r'$\chi^2_r$ = {0}'.format(np.round(chi_sq_red, decimals=3))
+ plt.annotate(xstr, xy=(0.3, 0.77), xycoords='figure fraction', color='black')
txt = r'$\nu$ = 2*{0} - {1} = {2}'.format(len(diff_x), num_mod_params,
deg_freedom)
- py.annotate(txt, xy=(0.25,0.74), xycoords='figure fraction', color='black')
+ plt.annotate(txt, xy=(0.25,0.74), xycoords='figure fraction', color='black')
xstr2 = 'With Outliers'
- xstr3 = '{0} with +/- {1}+ sigma'.format(len(ratio_x) - len(good[0]), outlier)
- py.annotate(xstr2, xy=(0.29, 0.83), xycoords='figure fraction', color='black')
- py.annotate(xstr3, xy=(0.25, 0.80), xycoords='figure fraction', color='black')
-
+ xstr3 = '{0} with ± {1}+ sigma'.format(len(ratio_x) - len(good[0]), outlier)
+ plt.annotate(xstr2, xy=(0.29, 0.83), xycoords='figure fraction', color='black')
+ plt.annotate(xstr3, xy=(0.25, 0.80), xycoords='figure fraction', color='black')
+
# Annotate reduced chi-sqared values in plot: without outliers
- xstr = '$\chi^2_r$ = {0}'.format(np.round(chi_sq_red_good, decimals=3))
- py.annotate(xstr, xy=(0.7, 0.8), xycoords='figure fraction', color='black')
+ xstr = r'$\chi^2_r$ = {0}'.format(np.round(chi_sq_red_good, decimals=3))
+ plt.annotate(xstr, xy=(0.7, 0.8), xycoords='figure fraction', color='black')
txt = r'$\nu$ = 2*{0} - {1} = {2}'.format(len(good[0]), num_mod_params,
deg_freedom_good)
- py.annotate(txt, xy=(0.65,0.77), xycoords='figure fraction', color='black')
+ plt.annotate(txt, xy=(0.65,0.77), xycoords='figure fraction', color='black')
xstr2 = 'Without Outliers'
- py.annotate(xstr2, xy=(0.67, 0.83), xycoords='figure fraction', color='black')
-
- py.xlabel('(Ref Pos - TransStarlist Pos) / Ast. Error')
- py.ylabel('N stars (normalized)')
- py.title('Position Residuals for Matched Stars')
+ plt.annotate(xstr2, xy=(0.67, 0.83), xycoords='figure fraction', color='black')
+
+ plt.xlabel('(Ref Pos - TransStarlist Pos) / Ast. Error')
+ plt.ylabel('N stars (normalized)')
+ plt.title('Position Residuals for Matched Stars')
if xlim != None:
- py.xlim([xlim[0], xlim[1]])
- py.legend()
+ plt.xlim([xlim[0], xlim[1]])
+ plt.legend()
if fileName != None:
- py.savefig(root + fileName[3:8] + 'Positions_err_ratio_hist_' + '.png')
+ plt.savefig(root + fileName[3:8] + 'Positions_err_ratio_hist_' + '.png', dpi=300)
else:
- py.savefig(root + 'Positions_err_ratio_hist.png')
+ plt.savefig(root + 'Positions_err_ratio_hist.png', dpi=300)
- py.close()
+ plt.close()
return
@@ -306,10 +312,10 @@ def mag_diff_hist(ref_mat, starlist_mat, bins=25, fileName=None, root='./'):
ref_mat: astropy table
Reference starlist only containing matched stars that were used in the
transformation. Standard column headers are assumed.
-
+
starlist_mat: astropy table
Transformed starlist only containing the matched stars used in
- the transformation. Standard column headers are assumed.
+ the transformation. Standard column headers are assumed.
"""
diff_m = ref_mat['m'] - starlist_mat['m']
@@ -318,19 +324,19 @@ def mag_diff_hist(ref_mat, starlist_mat, bins=25, fileName=None, root='./'):
bad = np.isnan(diff_m)
bad2 = np.where(bad == True)
diff_m = np.delete(diff_m, bad2)
-
- py.figure(figsize=(10,10))
- py.clf()
- py.hist(diff_m, bins=bins)
- py.xlabel('Reference Mag - TransStarlist Mag')
- py.ylabel('N stars')
- py.title('Magnitude Difference for matched stars')
+
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ plt.hist(diff_m, bins=bins)
+ plt.xlabel('Reference Mag - TransStarlist Mag')
+ plt.ylabel('N stars')
+ plt.title('Magnitude Difference for matched stars')
if fileName != None:
- py.savefig(root + fileName[3:8] + 'Magnitude_hist_' + '.png')
+ plt.savefig(root + fileName[3:8] + 'Magnitude_hist_' + '.png', dpi=300)
else:
- py.savefig(root + 'Magnitude_hist.png')
+ plt.savefig(root + 'Magnitude_hist.png', dpi=300)
- py.close()
+ plt.close()
return
def pos_diff_quiver(ref_mat, starlist_mat, qscale=10, keyLength=0.2, xlim=None, ylim=None,
@@ -344,7 +350,7 @@ def pos_diff_quiver(ref_mat, starlist_mat, qscale=10, keyLength=0.2, xlim=None,
ref_mat: astropy table
Reference starlist only containing matched stars that were used in the
transformation. Standard column headers are assumed.
-
+
starlist_mat: astropy table
Transformed starlist only containing the matched stars used in
the transformation. Standard column headers are assumed.
@@ -389,7 +395,7 @@ def pos_diff_quiver(ref_mat, starlist_mat, qscale=10, keyLength=0.2, xlim=None,
diff_y = diff_y[good]
xpos = xpos[good]
ypos = ypos[good]
-
+
# Divide differences by reference error, if desired
if sigma:
@@ -410,36 +416,36 @@ def pos_diff_quiver(ref_mat, starlist_mat, qscale=10, keyLength=0.2, xlim=None,
diff_y = np.append(diff_y, 0)
s = len(xpos)
-
- py.figure(figsize=(10,10))
- py.clf()
- q = py.quiver(xpos, ypos, diff_x, diff_y, scale=qscale)
+
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ q = plt.quiver(xpos, ypos, diff_x, diff_y, scale=qscale)
fmt = '{0} ref units'.format(keyLength)
- #py.quiverkey(q, 0.2, 0.92, keyLength, fmt, coordinates='figure', color='black')
+ #plt.quiverkey(q, 0.2, 0.92, keyLength, fmt, coordinates='figure', color='black')
# Make our reference arrow a different color
- q2 = py.quiver(xpos[s-2:s], ypos[s-2:s], diff_x[s-2:s], diff_y[s-2:s], scale=qscale, color='red')
+ q2 = plt.quiver(xpos[s-2:s], ypos[s-2:s], diff_x[s-2:s], diff_y[s-2:s], scale=qscale, color='red')
# Annotate our reference quiver arrow
- py.annotate(fmt, xy=(xpos[-1]-2, ypos[-1]+0.5), color='red')
- py.xlabel('X Position (Reference coords)')
- py.ylabel('Y Position (Reference coords)')
+ plt.annotate(fmt, xy=(xpos[-1]-2, ypos[-1]+0.5), color='red')
+ plt.xlabel('X Position (Reference coords)')
+ plt.ylabel('Y Position (Reference coords)')
if xlim != None:
- py.axis([xlim[0], ylim[1], ylim[0], ylim[1]])
+ plt.axis([xlim[0], ylim[1], ylim[0], ylim[1]])
if sigma:
if fileName != None:
- py.title('(Reference - Transformed Starlist positions) / sigma')
- py.savefig(root + fileName[3:8] + 'Positions_quiver_sigma_' + '.png')
+ plt.title('(Reference - Transformed Starlist positions) / sigma')
+ plt.savefig(root + fileName[3:8] + 'Positions_quiver_sigma_' + '.png', dpi=300)
else:
- py.title('(Reference - Transformed Starlist positions) / sigma')
- py.savefig(root + 'Positions_quiver_sigma.png')
+ plt.title('(Reference - Transformed Starlist positions) / sigma')
+ plt.savefig(root + 'Positions_quiver_sigma.png', dpi=300)
else:
if fileName != None:
- py.title('Reference - Transformed Starlist positions')
- py.savefig(root + fileName[3:8] + 'Positions_quiver_' + '.png')
+ plt.title('Reference - Transformed Starlist positions')
+ plt.savefig(root + fileName[3:8] + 'Positions_quiver_' + '.png', dpi=300)
else:
- py.title('Reference - Transformed Starlist positions')
- py.savefig(root + 'Positions_quiver.png')
+ plt.title('Reference - Transformed Starlist positions')
+ plt.savefig(root + 'Positions_quiver.png', dpi=300)
- py.close()
+ plt.close()
return
def vpd(ref, starlist_trans, vxlim, vylim):
@@ -464,7 +470,7 @@ def vpd(ref, starlist_trans, vxlim, vylim):
If not None, sets the vxmin and vxmax limit of the plot
vylim: None or list/array [vymin, vymax]
- If not None, sets the vymin and vymax limit of the plot
+ If not None, sets the vymin and vymax limit of the plot
"""
# Extract velocities
ref_vx = ref['vx']
@@ -472,17 +478,17 @@ def vpd(ref, starlist_trans, vxlim, vylim):
trans_vx = starlist_trans['vx']
trans_vy = starlist_trans['vy']
- py.figure(figsize=(10,10))
- py.clf()
- py.plot(trans_vx, trans_vy, 'k.', ms=8, label='Transformed', alpha=0.4)
- py.plot(ref_vx, ref_vy, 'r.', ms=8, label='Reference', alpha=0.4)
- py.xlabel('Vx (Reference units)')
- py.ylabel('Vy (Reference units)')
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ plt.plot(trans_vx, trans_vy, 'k.', ms=8, label='Transformed', alpha=0.4)
+ plt.plot(ref_vx, ref_vy, 'r.', ms=8, label='Reference', alpha=0.4)
+ plt.xlabel('Vx (Reference units)')
+ plt.ylabel('Vy (Reference units)')
if vxlim != None:
- py.axis([vxlim[0], vylim[1], vylim[0], vylim[1]])
- py.title('Reference and Transformed Proper Motions')
- py.legend()
- py.savefig('Transformed_velocities.png')
+ plt.axis([vxlim[0], vylim[1], vylim[0], vylim[1]])
+ plt.title('Reference and Transformed Proper Motions')
+ plt.legend()
+ plt.savefig('Transformed_velocities.png', dpi=300)
return
@@ -507,7 +513,7 @@ def vel_diff_err_hist(ref_mat, starlist_mat, nbins=25, bin_width=None, vxlim=Non
bin_width: None or float
If float, sets the width of the bins used in the histograms. Will override
nbins
-
+
vxlim: None or [vx_min, vx_max]
If not none, set the X axis of the Vx plot by defining the minimum
and maximum values
@@ -519,7 +525,7 @@ def vel_diff_err_hist(ref_mat, starlist_mat, nbins=25, bin_width=None, vxlim=Non
# Will produce 2-panel plot: Vx resid and Vy resid
diff_vx = ref_mat['vx'] - starlist_mat['vx']
diff_vy = ref_mat['vy'] - starlist_mat['vy']
-
+
vx_err = np.hypot(ref_mat['vx_err'], starlist_mat['vx_err'])
vy_err = np.hypot(ref_mat['vy_err'], starlist_mat['vy_err'])
@@ -537,28 +543,28 @@ def vel_diff_err_hist(ref_mat, starlist_mat, nbins=25, bin_width=None, vxlim=Non
mean = 0
sigma = 1
x = np.arange(-6, 6, 0.1)
-
- py.figure(figsize=(20,10))
- py.subplot(121)
- py.subplots_adjust(left=0.1)
- py.hist(ratio_vx, bins=xbins, histtype='step', color='black', density=True,
+
+ plt.figure(figsize=(20,10))
+ plt.subplot(121)
+ plt.subplots_adjust(left=0.1)
+ plt.hist(ratio_vx, bins=xbins, histtype='step', color='black', density=True,
linewidth=2)
- py.plot(x, norm.pdf(x,mean,sigma), 'r-', linewidth=2)
- py.xlabel('(Ref Vx - Trans Vx) / Vxe')
- py.ylabel('N_stars')
- py.title('Vx Residuals, Matched')
+ plt.plot(x, norm.pdf(x,mean,sigma), 'r-', linewidth=2)
+ plt.xlabel('(Ref Vx - Trans Vx) / Vxe')
+ plt.ylabel('N_stars')
+ plt.title('Vx Residuals, Matched')
if vxlim != None:
- py.xlim([vxlim[0], vxlim[1]])
- py.subplot(122)
- py.hist(ratio_vy, bins=ybins, histtype='step', color='black', density=True,
+ plt.xlim([vxlim[0], vxlim[1]])
+ plt.subplot(122)
+ plt.hist(ratio_vy, bins=ybins, histtype='step', color='black', density=True,
linewidth=2)
- py.plot(x, norm.pdf(x,mean,sigma), 'r-', linewidth=2)
- py.xlabel('(Ref Vy - Trans Vy) / Vye')
- py.ylabel('N_stars')
- py.title('Vy Residuals, Matched')
+ plt.plot(x, norm.pdf(x,mean,sigma), 'r-', linewidth=2)
+ plt.xlabel('(Ref Vy - Trans Vy) / Vye')
+ plt.ylabel('N_stars')
+ plt.title('Vy Residuals, Matched')
if vylim != None:
- py.xlim([vylim[0], vylim[1]])
- py.savefig('Vel_err_ratio_dist.png')
+ plt.xlim([vylim[0], vylim[1]])
+ plt.savefig('Vel_err_ratio_dist.png', dpi=300)
return
@@ -606,17 +612,17 @@ def residual_vpd(ref_mat, starlist_trans_mat, pscale=None):
yerr = np.hypot(ref_mat['vy_err'], starlist_trans_mat['vy_err'])
# Plotting
- py.figure(figsize=(10,10))
- py.clf()
- py.errorbar(diff_x, diff_y, xerr=xerr, yerr=yerr, fmt='k.', ms=8, alpha=0.5)
+ plt.figure(figsize=(10,10))
+ plt.clf()
+ plt.errorbar(diff_x, diff_y, xerr=xerr, yerr=yerr, fmt='k.', ms=8, alpha=0.5)
if pscale != None:
- py.xlabel('Reference_vx - Transformed_vx (mas/yr)')
- py.ylabel('Reference_vy - Transformed_vy (mas/yr)')
+ plt.xlabel('Reference_vx - Transformed_vx (mas/yr)')
+ plt.ylabel('Reference_vy - Transformed_vy (mas/yr)')
else:
- py.xlabel('Reference_vx - Transformed_vx (reference coords)')
- py.ylabel('Reference_vy - Transformed_vy (reference coords)')
- py.title('Proper Motion Residuals')
- py.savefig('resid_vpd.png')
+ plt.xlabel('Reference_vx - Transformed_vx (reference coords)')
+ plt.ylabel('Reference_vy - Transformed_vy (reference coords)')
+ plt.title('Proper Motion Residuals')
+ plt.savefig('resid_vpd.png', dpi=300)
return
@@ -626,7 +632,7 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
print( 'Creating residuals plots for star(s):' )
print( starNames )
-
+
s = starset.StarSet(rootDir + align)
s.loadPolyfit(rootDir + poly, accel=0, arcsec=0)
Nstars = len(starNames)
@@ -636,18 +642,18 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
else:
Nrows = math.ceil(Nstars / (Ncols / 2)) * 3
- py.close('all')
- py.figure(2, figsize=figsize)
+ plt.close('all')
+ plt.figure(2, figsize=figsize)
names = s.getArray('name')
mag = s.getArray('mag')
x = s.getArray('x')
y = s.getArray('y')
r = np.hypot(x,y)
-
+
for i in range(Nstars):
-
+
starName = starNames[i]
-
+
ii = names.index(starName)
star = s.stars[ii]
@@ -728,9 +734,9 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
idx = np.where(abs(sig) > 4)
print( 'Star: ', starName )
- print( '\tX Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tX Chi^2 = %5.2f (%6.2f for %2d dof)' %
(fitx.chi2red, fitx.chi2, fitx.dof))
- print( '\tY Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tY Chi^2 = %5.2f (%6.2f for %2d dof)' %
(fity.chi2red, fity.chi2, fity.dof))
# print( 'X Outliers: ', time[idxX] )
# print( 'Y Outliers: ', time[idxY] )
@@ -745,8 +751,8 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
t0 = int(np.floor(np.min(time)))
tO = int(np.ceil(np.max(time)))
-
- dateTicLoc = py.MultipleLocator(3)
+
+ dateTicLoc = plt.MultipleLocator(3)
dateTicRng = [t0-1, tO+1]
dateTics = np.arange(t0, tO+1)
DateTicsLabel = dateTics-2000
@@ -754,7 +760,7 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
# See if we are using MJD instead.
if time[0] > 50000:
print('MJD')
- dateTicLoc = py.MultipleLocator(1000)
+ dateTicLoc = plt.MultipleLocator(1000)
t0 = int(np.round(np.min(time), 50))
tO = int(np.round(np.max(time), 50))
dateTicRng = [t0-200, tO+200]
@@ -775,125 +781,125 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
row = 1
else:
col = 1 + 2*(i % (Ncols/2))
- row = 1 + 3*(i//(Ncols/2))
-
+ row = 1 + 3*(i//(Ncols/2))
+
ind = (row-1)*Ncols + col
- paxes = py.subplot(Nrows, Ncols, ind)
- py.plot(time, fitLineX, 'b-')
- py.plot(time, fitLineX + fitSigX, 'b--')
- py.plot(time, fitLineX - fitSigX, 'b--')
- py.errorbar(time, x, yerr=xerr, fmt='k.')
- rng = py.axis()
- py.ylim(np.min(x-xerr-0.1),np.max(x+xerr+0.1))
- py.xlabel('Date - 2000 (yrs)', fontsize=fontsize1)
+ paxes = plt.subplot(Nrows, Ncols, ind)
+ plt.plot(time, fitLineX, 'b-')
+ plt.plot(time, fitLineX + fitSigX, 'b--')
+ plt.plot(time, fitLineX - fitSigX, 'b--')
+ plt.errorbar(time, x, yerr=xerr, fmt='k.')
+ rng = plt.axis()
+ plt.ylim(np.min(x-xerr-0.1),np.max(x+xerr+0.1))
+ plt.xlabel('Date - 2000 (yrs)', fontsize=fontsize1)
if time[0] > 50000:
- py.xlabel('Date (MJD)', fontsize=fontsize1)
- py.ylabel('X (pix)', fontsize=fontsize1)
+ plt.xlabel('Date (MJD)', fontsize=fontsize1)
+ plt.ylabel('X (pix)', fontsize=fontsize1)
paxes.xaxis.set_major_formatter(fmtX)
paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.yaxis.set_major_formatter(fmtY)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
- py.yticks(np.arange(np.min(x-xerr-0.1), np.max(x+xerr+0.1), 0.2))
- py.xticks(dateTics, DateTicsLabel)
- py.xlim(np.min(dateTics), np.max(dateTics))
- py.annotate(starName,xy=(1.0,1.1), xycoords='axes fraction', fontsize=12, color='red')
+ plt.yticks(np.arange(np.min(x-xerr-0.1), np.max(x+xerr+0.1), 0.2))
+ plt.xticks(dateTics, DateTicsLabel)
+ plt.xlim(np.min(dateTics), np.max(dateTics))
+ plt.annotate(starName,xy=(1.0,1.1), xycoords='axes fraction', fontsize=12, color='red')
col = col + 1
ind = (row-1)*Ncols + col
- paxes = py.subplot(Nrows, Ncols, ind)
- py.plot(time, fitLineY, 'b-')
- py.plot(time, fitLineY + fitSigY, 'b--')
- py.plot(time, fitLineY - fitSigY, 'b--')
- py.errorbar(time, y, yerr=yerr, fmt='k.')
- rng = py.axis()
- py.axis(dateTicRng + [rng[2], rng[3]], fontsize=fontsize1)
- py.xlabel('Date - 2000 (yrs)', fontsize=fontsize1)
+ paxes = plt.subplot(Nrows, Ncols, ind)
+ plt.plot(time, fitLineY, 'b-')
+ plt.plot(time, fitLineY + fitSigY, 'b--')
+ plt.plot(time, fitLineY - fitSigY, 'b--')
+ plt.errorbar(time, y, yerr=yerr, fmt='k.')
+ rng = plt.axis()
+ plt.axis(dateTicRng + [rng[2], rng[3]], fontsize=fontsize1)
+ plt.xlabel('Date - 2000 (yrs)', fontsize=fontsize1)
if time[0] > 50000:
- py.xlabel('Date (MJD)', fontsize=fontsize1)
- py.ylabel('Y (pix)', fontsize=fontsize1)
+ plt.xlabel('Date (MJD)', fontsize=fontsize1)
+ plt.ylabel('Y (pix)', fontsize=fontsize1)
#paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.xaxis.set_major_formatter(fmtX)
paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.yaxis.set_major_formatter(fmtY)
paxes.tick_params(axis='both', which='major', labelsize=12)
- py.ylim(np.min(y-yerr-0.1),np.max(y+yerr+0.1))
- py.yticks(np.arange(np.min(y-yerr-0.1), np.max(y+yerr+0.1), 0.2))
- py.xticks(dateTics, DateTicsLabel)
- py.xlim(np.min(dateTics), np.max(dateTics))
+ plt.ylim(np.min(y-yerr-0.1),np.max(y+yerr+0.1))
+ plt.yticks(np.arange(np.min(y-yerr-0.1), np.max(y+yerr+0.1), 0.2))
+ plt.xticks(dateTics, DateTicsLabel)
+ plt.xlim(np.min(dateTics), np.max(dateTics))
row = row + 1
col = col - 1
ind = (row-1)*Ncols + col
- paxes = py.subplot(Nrows, Ncols, ind)
- py.plot(time, np.zeros(len(time)), 'b-')
- py.plot(time, fitSigX, 'b--')
- py.plot(time, -fitSigX, 'b--')
- py.errorbar(time, x - fitLineX, yerr=xerr, fmt='k.')
- py.axis(dateTicRng + resTicRng, fontsize=fontsize1)
- py.xlabel('Date - 2000 (yrs)', fontsize=fontsize1)
+ paxes = plt.subplot(Nrows, Ncols, ind)
+ plt.plot(time, np.zeros(len(time)), 'b-')
+ plt.plot(time, fitSigX, 'b--')
+ plt.plot(time, -fitSigX, 'b--')
+ plt.errorbar(time, x - fitLineX, yerr=xerr, fmt='k.')
+ plt.axis(dateTicRng + resTicRng, fontsize=fontsize1)
+ plt.xlabel('Date - 2000 (yrs)', fontsize=fontsize1)
if time[0] > 50000:
- py.xlabel('Date (MJD)', fontsize=fontsize1)
- py.ylabel('X Residuals (pix)', fontsize=fontsize1)
+ plt.xlabel('Date (MJD)', fontsize=fontsize1)
+ plt.ylabel('X Residuals (pix)', fontsize=fontsize1)
paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.xaxis.set_major_formatter(fmtX)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
- py.xticks(dateTics, DateTicsLabel)
- py.xlim(np.min(dateTics), np.max(dateTics))
+ plt.xticks(dateTics, DateTicsLabel)
+ plt.xlim(np.min(dateTics), np.max(dateTics))
col = col + 1
ind = (row-1)*Ncols + col
- paxes = py.subplot(Nrows, Ncols, ind)
- py.plot(time, np.zeros(len(time)), 'b-')
- py.plot(time, fitSigY, 'b--')
- py.plot(time, -fitSigY, 'b--')
- py.errorbar(time, y - fitLineY, yerr=yerr, fmt='k.')
- py.axis(dateTicRng + resTicRng, fontsize=fontsize1)
- py.xlabel('Date -2000 (yrs)', fontsize=fontsize1)
+ paxes = plt.subplot(Nrows, Ncols, ind)
+ plt.plot(time, np.zeros(len(time)), 'b-')
+ plt.plot(time, fitSigY, 'b--')
+ plt.plot(time, -fitSigY, 'b--')
+ plt.errorbar(time, y - fitLineY, yerr=yerr, fmt='k.')
+ plt.axis(dateTicRng + resTicRng, fontsize=fontsize1)
+ plt.xlabel('Date -2000 (yrs)', fontsize=fontsize1)
if time[0] > 50000:
- py.xlabel('Date (MJD)', fontsize=fontsize1)
- py.ylabel('Y Residuals (pix)', fontsize=fontsize1)
+ plt.xlabel('Date (MJD)', fontsize=fontsize1)
+ plt.ylabel('Y Residuals (pix)', fontsize=fontsize1)
paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.xaxis.set_major_formatter(fmtX)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
- py.xticks(dateTics, DateTicsLabel)
- py.xlim(np.min(dateTics), np.max(dateTics))
+ plt.xticks(dateTics, DateTicsLabel)
+ plt.xlim(np.min(dateTics), np.max(dateTics))
row = row + 1
col = col - 1
ind = (row-1)*Ncols + col
- paxes = py.subplot(Nrows, Ncols, ind)
- py.errorbar(x,y, xerr=xerr, yerr=yerr, fmt='k.')
- py.yticks(np.arange(np.min(y-yerr-0.1), np.max(y+yerr+0.1), 0.2))
- py.xticks(np.arange(np.min(x-xerr-0.1), np.max(x+xerr+0.1), 0.2), rotation = 270)
- py.axis('equal')
+ paxes = plt.subplot(Nrows, Ncols, ind)
+ plt.errorbar(x,y, xerr=xerr, yerr=yerr, fmt='k.')
+ plt.yticks(np.arange(np.min(y-yerr-0.1), np.max(y+yerr+0.1), 0.2))
+ plt.xticks(np.arange(np.min(x-xerr-0.1), np.max(x+xerr+0.1), 0.2), rotation = 270)
+ plt.axis('equal')
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
paxes.yaxis.set_major_formatter(FormatStrFormatter('%.2f'))
paxes.xaxis.set_major_formatter(FormatStrFormatter('%.2f'))
- py.xlabel('X (pix)', fontsize=fontsize1)
- py.ylabel('Y (pix)', fontsize=fontsize1)
- py.plot(fitLineX, fitLineY, 'b-')
+ plt.xlabel('X (pix)', fontsize=fontsize1)
+ plt.ylabel('Y (pix)', fontsize=fontsize1)
+ plt.plot(fitLineX, fitLineY, 'b-')
col = col + 1
ind = (row-1)*Ncols + col
bins = np.arange(-7.5, 7.5, 1)
- paxes = py.subplot(Nrows, Ncols, ind)
+ paxes = plt.subplot(Nrows, Ncols, ind)
id = np.where(diffY < 0)[0]
- sig[id] = -1.*sig[id]
- (n, b, p) = py.hist(sigX, bins, histtype='stepfilled', color='b', label='X')
- py.setp(p, 'facecolor', 'b')
- (n, b, p) = py.hist(sigY, bins, histtype='step', color='r', label='Y')
- py.axis([-7, 7, 0, 8], fontsize=10)
- py.legend()
- py.xlabel('Residuals (sigma)', fontsize=fontsize1)
- py.ylabel('Number of Epochs', fontsize=fontsize1)
+ sig[id] = -1.*sig[id]
+ (n, b, p) = plt.hist(sigX, bins, histtype='stepfilled', color='b', label='X')
+ plt.setp(p, 'facecolor', 'b')
+ (n, b, p) = plt.hist(sigY, bins, histtype='step', color='r', label='Y')
+ plt.axis([-7, 7, 0, 8], fontsize=10)
+ plt.legend()
+ plt.xlabel('Residuals (sigma)', fontsize=fontsize1)
+ plt.ylabel('Number of Epochs', fontsize=fontsize1)
##########
#
@@ -901,9 +907,9 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
#
##########
if (radial == True):
- py.clf()
+ plt.clf()
- dateTicLoc = py.MultipleLocator(3)
+ dateTicLoc = plt.MultipleLocator(3)
maxErr = np.array([rerr, terr]).max()
resTicRng = [-3*maxErr, 3*maxErr]
@@ -912,90 +918,90 @@ def plotStar(starNames, rootDir='./', align='align/align_d_rms_1000_abs_t',
fmtX = FormatStrFormatter('%5i')
fmtY = FormatStrFormatter('%6.2f')
- paxes = py.subplot(3,2,1)
- py.plot(time, fitLineR, 'b-')
- py.plot(time, fitLineR + fitSigR, 'b--')
- py.plot(time, fitLineR - fitSigR, 'b--')
- py.errorbar(time, r, yerr=rerr, fmt='k.')
- rng = py.axis()
- py.axis(dateTicRng + [rng[2], rng[3]])
- py.xlabel('Date (yrs)')
- py.ylabel('R (pix)')
+ paxes = plt.subplot(3,2,1)
+ plt.plot(time, fitLineR, 'b-')
+ plt.plot(time, fitLineR + fitSigR, 'b--')
+ plt.plot(time, fitLineR - fitSigR, 'b--')
+ plt.errorbar(time, r, yerr=rerr, fmt='k.')
+ rng = plt.axis()
+ plt.axis(dateTicRng + [rng[2], rng[3]])
+ plt.xlabel('Date (yrs)')
+ plt.ylabel('R (pix)')
paxes.xaxis.set_major_formatter(fmtX)
paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.yaxis.set_major_formatter(fmtY)
- paxes = py.subplot(3, 2, 2)
- py.plot(time, fitLineT, 'b-')
- py.plot(time, fitLineT + fitSigT, 'b--')
- py.plot(time, fitLineT - fitSigT, 'b--')
- py.errorbar(time, t, yerr=terr, fmt='k.')
- rng = py.axis()
- py.axis(dateTicRng + [rng[2], rng[3]])
- py.xlabel('Date (yrs)')
- py.ylabel('T (pix)')
+ paxes = plt.subplot(3, 2, 2)
+ plt.plot(time, fitLineT, 'b-')
+ plt.plot(time, fitLineT + fitSigT, 'b--')
+ plt.plot(time, fitLineT - fitSigT, 'b--')
+ plt.errorbar(time, t, yerr=terr, fmt='k.')
+ rng = plt.axis()
+ plt.axis(dateTicRng + [rng[2], rng[3]])
+ plt.xlabel('Date (yrs)')
+ plt.ylabel('T (pix)')
paxes.xaxis.set_major_formatter(fmtX)
paxes.get_xaxis().set_major_locator(dateTicLoc)
paxes.yaxis.set_major_formatter(fmtY)
- paxes = py.subplot(3, 2, 3)
- py.plot(time, np.zeros(len(time)), 'b-')
- py.plot(time, fitSigR, 'b--')
- py.plot(time, -fitSigR, 'b--')
- py.errorbar(time, r - fitLineR, yerr=rerr, fmt='k.')
- py.axis(dateTicRng + resTicRng)
- py.xlabel('Date (yrs)')
- py.ylabel('R Residuals (pix)')
+ paxes = plt.subplot(3, 2, 3)
+ plt.plot(time, np.zeros(len(time)), 'b-')
+ plt.plot(time, fitSigR, 'b--')
+ plt.plot(time, -fitSigR, 'b--')
+ plt.errorbar(time, r - fitLineR, yerr=rerr, fmt='k.')
+ plt.axis(dateTicRng + resTicRng)
+ plt.xlabel('Date (yrs)')
+ plt.ylabel('R Residuals (pix)')
paxes.get_xaxis().set_major_locator(dateTicLoc)
- paxes = py.subplot(3, 2, 4)
- py.plot(time, np.zeros(len(time)), 'b-')
- py.plot(time, fitSigT, 'b--')
- py.plot(time, -fitSigT, 'b--')
- py.errorbar(time, t - fitLineT, yerr=terr, fmt='k.')
- py.axis(dateTicRng + resTicRng)
- py.xlabel('Date (yrs)')
- py.ylabel('T Residuals (pix)')
+ paxes = plt.subplot(3, 2, 4)
+ plt.plot(time, np.zeros(len(time)), 'b-')
+ plt.plot(time, fitSigT, 'b--')
+ plt.plot(time, -fitSigT, 'b--')
+ plt.errorbar(time, t - fitLineT, yerr=terr, fmt='k.')
+ plt.axis(dateTicRng + resTicRng)
+ plt.xlabel('Date (yrs)')
+ plt.ylabel('T Residuals (pix)')
paxes.get_xaxis().set_major_locator(dateTicLoc)
bins = np.arange(-7, 7, 1)
- py.subplot(3, 2, 5)
- (n, b, p) = py.hist(sigR, bins)
- py.setp(p, 'facecolor', 'k')
- py.axis([-5, 5, 0, 20])
- py.xlabel('T Residuals (sigma)')
- py.ylabel('Number of Epochs')
-
- py.subplot(3, 2, 6)
- (n, b, p) = py.hist(sigT, bins)
- py.axis([-5, 5, 0, 20])
- py.setp(p, 'facecolor', 'k')
- py.xlabel('Y Residuals (sigma)')
- py.ylabel('Number of Epochs')
-
- py.subplots_adjust(wspace=0.4, hspace=0.4, right=0.95, top=0.95)
- py.savefig(rootDir+'plots/plotStarRadial_' + starName + '.png')
- py.show()
+ plt.subplot(3, 2, 5)
+ (n, b, p) = plt.hist(sigR, bins)
+ plt.setp(p, 'facecolor', 'k')
+ plt.axis([-5, 5, 0, 20])
+ plt.xlabel('T Residuals (sigma)')
+ plt.ylabel('Number of Epochs')
+
+ plt.subplot(3, 2, 6)
+ (n, b, p) = plt.hist(sigT, bins)
+ plt.axis([-5, 5, 0, 20])
+ plt.setp(p, 'facecolor', 'k')
+ plt.xlabel('Y Residuals (sigma)')
+ plt.ylabel('Number of Epochs')
+
+ plt.subplots_adjust(wspace=0.4, hspace=0.4, right=0.95, top=0.95)
+ plt.savefig(rootDir+'plots/plotStarRadial_' + starName + '.png', dpi=300)
+ plt.show()
title = rootDir.split('/')[-2]
- py.suptitle(title, x=0.5, y=0.97)
+ plt.suptitle(title, x=0.5, y=0.97)
if Nstars == 1:
- py.subplots_adjust(wspace=0.4, hspace=0.4, left = 0.15, bottom = 0.1, right=0.9, top=0.9)
- py.savefig(rootDir+'plots/plotStar_' + starName + '.png')
+ plt.subplots_adjust(wspace=0.4, hspace=0.4, left = 0.15, bottom = 0.1, right=0.9, top=0.9)
+ plt.savefig(rootDir+'plots/plotStar_' + starName + '.png', dpi=300)
else:
- py.subplots_adjust(wspace=0.6, hspace=0.6, left = 0.08, bottom = 0.05, right=0.95, top=0.90)
- py.savefig(rootDir+'plots/plotStar_all.png')
- py.show()
+ plt.subplots_adjust(wspace=0.6, hspace=0.6, left = 0.08, bottom = 0.05, right=0.95, top=0.90)
+ plt.savefig(rootDir+'plots/plotStar_all.png', dpi=300)
+ plt.show()
- py.show()
+ plt.show()
print('Fubar')
-
+
##################################################
# New codes for velocity support in FlyStar and using
-# the new StarTable and StarList format.
+# the new StarTable and StarList format.
##################################################
def plot_pm(tab):
@@ -1005,7 +1011,7 @@ def plot_pm(tab):
q = plt.quiver(tab['x0'].data, tab['y0'].data,
tab['vx'].data*1e3, tab['vy'].data*1e3,
scale=1e2, angles='xy')
- plt.quiverkey(q, 0.5, 0.8, 10, '10 mas/yr', color='red',
+ plt.quiverkey(q, 0.5, 0.8, 10, '10 mas/yr', color='red',
coordinates='figure', labelpos='E')
plt.xlabel(r'$\Delta \alpha$ (")')
plt.ylabel(r'$\Delta \delta$ (")')
@@ -1022,7 +1028,7 @@ def plot_gaia(gaia):
d_ra_tan = (ra_tan - ra_tan_mean) * cos_dec * 3600.0
d_de_tan = (de_tan - de_tan_mean) * 3600.0
-
+
pmra = gaia['pmra']
pmdec = gaia['pmdec']
plt.figure(figsize=(6,6))
@@ -1031,7 +1037,7 @@ def plot_gaia(gaia):
q = plt.quiver(d_ra_tan.data, d_de_tan.data,
pmra.data, pmdec.data,
scale=1e2, angles='xy')
- plt.quiverkey(q, 0.5, 0.8, 10, '10 mas/yr', color='red',
+ plt.quiverkey(q, 0.5, 0.8, 10, '10 mas/yr', color='red',
coordinates='figure', labelpos='E')
plt.xlabel(r'$\Delta \alpha \cos \delta$ ('')')
plt.ylabel(r'$\Delta \delta$ ('')')
@@ -1039,42 +1045,45 @@ def plot_gaia(gaia):
fmt = r'[$\alpha$, $\delta$] = [{0:8.3f}$^\circ$, {1:8.3f}$^\circ$]'
plt.title(fmt.format(ra_tan_mean, de_tan_mean))
plt.gca().invert_xaxis()
-
-
- return
-def plot_pm_error(tab):
- plt.figure(figsize=(6,6))
- plt.clf()
- plt.semilogy(tab['m0'], tab['vx_err']*1e3, 'r.', label=r'$\sigma_{\mu_{\alpha *}}$', alpha=0.4)
- plt.semilogy(tab['m0'], tab['vy_err']*1e3, 'b.', label=r'$\sigma_{\mu_{\delta}}$', alpha=0.4)
- plt.legend()
- plt.xlabel('Mag')
- plt.ylabel('PM Error (mas/yr)')
return
-def plot_mag_error(tab):
- plt.figure(figsize=(6,6))
- plt.clf()
- plt.semilogy(tab['m0'], tab['m0_err'], 'r.', alpha=0.4)
- plt.legend()
- plt.xlabel('Mag')
- plt.ylabel('Mag Error (mag)')
+def plot_pm_error(tab, save_path=None):
+ fig, ax = plt.subplots(1, 1, figsize=(6, 6))
+ ax.semilogy(tab['m0'], tab['vx_err']*1e3, color='C0', marker='.', ls='none', ms=3, label=r'$\sigma_{\mu_{\alpha *}}$', alpha=0.3)
+ ax.semilogy(tab['m0'], tab['vy_err']*1e3, color='C3', marker='.', ls='none', ms=3, label=r'$\sigma_{\mu_{\delta}}$', alpha=0.3)
+ ax.legend()
+ ax.set_xlabel('Mag')
+ ax.set_ylabel('PM Error (mas/yr)')
+ plt.tight_layout()
+ if save_path is not None:
+ plt.savefig(save_path, dpi=300)
+ plt.show()
+ return
+def plot_mag_error(tab, save_path=None):
+ fig, ax = plt.subplots(1, 1, figsize=(6, 6))
+ ax.semilogy(tab['m0'], tab['m0_err'], color='C0', marker='.', ls='none', alpha=0.4)
+ ax.legend()
+ ax.set_xlabel('Mag')
+ ax.set_ylabel('Mag Error (mag)')
+ plt.tight_layout()
+ if save_path is not None:
+ plt.savefig(save_path, dpi=300)
+ plt.show()
return
-def plot_mean_residuals_by_epoch(tab, motion_model_dict={}):
+def plot_mean_residuals_by_epoch(tab):
"""
Plot mean position and magnitude residuals vs. epoch.
Note we are plotting the mean( |dx} ) to see
the size of the mean residual.
"""
# Predicted model positions at each epoch
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod, yt_mod, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
-
+ xt_mod, yt_mod, xt_mod_err, yt_mod_err = tab.predict_positions(tab['t'][i_all_detected])
+
# Residuals
dx = tab['x'] - xt_mod
dy = tab['y'] - yt_mod
@@ -1119,33 +1128,43 @@ def plot_mean_residuals_by_epoch(tab, motion_model_dict={}):
plt.axhline(0, ls='--', color='black')
plt.xlabel('Time (yr)')
plt.ylabel('Mag Residuals')
-
+
return
-def plot_quiver_residuals_all_epochs(tab, motion_model_dict={}, unit='arcsec', scale=None, plotlim=None):
+def plot_quiver_residuals_all_epochs(tab, unit='arcsec', scale=None, plotlim=None, save_path=None, show_plot=True):
# Keep track of the residuals for averaging.
dr_good = np.zeros(len(tab), dtype=float)
n_good = np.zeros(len(tab), dtype=int)
dr_ref = np.zeros(len(tab), dtype=float)
n_ref = np.zeros(len(tab), dtype=int)
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
complete_times = np.array([np.unique(col[~np.isnan(col)])[0] for col in tab['t'].T])
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(complete_times, motion_model_dict, allow_alt_models=True)
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(complete_times, motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(complete_times)
for ee in range(tab['x'].shape[1]):
xt_mod = xt_mod_all[:,ee]
yt_mod = yt_mod_all[:,ee]
-
+
good_idx = np.where(np.isfinite(tab['x'][:, ee]) == True)[0]
ref_idx = np.where(tab[good_idx]['used_in_trans'][:, ee] == True)[0]
- dx, dy = plot_quiver_residuals(tab['x'][:, ee], tab['y'][:, ee],
- xt_mod, yt_mod,
- good_idx, ref_idx,
- 'Epoch {0:d}'.format(ee),
- unit=unit, scale=scale, plotlim=plotlim)
+ dx, dy = plot_quiver_residuals(
+ tab['x'][:, ee],
+ tab['y'][:, ee],
+ xt_mod,
+ yt_mod,
+ good_idx,
+ ref_idx,
+ 'Epoch {0:d}'.format(ee),
+ unit=unit,
+ scale=scale,
+ plotlim=plotlim,
+ show_plot=show_plot,
+ save_path=f'{save_path}/Quiver_Residual_{ee}.png' if save_path else None
+ )
# Building up average dr for a set of stars.
dr = np.hypot(dx, dy)
@@ -1159,13 +1178,13 @@ def plot_quiver_residuals_all_epochs(tab, motion_model_dict={}, unit='arcsec', s
dr_good_avg = np.zeros(len(tab), dtype=float)
idx = np.where(n_good > 0)[0]
dr_good_avg[idx] = dr_good[idx] / n_good[idx]
-
+
dr_ref_avg = np.zeros(len(tab), dtype=float)
idx = np.where(n_ref > 0)[0]
dr_ref_avg[idx] = dr_ref[idx] / n_ref[idx]
- hdr = '{name:>16s} {mag:>5s} {dr:>6s} {x:>6s} {y:>6s} {r:>6s}'
- fmt = '{name:16s} {mag:5.2f} {dr:6.4f} {x:6.3f} {y:6.3f} {r:6.3f}'
+ # hdr = '{name:>16s} {mag:>5s} {dr:>6s} {x:>6s} {y:>6s} {r:>6s}'
+ # fmt = '{name:16s} {mag:5.2f} {dr:6.4f} {x:6.3f} {y:6.3f} {r:6.3f}'
# print()
# print('##########')
@@ -1185,75 +1204,76 @@ def plot_quiver_residuals_all_epochs(tab, motion_model_dict={}, unit='arcsec', s
# if (dr_ref_avg[rr] > 0):
# print(fmt.format(name=tab['name'][rr], mag=tab['m0'][rr], dr=dr_ref_avg[rr],
# x=tab['x0'][rr], y=tab['y0'][rr], r=np.hypot(tab['x0'][rr], tab['y0'][rr])))
-
+
return
-def plot_quiver_residuals_with_orig_all_epochs(tab, trans_list, motion_model_dict={}, unit='arcsec', scale=None, plotlim=None, scale_orig=None, cte_fit=None, mlim=15):
+def plot_quiver_residuals_with_orig_all_epochs(tab, trans_list, unit='arcsec', scale=None, plotlim=None, scale_orig=None, cte_fit=None, mlim=15, show_plot=True, save_path=None):
# Keep track of the residuals for averaging.
dr_good = np.zeros(len(tab), dtype=float)
n_good = np.zeros(len(tab), dtype=int)
dr_ref = np.zeros(len(tab), dtype=float)
n_ref = np.zeros(len(tab), dtype=int)
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+
for ee in range(tab['x'].shape[1]):
dt = tab['t'][:, ee] - tab['t0']
xt_mod = xt_mod_all[ee]
yt_mod = yt_mod_all[ee]
-
+
good_idx = np.where(np.isfinite(tab['x'][:, ee]) == True)[0]
ref_idx = np.where(tab[good_idx]['used_in_trans'][:, ee] == True)[0]
da = calc_da(trans_list[ee])
- dx, dy = plot_quiver_residuals(tab['x'][:, ee], tab['y'][:, ee],
- xt_mod, yt_mod,
+ dx, dy = plot_quiver_residuals(tab['x'][:, ee], tab['y'][:, ee],
+ xt_mod, yt_mod,
good_idx, ref_idx,
- 'Epoch {0:d}'.format(ee),
- unit=unit, scale=scale, plotlim=plotlim)
+ 'Epoch {0:d}'.format(ee),
+ unit=unit, scale=scale, plotlim=plotlim, show_plot=show_plot, save_path=f'{save_path}/Quiver_Residual_{ee}.png' if save_path else None)
- plot_quiver_residuals_orig(tab['x'][:, ee], tab['y'][:, ee],
- xt_mod, yt_mod,
+ plot_quiver_residuals_orig(tab['x'][:, ee], tab['y'][:, ee],
+ xt_mod, yt_mod,
good_idx, ref_idx,
tab['x_orig'][:, ee], tab['y_orig'][:, ee], da,
- 'Epoch {0:d}'.format(ee),
- scale=scale_orig, plotlim=plotlim)
+ 'Epoch {0:d}'.format(ee),
+ scale=scale_orig, plotlim=plotlim, show_plot=show_plot, save_path=f'{save_path}/Quiver_Residual_Orig_{ee}.png' if save_path else None)
- plot_mag_scatter(tab['m'][:, ee],
+ plot_mag_scatter(tab['m'][:, ee],
tab['m0'], tab['m0_err'],
- tab['x'][:, ee], tab['y'][:, ee],
+ tab['x'][:, ee], tab['y'][:, ee],
tab['xe'][:, ee], tab['ye'][:, ee],
- xt_mod, yt_mod,
+ xt_mod, yt_mod,
good_idx, ref_idx,
'Epoch {0:d}'.format(ee), da=da,
xorig=tab['x_orig'][:, ee], yorig=tab['y_orig'][:, ee],
- cte_fit=cte_fit, mlim=mlim)
+ cte_fit=cte_fit, mlim=mlim, show_plot=show_plot, save_path=f'{save_path}/Mag_Scatter_{ee}.png' if save_path else None)
- plot_y_scatter(tab['m'][:, ee],
+ plot_y_scatter(tab['m'][:, ee],
tab['m0'], tab['m0_err'],
- tab['x'][:, ee], tab['y'][:, ee],
+ tab['x'][:, ee], tab['y'][:, ee],
tab['xe'][:, ee], tab['ye'][:, ee],
- xt_mod, yt_mod,
+ xt_mod, yt_mod,
good_idx, ref_idx,
'Epoch {0:d}'.format(ee), da=da,
xorig=tab['x_orig'][:, ee], yorig=tab['y_orig'][:, ee],
- cte_fit=cte_fit, mlim=mlim)
+ cte_fit=cte_fit, mlim=mlim, show_plot=show_plot, save_path=f'{save_path}/Y_Scatter_{ee}.png' if save_path else None)
# plot_quiver_residuals_orig_angle_xy(tab['x'][:, ee], tab['y'][:, ee],
-# xt_mod, yt_mod,
+# xt_mod, yt_mod,
# good_idx, ref_idx,
# tab['x_orig'][:, ee], tab['y_orig'][:, ee], da,
# 'Epoch {0:d}'.format(ee))
#
# plot_quiver_residuals_vs_pos_err(dx, dy, good_idx, ref_idx,
-# 1e3 * tab['xe'][:, ee], 1e3 * tab['ye'][:, ee],
+# 1e3 * tab['xe'][:, ee], 1e3 * tab['ye'][:, ee],
# 'positional err (mas)', 'Epoch {0:d}'.format(ee), da=da)
-
+
# Building up average dr for a set of stars.
dr = np.hypot(dx, dy)
@@ -1266,13 +1286,13 @@ def plot_quiver_residuals_with_orig_all_epochs(tab, trans_list, motion_model_dic
dr_good_avg = np.zeros(len(tab), dtype=float)
idx = np.where(n_good > 0)[0]
dr_good_avg[idx] = dr_good[idx] / n_good[idx]
-
+
dr_ref_avg = np.zeros(len(tab), dtype=float)
idx = np.where(n_ref > 0)[0]
dr_ref_avg[idx] = dr_ref[idx] / n_ref[idx]
- hdr = '{name:>16s} {mag:>5s} {dr:>6s} {x:>6s} {y:>6s} {r:>6s}'
- fmt = '{name:16s} {mag:5.2f} {dr:6.4f} {x:6.3f} {y:6.3f} {r:6.3f}'
+ # hdr = '{name:>16s} {mag:>5s} {dr:>6s} {x:>6s} {y:>6s} {r:>6s}'
+ # fmt = '{name:16s} {mag:5.2f} {dr:6.4f} {x:6.3f} {y:6.3f} {r:6.3f}'
# print()
# print('##########')
@@ -1292,27 +1312,28 @@ def plot_quiver_residuals_with_orig_all_epochs(tab, trans_list, motion_model_dic
# if (dr_ref_avg[rr] > 0):
# print(fmt.format(name=tab['name'][rr], mag=tab['m0'][rr], dr=dr_ref_avg[rr],
# x=tab['x0'][rr], y=tab['y0'][rr], r=np.hypot(tab['x0'][rr], tab['y0'][rr])))
-
+
return
-def plot_mag_scatter_multi_trans_all_epochs(tab_list, trans_list_list, motion_model_dict={}, unit='arcsec', scale=None, plotlim=None, scale_orig=None):
+def plot_mag_scatter_multi_trans_all_epochs(tab_list, trans_list_list, unit='arcsec', scale=None, plotlim=None, scale_orig=None):
m_t_list = []
x_t_list = []
y_t_list = []
- xe_t_list = []
+ xe_t_list = []
ye_t_list = []
x_ref_list = []
- y_ref_list = []
- good_idx_list = []
- ref_idx_list =[]
+ y_ref_list = []
+ good_idx_list = []
+ ref_idx_list =[]
da_list = []
ntrans = len(tab_list)
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+
for mm in range(ntrans):
tab = tab_list[mm]
trans_list = trans_list_list[mm]
@@ -1320,7 +1341,7 @@ def plot_mag_scatter_multi_trans_all_epochs(tab_list, trans_list_list, motion_mo
dt = tab['t'][:, ee] - tab['t0']
xt_mod = xt_mod_all[ee]
yt_mod = yt_mod_all[ee]
-
+
good_idx = np.where(np.isfinite(tab['x'][:, ee]) == True)[0]
ref_idx = np.where(tab[good_idx]['used_in_trans'][:, ee] == True)[0]
@@ -1329,19 +1350,19 @@ def plot_mag_scatter_multi_trans_all_epochs(tab_list, trans_list_list, motion_mo
m_t_list.append(tab['m'][:, ee])
x_t_list.append(tab['x'][:, ee])
y_t_list.append(tab['y'][:, ee])
- xe_t_list.append(tab['xe'][:, ee])
+ xe_t_list.append(tab['xe'][:, ee])
ye_t_list.append(tab['ye'][:, ee])
x_ref_list.append(xt_mod)
y_ref_list.append(yt_mod)
- good_idx_list.append(good_idx)
- ref_idx_list.append(ref_idx)
+ good_idx_list.append(good_idx)
+ ref_idx_list.append(ref_idx)
da_list.append(da)
for ee in range(tab_list[0]['x'].shape[1]):
- plot_mag_scatter_multi_trans(m_t_list[ee::ntrans], x_t_list[ee::ntrans], y_t_list[ee::ntrans],
- xe_t_list[ee::ntrans], ye_t_list[ee::ntrans], x_ref_list[ee::ntrans], y_ref_list[ee::ntrans],
+ plot_mag_scatter_multi_trans(m_t_list[ee::ntrans], x_t_list[ee::ntrans], y_t_list[ee::ntrans],
+ xe_t_list[ee::ntrans], ye_t_list[ee::ntrans], x_ref_list[ee::ntrans], y_ref_list[ee::ntrans],
good_idx_list[ee::ntrans], ref_idx_list[ee::ntrans], 'Epoch {0:d}'.format(ee), da_list[ee::ntrans])
-
+
return
@@ -1363,7 +1384,7 @@ def calc_da(trans_list):
c01 = trans_list.px.parameters[c01_idx]
c10 = trans_list.px.parameters[c10_idx]
da = np.degrees(np.arctan2(-c01, c10))
-
+
return da
@@ -1371,7 +1392,7 @@ def plot_mag_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx,
# Residual
dx = (x_t - x_ref)
dy = (y_t - y_ref)
-
+
# Magnitude
mgood = m_t[good_idx]
mref = m_t[good_idx][ref_idx]
@@ -1468,7 +1489,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
# Residual
dx = (x_t - x_ref)
dy = (y_t - y_ref)
-
+
# Magnitude
mgood = m_t[good_idx]
mref = m_t[good_idx][ref_idx]
@@ -1579,23 +1600,23 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
if cte_fit=='power':
idx = np.where(mgood > mlim)[0]
gpopt, gpcov = curve_fit(T_cte_y, mgood[idx], ygood[idx], maxfev=100000)
-
+
marr = np.linspace(13, 24, 1000)
-
+
# Corrected values
ygood_new = ygood - T_cte_y(mgood, *gpopt)
yref_new = yref - T_cte_y(mref, *gpopt)
-
+
agood = angle_from_xy(xgood, ygood) % 360
rgood = np.hypot(xgood, ygood)
aref = angle_from_xy(xref, yref) % 360
rref = np.hypot(xref, yref)
-
+
agood_new = angle_from_xy(xgood, ygood_new) % 360
rgood_new = np.hypot(xgood, ygood_new)
aref_new = angle_from_xy(xref, yref_new) % 360
rref_new = np.hypot(xref, yref_new)
-
+
fig, ax = plt.subplots(4, 2, figsize=(12,12), sharex=True, sharey='row', num=105)
plt.subplots_adjust(hspace=0.01, wspace=0.01)
ax[0,0].scatter(mgood, ygood, color='black', alpha=0.3, s=2)
@@ -1605,24 +1626,24 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[0,0].axhline(y=0)
ax[0,0].plot(marr, T_cte_y(marr, *gpopt), 'k-')
ax[0,0].set_title('No correction')
-
+
ax[0,1].scatter(mgood, ygood_new, color='black', alpha=0.3, s=2)
ax[0,1].scatter(mref, yref_new, color='red', alpha=0.3, s=2)
ax[0,1].set_ylim(-0.01, 0.01)
ax[0,1].axhline(y=0)
ax[0,1].set_title('Corrected')
-
+
ax[1,0].scatter(mgood, ygood/yegood, color='black', alpha=0.3, s=2)
ax[1,0].scatter(mref, yref/yeref, color='red', alpha=0.3, s=2)
ax[1,0].set_ylabel('Res/Pos Err, y')
ax[1,0].set_ylim(-10, 10)
ax[1,0].axhline(y=0)
-
+
ax[1,1].scatter(mgood, ygood_new/yegood, color='black', alpha=0.3, s=2)
ax[1,1].scatter(mref, yref_new/yeref, color='red', alpha=0.3, s=2)
ax[1,1].set_ylim(-10, 10)
ax[1,1].axhline(y=0)
-
+
ax[2,0].scatter(mgood, rgood, color='black', alpha=0.3, s=2)
ax[2,0].scatter(mref, rref, color='red', alpha=0.3, s=2)
ax[2,0].set_ylabel('Modulus (arcsec)')
@@ -1631,7 +1652,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[2,0].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood.data, rref.data])))
else:
ax[2,0].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood, rref])))
-
+
ax[2,1].scatter(mgood, rgood_new, color='black', alpha=0.3, s=2)
ax[2,1].scatter(mref, rref_new, color='red', alpha=0.3, s=2)
ax[2,1].set_yscale('log')
@@ -1639,12 +1660,12 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[2,1].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood_new.data, rref_new.data])))
else:
ax[2,1].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood_new, rref_new])))
-
+
ax[3,0].scatter(mgood, agood, color='black', alpha=0.3, s=2)
ax[3,0].scatter(mref, aref, color='red', alpha=0.3, s=2)
ax[3,0].set_ylabel('Angle (deg)')
ax[3,0].set_xlabel('mag')
-
+
ax[3,1].scatter(mgood, agood_new, color='black', alpha=0.3, s=2)
ax[3,1].scatter(mref, aref_new, color='red', alpha=0.3, s=2)
ax[3,1].set_xlabel('mag')
@@ -1658,7 +1679,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
gpopt1, gpcov1 = curve_fit(T_line, mgood[idx1], ygood[idx1], maxfev=100000)
gpopt2, gpcov2 = curve_fit(T_cte_y, mgood[idx2], ygood[idx2], maxfev=100000)
-
+
marr1 = np.linspace(13, 18.5, 1000)
marr2 = np.linspace(18.5, 24, 1000)
@@ -1686,7 +1707,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
xeref2 = xeref[idx2r]
yeref1 = yeref[idx1r]
yeref2 = yeref[idx2r]
-
+
# Corrected values
ygood_new1 = ygood1 - T_line(mgood1, *gpopt1)
yref_new1 = yref1 - T_line(mref1, *gpopt1)
@@ -1712,7 +1733,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
rgood_new2 = np.hypot(xgood2, ygood_new2)
aref_new2 = angle_from_xy(xref2, yref_new2) % 360
rref_new2 = np.hypot(xref2, yref_new2)
-
+
fig, ax = plt.subplots(4, 2, figsize=(12,12), sharex=True, sharey='row', num=105)
plt.subplots_adjust(hspace=0.01, wspace=0.01)
ax[0,0].scatter(mgood, ygood, color='black', alpha=0.3, s=2)
@@ -1723,7 +1744,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[0,0].plot(marr1, T_line(marr1, *gpopt1), 'b-')
ax[0,0].plot(marr2, T_cte_y(marr2, *gpopt2), 'b-')
ax[0,0].set_title('No correction')
-
+
ax[0,1].scatter(mgood1, ygood_new1, color='black', alpha=0.3, s=2)
ax[0,1].scatter(mref1, yref_new1, color='red', alpha=0.3, s=2)
ax[0,1].scatter(mgood2, ygood_new2, color='black', alpha=0.3, s=2)
@@ -1731,20 +1752,20 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[0,1].set_ylim(-0.01, 0.01)
ax[0,1].axhline(y=0)
ax[0,1].set_title('Corrected')
-
+
ax[1,0].scatter(mgood, ygood/yegood, color='black', alpha=0.3, s=2)
ax[1,0].scatter(mref, yref/yeref, color='red', alpha=0.3, s=2)
ax[1,0].set_ylabel('Res/Pos Err, y')
ax[1,0].set_ylim(-10, 10)
ax[1,0].axhline(y=0)
-
+
ax[1,1].scatter(mgood1, ygood_new1/yegood1, color='black', alpha=0.3, s=2)
ax[1,1].scatter(mref1, yref_new1/yeref1, color='red', alpha=0.3, s=2)
ax[1,1].scatter(mgood2, ygood_new2/yegood2, color='black', alpha=0.3, s=2)
ax[1,1].scatter(mref2, yref_new2/yeref2, color='red', alpha=0.3, s=2)
ax[1,1].set_ylim(-10, 10)
ax[1,1].axhline(y=0)
-
+
ax[2,0].scatter(mgood, rgood, color='black', alpha=0.3, s=2)
ax[2,0].scatter(mref, rref, color='red', alpha=0.3, s=2)
ax[2,0].set_ylabel('Modulus (arcsec)')
@@ -1753,7 +1774,7 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[2,0].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood.data, rref.data])))
else:
ax[2,0].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood, rref])))
-
+
ax[2,1].scatter(mgood1, rgood_new1, color='black', alpha=0.3, s=2)
ax[2,1].scatter(mref1, rref_new1, color='red', alpha=0.3, s=2)
ax[2,1].scatter(mgood2, rgood_new2, color='black', alpha=0.3, s=2)
@@ -1763,18 +1784,18 @@ def plot_y_scatter(m_t, m0, m0e, x_t, y_t, xe_t, ye_t, x_ref, y_ref, good_idx, r
ax[2,1].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood_new.data2, rref_new.data2])))
else:
ax[2,1].set_ylim(1e-6, 1.1 * np.max(np.concatenate([rgood_new2, rref_new2])))
-
+
ax[3,0].scatter(mgood, agood, color='black', alpha=0.3, s=2)
ax[3,0].scatter(mref, aref, color='red', alpha=0.3, s=2)
ax[3,0].set_ylabel('Angle (deg)')
ax[3,0].set_xlabel('mag')
-
+
ax[3,1].scatter(mgood1, agood_new1, color='black', alpha=0.3, s=2)
ax[3,1].scatter(mref1, aref_new1, color='red', alpha=0.3, s=2)
ax[3,1].scatter(mgood2, agood_new2, color='black', alpha=0.3, s=2)
ax[3,1].scatter(mref2, aref_new2, color='red', alpha=0.3, s=2)
ax[3,1].set_xlabel('mag')
-
+
def T_cte_y(m, A, m0, alpha, m1):
base = m/m0
@@ -1784,16 +1805,16 @@ def T_line(m, a, b):
return a + m*b
-def plot_quiver_residuals(x_t, y_t, x_ref, y_ref, good_idx, ref_idx, title,
- unit='pixel', scale=None, plotlim=None):
+def plot_quiver_residuals(x_t, y_t, x_ref, y_ref, good_idx, ref_idx, title,
+ unit='pixel', scale=None, plotlim=None, save_path=None, show_plot=True):
"""
unit : str
'pixel' or 'arcsec'
The pixel units of the input values. Note, if arcsec, then the values will be
- converted to milli-arcsec for plotting when appropriate.
+ converted to milli-arcsec for plotting when appropriate.
scale : float
- The quiver scale. If none, then default units will be used appropriate to the unit.
+ The quiver scale. If none, then default units will be used appropriate to the unit.
plotlim : float (positive)
Sets the size of the plotted figure. If None, then default is used.
@@ -1822,52 +1843,57 @@ def plot_quiver_residuals(x_t, y_t, x_ref, y_ref, good_idx, ref_idx, title,
unit2 = 'mas'
- plt.figure(101, figsize=(6,6))
- plt.clf()
- q = plt.quiver(x_ref[good_idx], y_ref[good_idx], dx[good_idx], dy[good_idx],
+ fig, ax = plt.subplots(1, 1, figsize=(6, 6))
+ q = ax.quiver(x_ref[good_idx], y_ref[good_idx], dx[good_idx], dy[good_idx],
color='black', scale=quiv_scale, angles='xy', alpha=0.5)
- plt.quiver(x_ref[good_idx][ref_idx], y_ref[good_idx][ref_idx], dx[good_idx][ref_idx], dy[good_idx][ref_idx],
+ ax.quiver(x_ref[good_idx][ref_idx], y_ref[good_idx][ref_idx], dx[good_idx][ref_idx], dy[good_idx][ref_idx],
color='red', scale=quiv_scale, angles='xy')
- plt.quiverkey(q, 0.5, 0.85, quiv_label_val, quiv_label,
+ ax.quiverkey(q, 0.5, 0.85, quiv_label_val, quiv_label,
coordinates='figure', labelpos='E', color='green')
- plt.xlabel('X (ref ' + unit + ')')
- plt.ylabel('Y (ref ' + unit + ')')
- plt.title(title)
- plt.axis('equal')
+ ax.set_xlabel('X (ref ' + unit + ')')
+ ax.set_ylabel('Y (ref ' + unit + ')')
+ ax.set_title(title)
+ ax.axis('equal')
if plotlim is not None:
- plt.xlim(-1 * plotlim, plotlim)
- plt.ylim(-1 * plotlim, plotlim)
- plt.show()
- plt.pause(1)
+ ax.set_xlim(-1 * plotlim, plotlim)
+ ax.set_ylim(-1 * plotlim, plotlim)
+ plt.tight_layout()
+ if save_path:
+ plt.savefig(save_path, dpi=300)
+ if show_plot:
+ plt.show()
+ else:
+ plt.close()
- str_fmt = 'Residuals (mean, std): dx = {0:7.3f} +/- {1:7.3f} {5:s} dy = {2:7.3f} +/- {3:7.3f} {5:s} for {4:s} stars'
+ str_fmt = '{0:s}: Residuals (mean, std): dx = {1:7.3f} ± {2:7.3f} {6:s} dy = {3:7.3f} ± {4:7.3f} {6:s} for {5:s} stars'
if len(ref_idx) > 1:
- print(str_fmt.format(dx[good_idx][ref_idx].mean(), dx[good_idx][ref_idx].std(),
+ print(str_fmt.format(title, dx[good_idx][ref_idx].mean(), dx[good_idx][ref_idx].std(),
dy[good_idx][ref_idx].mean(), dy[good_idx][ref_idx].std(), 'REF', unit2))
else:
- print(str_fmt.format(dx[good_idx][ref_idx].mean(), 0.0,
+ print(str_fmt.format(title, dx[good_idx][ref_idx].mean(), 0.0,
dy[good_idx][ref_idx].mean(), 0.0, 'REF', unit2))
-
- print(str_fmt.format(dx[good_idx].mean(), dx[good_idx].std(),
+
+ print(str_fmt.format(title, dx[good_idx].mean(), dx[good_idx].std(),
dy[good_idx].mean(), dy[good_idx].std(), 'GOOD', unit2))
return (dx, dy)
-def plot_quiver_residuals_magcolor_all_epochs(tab, motion_model_dict={}, unit='arcsec', scale=None, plotlim=None, lower_mag=18, upper_mag=13):
+def plot_quiver_residuals_magcolor_all_epochs(tab, unit='arcsec', scale=None, plotlim=None, lower_mag=18, upper_mag=13):
# Keep track of the residuals for averaging.
dr_good = np.zeros(len(tab), dtype=float)
n_good = np.zeros(len(tab), dtype=int)
dr_ref = np.zeros(len(tab), dtype=float)
n_ref = np.zeros(len(tab), dtype=int)
- idx = np.where((tab['m0'] < lower_mag) &
+ idx = np.where((tab['m0'] < lower_mag) &
(tab['m0'] > upper_mag))[0]
tab = tab[idx]
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+
for ee in range(tab['x'].shape[1]):
dt = tab['t'][:, ee] - tab['t0']
xt_mod = xt_mod_all[ee]
@@ -1877,10 +1903,10 @@ def plot_quiver_residuals_magcolor_all_epochs(tab, motion_model_dict={}, unit='a
good_idx = np.where(np.isfinite(tab['x'][:, ee]) == True)[0]
ref_idx = np.where(tab[good_idx]['used_in_trans'][:, ee] == True)[0]
- dx, dy = plot_quiver_residuals_magcolor(tab['x'][:, ee], tab['y'][:, ee],
+ dx, dy = plot_quiver_residuals_magcolor(tab['x'][:, ee], tab['y'][:, ee],
xt_mod, yt_mod, mag,
good_idx, ref_idx,
- 'Epoch {0:d}'.format(ee),
+ 'Epoch {0:d}'.format(ee),
unit=unit, scale=scale, plotlim=plotlim)
# Building up average dr for a set of stars.
@@ -1895,7 +1921,7 @@ def plot_quiver_residuals_magcolor_all_epochs(tab, motion_model_dict={}, unit='a
dr_good_avg = np.zeros(len(tab), dtype=float)
idx = np.where(n_good > 0)[0]
dr_good_avg[idx] = dr_good[idx] / n_good[idx]
-
+
dr_ref_avg = np.zeros(len(tab), dtype=float)
idx = np.where(n_ref > 0)[0]
dr_ref_avg[idx] = dr_ref[idx] / n_ref[idx]
@@ -1905,16 +1931,16 @@ def plot_quiver_residuals_magcolor_all_epochs(tab, motion_model_dict={}, unit='a
-def plot_quiver_residuals_magcolor(x_t, y_t, x_ref, y_ref, mag, good_idx, ref_idx, title,
+def plot_quiver_residuals_magcolor(x_t, y_t, x_ref, y_ref, mag, good_idx, ref_idx, title,
unit='pixel', scale=None, plotlim=None):
"""
unit : str
'pixel' or 'arcsec'
The pixel units of the input values. Note, if arcsec, then the values will be
- converted to milli-arcsec for plotting when appropriate.
+ converted to milli-arcsec for plotting when appropriate.
scale : float
- The quiver scale. If none, then default units will be used appropriate to the unit.
+ The quiver scale. If none, then default units will be used appropriate to the unit.
plotlim : float (positive)
Sets the size of the plotted figure. If None, then default is used.
@@ -1942,51 +1968,48 @@ def plot_quiver_residuals_magcolor(x_t, y_t, x_ref, y_ref, mag, good_idx, ref_id
quiv_label_val = 1.0
unit2 = 'mas'
- norm = matplotlib.colors.Normalize()
+ norm = mcolors.Normalize()
norm.autoscale(mag)
- cm = matplotlib.cm.viridis
- sm = matplotlib.cm.ScalarMappable(cmap=cm, norm=norm)
+ cmap = matplotlib.colormaps['viridis']
+ sm = matplotlib.cm.ScalarMappable(cmap=cmap, norm=norm)
# cmap = mpl.cm.cool
-# norm = mpl.colors.Normalize(vmin=np.min(mag), vmax=np.max(mag))
-#
+# norm = mpl.mcolors.Normalize(vmin=np.min(mag), vmax=np.max(mag))
+#
# cb1 = mpl.colorbar.ColorbarBase(ax, cmap=cmap,
# norm=norm,
# orientation='horizontal')
- plt.figure(101, figsize=(6,6))
- plt.clf()
- q = plt.quiver(x_ref[good_idx], y_ref[good_idx], dx[good_idx], dy[good_idx],
+ fig, ax=plt.subplots(1, 1, figsize=(6, 6))
+ q = ax.quiver(x_ref[good_idx], y_ref[good_idx], dx[good_idx], dy[good_idx],
color=cm(norm(mag[good_idx])), scale=quiv_scale, angles='xy', alpha=0.8)
- plt.quiverkey(q, 0.5, 0.85, quiv_label_val, quiv_label,
+ ax.quiverkey(q, 0.5, 0.85, quiv_label_val, quiv_label,
coordinates='figure', labelpos='E', color='green')
- plt.colorbar(sm)
- plt.xlabel('X (ref ' + unit + ')')
- plt.ylabel('Y (ref ' + unit + ')')
- plt.title(title + ', Good')
- plt.axis('equal')
+ fig.colorbar(sm, ax=ax)
+ ax.set_xlabel('X (ref ' + unit + ')')
+ ax.set_ylabel('Y (ref ' + unit + ')')
+ ax.set_title(title + ', Good')
+ ax.axis('equal')
if plotlim is not None:
- plt.xlim(-1 * plotlim, plotlim)
- plt.ylim(-1 * plotlim, plotlim)
+ ax.set_xlim(-1 * plotlim, plotlim)
+ ax.set_ylim(-1 * plotlim, plotlim)
+ plt.tight_layout()
plt.show()
- plt.pause(1)
- plt.figure(102, figsize=(6,6))
- plt.clf()
- q = plt.quiver(x_ref[good_idx][ref_idx], y_ref[good_idx][ref_idx], dx[good_idx][ref_idx], dy[good_idx][ref_idx],
+ fig, ax = plt.subplots(1, 1, figsize=(6,6))
+ q = ax.quiver(x_ref[good_idx][ref_idx], y_ref[good_idx][ref_idx], dx[good_idx][ref_idx], dy[good_idx][ref_idx],
color=cm(norm(mag[good_idx][ref_idx])), scale=quiv_scale, angles='xy', alpha=0.8)
- plt.quiverkey(q, 0.5, 0.85, quiv_label_val, quiv_label,
+ ax.quiverkey(q, 0.5, 0.85, quiv_label_val, quiv_label,
coordinates='figure', labelpos='E', color='green')
- plt.colorbar(sm)
- plt.xlabel('X (ref ' + unit + ')')
- plt.ylabel('Y (ref ' + unit + ')')
- plt.title(title + ', Ref')
- plt.axis('equal')
+ fig.colorbar(sm, ax=ax)
+ ax.set_xlabel('X (ref ' + unit + ')')
+ ax.set_ylabel('Y (ref ' + unit + ')')
+ ax.set_title(title + ', Ref')
+ ax.axis('equal')
if plotlim is not None:
- plt.xlim(-1 * plotlim, plotlim)
- plt.ylim(-1 * plotlim, plotlim)
+ ax.set_xlim(-1 * plotlim, plotlim)
+ ax.set_ylim(-1 * plotlim, plotlim)
plt.show()
- plt.pause(1)
str_fmt = 'Residuals (mean, std): dx = {0:7.3f} +/- {1:7.3f} {5:s} dy = {2:7.3f} +/- {3:7.3f} {5:s} for {4:s} stars'
if len(ref_idx) > 1:
@@ -1995,7 +2018,7 @@ def plot_quiver_residuals_magcolor(x_t, y_t, x_ref, y_ref, mag, good_idx, ref_id
else:
print(str_fmt.format(dx[good_idx][ref_idx].mean(), 0.0,
dy[good_idx][ref_idx].mean(), 0.0, 'REF', unit2))
-
+
print(str_fmt.format(dx[good_idx].mean(), dx[good_idx].std(),
dy[good_idx].mean(), dy[good_idx].std(), 'GOOD', unit2))
@@ -2003,17 +2026,17 @@ def plot_quiver_residuals_magcolor(x_t, y_t, x_ref, y_ref, mag, good_idx, ref_id
return (dx, dy)
-def plot_quiver_residuals_orig(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
- x_orig, y_orig, da, title,
- scale=None, plotlim=None):
+def plot_quiver_residuals_orig(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
+ x_orig, y_orig, da, title,
+ scale=None, plotlim=None, save_path=None):
"""
unit : str
'pixel' or 'arcsec'
The pixel units of the input values. Note, if arcsec, then the values will be
- converted to milli-arcsec for plotting when appropriate.
+ converted to milli-arcsec for plotting when appropriate.
scale : float
- The quiver scale. If none, then default units will be used appropriate to the unit.
+ The quiver scale. If none, then default units will be used appropriate to the unit.
plotlim : float (positive)
Sets the size of the plotted figure. If None, then default is used.
@@ -2028,8 +2051,8 @@ def plot_quiver_residuals_orig(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
dy /= 0.04
# Residual modulus
- r_good = np.hypot(dx[good_idx], dy[good_idx])
- r_ref = np.hypot(dx[good_idx][ref_idx], dy[good_idx][ref_idx])
+ # r_good = np.hypot(dx[good_idx], dy[good_idx])
+ # r_ref = np.hypot(dx[good_idx][ref_idx], dy[good_idx][ref_idx])
# Residual angle
agood = angle_from_xy(dx[good_idx], dy[good_idx])
@@ -2045,21 +2068,23 @@ def plot_quiver_residuals_orig(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
dx_ref_new, dy_ref_new = rotate(dx[good_idx][ref_idx], dy[good_idx][ref_idx], -da)
print('Rotation angle between HST and Gaia (deg): ', da)
- plt.figure(102, figsize=(6,6))
- plt.clf()
- q = plt.quiver(x_orig[good_idx], y_orig[good_idx], dx_good_new, dy_good_new,
+ fig, ax = plt.subplots(1, 1, figsize=(6, 6))
+ q = ax.quiver(x_orig[good_idx], y_orig[good_idx], dx_good_new, dy_good_new,
color='black', scale=scale, angles='xy', alpha=0.5)
- plt.quiver(x_orig[good_idx][ref_idx], y_orig[good_idx][ref_idx], dx_ref_new, dy_ref_new,
+ ax.quiver(x_orig[good_idx][ref_idx], y_orig[good_idx][ref_idx], dx_ref_new, dy_ref_new,
color='red', scale=scale, angles='xy')
- plt.quiverkey(q, 0.5, 0.85, 0.3, '0.3 pix',
+ ax.quiverkey(q, 0.5, 0.85, 0.3, '0.3 pix',
coordinates='figure', labelpos='E', color='green')
- plt.xlabel('X (ref pix)')
- plt.ylabel('Y (ref pix)')
- plt.title(title)
- plt.axis('equal')
+ ax.set_xlabel('X (ref pix)')
+ ax.set_ylabel('Y (ref pix)')
+ ax.set_title(title)
+ ax.axis('equal')
if plotlim is not None:
- plt.xlim(-1 * plotlim, plotlim)
- plt.ylim(-1 * plotlim, plotlim)
+ ax.set_xlim(-1 * plotlim, plotlim)
+ ax.set_ylim(-1 * plotlim, plotlim)
+ plt.tight_layout()
+ if save_path:
+ plt.savefig(save_path, dpi=300)
plt.show()
plt.pause(1)
@@ -2073,11 +2098,11 @@ def plot_quiver_residuals_orig(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
# ax1.hist(aref ,color='red', histtype = 'step',
# alpha=0.8, bins = 36, density=True)
# ax1.set_xlabel('Quiver angle (degrees), HST camera')
-#
-# ax2.scatter(x_orig[good_idx], y_orig[good_idx],
+#
+# ax2.scatter(x_orig[good_idx], y_orig[good_idx],
# s=5e3 * r_good**2, alpha=0.3, color='black')
-# ax2.scatter(x_orig[good_idx][ref_idx], y_orig[good_idx][ref_idx],
-# s=5e3 * r_ref**2, alpha=0.5, color='red')
+# ax2.scatter(x_orig[good_idx][ref_idx], y_orig[good_idx][ref_idx],
+# s=5e3 * r_ref**2, alpha=0.5, color='red')
# ax2.set_xlabel('X (orig pix)')
# ax2.set_ylabel('Y (orig pix)')
# plt.title(title)
@@ -2103,16 +2128,16 @@ def rotate(x, y, theta):
return xnew, ynew
-def plot_quiver_residuals_orig_angle_xy(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
+def plot_quiver_residuals_orig_angle_xy(x_t, y_t, x_ref, y_ref, good_idx, ref_idx,
x_orig, y_orig, da, title, scale=None, plotlim=None):
"""
unit : str
'pixel' or 'arcsec'
The pixel units of the input values. Note, if arcsec, then the values will be
- converted to milli-arcsec for plotting when appropriate.
+ converted to milli-arcsec for plotting when appropriate.
scale : float
- The quiver scale. If none, then default units will be used appropriate to the unit.
+ The quiver scale. If none, then default units will be used appropriate to the unit.
plotlim : float (positive)
Sets the size of the plotted figure. If None, then default is used.
@@ -2120,7 +2145,7 @@ def plot_quiver_residuals_orig_angle_xy(x_t, y_t, x_ref, y_ref, good_idx, ref_id
"""
dx = (x_t - x_ref)
dy = (y_t - y_ref)
-
+
# Residual modulus
r_good = np.hypot(dx[good_idx], dy[good_idx])
r_ref = np.hypot(dx[good_idx][ref_idx], dy[good_idx][ref_idx])
@@ -2164,7 +2189,7 @@ def plot_quiver_residuals_orig_angle_xy(x_t, y_t, x_ref, y_ref, good_idx, ref_id
return
-def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_err=False):
+def plot_chi2_dist(tab, Ndetect, xlim=40, n_bins=50, boot_err=False):
"""
tab = flystar table
Ndetect = Number of epochs star detected in
@@ -2172,16 +2197,17 @@ def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_
chi2_x_list = []
chi2_y_list = []
fnd_list = [] # Number of non-NaN error measurements
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
for ii in range(len(tab)):
- # Ignore the NaNs
+ # Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['xe'][ii,:]))
fnd_list.append(len(fnd))
-
+
x = tab['x'][ii, fnd]
y = tab['y'][ii, fnd]
if boot_err:
@@ -2198,7 +2224,7 @@ def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_
diffY = y - fitLineY
sigX = diffX / xerr
sigY = diffY / yerr
-
+
chi2_x = np.sum(sigX**2)
chi2_y = np.sum(sigY**2)
chi2_x_list.append(chi2_x)
@@ -2207,7 +2233,7 @@ def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_
x = np.array(chi2_x_list)
y = np.array(chi2_y_list)
fnd = np.array(fnd_list)
-
+
idx = np.where(fnd == Ndetect)[0]
# Fitting position and velocity... so subtract 2 to get Ndof
n_params = np.nanmean(tab['n_params'][idx])
@@ -2226,7 +2252,7 @@ def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_
plt.hist(x[idx], bins=chi2_bins, histtype='step', label='X', density=True)
plt.hist(y[idx], bins=chi2_bins, histtype='step', label='Y', density=True)
plt.plot(chi2_xaxis, chi2.pdf(chi2_xaxis, Ndof), 'r-', alpha=0.6,
- label='$\chi^2$ ' + str(round(Ndof,2)) + ' dof')
+ label=r'$\chi^2$ ' + str(round(Ndof,2)) + ' dof')
plt.title('$N_{epoch} = $' + str(Ndetect) + ', $N_{dof} = $' + str(round(Ndof,2)))
plt.xlim(0, xlim)
plt.legend()
@@ -2234,7 +2260,7 @@ def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_
chi2red_x = x / Ndof
chi2red_y = y / Ndof
chi2red_t = (x + y) / (2.0 * Ndof)
-
+
print('Mean reduced chi^2: (Ndetect = {0:d} of {1:d})'.format(len(idx), len(tab)))
fmt = ' {0:s} = {1:.1f} for N_detect and {2:.1f} for all'
med_chi2red_x_f = np.median(chi2red_x[idx])
@@ -2249,7 +2275,7 @@ def plot_chi2_dist(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, boot_
return
-def plot_chi2_reduced_dist(tab, Ndetect, motion_model_dict={}, xlim=8, n_bins=50, boot_err=False):
+def plot_chi2_reduced_dist(tab, Ndetect, xlim=8, n_bins=50, boot_err=False):
"""
tab = flystar table
Ndetect = Number of epochs star detected in
@@ -2257,16 +2283,17 @@ def plot_chi2_reduced_dist(tab, Ndetect, motion_model_dict={}, xlim=8, n_bins=50
chi2_x_list = []
chi2_y_list = []
fnd_list = [] # Number of non-NaN error measurements
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
for ii in range(len(tab)):
# Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['xe'][ii,:]))
fnd_list.append(len(fnd))
-
+
x = tab['x'][ii, fnd]
y = tab['y'][ii, fnd]
if boot_err:
@@ -2283,7 +2310,7 @@ def plot_chi2_reduced_dist(tab, Ndetect, motion_model_dict={}, xlim=8, n_bins=50
diffY = y - fitLineY
sigX = diffX / xerr
sigY = diffY / yerr
-
+
chi2_x = np.sum(sigX**2)
chi2_y = np.sum(sigY**2)
chi2_x_list.append(chi2_x)
@@ -2292,7 +2319,7 @@ def plot_chi2_reduced_dist(tab, Ndetect, motion_model_dict={}, xlim=8, n_bins=50
x = np.array(chi2_x_list)
y = np.array(chi2_y_list)
fnd = np.array(fnd_list)
-
+
idx = np.where(fnd == Ndetect)[0]
n_params = tab['n_params']
Ndof = Ndetect - n_params
@@ -2312,7 +2339,7 @@ def plot_chi2_reduced_dist(tab, Ndetect, motion_model_dict={}, xlim=8, n_bins=50
chi2red_x = x / Ndof
chi2red_y = y / Ndof
chi2red_t = (x + y) / (2.0 * Ndof + 1*(tab['motion_model_used']=='Parallax'))
-
+
print('Mean reduced chi^2: (Ndetect = {0:d} of {1:d})'.format(len(idx), len(tab)))
fmt = ' {0:s} = {1:.1f} for N_detect and {2:.1f} for all'
med_chi2red_x_f = np.median(chi2red_x[idx])
@@ -2328,7 +2355,7 @@ def plot_chi2_reduced_dist(tab, Ndetect, motion_model_dict={}, xlim=8, n_bins=50
return
-def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bins=50, filter=None, boot_err=False):
+def plot_chi2_dist_per_filter(tab, Ndetect, xlim=40, n_bins=50, filter=None, boot_err=False):
"""
tab = flystar table
Ndetect = Number of epochs star detected in
@@ -2336,16 +2363,17 @@ def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bin
chi2_x_list = []
chi2_y_list = []
fnd_list = [] # Number of non-NaN error measurements
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
for ii in range(len(tab)):
- # Ignore the NaNs
+ # Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['xe'][ii,:]))
fnd_list.append(len(fnd))
-
+
x = tab['x'][ii, fnd]
y = tab['y'][ii, fnd]
if boot_err:
@@ -2362,7 +2390,7 @@ def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bin
diffY = y - fitLineY
sigX = diffX / xerr
sigY = diffY / yerr
-
+
chi2_x = np.sum(sigX**2)
chi2_y = np.sum(sigY**2)
chi2_x_list.append(chi2_x)
@@ -2373,8 +2401,8 @@ def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bin
x = np.array(chi2_x_list)
y = np.array(chi2_y_list)
fnd = np.array(fnd_list)
-
-
+
+
idx = np.where(fnd == Ndetect)[0]
# Fitting position and velocity... so subtract n_params to get Ndof
n_params = np.nanmean(tab['n_params'][idx])
@@ -2390,7 +2418,7 @@ def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bin
plt.hist(x[idx], bins=chi2_bins, histtype='stepfilled', label='RA', density=True, color='skyblue', alpha=0.8, edgecolor='k')
plt.hist(y[idx], bins=chi2_bins, histtype='stepfilled', label='DEC', density=True, color='orange', alpha=0.8, edgecolor='k')
plt.plot(chi2_xaxis, chi2.pdf(chi2_xaxis, Ndof), 'r-', alpha=0.6,
- label='$\chi^2$ ' + str(Ndof) + ' dof')
+ label=r'$\chi^2$ ' + str(Ndof) + ' dof')
#plt.title('$N_{epoch} = $' + str(Ndetect) + ', $N_{dof} = $' + str(Ndof))
plt.title(str(filter)+' (N = '+str(len(chi2_x_list))+')', fontsize=22)
plt.xlim(0, xlim)
@@ -2399,12 +2427,12 @@ def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bin
plt.tick_params(labelsize=20, direction='in', right=True, top=True)
- plt.savefig(str(filter)+'_chi2_dist.png', dpi=400)
+ plt.savefig(str(filter)+'_chi2_dist.png', dpi=300)
chi2red_x = x / Ndof
chi2red_y = y / Ndof
chi2red_t = (x + y) / (2.0 * Ndof)
-
+
print('Mean reduced chi^2: (Ndetect = {0:d} of {1:d})'.format(len(idx), len(tab)))
fmt = ' {0:s} = {1:.1f} for N_detect and {2:.1f} for all'
med_chi2red_x_f = np.median(chi2red_x[idx])
@@ -2420,7 +2448,7 @@ def plot_chi2_dist_per_filter(tab, Ndetect, motion_model_dict={}, xlim=40, n_bin
return
-def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14,21], ylim = [-1, 1], target_idx = 0, motion_model_dict={}, boot_err=False):
+def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14, 21], ylim=[-1, 1], target_idx=0, boot_err=False):
"""
tab = flystar table
Ndetect = Number of epochs star detected in
@@ -2432,15 +2460,16 @@ def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14,21], ylim = [-1, 1], target_
sigX_arr = np.nan * np.ones((len(tab['xe']), Ndetect))
sigY_arr = np.nan * np.ones((len(tab['xe']), Ndetect))
m_arr = np.nan * np.ones((len(tab['xe']), Ndetect))
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+
for ii in range(len(tab['xe'])):
- # Ignore the NaNs
+ # Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['xe'][ii,:]))
- if len(fnd) == Ndetect and tab['use_in_trans'][ii]:
+ if len(fnd) == Ndetect and tab['use_in_trans'][ii]:
time = tab['t'][ii, fnd]
x = tab['x'][ii, fnd]
y = tab['y'][ii, fnd]
@@ -2455,7 +2484,7 @@ def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14,21], ylim = [-1, 1], target_
fitLineX = xt_mod_all[ii, fnd]
fitLineY = yt_mod_all[ii, fnd]
-
+
diffX = x - fitLineX
diffY = y - fitLineY
sigX = diffX / xerr
@@ -2464,7 +2493,7 @@ def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14,21], ylim = [-1, 1], target_
diffX_arr[ii] = diffX.reshape(Ndetect,)
diffY_arr[ii] = diffY.reshape(Ndetect,)
errX_arr[ii] = xerr.reshape(Ndetect,)
- errY_arr[ii] = yerr.reshape(Ndetect,)
+ errY_arr[ii] = yerr.reshape(Ndetect,)
sigX_arr[ii] = sigX.reshape(Ndetect,)
sigY_arr[ii] = sigY.reshape(Ndetect,)
m_arr[ii] = m.reshape(Ndetect,)
@@ -2497,14 +2526,14 @@ def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14,21], ylim = [-1, 1], target_
ax2.legend()
#print(errX_arr[:, ii])
- ax3.errorbar(m_arr[:, ii], diffX_arr[:, ii]*1E3, yerr=errX_arr[:, ii]*1E3,
+ ax3.errorbar(m_arr[:, ii], diffX_arr[:, ii]*1E3, yerr=errX_arr[:, ii]*1E3,
marker='s', label = 'X', ls='none', color='tab:blue', alpha=0.4, ms=5)
- ax3.errorbar(m_arr[:, ii], diffY_arr[:, ii]*1E3, yerr=errY_arr[:, ii]*1E3,
+ ax3.errorbar(m_arr[:, ii], diffY_arr[:, ii]*1E3, yerr=errY_arr[:, ii]*1E3,
marker='o', label = 'Y', ls='none', color='tab:orange', alpha=0.4, ms=5)
if target_idx is not None:
- ax3.errorbar(m_arr[target_idx, ii], diffX_arr[target_idx, ii]*1E3, yerr=errX_arr[target_idx, ii]*1E3,
+ ax3.errorbar(m_arr[target_idx, ii], diffX_arr[target_idx, ii]*1E3, yerr=errX_arr[target_idx, ii]*1E3,
marker='s', ls='none', color='black', ms=5)
- ax3.errorbar(m_arr[target_idx, ii], diffY_arr[target_idx, ii]*1E3, yerr=errY_arr[target_idx, ii]*1E3,
+ ax3.errorbar(m_arr[target_idx, ii], diffY_arr[target_idx, ii]*1E3, yerr=errY_arr[target_idx, ii]*1E3,
marker='o', ls='none', color='black', ms=5)
ax3.set_xlim(mlim[0], mlim[1])
ax3.set_ylim(ylim[0], ylim[1])
@@ -2515,7 +2544,7 @@ def plot_chi2_dist_per_epoch(tab, Ndetect, mlim=[14,21], ylim = [-1, 1], target_
ax3.set_ylabel('residual (mas)')
return
-
+
# TODO: update for motion model
def plot_chi2_ecliptic_per_epoch(tab, Ndetect,ra,dec, mlim=[14,21], ylim = [-1, 1], target_idx = 0):
"""
@@ -2529,7 +2558,7 @@ def plot_chi2_ecliptic_per_epoch(tab, Ndetect,ra,dec, mlim=[14,21], ylim = [-1,
sigX_arr = -99 * np.ones((len(tab['xe']), Ndetect))
sigY_arr = -99 * np.ones((len(tab['xe']), Ndetect))
m_arr = -99 * np.ones((len(tab['xe']), Ndetect))
-
+
rad_to_as = 180/np.pi * 60 * 60
deg_to_as = 60 * 60
def eq_to_ec(ra,dec):
@@ -2570,7 +2599,7 @@ def eq_to_ec(ra,dec):
dt = tab['t'][ii, fnd] - tab['t0'][ii]
fitLineX = lambda_pm
fitLineY = beta_pm
-
+
diffX = lambda_obs - fitLineX
diffY = beta_obs - fitLineY
sigX = diffX / xerr
@@ -2645,10 +2674,10 @@ def plot_chi2_dist_mag(tab, Ndetect, xlim=40, n_bins=30, boot_err=False):
fnd_list = [] # Number of non-NaN error measurements
for ii in range(len(tab['me'])):
- # Ignore the NaNs
+ # Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['me'][ii,:]))
fnd_list.append(len(fnd))
-
+
m = tab['m'][ii, fnd]
if boot_err:
merr = np.hypot(tab['me_boot'][ii, fnd], tab['me'][ii, fnd])
@@ -2659,7 +2688,7 @@ def plot_chi2_dist_mag(tab, Ndetect, xlim=40, n_bins=30, boot_err=False):
diff_m = m0 - m
sig_m = diff_m/merr
-
+
chi2_m = np.sum(sig_m**2)
chi2_m_list.append(chi2_m)
@@ -2676,8 +2705,8 @@ def plot_chi2_dist_mag(tab, Ndetect, xlim=40, n_bins=30, boot_err=False):
plt.figure(figsize=(6,4))
plt.clf()
plt.hist(chi2_m[idx], bins=np.arange(xlim*10), histtype='step', density=True)
- plt.plot(chi2_maxis, chi2.pdf(chi2_maxis, Ndof), 'r-', alpha=0.6,
- label='$\chi^2$ ' + str(Ndof) + ' dof')
+ plt.plot(chi2_maxis, chi2.pdf(chi2_maxis, Ndof), 'r-', alpha=0.6,
+ label=r'$\chi^2$ ' + str(Ndof) + ' dof')
plt.title('$N_{epoch} = $' + str(Ndetect) + ', $N_{dof} = $' + str(Ndof))
plt.xlim(0, xlim)
plt.legend()
@@ -2685,7 +2714,7 @@ def plot_chi2_dist_mag(tab, Ndetect, xlim=40, n_bins=30, boot_err=False):
print('Mean reduced chi^2: (Ndetect = {0:d} of {1:d})'.format(len(idx), len(tab)))
fmt = ' {0:s} = {1:.1f} for N_detect and {2:.1f} for all'
print(fmt.format('M', np.median(chi2_m[idx] / (fnd[idx] - 2)), np.median(chi2_m / (fnd - 2))))
-
+
return
def plot_chi2_dist_mag_per_filter(tab, Ndetect, mlim=40, n_bins=30, xlim=40, file_name=None, filter=None):
@@ -2697,10 +2726,10 @@ def plot_chi2_dist_mag_per_filter(tab, Ndetect, mlim=40, n_bins=30, xlim=40, fil
fnd_list = [] # Number of non-NaN error measurements
for ii in range(len(tab['me'])):
- # Ignore the NaNs
+ # Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['me'][ii,:]))
fnd_list.append(len(fnd))
-
+
m = tab['m'][ii, fnd]
merr = tab['me'][ii, fnd]
m0 = tab['m0'][ii]
@@ -2708,7 +2737,7 @@ def plot_chi2_dist_mag_per_filter(tab, Ndetect, mlim=40, n_bins=30, xlim=40, fil
diff_m = m0 - m
sig_m = diff_m/merr
-
+
chi2_m = np.sum(sig_m**2)
chi2_m_list.append(chi2_m)
@@ -2725,8 +2754,8 @@ def plot_chi2_dist_mag_per_filter(tab, Ndetect, mlim=40, n_bins=30, xlim=40, fil
plt.figure(figsize=(6,4))
plt.clf()
plt.hist(chi2_m[idx], bins=np.arange(xlim*10), label='mag', histtype='stepfilled', density=True, color='green', alpha=0.7, edgecolor='k')
- plt.plot(chi2_maxis, chi2.pdf(chi2_maxis, Ndof), 'r-', alpha=0.6,
- label='$\chi^2$ ' + str(Ndof) + ' dof')
+ plt.plot(chi2_maxis, chi2.pdf(chi2_maxis, Ndof), 'r-', alpha=0.6,
+ label=r'$\chi^2$ ' + str(Ndof) + ' dof')
#plt.title('$N_{epoch} = $' + str(Ndetect) + ', $N_{dof} = $' + str(Ndof))
plt.xlim(0, xlim)
plt.xlabel(r'$\chi^{2}$', fontsize=28)
@@ -2735,28 +2764,28 @@ def plot_chi2_dist_mag_per_filter(tab, Ndetect, mlim=40, n_bins=30, xlim=40, fil
plt.tick_params(labelsize=20, direction='in', right=True, top=True)
- plt.savefig(str(filter)+'_chi2_dist_mag.png', dpi=400)
+ plt.savefig(str(filter)+'_chi2_dist_mag.png', dpi=300)
print('Mean reduced chi^2: (Ndetect = {0:d} of {1:d})'.format(len(idx), len(tab)))
fmt = ' {0:s} = {1:.1f} for N_detect and {2:.1f} for all'
print(fmt.format('M', np.median(chi2_m[idx] / (fnd[idx] - 2)), np.median(chi2_m / (fnd - 2))))
-
+
return
-def plot_stars(tab, star_names, motion_model_dict={}, NcolMax=2, epoch_array = None, figsize=(15,25), color_time=False, boot_err=False):
+def plot_stars(tab, star_names, NcolMax=2, epoch_array = None, figsize=(15,25), color_time=False, boot_err=False):
"""
- Plot a set of stars positions, flux and residuals over time.
+ Plot a set of stars positions, flux and residuals over time.
epoch_array : None, array
Array of the epoch indicies to plot. If None, plots all epochs.
"""
-
+
def rs(x):
return x.reshape(len(x))
-
+
print( 'Creating residuals plots for star(s):' )
print( star_names )
-
+
Nstars = len(star_names)
Ncols = 3 * np.min([Nstars, NcolMax])
if Nstars <= Ncols/3:
@@ -2771,15 +2800,17 @@ def rs(x):
x = tab['x0']
y = tab['y0']
r = np.hypot(x, y)
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
cont_times = np.arange(np.min(tab['t'][i_all_detected]), np.max(tab['t'][i_all_detected]), 0.01)
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
- xt_cont_all, yt_cont_all, xt_cont_err, yt_cont_err = tab.get_star_positions_at_time(cont_times, motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+ # xt_cont_all, yt_cont_all, xt_cont_err, yt_cont_err = tab.get_star_positions_at_time(cont_times, motion_model_dict, allow_alt_models=True)
+ xt_cont_all, yt_cont_all, xt_cont_err, yt_cont_err = tab.infer_positions(cont_times)
+
for i in range(Nstars):
starName = star_names[i]
-
+
try:
ii = np.where(tab['name'] == starName)[0][0]
except IndexError:
@@ -2794,7 +2825,7 @@ def rs(x):
fnd = fnd.reshape(len(fnd),1)
time = tab['t'][ii, fnd]
- dtime = time.data % 1
+ dtime = time.data % 1
x = tab['x'][ii, fnd]
y = tab['y'][ii, fnd]
m = tab['m'][ii, fnd]
@@ -2809,7 +2840,7 @@ def rs(x):
merr = tab['me'][ii, fnd]
dt = tab['t'][ii, fnd] - tab['t0'][ii]
-
+
fitLineX = xt_mod_all[ii, fnd]
fitLineY = yt_mod_all[ii, fnd]
@@ -2846,14 +2877,14 @@ def rs(x):
chi2_red_x = chi2_x / dof
chi2_red_y = chi2_y / dof
chi2_red_m = chi2_m / dofM
-
+
print( 'Star: ', starName )
- print( '\tX Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tX Chi^2 = %5.2f (%6.2f for %2d dof)' %
(chi2_red_x, chi2_x, dof))
- print( '\tY Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tY Chi^2 = %5.2f (%6.2f for %2d dof)' %
(chi2_red_y, chi2_y, dof))
- print( '\tM Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tM Chi^2 = %5.2f (%6.2f for %2d dof)' %
(chi2_red_m, chi2_m, dofM))
if 'motion_model_used' in tab.keys():
print('\tMotion model:', tab['motion_model_used'][ii])
@@ -2902,7 +2933,7 @@ def rs(x):
row = 1
else:
col = 1 + 3*(i % (Ncols/3))
- row = 1 + 3*(i//(Ncols/3))
+ row = 1 + 3*(i//(Ncols/3))
ind = int((row-1)*Ncols + col)
@@ -2918,7 +2949,7 @@ def rs(x):
plt.errorbar(rs(time), rs(x), yerr=rs(xerr), fmt='k.')
#plt.errorbar(time, x, yerr=xerr, fmt='k.')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, x, xerr, time_color):
@@ -2950,7 +2981,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(y), yerr=rs(yerr), fmt='k.')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, y, yerr, time_color):
@@ -2980,7 +3011,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(m), yerr=rs(merr), fmt='k.')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, m, merr, time_color):
@@ -2996,7 +3027,7 @@ def rs(x):
paxes.xaxis.set_major_formatter(fmtX)
paxes.yaxis.set_major_formatter(fmtM)
paxes.tick_params(axis='both', which='major', labelsize=12)
-
+
##########
# X residuals vs time
@@ -3012,7 +3043,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(x - fitLineX)*1e3, yerr=rs(xerr)*1e3, fmt='k.')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, (x - fitLineX)*1e3, xerr*1e3, time_color):
@@ -3040,7 +3071,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(y - fitLineY)*1e3, yerr=rs(yerr)*1e3, fmt='k.')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, (y - fitLineY)*1e3, yerr*1e3, time_color):
@@ -3068,7 +3099,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(m - fitLineM), yerr=rs(merr), fmt='k.')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, (m - fitLineM), merr, time_color):
@@ -3099,7 +3130,7 @@ def rs(x):
sc = plt.scatter(x, y, s=0, c=dtime, vmin=0, vmax=1, cmap='hsv')
clb = plt.colorbar(sc)
clb.ax.tick_params(labelsize=fontsize1)
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, eexx, eeyy, color in zip(x, y, xerr, yerr, time_color):
@@ -3112,7 +3143,7 @@ def rs(x):
plt.xlabel('X (asec)', fontsize=fontsize1)
plt.ylabel('Y (asec)', fontsize=fontsize1)
plt.plot(xt_cont_all[ii], yt_cont_all[ii], 'b-')
-
+
##########
# X, Y Histogram of Residuals
##########
@@ -3122,7 +3153,7 @@ def rs(x):
bins = np.arange(-7.5, 7.5, 1)
paxes = plt.subplot(Nrows, Ncols, ind)
id = np.where(diffY < 0)[0]
- sig[id] = -1.*sig[id]
+ sig[id] = -1.*sig[id]
(n, b, p) = plt.hist(sigX, bins, histtype='stepfilled', color='b', label='X')
plt.setp(p, 'facecolor', 'b')
(n, b, p) = plt.hist(sigY, bins, histtype='step', color='r', label='Y')
@@ -3148,24 +3179,24 @@ def rs(x):
plt.xlabel('Residuals (sigma)', fontsize=fontsize1)
plt.ylabel('Number of Epochs', fontsize=fontsize1)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
+
if Nstars == 1:
- plt.subplots_adjust(wspace=0.4, hspace=0.4, left = 0.15, bottom = 0.1, right=0.9, top=0.9)
- # plt.savefig(rootDir+'plots/plotStar_' + starName + '.png')
+ plt.subplots_adjust(wspace=0.4, hspace=0.4, left = 0.15, bottom = 0.1, right=0.9, top=0.9)
+ # plt.savefig(rootDir+'plots/plotStar_' + starName + '.png', dpi=300)
else:
plt.subplots_adjust(wspace=0.6, hspace=0.6, left = 0.08, bottom = 0.05, right=0.95, top=0.90)
- # plt.savefig(rootDir+'plots/plotStar_all.png')
+ # plt.savefig(rootDir+'plots/plotStar_all.png', dpi=300)
plt.show()
plt.show()
return
-def plot_stars_nfilt(tab, star_names, motion_model_dict={}, NcolMax=2, epoch_array_list = None, color_list = None,
+def plot_stars_nfilt(tab, star_names, NcolMax=2, epoch_array_list = None, color_list = None,
figsize=(15,25), color_time=False, resTicRng=None, save_name=None, boot_err=False):
"""
- Plot a set of stars positions, flux and residuals over time.
+ Plot a set of stars positions, flux and residuals over time.
epoch_array : None, array
Array of the epoch indicies to plot. If None, plots all epochs.
@@ -3177,11 +3208,12 @@ def plot_stars_nfilt(tab, star_names, motion_model_dict={}, NcolMax=2, epoch_arr
print( star_names )
def rs(x):
return x.reshape(len(x))
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+
Nstars = len(star_names)
Ncols = 3 * np.min([Nstars, NcolMax])
if Nstars <= Ncols/3:
@@ -3196,36 +3228,38 @@ def rs(x):
x = tab['x0']
y = tab['y0']
r = np.hypot(x, y)
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
+ # motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, tab, None)
i_all_detected = np.where(~np.any(np.isnan(tab['t']),axis=1))[0][0]
cont_times = np.arange(np.min(tab['t'][i_all_detected]), np.max(tab['t'][i_all_detected]), 0.01)
- xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
- xt_cont_all, yt_cont_all, xt_cont_err, yt_cont_err = tab.get_star_positions_at_time(cont_times, motion_model_dict, allow_alt_models=True)
-
+ # xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.get_star_positions_at_time(tab['t'][i_all_detected], motion_model_dict, allow_alt_models=True)
+ xt_mod_all, yt_mod_all, xt_mod_err, yt_mod_err = tab.infer_positions(tab['t'][i_all_detected])
+ # xt_cont_all, yt_cont_all, xt_cont_err, yt_cont_err = tab.get_star_positions_at_time(cont_times, motion_model_dict, allow_alt_models=True)
+ xt_cont_all, yt_cont_all, xt_cont_err, yt_cont_err = tab.infer_positions(cont_times)
+
for i in range(Nstars):
for ea, epoch_array in enumerate(epoch_array_list):
color=color_list[ea]
starName = star_names[i]
-
+
try:
ii = np.where(tab['name'] == starName)[0][0]
except IndexError:
print("!! %s is not in this list"%starName)
continue
-
+
# Ignore the NaNs
fnd = np.argwhere(~np.isnan(tab['xe'][ii,:]))
-
+
if epoch_array is not None:
fnd = np.intersect1d(fnd, epoch_array)
fnd = fnd.reshape(len(fnd),1)
-
+
time = tab['t'][ii, fnd]
- dtime = time.data % 1
+ dtime = time.data % 1
x = tab['x'][ii, fnd]
y = tab['y'][ii, fnd]
m = tab['m'][ii, fnd]
-
+
if boot_err:
xerr = np.hypot(tab['xe'][ii, fnd], tab['xe_boot'][ii, fnd])
yerr = np.hypot(tab['ye'][ii, fnd], tab['ye_boot'][ii, fnd])
@@ -3234,16 +3268,16 @@ def rs(x):
xerr = tab['xe'][ii, fnd]
yerr = tab['ye'][ii, fnd]
merr = tab['me'][ii, fnd]
-
+
fitLineX = xt_mod_all[ii, fnd]
fitLineY = yt_mod_all[ii, fnd]
-
+
fitSigX = xt_mod_err[ii, fnd]
fitSigY = yt_mod_err[ii, fnd]
-
+
fitLineM = np.repeat(tab['m0'][ii], len(time)).reshape(len(time),1)
fitSigM = np.repeat(tab['m0_err'][ii], len(time)).reshape(len(time),1)
-
+
diffX = x - fitLineX
diffY = y - fitLineY
diffM = m - fitLineM
@@ -3253,42 +3287,42 @@ def rs(x):
sigY = diffY / yerr
sigM = diffM / merr
sig = diff / rerr
-
+
# Determine if there are points that are more than 4 sigma off
idxX = np.where(abs(sigX) > 4)
idxY = np.where(abs(sigY) > 4)
idxM = np.where(abs(sigM) > 4)
idx = np.where(abs(sig) > 4)
-
+
# Calculate chi^2 metrics
chi2_x = np.sum(sigX**2)
chi2_y = np.sum(sigY**2)
chi2_m = np.sum(sigM**2)
-
+
dof = len(x) - 2
dofM = len(m) - 1
-
+
chi2_red_x = chi2_x / dof
chi2_red_y = chi2_y / dof
chi2_red_m = chi2_m / dofM
-
-
+
+
print( 'Star: ', starName )
- print( '\tX Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tX Chi^2 = %5.2f (%6.2f for %2d dof)' %
(chi2_red_x, chi2_x, dof))
- print( '\tY Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tY Chi^2 = %5.2f (%6.2f for %2d dof)' %
(chi2_red_y, chi2_y, dof))
- print( '\tM Chi^2 = %5.2f (%6.2f for %2d dof)' %
+ print( '\tM Chi^2 = %5.2f (%6.2f for %2d dof)' %
(chi2_red_m, chi2_m, dofM))
-
+
tmin = time.min()
tmax = time.max()
-
+
dateTicLoc = plt.MultipleLocator(3)
dateTicRng = [np.floor(tmin), np.ceil(tmax)]
dateTics = np.arange(np.floor(tmin), np.ceil(tmax)+0.1)
DateTicsLabel = dateTics
-
+
# See if we are using MJD instead.
if time[0] > 50000:
print('MJD')
@@ -3298,12 +3332,12 @@ def rs(x):
dateTicRng = [tmin-200, tmax+200]
dateTics = np.arange(dateTicRng[0], dateTicRng[-1]+500, 1000)
DateTicsLabel = dateTics
-
-
+
+
maxErr = np.array([(diffX-xerr)*1e3, (diffX+xerr)*1e3,
(diffY-yerr)*1e3, (diffY+yerr)*1e3]).max()
maxErrM = np.array([(diffM - merr), (diffM + merr)]).max()
-
+
if maxErr > 2:
maxErr = 2.0
if maxErrM > 1.0:
@@ -3311,13 +3345,13 @@ def rs(x):
if resTicRng == None:
resTicRng = [-1.1*maxErr, 1.1*maxErr]
resTicRngM = [-1.1*maxErrM, 1.1*maxErrM]
-
+
from matplotlib.ticker import FormatStrFormatter
fmtX = FormatStrFormatter('%5i')
fmtY = FormatStrFormatter('%6.3f')
fmtM = FormatStrFormatter('%5.2f')
fontsize1 = 10
-
+
##########
# X vs time
##########
@@ -3326,10 +3360,10 @@ def rs(x):
row = 1
else:
col = 1 + 3*(i % (Ncols/3))
- row = 1 + 3*(i//(Ncols/3))
-
+ row = 1 + 3*(i//(Ncols/3))
+
ind = int((row-1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
plt.plot(cont_times, xt_cont_all[ii], 'b-')
plt.plot(cont_times, xt_cont_all[ii] + xt_cont_err[ii], 'b--')
@@ -3338,7 +3372,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(x), yerr=rs(xerr), marker='.', color=color, ls='none')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, x, xerr, time_color):
@@ -3355,14 +3389,14 @@ def rs(x):
paxes.yaxis.set_major_formatter(fmtY)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
plt.annotate(starName, xy=(1.0,1.1), xycoords='axes fraction', fontsize=12, color='red')
-
-
+
+
##########
# Y vs time
##########
col = col + 1
ind = int((row-1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
plt.plot(cont_times, yt_cont_all[ii], 'b-')
plt.plot(cont_times, yt_cont_all[ii] + yt_cont_err[ii], 'b--')
@@ -3370,7 +3404,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(y), yerr=rs(yerr), marker='.', color=color, ls='none')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, y, yerr, time_color):
@@ -3386,13 +3420,13 @@ def rs(x):
paxes.xaxis.set_major_formatter(fmtX)
paxes.yaxis.set_major_formatter(fmtY)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
+
##########
# M vs time
##########
col = col + 1
ind = int((row - 1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
plt.plot(time, fitLineM, 'g-')
plt.plot(time, fitLineM + fitSigM, 'g--')
@@ -3400,7 +3434,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(m), yerr=rs(merr), marker='.', color=color, ls='none')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, m, merr, time_color):
@@ -3416,15 +3450,15 @@ def rs(x):
paxes.xaxis.set_major_formatter(fmtX)
paxes.yaxis.set_major_formatter(fmtM)
paxes.tick_params(axis='both', which='major', labelsize=12)
-
-
+
+
##########
# X residuals vs time
##########
row = row + 1
col = col - 2
ind = int((row-1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
plt.plot(time, np.zeros(len(time)), 'b-')
plt.plot(cont_times, xt_cont_err[ii]*1e3, 'b--')
@@ -3432,7 +3466,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(x - fitLineX)*1e3, yerr=rs(xerr)*1e3, marker='.', color=color, ls='none')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, (x - fitLineX)*1e3, xerr*1e3, time_color):
@@ -3446,13 +3480,13 @@ def rs(x):
plt.ylabel('X Residuals (mas)', fontsize=fontsize1)
paxes.xaxis.set_major_formatter(fmtX)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
+
##########
# Y residuals vs time
##########
col = col + 1
ind = int((row-1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
plt.plot(time, np.zeros(len(time)), 'b-')
plt.plot(cont_times, yt_cont_err[ii]*1e3, 'b--')
@@ -3460,7 +3494,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(y - fitLineY)*1e3, yerr=rs(yerr)*1e3, marker='.', color=color, ls='none')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, (y - fitLineY)*1e3, yerr*1e3, time_color):
@@ -3474,13 +3508,13 @@ def rs(x):
plt.ylabel('Y Residuals (mas)', fontsize=fontsize1)
paxes.xaxis.set_major_formatter(fmtX)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
+
##########
# M residuals vs time
##########
col = col + 1
ind = int((row-1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
plt.plot(time, np.zeros(len(time)), 'g-')
plt.plot(time, fitSigM*1e3, 'g--')
@@ -3488,7 +3522,7 @@ def rs(x):
if not color_time:
plt.errorbar(rs(time), rs(m - fitLineM), yerr=rs(merr), marker='.', color=color, ls='none')
else:
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, ee, color in zip(time, (m - fitLineM), merr, time_color):
@@ -3502,15 +3536,15 @@ def rs(x):
plt.ylabel('m Residuals (mag)', fontsize=fontsize1)
paxes.xaxis.set_major_formatter(fmtX)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
-
+
+
##########
# X vs. Y
##########
row = row + 1
col = col - 2
ind = int((row-1)*Ncols + col)
-
+
paxes = plt.subplot(Nrows, Ncols, ind)
if not color_time:
plt.errorbar(rs(x),rs(y), xerr=rs(xerr),
@@ -3519,7 +3553,7 @@ def rs(x):
sc = plt.scatter(x, y, s=0, c=dtime, vmin=0, vmax=1, cmap='hsv')
clb = plt.colorbar(sc)
clb.ax.tick_params(labelsize=fontsize1)
- norm = colors.Normalize(vmin=0, vmax=1, clip=True)
+ norm = mcolors.Normalize(vmin=0, vmax=1, clip=True)
mapper = cm.ScalarMappable(norm=norm, cmap='hsv')
time_color = np.array([(mapper.to_rgba(v)) for v in dtime])
for xx, yy, eexx, eeyy, color in zip(x, y, xerr, yerr, time_color):
@@ -3531,18 +3565,18 @@ def rs(x):
paxes.xaxis.set_major_formatter(FormatStrFormatter('%.3f'))
plt.xlabel('X (asec)', fontsize=fontsize1)
plt.ylabel('Y (asec)', fontsize=fontsize1)
- plt.plot(fitLineX, fitLineY, 'b-')
-
+ plt.plot(fitLineX, fitLineY, 'b-')
+
##########
# X, Y Histogram of Residuals
##########
col = col + 1
ind = int((row-1)*Ncols + col)
-
+
bins = np.arange(-7.5, 7.5, 1)
paxes = plt.subplot(Nrows, Ncols, ind)
id = np.where(diffY < 0)[0]
- sig[id] = -1.*sig[id]
+ sig[id] = -1.*sig[id]
(n, b, p) = plt.hist(sigX, bins, histtype='stepfilled', color='b', label='X')
plt.setp(p, 'facecolor', 'b')
(n, b, p) = plt.hist(sigY, bins, histtype='step', color='r', label='Y')
@@ -3552,13 +3586,13 @@ def rs(x):
plt.xlabel('Residuals (sigma)', fontsize=fontsize1)
plt.ylabel('Number of Epochs', fontsize=fontsize1)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
+
##########
# M Histogram of Residuals
##########
col = col + 1
ind = int((row-1)*Ncols + col)
-
+
bins = np.arange(-7.5, 7.5, 1)
paxes = plt.subplot(Nrows, Ncols, ind)
(n, b, p) = plt.hist(sigM, bins, histtype='stepfilled', color='g', label='m')
@@ -3568,17 +3602,17 @@ def rs(x):
plt.xlabel('Residuals (sigma)', fontsize=fontsize1)
plt.ylabel('Number of Epochs', fontsize=fontsize1)
paxes.tick_params(axis='both', which='major', labelsize=fontsize1)
-
+
if Nstars == 1:
- plt.subplots_adjust(wspace=0.4, hspace=0.4, left = 0.15, bottom = 0.1, right=0.9, top=0.9)
- # plt.savefig(rootDir+'plots/plotStar_' + starName + '.png')
+ plt.subplots_adjust(wspace=0.4, hspace=0.4, left = 0.15, bottom = 0.1, right=0.9, top=0.9)
+ # plt.savefig(rootDir+'plots/plotStar_' + starName + '.png', dpi=300)
else:
plt.subplots_adjust(wspace=0.6, hspace=0.6, left = 0.08, bottom = 0.05, right=0.95, top=0.90)
- # plt.savefig(rootDir+'plots/plotStar_all.png')
+ # plt.savefig(rootDir+'plots/plotStar_all.png', dpi=300)
plt.show()
if save_name is not None:
- plt.savefig(save_name + '.png')
+ plt.savefig(save_name + '.png', dpi=300)
plt.show()
return
@@ -3586,9 +3620,9 @@ def rs(x):
def plot_errors_vs_r_m(star_tab, vmax_perr=0.75, vmax_pmerr=0.75):
"""
- Plot the positional errors and the proper motion errors as a function of radius
- and magnitude. The positional an proper motion errors will be the mean in the
- two axis (as is used in pick_good_ref_stars()).
+ Plot the positional errors and the proper motion errors as a function of radius
+ and magnitude. The positional an proper motion errors will be the mean in the
+ two axis (as is used in pick_good_ref_stars()).
"""
r = np.hypot(star_tab['x0'], star_tab['y0'])
p_err = np.mean((star_tab['x0_err'], star_tab['y0_err']), axis=0) * 1e3
@@ -3597,7 +3631,7 @@ def plot_errors_vs_r_m(star_tab, vmax_perr=0.75, vmax_pmerr=0.75):
plt.figure(figsize=(12, 6))
plt.clf()
plt.subplots_adjust(wspace=0.4)
-
+
plt.subplot(1, 2, 1)
plt.scatter(star_tab['m0'], r, c=p_err, s=8, vmin=0, vmax=vmax_perr)
plt.colorbar(label='Pos Err (mas)')
@@ -3625,7 +3659,7 @@ def plot_plxs(star_tab, target_idx=0):
ax[1].set_xlabel('Plx/Plx_err')
plt.tight_layout()
ax[0].set_ylim(-5,5)
-
+
def plot_sky(stars_tab,
plot_errors=False, center_star=None, range=0.4,
xcenter=0, ycenter=0, show_names=False, saveplot=False,
@@ -3639,8 +3673,8 @@ def plot_sky(stars_tab,
Parameters
----------
stars_tab : flystar.startables.StarTable
- The StarTable containining 'x', 'y', 't', 'xe', 'ye', columns etc.
- for plotting, where each of these columns is a 2D array of
+ The StarTable containining 'x', 'y', 't', 'xe', 'ye', columns etc.
+ for plotting, where each of these columns is a 2D array of
[star_index, epoch_index].
@@ -3685,11 +3719,11 @@ def plot_sky(stars_tab,
good_t = np.isfinite(stars_tab['t'])
epochs = np.unique(stars_tab['t'][good_t])
assert len(epochs) == stars_tab['t'].shape[1]
-
+
yearsInt = np.floor(epochs).astype('int')
# Set up a color scheme
- cnorm = colors.Normalize(stars_tab['t'][0, :].min(), stars_tab['t'][0, :].max() + 1)
+ cnorm = mcolors.Normalize(stars_tab['t'][0, :].min(), stars_tab['t'][0, :].max() + 1)
cmap = plt.cm.gist_ncar
colorList = []
@@ -3697,8 +3731,8 @@ def plot_sky(stars_tab,
foo = cnorm(yearsInt[ee])
colorList.append( cmap(cnorm(yearsInt[ee])) )
- py.close(2)
- fig = py.figure(2, figsize=(13,10))
+ plt.close(2)
+ fig = plt.figure(2, figsize=(13,10))
previousYear = 0.0
@@ -3736,13 +3770,13 @@ def plot_sky(stars_tab,
label = '_nolegend_'
if plot_errors:
- (line, foo1, foo2) = py.errorbar(x, y, xerr=xe, yerr=ye,
+ (line, foo1, foo2) = plt.errorbar(x, y, xerr=xe, yerr=ye,
color=colorList[ee], fmt='^',
markeredgecolor=colorList[ee],
markerfacecolor=colorList[ee],
label=label, picker=4)
else:
- (line, foo1, foo2) = py.errorbar(x, y, xerr=None, yerr=None,
+ (line, foo1, foo2) = plt.errorbar(x, y, xerr=None, yerr=None,
color=colorList[ee], fmt='^',
markeredgecolor=colorList[ee],
markerfacecolor=colorList[ee],
@@ -3760,19 +3794,19 @@ def plot_sky(stars_tab,
point_labels[line] = points_info
foo = PrintSelected(point_labels, fig, stars_tab, mag_range, manual_print=manual_print)
- py.connect('pick_event', foo)
+ plt.connect('pick_event', foo)
xlo = xcenter + (range)
xhi = xcenter - (range)
ylo = ycenter - (range)
yhi = ycenter + (range)
- py.axis('equal')
- py.axis([xlo, xhi, ylo, yhi])
- py.xlabel('R.A. Offset from Sgr A* (arcsec)')
- py.ylabel('Dec. Offset from Sgr A* (arcsec)')
+ plt.axis('equal')
+ plt.axis([xlo, xhi, ylo, yhi])
+ plt.xlabel('R.A. Offset from Sgr A* (arcsec)')
+ plt.ylabel('Dec. Offset from Sgr A* (arcsec)')
- py.legend(handles=epochs_legend, numpoints=1, loc='lower left', fontsize=12)
+ plt.legend(handles=epochs_legend, numpoints=1, loc='lower left', fontsize=12)
if show_names:
xpos = stars_tab['x0']
@@ -3780,20 +3814,20 @@ def plot_sky(stars_tab,
goodind = np.where((xpos <= xlo) & (xpos >= xhi) &
(ypos >= ylo) & (ypos <= yhi))[0]
for ind in goodind:
- py.text(xpos[ind], ypos[ind], stars_tab['name'][ind], size=10)
+ plt.text(xpos[ind], ypos[ind], stars_tab['name'][ind], size=10)
if saveplot:
- py.show(block=0)
+ plt.show(block=0)
if (center_star != None):
- py.savefig('plot_sky_' + center_star + '.png')
+ plt.savefig('plot_sky_' + center_star + '.png', dpi=300)
else:
- py.savefig('plot_sky.png')
+ plt.savefig('plot_sky.png', dpi=300)
else:
- py.show()
+ plt.show()
return
-
-
+
+
class PrintSelected(object):
def __init__(self, points_info, fig, tab, mag_range, manual_print=False):
self.points_info = points_info
@@ -3861,3 +3895,93 @@ def __call__(self, event):
self.fig.canvas.draw()
return
+
+
+def plotly_stars(x, y, m=None, star_name=None, marker_size=3, color=None, alpha=0.7, symbol='circle', label='starlist', fig=None, figsize=(700, 700), show=True):
+ """Plot stars with plotly in interactive html format
+
+ Parameters
+ ----------
+ x : array-like
+ x positions
+ y : array-like
+ y positions
+ m : array-like, optional
+ magnitude to be added in hover label, by default None
+ star_name : array-like, optional
+ Star names to be added in hover label, by default None
+ marker_size : int, optional
+ Size of marker, by default 10
+ color : array or str, optional
+ Color of marker, either a string (e.g., 'red') or rgba array, by default None
+ alpha : float, optional
+ Opacity of marker color, by default 0.7
+ symbol : str, optional
+ Marker symbol, by default 'circle'
+ label : str, optional
+ Label for the star list, by default 'starlist'
+ fig : plotly.graph_objects.Figure object, optional
+ Figure if the stars are to be added to an exisiting plot, by default None
+ figsize : tuple, optional
+ Figure size, by default (700, 700)
+ show : bool, optional
+ Show figure or not, by default True
+
+ Returns
+ -------
+ fig : plotly.graph_objects.Figure
+ Figure object
+ """
+ import plotly.graph_objects as go
+ x = np.asarray(x)
+ y = np.asarray(y)
+ hover_template = 'x: %{x:.3f} y: %{y:.3f}'
+
+ if isinstance(color, str) and color.startswith('C') and color[1:].isdigit():
+ color = mcolors.to_rgba(color, alpha=alpha)
+ color = f'rgba({color[0]*255}, {color[1]*255}, {color[2]*255}, {color[3]:.2f})'
+
+ customdata = []
+ if star_name is not None:
+ hover_template = 'name: %{customdata[0]} ' + hover_template
+ customdata.append(star_name)
+
+ if m is not None:
+ m = np.asarray(m)
+ m_idx = len(customdata)
+ hover_template += f' m: %{{customdata[{m_idx}]:.2f}}'
+ customdata.append(m)
+
+ if customdata:
+ customdata = np.column_stack(customdata)
+ hover_template += ''
+
+ fig_data = go.Scattergl(
+ x=x,
+ y=y,
+ mode='markers',
+ marker=dict(
+ size=marker_size,
+ color=color,
+ symbol=symbol
+ ),
+ customdata=customdata,
+ hovertemplate=hover_template,
+ name=label
+ )
+
+ if fig is None:
+ fig = go.Figure(data=[fig_data])
+ else:
+ fig.add_trace(fig_data)
+
+ fig.update_layout(
+ xaxis_title='x',
+ yaxis_title='y',
+ xaxis=dict(scaleanchor='y', scaleratio=1), # Ensure equal aspect ratio
+ width=figsize[0],
+ height=figsize[1]
+ )
+ if show:
+ fig.show()
+ return fig
\ No newline at end of file
diff --git a/flystar/starlists.py b/flystar/starlists.py
index 23df44f..ef8a666 100644
--- a/flystar/starlists.py
+++ b/flystar/starlists.py
@@ -31,7 +31,7 @@ def restrict_by_name(table1, table2):
name1 = table1['name']
name2 = table2['name']
-
+
Name = np.intersect1d(name1, name2)
# trim out stars begin with 'star'
idx = []
@@ -67,7 +67,7 @@ def restrict_by_area(table1, area, exclude=False):
exclude: boolean (default=False)
If true, *exclude* the stars that fall within the given area. If false,
then only return stars that fall within the given area
-
+
Output:
------
array of indicies corresponding to stars which are within the designated
@@ -76,7 +76,7 @@ def restrict_by_area(table1, area, exclude=False):
# Extract star coordinates
xpos = table1['x']
ypos = table1['y']
-
+
# Extract desired coordinate ranges
x_range = area[0]
y_range = area[1]
@@ -89,7 +89,7 @@ def restrict_by_area(table1, area, exclude=False):
else:
good = np.where( ( (xpos < x_range[0]) | (xpos > x_range[1]) ) &
( (ypos < y_range[0]) | (ypos > y_range[1]) ) )
-
+
return good[0]
def restrict_by_use(label_mat, starlist_mat, idx_label, idx_starlist):
@@ -114,7 +114,7 @@ def restrict_by_use(label_mat, starlist_mat, idx_label, idx_starlist):
idx_starlist: array of indicies
Indicies of the matched stars in the starlist.
-
+
Output:
-------
idx_label_f: array of indicies in the label catalog that fulfill the restrict
@@ -122,15 +122,15 @@ def restrict_by_use(label_mat, starlist_mat, idx_label, idx_starlist):
idx_starlist_f: array of indicies in the starlist that fulfill the restrict
condition
-
-
+
+
label_trim: astropy table
label table with only use > 2 stars
starlist_trim: astropy table
reference table with only stars that correspond to use > 2 stars
in the label_mat table.
-
+
"""
print( 'Restrict option activated')
@@ -151,7 +151,7 @@ def restrict_by_use(label_mat, starlist_mat, idx_label, idx_starlist):
print( 'Restrict option activated')
print(( 'Keeping {0} of {1} stars'.format(len(idx_restrict),
len(label_mat))))
-
+
return idx_label_f, idx_starlist_f
@@ -188,7 +188,7 @@ def read_label(labelFile, prop_to_time=None, flipX=True):
If true, multiply the x positions and velocities by -1.0. This is
useful when label.dat has +x to the east, while reference starlist
has +x to the west.
-
+
#OLD# tref: reference epoch that label.dat is converted to.
Output:
@@ -196,11 +196,11 @@ def read_label(labelFile, prop_to_time=None, flipX=True):
labelFile: astropy.table.
containing name, m, x0, y0, x0e, y0e, vx, vy, vxe, vye, t0, use, r0,
(if prop_to_time: x, y, xe, ye, t)
-
+
x and y is in arcsec,
converted to tref epoch,
*(-1) so it increases to west
-
+
vx, vy, vxe, vye is converted to arcsec/yr
"""
@@ -248,7 +248,7 @@ def read_label(labelFile, prop_to_time=None, flipX=True):
t_label['y'].format = '.5f'
t_label['xe'].format = '.5f'
t_label['ye'].format = '.5f'
-
+
# flip the x axis if flipX is True
if flipX == True:
t_label['x0'] = t_label['x0'] * (-1.0)
@@ -295,7 +295,7 @@ def read_label_accel(labelFile, prop_to_time=None, flipX=True):
If true, multiply the x positions and velocities by -1.0. This is
useful when label.dat has +x to the east, while reference starlist
has +x to the west.
-
+
#OLD# tref: reference epoch that label.dat is converted to.
Output:
@@ -303,11 +303,11 @@ def read_label_accel(labelFile, prop_to_time=None, flipX=True):
labelFile: astropy.table.
containing name, m, x0, y0, x0e, y0e, vx, vy, vxe, vye, t0, use, r0,
(if prop_to_time: x, y, xe, ye, t)
-
+
x and y is in arcsec,
converted to tref epoch,
*(-1) so it increases to west
-
+
vx, vy, vxe, vye is converted to arcsec/yr
"""
@@ -411,21 +411,21 @@ def read_starlist(starlistFile, error=True):
col7: corr
col8: N_frames
col9: ? (left as default)
-
+
error: boolean (default=True)
If true, assumes starlist has error columns. This significantly
changes the order of the columns.
-
+
Output:
------
starlist astropy table.
containing: name, m, x, y, xe, ye, t
"""
- t_ref = Table.read(starlistFile, format='ascii', delimiter='\s')
+ t_ref = Table.read(starlistFile, format='ascii', delimiter=r'\s')
# Check if this already has column names:
cols = t_ref.colnames
-
+
if cols[0] != 'col1':
t_ref['name'] = t_ref['name'].astype(str)
return t_ref
@@ -436,7 +436,7 @@ def read_starlist(starlistFile, error=True):
t_ref.rename_column(cols[2], 't')
t_ref.rename_column(cols[3], 'x')
t_ref.rename_column(cols[4], 'y')
-
+
if error==True:
t_ref.rename_column(cols[5], 'xe')
t_ref.rename_column(cols[6], 'ye')
@@ -449,61 +449,56 @@ def read_starlist(starlistFile, error=True):
t_ref.rename_column(cols[6], 'corr')
t_ref.rename_column(cols[7], 'N_frames')
t_ref.rename_column(cols[8], 'flux')
-
+
return t_ref
class StarList(Table):
- """
- A StarList is an astropy.Table with star catalog from a single image.
-
- Required table columns (input as keywords):
- -------------------------
- name : 1D numpy.array with shape = N_stars
- List of names of the stars in the table.
+ def __init__(self, *args, **kwargs):
+ """
+ A StarList is an astropy.Table with star catalog from a single image.
- x : 1D numpy.array with shape = N_stars
- Positions of N_stars in the x dimension.
+ Required table columns (input as keywords):
+ -------------------------
+ name : 1D numpy.array with shape = N_stars
+ List of names of the stars in the table.
- y : 1D numpy.array with shape = N_stars
- Positions of N_stars in the y dimension.
+ x : 1D numpy.array with shape = N_stars
+ Positions of N_stars in the x dimension.
- m : 1D numpy.array with shape = N_stars
- Magnitudes of N_stars.
+ y : 1D numpy.array with shape = N_stars
+ Positions of N_stars in the y dimension.
- Optional table columns (input as keywords):
- -------------------------
- xe : 1D numpy.array with shape = N_stars
- Position uncertainties of N_stars in the x dimension.
+ m : 1D numpy.array with shape = N_stars
+ Magnitudes of N_stars.
- ye : 1D numpy.array with shape = N_stars
- Position uncertainties of N_stars in the y dimension.
+ Optional table columns (input as keywords):
+ -------------------------
+ xe : 1D numpy.array with shape = N_stars
+ Position uncertainties of N_stars in the x dimension.
- me : 1D numpy.array with shape = N_stars
- Magnitude uncertainties of N_stars.
-
- corr : 1D numpy.array with shape = N_stars
- Fitting correlation of N_stars.
+ ye : 1D numpy.array with shape = N_stars
+ Position uncertainties of N_stars in the y dimension.
- Optional table meta data
- -------------------------
- list_name : str
- Name of the starlist.
+ me : 1D numpy.array with shape = N_stars
+ Magnitude uncertainties of N_stars.
- list_time : int or float
- Time/date of the starlist.
+ corr : 1D numpy.array with shape = N_stars
+ Fitting correlation of N_stars.
+ Optional table meta data
+ -------------------------
+ list_name : str
+ Name of the starlist.
- """
-
- def __init__(self, *args, **kwargs):
- """
+ list_time : int or float
+ Time/date of the starlist.
"""
# Check if the required arguments are present
arg_req = ('name', 'x', 'y', 'm')
found_all_required = True
-
+
for arg_test in arg_req:
if arg_test not in kwargs:
found_all_required = False
@@ -526,6 +521,7 @@ def __init__(self, *args, **kwargs):
# Check if the type and size of the arguments are correct.
# Name checking: type and shape
+ kwargs['name'] = np.asarray(kwargs['name'])
if (not isinstance(kwargs['name'], np.ndarray)) or (
len(kwargs['name']) != n_stars):
err_msg = "The '{0:s}' argument has to be a numpy array "
@@ -544,8 +540,8 @@ def __init__(self, *args, **kwargs):
raise TypeError(err_msg.format(arg_test))
if kwargs[arg_test].shape != (n_stars,):
- err_msg = "The '{0:s}' argument has to have shape = ({1:d},)"
- raise TypeError(err_msg.format(arg_test, n_stars))
+ err_msg = "The '{0:s}' argument has to have shape = ({1:d},), but has shape = {2}"
+ raise TypeError(err_msg.format(arg_test, n_stars, kwargs[arg_test].shape))
# We have to have special handling of meta-data
meta_tab = ('list_time', 'list_name')
@@ -583,7 +579,7 @@ def __init__(self, *args, **kwargs):
self.add_column(MaskedColumn(data=kwargs[arg], name=arg))
else:
self.add_column(Column(data=kwargs[arg], name=arg))
-
+
return
@classmethod
@@ -624,7 +620,7 @@ def from_lis_file(cls, filename, error=True, fvu_file=None):
------
starlists.StarList() object (subclass of Astropy Table).
"""
- t_ref = Table.read(filename, format='ascii', delimiter='\s')
+ t_ref = Table.read(filename, format='ascii', delimiter=r'\s')
# Check if this already has column names:
cols = t_ref.colnames
@@ -641,22 +637,22 @@ def from_lis_file(cls, filename, error=True, fvu_file=None):
t_ref.rename_column(cols[2], 't')
t_ref.rename_column(cols[3], 'x')
t_ref.rename_column(cols[4], 'y')
-
+
if error==True:
t_ref.rename_column(cols[5], 'xe')
t_ref.rename_column(cols[6], 'ye')
- t_ref.rename_column(cols[7], 'snr')
+ t_ref.rename_column(cols[7], 'me')
t_ref.rename_column(cols[8], 'corr')
t_ref.rename_column(cols[9], 'N_frames')
t_ref.rename_column(cols[10], 'flux')
else:
- t_ref.rename_column(cols[5], 'snr')
+ t_ref.rename_column(cols[5], 'me')
t_ref.rename_column(cols[6], 'corr')
t_ref.rename_column(cols[7], 'N_frames')
t_ref.rename_column(cols[8], 'flux')
-
- if ('me' not in cols) and ('snr' in cols) and (error == True):
- t_ref['me'] = 1.0 / t_ref['snr']
+
+ # if ('me' not in cols) and ('snr' in cols) and (error == True):
+ # t_ref['me'] = 1.0 / t_ref['snr']
if fvu_file is not None:
t_fvu = Table.read(fvu_file, format='ascii.no_header')
@@ -667,16 +663,16 @@ def from_lis_file(cls, filename, error=True, fvu_file=None):
msg = 'Star list and metric list have different lengths.\n'
msg += '\t len(stars) = {0:d}\n'
msg += '\t len(fvu) = {1:d}\n'
-
+
raise RuntimeError(msg.format(len(t_ref), len(t_fvu)))
-
- t_ref = astropy.table.hstack([t_ref, t_fvu])
+
+ t_ref = astropy.table.hstack([t_ref, t_fvu])
return cls.from_table(t_ref)
def to_lis_file(self, filename):
_out = open(filename, 'w')
-
+
hdr = '{name:13s} {mag:>6s} {year:>8s} '
hdr += '{x:>9s} {y:>9s} {xe:>9s} {ye:>9s} '
hdr += '{snr:>20s} {corr:>6s} {nimg:>8s} {flux:>20s}\n'
@@ -684,7 +680,7 @@ def to_lis_file(self, filename):
_out.write(hdr.format(name='# name', mag='m', year='t',
x='x', y='y', xe='xe', ye='ye',
snr='snr', corr='corr', nimg='N_frames', flux='flux'))
-
+
fmt = '{name:13s} {mag:6.3f} {year:8.3f} '
fmt += '{x:9.3f} {y:9.3f} {xe:9.3f} {ye:9.3f} '
@@ -697,10 +693,10 @@ def to_lis_file(self, filename):
flux=self['flux'][ss]))
_out.close()
-
+
return
-
-
+
+
@classmethod
def from_table(cls, table):
"""
@@ -709,7 +705,7 @@ def from_table(cls, table):
will be added to the new StarList object that is returned.
"""
starlist = cls(name=table['name'], x=table['x'], y=table['y'], m=table['m'], meta=table.meta)
-
+
for col in table.colnames:
if col in ['name', 'x', 'y', 'm']:
continue
@@ -721,10 +717,10 @@ def from_table(cls, table):
def fubar(self):
print('This is in StarList')
return
-
+
def restrict_by_value(self, **kwargs):
"""
- Restrict a table to any min/max range of column values. For instance,
+ Restrict a table to any min/max range of column values. For instance,
to restrict to only stars between 10 <= m <= 15, use:
starlist.restrict_by_value(m_min=10, m_max=15)
@@ -732,31 +728,31 @@ def restrict_by_value(self, **kwargs):
where 'm' was the column name.
This function acts on self, so the rows are removed
- forever.
+ forever.
"""
# Loop through all conditions and build up
- # an array of indicies of rows to remove.
+ # an array of indicies of rows to remove.
remove_flag = np.zeros(len(self), dtype=bool)
-
- for kwarg in kwargs:
- if kwargs[kwarg] is not None:
+
+ for key, value in kwargs.items():
+ if value is not None:
# Get the name of the column to act on and
# whether the condition is min or max.
- kwarg_split = kwarg.split('_')
+ key_split = key.split('_')
+
+ # Support column names such as x_0.
+ col = '_'.join(key_split[:-1])
- # Support column names such as x_0.
- col = '_'.join(kwarg_split[:-1])
+ if key_split[-1] == 'min':
+ remove_flag = np.logical_or(remove_flag, self[col] <= value)
- if kwarg_split[-1] == 'min':
- remove_flag = np.logical_or(remove_flag, self[col] <= kwargs[kwarg])
-
- if kwarg_split[-1] == 'max':
- remove_flag = np.logical_or(remove_flag, self[col] >= kwargs[kwarg])
+ if key_split[-1] == 'max':
+ remove_flag = np.logical_or(remove_flag, self[col] >= value)
rem_idx = np.where(remove_flag == True)[0]
-
+
self.remove_rows(rem_idx)
-
+
return
def transform_xym(self, trans):
@@ -769,7 +765,7 @@ def transform_xym(self, trans):
self.transform_xy(trans)
self.transform_m(trans)
-
+
return
def transform_xy(self, trans):
@@ -781,7 +777,7 @@ def transform_xy(self, trans):
"""
if trans == None:
return
-
+
x_T, y_T = trans.evaluate(self['x'], self['y'])
self['x'] = x_T
self['y'] = y_T
@@ -792,7 +788,7 @@ def transform_xy(self, trans):
self['ye'] = ye_T
return
-
+
def transform_m(self, trans):
"""
Apply a transformation (instance of flystar.transforms.Transform2D)
@@ -802,14 +798,14 @@ def transform_m(self, trans):
"""
if trans == None:
return
-
+
m_T = trans.evaluate_mag(self['m'])
self['m'] = m_T
if 'me' in self.colnames:
me_T = trans.evaluate_magerror(self['m'], self['me'])
self['me'] = me_T
-
+
return
diff --git a/flystar/startables.py b/flystar/startables.py
index d75fca9..367436a 100644
--- a/flystar/startables.py
+++ b/flystar/startables.py
@@ -1,5 +1,5 @@
from astropy.table import Table, Column, MaskedColumn, hstack
-from astropy.stats import sigma_clipping
+from astropy.stats import sigma_clip
from astropy.time import Time
from scipy.optimize import curve_fit
from tqdm import tqdm
@@ -11,78 +11,75 @@
import copy
from flystar import motion_model
import pandas as pd
-
+from flystar.motion_model import Empty, Fixed, Linear
+from pandas.api.types import is_string_dtype
+from collections.abc import Iterable
class StarTable(Table):
- """
- A StarTable is an astropy.Table with stars matched from multiple starlists.
+ def __init__(self, *args, ref_list=0, **kwargs):
+ """
+ A StarTable is an astropy.Table with stars matched from multiple starlists.
- Required table columns (input as keywords):
- -------------------------
- name : 1D numpy.array with shape = N_stars
- List of unique names for each of the stars in the table.
+ Required table columns (input as keywords):
+ -------------------------
+ name : 1D numpy.array with shape = N_stars
+ List of unique names for each of the stars in the table.
- x : 2D numpy.array with shape = (N_stars, N_lists)
- Positions of N_stars in each of N_lists in the x dimension.
+ x : 2D numpy.array with shape = (N_stars, N_lists)
+ Positions of N_stars in each of N_lists in the x dimension.
- y : 2D numpy.array with shape = (N_stars, N_lists)
- Positions of N_stars in each of N_lists in the y dimension.
+ y : 2D numpy.array with shape = (N_stars, N_lists)
+ Positions of N_stars in each of N_lists in the y dimension.
- m : 2D numpy.array with shape = (N_stars, N_lists)
- Magnitudes of N_stars in each of N_lists.
+ m : 2D numpy.array with shape = (N_stars, N_lists)
+ Magnitudes of N_stars in each of N_lists.
- Optional table columns (input as keywords):
- -------------------------
- motion_model : 1D numpy.array with shape = N_stars
- string indicating motion model type for each star
-
- xe : 2D numpy.array with shape = (N_stars, N_lists)
- Position uncertainties of N_stars in each of N_lists in the x dimension.
+ Optional table columns (input as keywords):
+ -------------------------
+ motion_model : 1D numpy.array with shape = N_stars
+ string indicating motion model type for each star
- ye : 2D numpy.array with shape = (N_stars, N_lists)
- Position uncertainties of N_stars in each of N_lists in the y dimension.
+ xe : 2D numpy.array with shape = (N_stars, N_lists)
+ Position uncertainties of N_stars in each of N_lists in the x dimension.
- me : 2D numpy.array with shape = (N_stars, N_lists)
- Magnitude uncertainties of N_stars in each of N_lists.
+ ye : 2D numpy.array with shape = (N_stars, N_lists)
+ Position uncertainties of N_stars in each of N_lists in the y dimension.
- ep_name : 2D numpy.array with shape = (N_stars, N_lists)
- Names in each epoch for each of N_stars in each of N_lists. This is
- useful for tracking purposes.
-
- corr : 2D numpy.array with shape = (N_stars, N_lists)
- Fitting correlation for each of N_stars in each of N_lists.
+ me : 2D numpy.array with shape = (N_stars, N_lists)
+ Magnitude uncertainties of N_stars in each of N_lists.
- Optional table meta data
- -------------------------
- list_names : list of strings
- List of names, one for each of the starlists.
+ ep_name : 2D numpy.array with shape = (N_stars, N_lists)
+ Names in each epoch for each of N_stars in each of N_lists. This is
+ useful for tracking purposes.
- list_times : list of integers or floats
- List of times/dates for each starlist.
+ corr : 2D numpy.array with shape = (N_stars, N_lists)
+ Fitting correlation for each of N_stars in each of N_lists.
- ref_list : int
- Specify which list is the reference list (if any).
+ Optional table meta data
+ -------------------------
+ list_names : list of strings
+ List of names, one for each of the starlists.
- Examples
- --------------------------
+ list_times : list of integers or floats
+ List of times/dates for each starlist.
- t = startables.StarTable(name=name, x=x, y=y, m=m)
+ ref_list : int
+ Specify which list is the reference list (if any).
- # Access the data:
- print(t)
- print(t['name'][0:10]) # print the first 10 star names
- print(t['x'][0:10, 0]) # print x from the first epoch/list/column for the first 10 stars
- """
- def __init__(self, *args, ref_list=0, **kwargs):
- """
+ Examples
+ --------------------------
+
+ t = startables.StarTable(name=name, x=x, y=y, m=m)
+
+ # Access the data:
+ print(t)
+ print(t['name'][0:10]) # print the first 10 star names
+ print(t['x'][0:10, 0]) # print x from the first epoch/list/column for the first 10 stars
"""
-
+
# Check if the required arguments are present
arg_req = ('name', 'x', 'y', 'm')
-
- found_all_required = True
- for arg_test in arg_req:
- if arg_test not in kwargs:
- found_all_required = False
+
+ found_all_required = all(arg in kwargs for arg in arg_req)
if not found_all_required:
if len(args) > 1: # If there are no arguments, it's because the
@@ -105,9 +102,9 @@ def __init__(self, *args, ref_list=0, **kwargs):
# Check if the type and size of the arguments are correct.
# Name checking: type and shape
if (not isinstance(kwargs['name'], np.ndarray)) or (len(kwargs['name']) != n_stars):
- err_msg = "The '{0:s}' argument has to be a numpy array "
- err_msg += "with length = {1:d}"
- raise TypeError(err_msg.format('name', n_stars))
+ err_msg = f"The 'name' argument has to be a numpy array, not {type(kwargs['name'])};"
+ err_msg += f"Its length should be {n_stars}, not {len(kwargs['name'])}."
+ raise TypeError(err_msg)
# Check all the 2D arrays.
arg_tab = ('x', 'y', 'm', 'xe', 'ye', 'me', 'name_in_list')
@@ -115,21 +112,22 @@ def __init__(self, *args, ref_list=0, **kwargs):
for arg_test in arg_tab:
if arg_test in kwargs:
if not isinstance(kwargs[arg_test], np.ndarray):
- err_msg = "The '{0:s}' argument has to be a numpy array"
- raise TypeError(err_msg.format(arg_test))
+ err_msg = f"The '{arg_test}' argument has to be a numpy array, not {type(kwargs[arg_test])}"
+ raise TypeError(err_msg)
if kwargs[arg_test].shape != (n_stars, n_lists):
- err_msg = "The '{0:s}' argument has to have shape = ({1:d}, {2:d})"
- raise TypeError(err_msg.format(arg_test, n_stars, n_lists))
+ err_msg = f"The '{arg_test}' argument has to have shape = ({n_stars}, {n_lists})"
+ raise TypeError(err_msg)
# Check that the reference list is specified.
if ref_list not in range(n_lists):
- err_msg = "The 'ref_list' argument has to be an integer between 0 and {0:d}"
- raise IndexError(err_msg.format(n_lists-1))
+ err_msg = f"The 'ref_list' argument has to be an integer between 0 and {n_lists-1}"
+ raise IndexError(err_msg)
# We have to have special handling of meta-data (i.e. info that has
# dimensions of n_lists).
meta_tab = ('list_times', 'list_names')
+ meta_tab = ('list_times', 'list_names')
meta_type = ((float, int), str)
for mm in range(len(meta_tab)):
meta_test = meta_tab[mm]
@@ -137,13 +135,12 @@ def __init__(self, *args, ref_list=0, **kwargs):
if meta_test in kwargs:
if len(kwargs[meta_test]) != n_lists:
- err_msg = "The '{0:s}' argument has to have length = {1:d}"
- raise ValueError(err_msg.format(meta_test, n_lists))
+ err_msg = f"The '{meta_test}' argument has to have length = {n_lists}"
+ raise ValueError(err_msg)
if not all(isinstance(tt, meta_type_test) for tt in kwargs[meta_test]):
- err_msg = "The '{0:s}' argument has to be a list of {1:s}."
- raise TypeError(err_msg.format(meta_test, str(meta_type_test)))
-
+ err_msg = f"The '{meta_test}' argument has to be a list of {str(meta_type_test)}."
+ raise TypeError(err_msg)
#####
# Create the startable
#####
@@ -161,7 +158,7 @@ def __init__(self, *args, ref_list=0, **kwargs):
del kwargs[meta_arg]
for arg in kwargs:
- if arg in ['name', 'x', 'y', 'm']:
+ if arg in ['name', 'x', 'y', 'm', 'list_times', 'list_names']:
continue
else:
self.add_column(Column(data=kwargs[arg], name=arg))
@@ -175,12 +172,12 @@ def __init__(self, *args, ref_list=0, **kwargs):
# self['motion_model_input'] = np.repeat(self.default_motion_model, len(self['name']))
return
-
+
def add_starlist(self, **kwargs):
"""
- Add data from a new list to an existing StarTable.
+ Add data from a new list to an existing StarTable.
Note, you can pass in the data via a StarList object or
- via a series of keywords with a 1D array on each.
+ via a series of keywords with a 1D array on each.
In either case, the number of stars must already match
the existing number of stars in the StarTable.
@@ -216,16 +213,16 @@ def _add_list_data_from_starlist(self, starlist):
old_type = self[col_name].info.dtype
new_data = np.empty((old_data.shape[0], old_data.shape[1] + 1), dtype=old_type)
new_data[:, :-1] = old_data
-
+
# Save the new data array (with both old and new data in it) to the table.
- self[col_name] = new_data
-
+ self[col_name] = new_data
+
if (col_name in starlist.colnames): # Add data if it was input
self[col_name][:, -1] = starlist[col_name]
else: # Add junk data it if wasn't input
self._set_invalid_list_values(col_name, -1)
-
-
+
+
##########
# Update the table meta-data. Remember that entries are lists not numpy arrays.
##########
@@ -234,38 +231,38 @@ def _add_list_data_from_starlist(self, starlist):
lis_meta_keys = list(starlist.meta.keys())
# append 's' to the end to pluralize the input starlist.
lis_meta_keys_plural = [lis_meta_key + 's' for lis_meta_key in lis_meta_keys]
-
+
for kk in range(len(tab_meta_keys)):
tab_key = tab_meta_keys[kk]
# Meta table entries with a size that matches the n_lists size are the ones
# that need a new value. We have to add something... whatever was passed in or None
- if isinstance(self.meta[tab_key], collections.abc.Iterable) and (len(self.meta[tab_key]) == self.meta['n_lists']) and (not isinstance(self.meta[tab_key], str)):
+ if isinstance(self.meta[tab_key], Iterable) and (len(self.meta[tab_key]) == self.meta['n_lists']) and (not isinstance(self.meta[tab_key], str)):
# If we find the key in the starlists' meta argument, then add the new values.
# Otherwise, add "None".
- idx = np.where(lis_meta_keys_plural == tab_key)[0]
- if len(idx) > 0:
- lis_key = lis_meta_keys[idx[0]]
+ idx = lis_meta_keys_plural.index(tab_key) if tab_key in lis_meta_keys_plural else None
+ if idx is not None:
+ lis_key = lis_meta_keys[idx]
self.meta[tab_key] = np.append(self.meta[tab_key], [starlist.meta[lis_key]])
else:
self._append_invalid_meta_values(tab_key)
# Update the n_lists meta keyword.
self.meta['n_lists'] += 1
-
+
return
-
-
+
+
def _add_list_data_from_keywords(self, **kwargs):
# # Check if the required arguments are present
# arg_req = ('x', 'y', 'm')
-
+
# for arg_test in arg_req:
# if arg_test not in kwargs:
# err_msg = "Added lists require a '{0:s}' argument"
# raise TypeError(err_msg.format(arg_test))
-
+
# # If we have errors, we need them in both dimensions.
# if ('xe' in kwargs) ^ ('ye' in kwargs):
# raise TypeError("Added lists with errors require both 'xe' and" +
@@ -283,21 +280,21 @@ def _add_list_data_from_keywords(self, **kwargs):
old_type = self[col_name].info.dtype
new_data = np.empty((old_data.shape[0], old_data.shape[1] + 1), dtype=old_type)
new_data[:, :-1] = old_data
-
+
# Save the new data array (with both old and new data in it) to the table.
self[col_name] = new_data
-
+
if (col_name in kwargs): # Add data if it was input
self[col_name][:, -1] = kwargs[col_name]
else: # Add junk data it if wasn't input
self._set_invalid_list_values(col_name, -1)
-
+
# Update the table meta-data. Remember that entries are lists not numpy arrays.
for key in self.meta.keys():
# Meta table entries with a size that matches the n_lists size are the ones
# that need a new value. We have to add something... whatever was passed in or None
- if isinstance(self.meta[key], collections.abc.Iterable) and (len(self.meta[key]) == self.meta['n_lists']) and (not isinstance(self.meta[key], str)):
+ if isinstance(self.meta[key], Iterable) and (len(self.meta[key]) == self.meta['n_lists']) and (not isinstance(self.meta[key], str)):
# If we find the key is the passed in meta argument, then add the new values.
# Otherwise, add "None".
if 'meta' in kwargs:
@@ -311,7 +308,7 @@ def _add_list_data_from_keywords(self, **kwargs):
# Update the n_lists meta keyword.
self.meta['n_lists'] += 1
-
+
return
def _set_invalid_list_values(self, col_name, col_idx):
@@ -325,7 +322,7 @@ def _set_invalid_list_values(self, col_name, col_idx):
self[col_name][:, col_idx] = np.nan
else:
self[col_name][:, col_idx] = None
-
+
return
def _set_invalid_star_values(self, col_name, row_idx):
@@ -339,13 +336,13 @@ def _set_invalid_star_values(self, col_name, row_idx):
self[col_name][row_idx] = np.nan
else:
self[col_name][row_idx] = None
-
+
return
-
+
def _append_invalid_meta_values(self, key):
"""
- For an existing meta keyword that is a list (already known),
- add an invalid value depending on the type.
+ For an existing meta keyword that is a list (already known),
+ add an invalid value depending on the type.
"""
if issubclass(type(self.meta[key][0]), np.integer):
self.meta[key] = np.append(self.meta[key], [-1])
@@ -361,11 +358,11 @@ def _append_invalid_meta_values(self, key):
warnings.warn(err_msg, UserWarning)
return
-
-
+
+
def get_starlist(self, list_index):
"""
- Return a StarList object for the specified list_index or epoch.
+ Return a StarList object for the specified list_index or epoch.
Parameters
----------
@@ -385,26 +382,26 @@ def get_starlist(self, list_index):
col_req_dict[col_name] = self[col_name]
starlist = StarList(**col_req_dict)
-
+
for col_name in self.colnames:
if col_name in col_req_names:
pass
-
+
if len(self[col_name].data.shape) == 2: # Find the 2D columns
starlist[col_name] = self[col_name][:, list_index]
else:
starlist[col_name] = self[col_name]
-
+
return starlist
- def combine_lists_xym(self, weighted_xy=True, weighted_m=True, mask_lists=False, sigma=3):
+ def combine_lists_xym(self, weighted_xy=True, weighted_m=True, mask_lists=None, sigma=3):
"""
For x, y and m columns in the table, collapse along the lists
direction. For 'x', 'y' this means calculating the average position with
outlier rejection. Optionally, weight by the 'xe' and 'ye' individual
uncertainties. Optionally, use sigma clipping.
- "mask_lists" is a list with the indices of starlists that are
+ "mask_lists" is a list with the indices of starlists that are
excluded from the combination.
Also, count the number of times a star is found in starlists.
"""
@@ -421,15 +418,15 @@ def combine_lists_xym(self, weighted_xy=True, weighted_m=True, mask_lists=False,
weights_colm = 'me'
else:
weights_colm = None
-
+
self.combine_lists('x', weights_col=weights_colx, mask_lists=mask_lists, sigma=sigma)
self.combine_lists('y', weights_col=weights_coly, mask_lists=mask_lists, sigma=sigma)
self.combine_lists('m', weights_col=weights_colm, mask_lists=mask_lists, sigma=sigma, ismag=True)
-
+
return
def combine_lists(self, col_name_in, weights_col=None, mask_val=None,
- mask_lists=False, meta_add=True, ismag=False, sigma=3):
+ mask_lists=None, meta_add=True, ismag=False, sigma=3):
"""
For the specified column (col_name_in), collapse along the starlists
direction and calculated the average value, with outlier rejection.
@@ -439,75 +436,78 @@ def combine_lists(self, col_name_in, weights_col=None, mask_val=None,
0e -- the std (with outlier rejection)
Masking of NaN values is also performed.
-
- "mask_lists" is a list with the indices of starlists that are
+
+ "mask_lists" is a list with the indices of starlists that are
excluded from the combination.
-
+
A flag can be stored in the metadata to record if the average was
weighted or not.
"""
- # Get the array we are going to combine. Make a copy so we don't mod it.
- val_2d = copy.deepcopy( self[col_name_in].data )
+ if mask_lists is not None:
+ # Extract list of indices that we want to keep (i.e. not mask)
+ mask_lists = np.atleast_1d(mask_lists)
+ assert mask_lists.dtype == int, "mask_lists needs to be a list of integers."
+ list_indices = np.array([i for i in np.arange(self[col_name_in].data.shape[1]) if i not in mask_lists])
+ else:
+ # Use all indices
+ list_indices = np.arange(self[col_name_in].data.shape[1])
+
+ val_2d = np.ma.masked_invalid(self[col_name_in].data[:, list_indices])
if ismag:
# Convert to flux.
- val_2d = 10**(-val_2d / 2.5)
+ val_2d = 10**(-0.4 * val_2d)
# Make a mask of invalid (NaN) values and a user-specified invalid value.
- val_2d = np.ma.masked_invalid(val_2d)
+
if mask_val:
val_2d = np.ma.masked_values(val_2d, mask_val)
-
- if mask_lists is not False:
- # Remove a list
- if isinstance(mask_lists, list):
- if all(isinstance(item, int) for item in mask_lists):
- val_2d.mask[:, mask_lists] = True
-
- # Throw a warning if mask_lists is not a list
- if not isinstance(mask_lists, list):
- raise RuntimeError('mask_lists needs to be a list.')
+
+ # Figure out which ones are outliers. Returns a masked array.
+ if sigma:
+ # with warnings.catch_warnings():
+ # warnings.filterwarnings('ignore', category=RuntimeWarning)
+ val_2d_clip = sigma_clip(val_2d, sigma=sigma, maxiters=5, axis=1)
+ else:
+ val_2d_clip = val_2d
# Decide if we are going to have weights (before we
# do the expensive sigma clipping routine). Note that
- # if we have only 1 column to average, then we can't do weighting.
+ # if we have only 1 column to average, then we can't do weighting.
if (weights_col and weights_col in self.colnames) and (val_2d.shape[1] > 1):
- err_2d = self[weights_col].data
-
+ err_2d = np.ma.masked_invalid(self[weights_col].data[:, list_indices])
+
if ismag:
# Convert to flux error
- err_2d = err_2d * val_2d * np.log(10) / 2.5
-
- np.seterr(divide='ignore')
- wgt_2d = np.ma.masked_invalid(1.0 / err_2d**2)
- np.seterr(divide='warn')
-
+ err_2d = 0.4 * np.log(10) * val_2d * err_2d
+
+ # Unify masks
+ unified_mask = val_2d_clip.mask | err_2d.mask
+ val_2d_clip.mask = unified_mask
+ err_2d.mask = unified_mask
+
+ # Inverse variance weights minimize the propagated uncertainty
+ wgt_2d = np.ma.masked_invalid(1. / err_2d**2)
+
+ # Calculate the weighted mean and uncertainty
+ avg = np.ma.average(val_2d_clip, weights=wgt_2d, axis=1)
+ std = np.ma.sqrt(1 / np.ma.sum(wgt_2d, axis=1)) # Error propagation for weighted mean
+
if meta_add:
self.meta[col_name_in + '0'] = 'weighted'
else:
wgt_2d = None
+ # Calculate the weighted mean and uncertainty
+ avg = np.ma.mean(val_2d_clip, axis=1)
+ std = np.ma.std(val_2d_clip, axis=1) / np.sqrt(len(list_indices)) # Standard error of the mean
+
if meta_add:
self.meta[col_name_in + '0'] = 'not_weighted'
- # Figure out which ones are outliers. Returns a masked array.
- if sigma:
- warnings.filterwarnings('ignore', category=RuntimeWarning)
- val_2d_clip = sigma_clipping.sigma_clip(val_2d, sigma=sigma, maxiters=5, axis=1)
- warnings.filterwarnings('default', category=RuntimeWarning)
- else:
- val_2d_clip = val_2d
-
- # Calculate the (weighted) mean and standard deviation along
- # the N_lists direction (axis=1).
- if wgt_2d is not None:
- avg = np.ma.average(val_2d_clip, weights=wgt_2d, axis=1)
- std = np.sqrt(np.ma.average((val_2d_clip.T - avg).T**2, weights=wgt_2d, axis=1))
- else:
- avg = np.ma.mean(val_2d_clip, axis=1)
- std = np.ma.std(val_2d_clip, axis=1)
+ # FIXME: What does this part do?
# To Do: bring the previous uncertainties of stars that are detected
# in only one input frame.
if (weights_col and weights_col in self.colnames) and (val_2d.shape[1] > 1):
- mask_for_singles = ((~np.isnan(val_2d_clip)).sum(axis=1)==1)
+ mask_for_singles = ((np.isfinite(val_2d_clip)).sum(axis=1)==1)
std[mask_for_singles]=np.nanmean(err_2d[mask_for_singles], axis=1)
# Save off our new AVG and STD into new columns with shape (N_stars).
@@ -515,355 +515,609 @@ def combine_lists(self, col_name_in, weights_col=None, mask_val=None,
col_name_std = col_name_in + '0_err'
if ismag:
- std = (2.5 / np.log(10)) * std / avg
+ std = 2.5 / np.log(10) * std / avg # Error propagation
avg = -2.5 * np.ma.log10(avg)
+
+ # Fill mask with nan or inf
+ avg = avg.filled(np.nan)
+ std = std.filled(np.inf)
+
if col_name_avg in self.colnames:
- self[col_name_avg] = avg.data
- self[col_name_std] = std.data
+ self[col_name_avg] = avg
+ self[col_name_std] = std
else:
- self.add_column(Column(data=avg.data, name=col_name_avg))
- self.add_column(Column(data=std.data, name=col_name_std))
-
+ self.add_column(Column(data=avg, name=col_name_avg))
+ self.add_column(Column(data=std, name=col_name_std))
+
return
def detections(self):
"""
Find where stars are detected.
# """
- n_detect = np.sum(~np.isnan(self['x']), axis=1)
-
+ n_detect = np.sum(np.isfinite(self['x']) & np.isfinite(self['y']), axis=1)
+
if 'n_detect' in self.colnames:
self['n_detect'] = n_detect
else:
- self.add_column(Column(n_detect), name='n_detect')
-
+ self.add_column(Column(data=n_detect, name='n_detect'))
+
return
-
- def fit_velocities(self, weighting='var', use_scipy=True, absolute_sigma=True, bootstrap=0,
- fixed_t0=False, verbose=False, mask_val=None, mask_lists=False, show_progress=True,
- default_motion_model='Linear', reassign_motion_model=False, select_stars=None, motion_model_dict={}):
- """Fit velocities for all stars in the table and add to the columns 'vx', 'vxe', 'vy', 'vye', 'x0', 'x0e', 'y0', 'y0e'.
+
+ def fit_motion_models(
+ self,
+ motion_models=None,
+ fixed_params_dict=None,
+ weighting='var',
+ use_scipy=True,
+ absolute_sigma=True,
+ select_stars=None,
+ bootstrap=0,
+ seed=None,
+ mask_value=None,
+ mask_lists=None,
+ fill_value=np.nan,
+ verbose=True
+ ):
+ """Fit velocity for star table
Parameters
----------
+ motion_models : list of MotionModel or str, optional
+ Motion models to use, by default Empty, Fixed and Linear.
+ Empty and Fixed models are always added automatically for stars with n_fit = 0 or 1.
+ The behavior is as follows:
+ 1. If 'motion_model_input' column is NOT in table:
+ - Use the most complex model that has enough parameters to fit the data (n_fit >= n_params).
+ - If multiple models are supplied, prioritize the model with the most parameters to fit.
+ - If multiple models have the same number of parameters, raise AssertionError: not sure which to use.
+ 2. If 'motion_model_input' column IS in table:
+ - Use the model specified in the 'motion_model_input' column.
+ - If not enough data points to fit the specified model, use the most complex model in any 'motion_model_input' column that has enough parameters to fit the data (n_fit >= n_params) among the provided motion_models and 'motion_model_input'.
+ The actual used motion model is stored in the 'motion_model_used' column. The default motion_models are [Empty, Fixed, Linear].
+ fixed_params_dict : dict, optional
+ Dictionary of fixed parameters for motion models, e.g., {'t0': 0., 'ra': np.array([...]), 'dec': np.array([...])}.
+ - Scalar values are used for all stars, array values should have length = N_stars.
+ - t0 is automatically calculated as np.average(t, weights=1/np.hypot(xe, ye)) if not provided.
+ - The keys should match the fixed parameter names in the motion models. See MotionModel class for details, by default None
weighting : str, optional
- Weight by variance 'var' or standard deviation 'std', by default 'var'
+ Uncertainty weighting, 'std' for weight=1/xe(ye) or 'var' for weight=1/xe(ye)**2, by default 'var'
+ use_scipy : bool, optional
+ Use scipy.optimize.curve_fit or algebraic solution (for Linear model only), by default False
+ absolute_sigma : bool, optional
+ Use absolute sigma or not, see scipy curve_fit for details, by default True
+ select_stars : list of int, optional
+ Indices of stars to fit, by default None (fit all stars)
bootstrap : int, optional
- Calculate uncertainty using bootstraping or not, by default 0
- fixed_t0 : bool or array-like, optional
- Fix the t0 in dt = time - t0 if user provides an array with the same length of the table, or automatically calculate t0 = np.average(time, weights=1/np.hypot(xe, ye)) if False, by default False
+ Number of bootstrap for uncertainty resampling, by default 0
+ seed : int, optional
+ Random seed for bootstrap resampling, by default None
+ mask_value : float, optional
+ Values to mask in data, by default None
+ mask_lists : list of int, optional
+ Indices of lists to mask/exclude from fitting, by default None
+ fill_value : float, optional
+ Fill value when there is not enough data points to fit, by default np.nan
verbose : bool, optional
- Output verbose information or not, by default False
- mask_val : float, optional
- Value that needs to be masked in the data, e.g. -100000, by default None
- mask_lists : list, optional
- Columns that needs to be masked, by default False
- show_progress : bool, optional
- Show progress bar or not, by default True
+ Print verbose messages or not, by default True
+
Raises
------
ValueError
- If weighting is neither 'var' or 'std'
+ If weighting is not 'var' or 'std'.
KeyError
- If there's not time information in the table
+ If time values are not found in the table or meta.
+ KeyError
+ If required columns 'x' and 'y' are missing in the table.
"""
+ ###########################
+ ####### Check Params ######
+ ###########################
if weighting not in ['var', 'std']:
- raise ValueError(f"fit_velocities: Weighting must either be 'var' or 'std', not {weighting}!")
-
+ raise ValueError(f"fit_motion_models: Weighting must either be 'var' or 'std', not {weighting}!")
+
if ('t' not in self.colnames) and ('list_times' not in self.meta):
- raise KeyError("fit_velocities: Failed to access time values. No 't' column in table, no 'list_times' in meta.")
-
+ raise KeyError("fit_motion_models: Failed to access time values. No 't' column in table, no 'list_times' in meta.")
+
# Check if we have the required columns
if not all([_ in self.colnames for _ in ['x', 'y']]):
- raise KeyError(f"fit_velocities: Missing required columns in the table: {', '.join(['x', 'y'])}!")
-
+ raise KeyError(f"fit_motion_models: Missing required columns in the table: {', '.join(['x', 'y'])}!")
+
+ # Make a copy of fixed_params_dict to avoid modifying the original one outside the function
+ fixed_params_dict = copy.deepcopy(fixed_params_dict)
+
+ # Check fixed_params_dict is a dict
+ if fixed_params_dict is not None:
+ if not isinstance(fixed_params_dict, dict):
+ raise ValueError("fit_motion_models: fixed_params_dict must be a dictionary!")
+
+ # Convert motion_models to MotionModel objects if they are strings:
+ if motion_models is None:
+ # Setting the default to None to avoid mutable default argument issue
+ # See https://stackoverflow.com/questions/15189245/assigning-class-variable-as-default-value-to-class-method-argument
+ motion_models = [Empty, Fixed, Linear]
+ all_mm_map = motion_model.motion_model_map()
+ if all(isinstance(mm, str) for mm in motion_models):
+ mm_names = motion_models
+ motion_models = [all_mm_map[mm] for mm in motion_models]
+ else:
+ mm_names = [mm.name for mm in motion_models]
+
+ # Always add Empty and Fixed in motion models
+ if 'Fixed' not in mm_names:
+ motion_models.insert(0, Fixed)
+ if 'Empty' not in mm_names:
+ motion_models.insert(0, Empty)
+ mm_names = [mm.name for mm in motion_models]
+
+ # Construct motion models if motion_model_input column exists
+ if 'motion_model_input' in self.colnames:
+ input_mm_names = np.unique(self['motion_model_input'])
+ assert all([name in all_mm_map.keys() for name in input_mm_names]), \
+ f"fit_motion_models: Unknown motion model name(s) in 'motion_model_input' column. Available motion models are: {', '.join(all_mm_map.keys())}."
+ for mm_name in input_mm_names:
+ if mm_name not in mm_names:
+ motion_models.append(all_mm_map[mm_name])
+
+ # Sort motion models by required epochs
+ motion_models = sorted(motion_models, key=lambda mm: mm.n_params)
+
+ input_mm_map = {mm.name: mm for mm in motion_models}
+
+ mm_n_params = np.sort([mm.n_params for mm in motion_models])
+ if 'motion_model_input' not in self.colnames:
+ # If motion_model_input column is not provided, assert that motion model n_params are unique and sorted
+ # Otherwise the fitter does not know which motion model to use based on n_obs
+ assert len(mm_n_params) == len(set(mm_n_params)), \
+ f"fit_motion_models: Provided motion model n_params are not unique! Motion Models are: {[_.name for _ in motion_models]}" + '\n' + "Cannot decide which motion model to use based on n_obs. Please provide unique motion_models or a 'motion_model_input' column."
+
+
+ ###########################
+ ####### Prepare Data ######
+ ###########################
+ # Prepare data for fitting
N_stars = len(self)
+ N_times = self['x'].data.shape[1]
+ if mask_lists is not None:
+ list_indices = np.array([i for i in range(N_times) if i not in mask_lists])
+ else:
+ list_indices = np.arange(N_times)
+ x_data = np.ma.masked_invalid(self['x'].data[:, list_indices], copy=True)
+ y_data = np.ma.masked_invalid(self['y'].data[:, list_indices], copy=True)
+ xe_data = np.ma.masked_invalid(self['xe'].data[:, list_indices], copy=True) if 'xe' in self.colnames else np.ones_like(x_data)
+ ye_data = np.ma.masked_invalid(self['ye'].data[:, list_indices], copy=True) if 'ye' in self.colnames else np.ones_like(y_data)
+
+ # Mask out close to 0 values to avoid infinite weights
+ if xe_data is not None:
+ xe_data.mask[np.isclose(xe_data, 0)] = True
+ if ye_data is not None:
+ ye_data.mask[np.isclose(ye_data, 0)] = True
+
+ # If all of xe and ye is masked for a star, effectively no uncertainties provided, fill with 1.
+ # Note that this automatically turn the mask to False for these stars
+ if (xe_data is not None) and (ye_data is not None):
+ fill_with_one = np.all(xe_data.mask, axis=1) & np.all(ye_data.mask, axis=1)
+ xe_data[fill_with_one] = 1.
+ ye_data[fill_with_one] = 1.
+
+ # Ensure data is 2D for consistent indexing, even if we have only one list/epoch (shape (N_stars, 1) instead of (N_stars,))
+ if np.ndim(x_data) == 1:
+ x_data = x_data[:, np.newaxis]
+ if np.ndim(y_data) == 1:
+ y_data = y_data[:, np.newaxis]
+ if np.ndim(xe_data) == 1:
+ xe_data = xe_data[:, np.newaxis]
+ if np.ndim(ye_data) == 1:
+ ye_data = ye_data[:, np.newaxis]
+
+ # if mask_lists is not None:
+ # x_data.mask[:, mask_lists] = True
+ # y_data.mask[:, mask_lists] = True
+ # xe_data.mask[:, mask_lists] = True
+ # ye_data.mask[:, mask_lists] = True
+
+ # t_data: 2d array with shape (N_stars, N_epochs)
+ # t0: 1d array with shape (N_stars,)
+ if 't' in self.colnames:
+ t_data = copy.deepcopy(self['t'].data[:, list_indices])
+ else:
+ t_data = copy.deepcopy(np.array(self.meta['list_times']))[list_indices]
+ t_data = np.broadcast_to(t_data, x_data.shape)
+
+ fixed_params_dict = {} if fixed_params_dict is None else fixed_params_dict
+ # Add default t0 if not provided in fixed_params_dict
+ if 't0' not in fixed_params_dict:
+ weights = 1/np.hypot(xe_data, ye_data) if (xe_data is not None) and (ye_data is not None) else None
+ fixed_params_dict['t0'] = np.average(t_data, axis=1, weights=weights)
+ else:
+ if np.ndim(fixed_params_dict['t0']) == 0:
+ fixed_params_dict['t0'] = np.full(N_stars, fixed_params_dict['t0'])
+
+ t0 = fixed_params_dict['t0']
+
+ # Apply mask_value if provided
+ if mask_value:
+ x_data = np.ma.masked_values(x_data, mask_value)
+ y_data = np.ma.masked_values(y_data, mask_value)
+ if xe_data is not None:
+ xe_data = np.ma.masked_values(xe_data, mask_value)
+ if ye_data is not None:
+ ye_data = np.ma.masked_values(ye_data, mask_value)
+
+
+ # Calculate mask array
+ xy_mask = ~ (x_data.mask | y_data.mask)
+ if (xe_data is not None) and (ye_data is not None):
+ xy_mask = xy_mask & (~ (xe_data.mask | ye_data.mask))
+
+ # Calculate n_fit: unmasked x y values
+ # This will be used to determine which motion model to use for each star.
+ # Note that we don't require unique times here
+ # as scipy.curve_fit and Linear algebra can fit non-unique times.
+ # self['n_fit'] = np.sum(xy_mask, axis=1)
+
+ # Calculate n_fit: unique times & unmasked x y values
+ self['n_fit'] = np.array([
+ len(set(t_data[i][xy_mask[i]]))
+ for i in range(N_stars)
+ ])
+
+
+ ###########################
+ ####### Determine MM ######
+ ###########################
+ n_fit = np.array(self['n_fit'])
+ if 'motion_model_input' in self.colnames:
+ # Determine which motion model to use based on motion_model_input column
+ # If n_fit < n_params for the input motion model, use the most complicated motion model with n_fit >= n_params
+ required_params = np.array([all_mm_map[mm_name].n_params for mm_name in self['motion_model_input']])
+ reassign_mm = n_fit < required_params
+
+ mm_digitized = np.digitize(
+ x=n_fit[reassign_mm],
+ bins=mm_n_params
+ ) - 1 # Convert to 0-based index
+
+ # Assign motion models to stars
+ self['motion_model_used'] = self['motion_model_input']
+ self['motion_model_used'][reassign_mm] = np.array([motion_models[d].name for d in mm_digitized], dtype='U20')
- if verbose:
- start_time = time.time()
- msg = 'Starting startable.fit_velocities for {0:d} stars with n={1:d} bootstrap'
- print(msg.format(N_stars, bootstrap))
-
- # Set all to default_motion_model if none assigned already.
- # Reset motion_model_used to the inputs for now -> will change as fits run
- if ('motion_model_input' not in self.colnames) or reassign_motion_model:
- self['motion_model_input'] = default_motion_model
- self['motion_model_used'] = self['motion_model_input']
-
- motion_model_dict = motion_model.validate_motion_model_dict(motion_model_dict, self, default_motion_model)
-
- #
- # Fill table with all possible motion model parameter names as new
- # columns. Make everything empty for now.
- #
- all_motion_models = np.unique(self['motion_model_input'].tolist() + ['Fixed']+[default_motion_model]).tolist()
- new_col_list = motion_model.get_list_motion_model_param_names(all_motion_models, with_errors=True)
- # Append goodness of fit metrics and t0.
+ else:
+ # If motion_model_input column is not provided, use the most complicated model in motion_models with n_fit >= n_params.
+ mm_digitized = np.digitize(
+ x=n_fit,
+ bins=mm_n_params
+ ) - 1 # Convert to 0-based index
+
+ # Assign motion models to stars
+ self['motion_model_used'] = np.array([motion_models[d].name for d in mm_digitized], dtype='U20')
+
+ ############################
+ # Prepare Fixed Parameters #
+ ############################
+ # If required fixed params in self but not provided in fixed_params_dict, add them to fixed_params_dict
+ motion_model_used = [all_mm_map[name] for name in np.unique(self['motion_model_used'])]
+ raise_key_error = False
+ missing_params = []
+ for mm in motion_model_used:
+ # Check required fixed parameters
+ for param in mm.required_fixed_param_names:
+ if param not in fixed_params_dict:
+ # If not provided in fixed_params_dict, it must be in table columns
+ if param in self.colnames:
+ fixed_params_dict[param] = self[param].data
+ else:
+ raise_key_error = True
+ missing_params.append(f"'{param}'")
+
+ # Check optional fixed parameters
+ # Set to default value if not provided in fixed_params_dict or in self
+ for param, value in mm.optional_fixed_params.items():
+ if param not in fixed_params_dict:
+ # If param is not provided in fixed_params_dict
+ if param in self.colnames:
+ # Set to column value if column exists
+ fixed_params_dict[param] = self[param].data
+ else:
+ # Set to default value if neither in columns nor provided in fixed_params_dict
+ fixed_params_dict[param] = value
+ self.meta[param] = value
+
+ if raise_key_error:
+ raise KeyError(f"fit_motion_models: Missing required fixed parameter(s) for the motion models used: {', '.join(missing_params)}! Please provide them in fixed_params_dict or as columns in the table.")
+
+
+ # Prepare fixed_params_dict for each star
+ # This avoids checking types and slicing inside the fitting loop
+ fixed_params_stars = [{} for _ in range(N_stars)]
+ # Identify array parameters (length N_stars) and scalar parameters
+ array_params = {k: v for k, v in fixed_params_dict.items() if np.ndim(v) > 0 and len(v) == N_stars}
+ scalar_params = {k: v for k, v in fixed_params_dict.items() if k not in array_params}
+
+ # Construct list of dicts for each star
+ # Using list comprehension for speed
+ fixed_params_stars = [
+ {**scalar_params, **{k: v[i] for k, v in array_params.items()}}
+ for i in range(N_stars)
+ ]
+
+
+ ############################
+ ####### Prepare Table ######
+ ############################
+ # Fill table with all possible motion model parameter names as new columns.
+ new_col_list = motion_model.motion_model_param_names(motion_model_used, with_errors=True, with_fixed=False)
new_col_list += ['chi2_x', 'chi2_y', 'n_params']
+
if 't0' not in new_col_list:
new_col_list.append('t0')
- # Define output arrays for the best-fit parameters.
+ # Add new columns if they do not exist
for col in new_col_list:
- # Clean/remove up old arrays.
- if col in self.colnames: self.remove_column(col)
- # Add column #TODO: is this good for filling???
- self.add_column(Column(data = np.full(N_stars, np.nan, dtype=float), name = col))
-
- # Add a column to keep track of the number of points used in a fit.
- self['n_fit'] = 0
-
- # Preserve the number of bootstraps that will be run (if any).
- self.meta['n_fit_bootstrap'] = bootstrap
-
- # (FIXME: Do we need to catch the case where there's a single *unmasked* epoch?)
- # Catch the case when there is only a single epoch. Just return 0 velocity
- # and the same input position for the x0/y0.
- if len(self['x'].shape) == 1:
- self['motion_model_used'] = 'Fixed'
- self['x0'] = self['x']
- self['y0'] = self['y']
- if 't' in self.colnames:
- self['t0'] = self['t']
+ if col in self.colnames:
+ # Keep old data if the column already exists
+ continue
+ if col.endswith('_err'):
+ self.add_column(
+ Column(data=np.full(N_stars, np.inf, dtype=float), name=col),
+ rename_duplicate=True
+ )
else:
- self['t0'] = self.meta['list_times'][0]
- if 'xe' in self.colnames:
- self['x0_err'] = self['xe']
- self['y0_err'] = self['ye']
- self['n_fit'] = 1
- self['n_params'] = 1
- return
-
- if (self['x'].shape[1] == 1):
- self['motion_model_used'] = 'Fixed'
- self['x0'] = self['x'][:,0]
- self['y0'] = self['y'][:,0]
- if 't' in self.colnames:
- self['t0'] = self['t'][:, 0]
+ self.add_column(
+ Column(data=np.full(N_stars, fill_value, dtype=float), name=col),
+ rename_duplicate=True
+ )
+
+ # Add fixed parameter meta if scalar, column if array.
+ fixed_param_names = []
+ for mm in motion_model_used:
+ for param in mm.fixed_param_names:
+ if param not in fixed_param_names:
+ fixed_param_names.append(param)
+ # Remove t0 from fixed_param_names as it will be saved during fitting
+ if 't0' in fixed_param_names:
+ fixed_param_names.remove('t0')
+
+
+ for param in fixed_param_names:
+ coldata = np.array([fps[param] for fps in fixed_params_stars])
+
+ if param in self.colnames:
+ existing = self[param]
+
+ # Skip if identical
+ same = (
+ np.array_equal(existing, coldata)
+ if is_string_dtype(existing)
+ else np.allclose(existing, coldata, equal_nan=True)
+ )
+
+ if same:
+ continue
+
+ # Different (or column does not yet exist)
+ if len(np.unique(coldata)) == 1:
+ self.meta[param] = coldata[0]
else:
- self['t0'] = self.meta['list_times'][0]
- if 'xe' in self.colnames:
- self['x0_err'] = self['xe'][:,0]
- self['y0_err'] = self['ye'][:,0]
- self['n_fit'] = 1
- self['n_params'] = 1
- return
-
- # Only fit selected stars, if list given
- fit_star_idxs = range(N_stars)
+ self.add_column(
+ Column(data=coldata, name=f"{param}_mm"),
+ rename_duplicate=True,
+ )
+
+ # Add a column to keep track of the number of points used in a fit and number of bootstrap used.
+ self.meta['n_bootstrap'] = bootstrap
+
+
+ ###########################
+ ######### FITTING #########
+ ###########################
+ unique_motion_models, unique_inv_indices = np.unique(self['motion_model_used'], return_inverse=True)
if select_stars is not None:
- fit_star_idxs = select_stars
- # STARS LOOP through the stars and work on them 1 at a time.
- # This is slow; but robust.
- if show_progress:
- for ss in tqdm(fit_star_idxs):
- self.fit_velocity_for_star(ss, motion_model_dict, weighting=weighting, bootstrap=bootstrap,
- use_scipy=use_scipy, absolute_sigma=absolute_sigma,
- fixed_t0=fixed_t0, default_motion_model=default_motion_model,
- mask_val=mask_val, mask_lists=mask_lists)
+ select_stars = np.asarray(select_stars)
+ if select_stars.dtype == bool:
+ select_stars = np.flatnonzero(select_stars)
+ else:
+ select_stars = np.asarray(select_stars, dtype=int)
+ indices_by_motion_model = {key: np.intersect1d(select_stars, np.flatnonzero(unique_inv_indices == k)) for k, key in enumerate(unique_motion_models)}
else:
- for ss in fit_star_idxs:
- self.fit_velocity_for_star(ss, motion_model_dict, weighting=weighting, bootstrap=bootstrap,
- use_scipy=use_scipy, absolute_sigma=absolute_sigma,
- fixed_t0=fixed_t0, default_motion_model=default_motion_model,
- mask_val=mask_val, mask_lists=mask_lists)
- if verbose:
- stop_time = time.time()
- print('startable.fit_velocities runtime = {0:.0f} s for {1:d} stars'.format(stop_time - start_time, N_stars))
-
+ indices_by_motion_model = {key: np.flatnonzero(unique_inv_indices == k) for k, key in enumerate(unique_motion_models)}
+
+ # Unmasked indices for each star:
+ unmasked_idx = [np.flatnonzero(xy_mask[i]) for i in range(N_stars)]
+
+ # For each motion model
+ for unique_motion_model, unique_index in indices_by_motion_model.items():
+ # Create motion model instance
+ motion_model_instance = input_mm_map[unique_motion_model]()
+ param_names = motion_model_instance.fit_param_names
+ # Initialize arrays to store results
+ n_stars_this_model = len(unique_index)
+ n_params = len(param_names)
+
+ params_array = np.full((n_stars_this_model, n_params), fill_value, dtype=float)
+ param_errs_array = np.full((n_stars_this_model, n_params), np.inf, dtype=float)
+ chi2_x_array = np.full(n_stars_this_model, np.nan, dtype=float)
+ chi2_y_array = np.full(n_stars_this_model, np.nan, dtype=float)
+
+ # Prepare data as lists of arrays for faster access during fitting
+ t_stars = [np.array(t_data[i][unmasked_idx[i]]) for i in unique_index]
+ x_stars = [np.array(x_data[i][unmasked_idx[i]]) for i in unique_index]
+ y_stars = [np.array(y_data[i][unmasked_idx[i]]) for i in unique_index]
+ xe_stars = [np.array(xe_data[i][unmasked_idx[i]]) for i in unique_index] if xe_data is not None else [None]*n_stars_this_model
+ ye_stars = [np.array(ye_data[i][unmasked_idx[i]]) for i in unique_index] if ye_data is not None else [None]*n_stars_this_model
+
+ # For each star
+ # Expensive for loop! Prepare everything beforehand to speed up.
+ if len(unique_index) > 0:
+ for idx, i_star in enumerate(tqdm(unique_index, disable=not verbose, desc=f"Fitting motion model {unique_motion_model}")):
+ # Fit the star
+ params, param_errs, chi2_x, chi2_y = motion_model_instance.fit(
+ t=t_stars[idx],
+ x=x_stars[idx],
+ y=y_stars[idx],
+ xe=xe_stars[idx],
+ ye=ye_stars[idx],
+ fixed_params_dict=fixed_params_stars[i_star],
+ weighting=weighting,
+ use_scipy=use_scipy,
+ absolute_sigma=absolute_sigma,
+ fill_value=fill_value,
+ return_chi2=True,
+ bootstrap=bootstrap,
+ seed=seed,
+ verbose=verbose
+ )
+ params_array[idx] = params
+ param_errs_array[idx] = param_errs
+ chi2_x_array[idx] = chi2_x
+ chi2_y_array[idx] = chi2_y
+
+ # Store results back to the table
+ for j, param_name in enumerate(param_names):
+ self[param_name][unique_index] = params_array[:, j]
+ self[param_name + '_err'][unique_index] = param_errs_array[:, j]
+ self['chi2_x'][unique_index] = chi2_x_array
+ self['chi2_y'][unique_index] = chi2_y_array
+ self['t0'][unique_index] = t0[unique_index]
+
+ # Update n_params regardless of selections
+ for mm in motion_model_used:
+ self['n_params'][self['motion_model_used'] == mm.name] = mm.n_params
return
- def fit_velocity_for_star(self, ss, motion_model_dict, weighting='var', use_scipy=True, absolute_sigma=True,
- bootstrap=False, fixed_t0=False, mask_val=None, mask_lists=False,
- default_motion_model='Linear'):
- # TODO: "weighting" is not used
- #
- # Make a mask of invalid (NaN) values and a user-specified invalid value.
- #
-
- x = np.ma.masked_invalid(self['x'][ss, :].data)
- y = np.ma.masked_invalid(self['y'][ss, :].data)
- if mask_val:
- x = np.ma.masked_values(x, mask_val)
- y = np.ma.masked_values(y, mask_val)
- # If no mask, convert x.mask to list
- if not np.ma.is_masked(x):
- x.mask = np.zeros_like(x.data, dtype=bool)
- if not np.ma.is_masked(y):
- y.mask = np.zeros_like(y.data, dtype=bool)
-
- if mask_lists is not False:
- # Remove a list
- if isinstance(mask_lists, list):
- if all(isinstance(item, int) for item in mask_lists):
- x.mask[mask_lists] = True
- y.mask[mask_lists] = True
-
- # Throw a warning if mask_lists is not a list
- if not isinstance(mask_lists, list):
- raise RuntimeError('mask_lists needs to be a list.')
- #
- # Assign the appropriate positional errors
- #
- if 'xe' in self.colnames:
- # Make a mask of invalid (NaN) values and a user-specified invalid value.
- xe = np.ma.masked_invalid(self['xe'][ss, :].data)
- ye = np.ma.masked_invalid(self['ye'][ss, :].data)
-
- # Catch the case where we have positions but no errors for
- # some of the entries... we need to "fill in" reasonable
- # weights for these... just use the average weights over
- # all the other epochs.
- pos_no_err = np.where((np.isfinite(x) & np.isfinite(y)) &
- (np.isfinite(xe) == False) & (np.isfinite(ye) == False))[0]
- pos_with_err = np.where((np.isfinite(x) & np.isfinite(y)) &
- (np.isfinite(xe) & np.isfinite(ye)))[0]
-
- if len(pos_with_err) > 0:
- xe[pos_no_err] = xe[pos_with_err].mean()
- ye[pos_no_err] = ye[pos_with_err].mean()
- else:
- xe[pos_no_err] = 1.0
- ye[pos_no_err] = 1.0
- else:
- N_epochs = len(x)
- xe = np.ones(N_epochs, dtype=float)
- ye = np.ones(N_epochs, dtype=float)
- xe = np.ma.masked_invalid(xe)
- ye = np.ma.masked_invalid(xe)
+ def infer_positions(self, times, fixed_params_dict=None, fill_value=np.nan):
+ """Infer star positions at given times using fitted motion models.
- if mask_val:
- xe = np.ma.masked_values(xe, mask_val)
- ye = np.ma.masked_values(ye, mask_val)
- # If no mask, convert xe.mask to list
- if not np.ma.is_masked(xe):
- xe.mask = np.zeros_like(xe.data, dtype=bool)
- if not np.ma.is_masked(ye):
- ye.mask = np.zeros_like(ye.data, dtype=bool)
-
- if mask_lists is not False:
- # Remove a list
- if isinstance(mask_lists, list):
- if all(isinstance(item, int) for item in mask_lists):
- xe.mask[mask_lists] = True
- ye.mask[mask_lists] = True
-
- # Throw a warning if mask_lists is not a list
- if not isinstance(mask_lists, list):
- raise RuntimeError('mask_lists needs to be a list.')
-
- #
- # Make a mask of invalid (NaN) values and a user-specified invalid value.
- #
- if 't' in self.colnames:
- t = np.ma.masked_invalid(self['t'][ss, :].data)
- else:
- t = np.ma.masked_invalid(self.meta['list_times'])
+ Parameters
+ ----------
+ times : array_like
+ Times at which to predict positions. Scalar, or (N_times,) array, or (N_stars, N_times) array.
+ fixed_params_dict : None or dict, optional
+ Dictionary of fixed parameters to use for prediction.
+ If not provided, will try to look for fixed parameters in the meta data then in table columns.
+ If fixed params are found in both the table and the fixed_params_dict, the values in the table will be used and the fixed_params_dict values will be ignored,
+ by default None
+ fill_value : float, optional
+ Value to use for missing data, by default np.nan
- if mask_val:
- t = np.ma.masked_values(t, mask_val)
- if not np.ma.is_masked(t):
- t.mask = np.zeros_like(t.data, dtype=bool)
-
- if mask_lists is not False:
- # Remove a list
- if isinstance(mask_lists, list):
- if all(isinstance(item, int) for item in mask_lists):
- t.mask[mask_lists] = True
-
- # Throw a warning if mask_lists is not a list
- if not isinstance(mask_lists, list):
- raise RuntimeError('mask_lists needs to be a list.')
-
- # For inconsistent masks, mask the star if any of the values are masked.
- new_mask = np.logical_or.reduce((t.mask, x.mask, y.mask, xe.mask, ye.mask))
-
- #
- # Figure out where we have detections (as indicated by error columns)
- #
- good = np.where((xe != 0) & (ye != 0) &
- np.isfinite(xe) & np.isfinite(ye) &
- np.isfinite(x) & np.isfinite(y) & ~new_mask)[0]
-
- N_good = len(good)
-
- # Catch the case where there is NO good data.
- if N_good == 0:
- #self['motion_model_used'][ss] = 'None'
- self['n_fit'][ss] = N_good
- self['n_params'][ss] = 0
- return
+ Returns
+ -------
+ x, y, xe, ye : ndarray
+ Arrays of predicted x, y positions and their uncertainties xe, ye, with shape (N_stars, N_times) or (N_stars,) if N_times=1, or (N_times,) if N_stars=1, or scalar.
+ """
+ assert 'motion_model_used' in self.colnames, \
+ "infer_positions: 'motion_model_used' column not found in the table. Please run fit_motion_models() first."
- # Everything below has N_good >= 1
- x = x[good]
- y = y[good]
- t = t[good]
- xe = xe[good]
- ye = ye[good]
-
- #
- # Unless t0 is fixed, calculate the t0 for the stars.
- #
- if fixed_t0 is False:
- t_weight = 1.0 / np.hypot(xe, ye)
- t0 = np.average(t, weights=t_weight)
- elif fixed_t0 is True:
- t0 = self.t0
- else:
- t0 = fixed_t0[ss]
- self['t0'][ss] = t0
- self['n_fit'][ss] = N_good
-
- #
- # Decide which motion_model to fit.
- #
- motion_model_use = self['motion_model_input'][ss]
- # Go to default model if not enough points for assigned but enough for default
- # TODO: think about whether we want other fallbacks besides the singular default and Fixed
- if (N_good < motion_model_dict[motion_model_use].n_pts_req) and \
- (N_good >= motion_model_dict[default_motion_model].n_pts_req):
- motion_model_use = default_motion_model
- # If not enough points for either, go to a fixed model
- elif (N_good < motion_model_dict[motion_model_use].n_pts_req) and \
- (N_good < motion_model_dict[default_motion_model].n_pts_req):
- motion_model_use = 'Fixed'
- # If the points do not cover multiple times, go to a fixed model
- if (t == t[0]).all():
- motion_model_use = 'Fixed'
-
- self['motion_model_used'][ss] = motion_model_use
-
-# # Get the motion model object.
-# modClass = motion_model_dict[motion_model_use]
-#
-# # Load up any prior information on parameters for this model.
-# param_dict = {}
-# for par in modClass.fitter_param_names+modClass.fixed_param_names:
-# if ~np.isnan(self[par][ss]):
-# param_dict[par] = self[par][ss]
-
- # Model object
- mod = motion_model_dict[motion_model_use]
- fixed_params = [self[par][ss] for par in mod.fixed_param_names]
-
- # Fit for the best parameters
- params, param_errs = mod.fit_motion_model(t, x, y, xe, ye, t0, bootstrap=bootstrap,
- weighting=weighting, use_scipy=use_scipy, absolute_sigma=absolute_sigma)
- chi2_x,chi2_y = mod.get_chi2(params,fixed_params, t,x,y,xe,ye)
- self['chi2_x'][ss]=chi2_x
- self['chi2_y'][ss]=chi2_y
- self['n_params'][ss] = mod.n_params
-
- # Save parameters and errors to table.
- for pp in range(len(mod.fitter_param_names)):
- par = mod.fitter_param_names[pp]
- par_err = par + '_err'
- self[par][ss] = params[pp]
- self[par_err][ss] = param_errs[pp]
-
- return
+ N_stars = len(self)
+ times = np.atleast_1d(times)
+ N_times = len(times)
+
+ x_pred = np.full((N_stars, N_times), fill_value, dtype=float)
+ y_pred = np.full((N_stars, N_times), fill_value, dtype=float)
+ xe_pred = np.full((N_stars, N_times), np.inf, dtype=float)
+ ye_pred = np.full((N_stars, N_times), np.inf, dtype=float)
+
+ # Calculate the dictionary of {motion_model: indices of stars with this motion model} for faster access during prediction
+ unique_motion_models, unique_inv_indices = np.unique(self['motion_model_used'], return_inverse=True)
+ indices_by_motion_model = {key: np.flatnonzero(unique_inv_indices == k) for k, key in enumerate(unique_motion_models)}
+ mm_map = motion_model.motion_model_map()
+ # Prepare fit_params, fixed_params, fit_param_errs for each star
+ for unique_motion_model, unique_index in indices_by_motion_model.items():
+ # Create motion model instance
+ motion_model_instance = mm_map[unique_motion_model]()
+ # Prepare parameters for prediction
+ fit_params = np.array([
+ self[param_name][unique_index] for param_name in motion_model_instance.fit_param_names
+ ]).T # shape (N_stars_this_model, N_params)
+
+ fit_param_errs = np.array([
+ self[param_name + '_err'][unique_index] for param_name in motion_model_instance.fit_param_names
+ ]).T # shape (N_stars_this_model, N_params)
+
+ # Construct fixed_params: Look for fixed_params_dict -> table columns -> meta data -> default value
+ fixed_params = fixed_params_dict.copy() if fixed_params_dict is not None else {}
+ for param in motion_model_instance.required_fixed_param_names:
+ if param not in fixed_params:
+ # If required fixed param not provided, find it in the table columns or meta data
+ if param in self.colnames:
+ fixed_params[param] = self[param][unique_index]
+ elif param in self.meta:
+ fixed_params[param] = self.meta[param]
+ else:
+ raise KeyError(f"infer_positions: Required fixed parameter '{param}' not found for motion model '{unique_motion_model}'. Please provide it in fixed_params_dict, or add it as a column in the table, or add it to the meta data.")
+ else:
+ fixed_params[param] = fixed_params_dict[param]
+
+ for param, default_value in motion_model_instance.optional_fixed_params.items():
+ if param not in fixed_params:
+ # If optional fixed param not provided, find it in the table columns or meta data, otherwise use default value
+ if param in self.colnames:
+ if param == 'obsLocation':
+ # Special case for obsLocation: no vectorization implemented yet, use the value from the first star
+ assert np.unique(self[param][unique_index]).size == 1, \
+ f"infer_positions: obsLocation fixed parameter has different values ({np.unique(self[param][unique_index])}) for different stars. Vectorized handling not implemented yet."
+ fixed_params[param] = self[param][unique_index]
+ elif param in self.meta:
+ fixed_params[param] = self.meta[param]
+ else:
+ fixed_params[param] = default_value
+ else:
+ fixed_params[param] = fixed_params_dict[param]
+
+ # for param_name in motion_model_instance.fixed_param_names:
+ # col_name = copy.deepcopy(param_name)
+ # # If column not in table, check if it's provided in fixed_params_dict. If not, raise error. If provided, use the value from fixed_params_dict for all stars.
+ # if (col_name not in self.colnames) and (f'{col_name}_mm' not in self.colnames):
+ # if col_name in fixed_params_dict:
+ # fixed_params[param_name] = fixed_params_dict[col_name]
+ # continue
+ # else:
+ # raise KeyError(f"infer_positions: Fixed parameter '{param_name}' not found in table columns or fixed_params_dict. Please provide the value for this parameter in fixed_params_dict or add a column named '{param_name}' to the table.")
+
+ # # If original table has column and fit_motion_models added the column with _mm suffix, use the _mm column for prediction.
+ # if param_name + '_mm' in self.colnames:
+ # col_name = param_name + '_mm'
+ # fixed_params[param_name] = self[col_name][unique_index]
+
+ # if (param_name == 'obsLocation'):
+ # assert np.unique(fixed_params[param_name]).size == 1, \
+ # "infer_positions: obsLocation fixed parameter has different values for different stars. Vectorized handling not implemented yet."
+ # fixed_params[param_name] = fixed_params[param_name][0]
+
+ # Predict positions
+ # shape = (N_stars_this_model, N_times) or (N_stars_this_model,) if N_times=1 or (N_times,) if N_stars_this_model=1 or scalar
+ x, y, xe, ye = motion_model_instance.model(
+ times, fit_params, fit_param_errs, fixed_params
+ )
+ if N_stars==1 and N_times > 1:
+ # Reshape (N_times,) to (1, N_times)
+ x = x[np.newaxis, :]
+ y = y[np.newaxis, :]
+ xe = xe[np.newaxis, :]
+ ye = ye[np.newaxis, :]
+ elif N_times==1 and N_stars > 1:
+ # Reshape (N_stars,) to (N_stars, 1)
+ x = x[:, np.newaxis]
+ y = y[:, np.newaxis]
+ xe = xe[:, np.newaxis]
+ ye = ye[:, np.newaxis]
+
+ x_pred[unique_index] = x
+ y_pred[unique_index] = y
+ xe_pred[unique_index] = xe
+ ye_pred[unique_index] = ye
+
+ if N_stars==1 or N_times==1:
+ # Reshape back to 1D array or scalar
+ x_pred = x_pred.flatten()
+ y_pred = y_pred.flatten()
+ xe_pred = xe_pred.flatten()
+ ye_pred = ye_pred.flatten()
+ return x_pred, y_pred, xe_pred, ye_pred
+
+
# New function, to use in align
def get_star_positions_at_time(self, t, motion_model_dict, allow_alt_models=True):
""" Get current x,y positions of each star according to its motion_model
@@ -893,7 +1147,7 @@ def get_star_positions_at_time(self, t, motion_model_dict, allow_alt_models=True
mod = motion_model_dict[mm]
# Set up parameters
param_dict = {}
- for par in mod.fitter_param_names + mod.fixed_param_names + [pm+'_err' for pm in mod.fitter_param_names]:
+ for par in mod.fit_param_names + mod.fixed_param_names + [pm+'_err' for pm in mod.fit_param_names]:
param_dict[par] = self[par][idx]
x[idx],y[idx],xe[idx],ye[idx] = mod.get_batch_pos_at_time(t,**param_dict)
except:
@@ -913,147 +1167,9 @@ def get_star_positions_at_time(self, t, motion_model_dict, allow_alt_models=True
param_dict[par] = self[par][idx]
x[idx],y[idx],xe[idx],ye[idx] = mod.get_batch_pos_at_time(t,**param_dict)
- return x,y,xe,ye
-
+ return x, y, xe, ye
- def fit_velocities_all_detected(self, motion_model_to_fit, weighting='var', use_scipy=True, absolute_sigma=True, times=None,
- select_stars=None, epoch_cols='all', mask_val=None, art_star=False, return_result=False):
- """Fit velocities for stars detected in all epochs specified by epoch_cols.
- Criterion: xe/ye error > 0 and finite, x/y not masked.
- Parameters
- ----------
- motion_model_to_fit : MotionModel
- Motion model object to use for fitting all stars
- weighting : str, optional
- Variance weighting('var') or standard deviation weighting ('std'), by default 'var'
- select_idx : array-like, optional
- Indices of stars to select for fitting, by default None (fit all detected stars)
- epoch_cols : str or list of intergers, optional
- List of epoch column indices used for fitting velocity, by default 'all'
- mask_val : float, optional
- Values in x, y to be masked
- art_star : bool, optional
- Artificial star or observation star catalog. If artificial star, use 'det' column to select stars detected in all epochs, by default False
- return_result : bool, optional
- Return the velocity results or not, by default False
-
- Returns
- -------
- vel_result : astropy Table
- Astropy Table with velocity results
- """
-
- N_stars = len(self)
- if select_stars is None:
- select_stars = np.arange(N_stars)
- else:
- select_stars = np.asarray(select_stars)
-
- if epoch_cols == 'all':
- epoch_cols = np.arange(np.shape(self['x'])[1])
-
- # Artificial Star
- if art_star:
- detected_in_all_epochs = np.all(self['det'][select_stars, :][:, epoch_cols], axis=1)
-
- # Observation Star
- else:
- valid_xe = np.all(self['xe'][select_stars, :][:, epoch_cols]!=0, axis=1) & np.all(np.isfinite(self['xe'][select_stars, :][:, epoch_cols]), axis=1)
- valid_ye = np.all(self['ye'][select_stars, :][:, epoch_cols]!=0, axis=1) & np.all(np.isfinite(self['ye'][select_stars, :][:, epoch_cols]), axis=1)
-
- if mask_val:
- x = np.ma.masked_values(self['x'][select_stars, :][:, epoch_cols], mask_val)
- y = np.ma.masked_values(self['y'][select_stars, :][:, epoch_cols], mask_val)
-
- # If no mask, convert x.mask to list
- if not np.ma.is_masked(x):
- x.mask = np.zeros_like(self['x'][select_stars, :][:, epoch_cols].data, dtype=bool)
- if not np.ma.is_masked(y):
- y.mask = np.zeros_like(self['y'][select_stars, :][:, epoch_cols].data, dtype=bool)
-
- valid_x = ~np.any(x.mask, axis=1)
- valid_y = ~np.any(y.mask, axis=1)
- detected_in_all_epochs = np.logical_and.reduce((
- valid_x, valid_y, valid_xe, valid_ye))
- else:
- detected_in_all_epochs = np.logical_and(valid_xe, valid_ye)
-
- N = len(self['x'][select_stars, :])
- fit_params = motion_model_to_fit.fitter_param_names
- param_data = {p: np.zeros(N) for p in fit_params}
- param_data.update({p+'_err': np.zeros(N) for p in fit_params})
- param_data.update({p: np.zeros(N) for p in motion_model_to_fit.fixed_param_names})
- param_data['chi2_x'] = np.zeros(N)
- param_data['chi2_y'] = np.zeros(N)
-
- if times is None:
- if 'YEARS' in self.meta:
- times = np.array(self.meta['YEARS'])[epoch_cols]
- elif 't' in self.colnames:
- times = self['t'][0, epoch_cols]
- else:
- raise ValueError("No valid time column found.")
-
- if not art_star:
- x_arr = self['x'][select_stars, :][:, epoch_cols]
- y_arr = self['y'][select_stars, :][:, epoch_cols]
- else:
- x_arr = self['x'][select_stars, :][:, epoch_cols, 1]
- y_arr = self['y'][select_stars, :][:, epoch_cols, 1]
-
- xe_arr = self['xe'][select_stars, :][:, epoch_cols]
- ye_arr = self['ye'][select_stars, :][:, epoch_cols]
-
- # Only fit for >1 epochs, otherwise all velocities will be 0
- if len(epoch_cols) > 1:
- # For each star
- for i in tqdm(range(N)):
- x = x_arr[i]
- y = y_arr[i]
- xe = xe_arr[i]
- ye = ye_arr[i]
- t0 = np.average(times, weights=1. / np.hypot(xe, ye))
-
- # Run fit and record results
- params, param_errs = motion_model_to_fit.fit_motion_model(
- times, x, y, xe, ye, t0, weighting=weighting,
- use_scipy=use_scipy, absolute_sigma=absolute_sigma
- )
- if 't0' in motion_model_to_fit.fixed_param_names:
- param_data['t0'][i] = t0
- for j, param in enumerate(fit_params):
- param_data[param][i] = params[j]
- param_data[f'{param}_err'][i] = param_errs[j]
- chi2x, chi2y = motion_model_to_fit.get_chi2(params, [t0], times, x, y, xe, ye)
- param_data['chi2_x'][i] = chi2x
- param_data['chi2_y'][i] = chi2y
-
- vel_result = Table.from_pandas(pd.DataFrame(param_data))
-
- # Add n_vfit
- n_fit = len(epoch_cols)
- vel_result['n_fit'] = n_fit
-
- # Clean/remove up old arrays.
- columns = [*vel_result.keys(), 'n_fit']
- for column in columns:
- if column in self.colnames: self.remove_column(column)
-
- # Update self
- for column in columns:
- column_array = MaskedColumn(np.ma.zeros(N_stars), dtype=float, name=column)
- column_array[select_stars] = vel_result[column]
- column_array[select_stars][~detected_in_all_epochs] = np.nan
- column_array.mask[select_stars] = ~detected_in_all_epochs
- # Mask unselected indices
- column_array.mask[~np.isin(np.arange(N_stars), select_stars)] = True
- self[column] = column_array
-
- if return_result:
- return vel_result
- else:
- return
def shift_reference_frame(self, delta_vx=0.0, delta_vy=0.0, delta_pi=0.0,
motion_model_dict={}):
@@ -1062,7 +1178,7 @@ def shift_reference_frame(self, delta_vx=0.0, delta_vy=0.0, delta_pi=0.0,
the absolute frame using either Gaia or a Galactic model. This modified the
motion model fit parameters as well as the time series astrometry, assuming
zero error on the shift values.
-
+
Parameters
----------
delta_vx : float, optional
@@ -1097,7 +1213,7 @@ def shift_reference_frame(table, delta_vx=0.0, delta_vy=0.0, delta_pi=0.0,
the absolute frame using either Gaia or a Galactic model. This modified the
motion model fit parameters as well as the time series astrometry, assuming
zero error on the shift values.
-
+
Parameters
----------
delta_vx : float, optional
diff --git a/flystar/stitch_method2.py b/flystar/stitch_method2.py
index 8cab361..f9aa4e0 100644
--- a/flystar/stitch_method2.py
+++ b/flystar/stitch_method2.py
@@ -42,7 +42,7 @@ def align_starlists(starlist, ref, transModel=transforms.PolyTransform, order=2,
if weights==None, we don't use weights.
"""
-
+
#--------------------------------------------------
# Initial transformation with brightest briteN stars
#--------------------------------------------------
@@ -98,7 +98,7 @@ def weighted_mean(df,x,xe,frames_in_use):
# error = xe or ye
# all_frames = e.g. ['A', 'B', 'C', ...]
-
+
cols_x=["{0}_{1}".format(x,f) for f in frames_in_use] # columns for x_* e.g. ['x_A', 'x_B', 'x_C', ....]
cols_xe=["{0}_{1}".format(xe,f) for f in frames_in_use] # columns for xe_* e.g. ['xe_A', 'xe_B', 'xe_C', ....]
@@ -120,11 +120,11 @@ def weighted_mean(df,x,xe,frames_in_use):
xe_master.append(array_xe[i][mask][0])
else:
rows_to_drop.append(i)
-
+
df=df.drop(rows_to_drop)
df[x]=np.array(x_master)
df[xe]=np.array(xe_master)
-
+
return df
@@ -132,12 +132,12 @@ def normal_mean(df,x,frames_in_use):
cols_x=["{0}_{1}".format(x,f) for f in frames_in_use]
df[x]=df[cols_x].mean(axis=1)
-
+
return df
def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaster='./master.lis'):
-
+
# all_starslist: the list of the names of all starlists e.g. ['A', 'B', 'C', ... ]
# name_initial_ref: the name of the reference that you use in the very first match.
# corr_thresh : threshold for correlation values.
@@ -149,11 +149,11 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
input_starslists.remove(name_initial_ref)
for name_starlist in input_starslists:
-
+
starlist=starlists.read_starlist('{0}.lis'.format(name_starlist))
if 'ref' not in locals():
ref=starlists.read_starlist('{0}.lis'.format(name_initial_ref))
-
+
#------------ Choose good stars to use for a trans object --------------------
@@ -162,14 +162,14 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
# Select the very first 11 columns (i.e. the master reference) consistent with those of the starlist.
# Table -> dataframe -> Table, which lets us avoid the following error: 'MaskedColumn' object has no attribute '_mask'
-
+
ref_for_align=ref_for_align.to_pandas()
-
+
ref_for_align=Table.from_pandas(ref_for_align[starlist_for_align.colnames])
_,_,_,trans=align_starlists(starlist_for_align,ref_for_align,order=2,dr_tol=1,N_loop=15)
-
+
#------------ Transform the whole starlist using the trans object and match with the reference -------------
starlist_transformed=align.transform_from_object(starlist,trans)
@@ -183,7 +183,7 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
#-------------Convert the astropy talbes into dataframes ---------------------
df_ref=ref.to_pandas()
df_starlist_transformed=starlist_transformed.to_pandas()
-
+
#-------------Columns 11-21 contain the measurments for the initial reference--------------
colnames=starlist.colnames
@@ -199,11 +199,11 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
for col in colnames:
df_ref['{0}_{1}'.format(col,name_starlist)]=np.nan
df_ref.loc[idx_ref_matched,'{0}_{1}'.format(col,name_starlist)]= np.array(df_starlist_transformed.loc[idx_starlist_transformed_matched,col])
-
+
else:
for col in colnames:
-
+
df_ref.insert(len(df_ref.columns),'{0}_{1}'.format(col,name_starlist),np.nan)
df_ref.loc[idx_ref_matched,'{0}_{1}'.format(col,name_starlist)]= np.array(df_starlist_transformed.loc[idx_starlist_transformed_matched,col])
@@ -218,7 +218,7 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
#-------------- Figure out which frames are currently included in the master frame -----------
frames_in_use=sorted(set([column[-1] for column in columns if (column[-1] in all_starlists)]))
-
+
#-------------- Average the measurements -------------
for col in colnames:
if (col!='name') and (col!='x') and (col!='y') and (col!='xe') and (col!='ye') and (col!='N_frames'):
@@ -226,7 +226,7 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
df_comb=weighted_mean(df_comb,'x','xe',frames_in_use)
df_comb=weighted_mean(df_comb,'y','ye',frames_in_use)
-
+
#-------------Recalculate 'N_frames' for the master frame -> N_frames = the number of input starlists containing the star-----------
# N_frames = the number of notnull columns at each row in the master frame divided by the number of columns in an input starlist, then minus one.
# The "minus one" at the end accounts for the very first columns, i.e. master columns, that contain the averaged values of all the input starlists.
@@ -244,7 +244,7 @@ def stitch(all_starlists, name_initial_ref, N_iter=5, corr_thresh=0.8, outMaste
#-------------- Convert the final dataframe back into an astropy table ------
ref=Table.from_pandas(df_comb)
-
+
ref.write(outMaster,format='ascii.commented_header', header_start=-1, overwrite=True)
return
diff --git a/flystar/template.py b/flystar/template.py
index c714f9d..1373799 100644
--- a/flystar/template.py
+++ b/flystar/template.py
@@ -8,28 +8,28 @@
import pdb
-def align_template(labelFile, reference, transModel=transforms.PolyTransform, order=1, N_loop=2,
+def align_template(labelFile, reference, transModel=transforms.PolyTransform, order=1, N_loop=2,
dr_tol=1.0, dm_tol=None, briteN=100, weights='both', restrict=False, outFile='outTrans.txt'):
"""
Base example of how to use the flystar code. Assumes we are transforming a label.dat into
a reference starlist.
-
+
Parameters:
-----------
labelFile: ascii file
Starlist we would like to transform into the reference frame. For this
code, we expect a label.dat file
-
+
reference: ascii file
Starlist that defines the reference frame
-
+
transModel: transformation class (default: transforms.polyTransform)
Defines which transformation model to use. Both the four-parameter and
polynomial transformations are supported
-
+
order: int (default=1)
Order of the polynomial transformation. Only used for polynomial transform
-
+
N_loop: int (default=2)
How many times to iterate on the transformation calculation. Ideally,
each iteration adds more stars and thus a better transform, to some
@@ -39,11 +39,11 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
the distance tolerance for matching two stars in align.transform_and_match
dm_tol: float (defalut=None)
- the magnitude tolerance for matching two stars in align.trnasform_and_match
+ the magnitude tolerance for matching two stars in align.trnasform_and_match
briteN: int (default=100)
the number of stars used in blind matching
-
+
weights: string (default='both')
if weights=='both', we use both position error in transformed starlist and
reference starlist as uncertanty. And weights is the reciprocal of this uncertanty.
@@ -66,7 +66,7 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
tref = starlist['t'][0]
# label.dat has position & position err and velocity & velocity error
label = starlists.read_label(labelFile, prop_to_time=tref, flipX=True)
-
+
#--------------------------------------------------
# Initial transformation with brightest briteN stars
@@ -79,21 +79,21 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
# and calculate initial transform
label_ini = label[idx_ini_label]
starlist_ini = starlist[idx_ini_starlist]
-
+
trans = align.initial_align(label_ini, starlist_ini, briteN=briteN,
transformModel=transModel, order=order)
-
+
# apply the initial transform to label.dat
# this is used for future weights calculation
label_trans_ini = align.transform_from_object(label, trans)
-
+
#------------------------------------------------------------------------
# Use transformation to match starlists, then recalculate transformation.
#------------------------------------------------------------------------
# Iterate on this as many times as desired
for i in range(N_loop):
- # apply the transformation to label.dat and
+ # apply the transformation to label.dat and
# matched the transformed label with starlist.
idx_label, idx_starlist = align.transform_and_match(label, starlist, trans,
dr_tol=dr_tol, dm_tol=dm_tol)
@@ -101,17 +101,17 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
if restrict:
label_match = label[idx_label]
starlist_match = starlist[idx_starlist]
- idx_label, idx_starlist = stalists.restrict_by_use(label_match, starlist_match,
+ idx_label, idx_starlist = stalists.restrict_by_use(label_match, starlist_match,
idx_label, idx_starlist)
-
+
# use the matched stars to calculate new transformation
label_match = label[idx_label]
starlist_match = starlist[idx_starlist]
label_ini_match = label_trans_ini[idx_label]
- trans, N_trans = align.find_transform(label_match, label_ini_match, starlist_match,
+ trans, N_trans = align.find_transform(label_match, label_ini_match, starlist_match,
transModel=transModel, order=order, weights = weights)
-
+
#---------------------------------------------
# Write final transform in java align format
@@ -121,7 +121,7 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
# write the transformation coefficients to 'outTrans.txt'
align.write_transform(trans, labelFile, reference, N_trans, deltaMag=delta_m,
restrict=restrict, weights=weights, outFile=outFile)
-
+
#-----------------------------------------------------------
# Test transform: apply to label.dat, make diagnostic plots
@@ -129,11 +129,11 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
# apply the final transformation to label.dat
label_trans = align.transform_from_object(label, trans)
label_trans_match = label_trans[idx_label]
-
+
# postion map with every star in starlist and transformed label.
# both matched and unmatched stars.
plots.trans_positions( starlist, starlist_match, label_trans, label_trans_match)
-
+
# position difference histogram for matched stars.
plots.pos_diff_hist( starlist_match, label_trans_match)
@@ -146,6 +146,6 @@ def align_template(labelFile, reference, transModel=transforms.PolyTransform, or
# quiver plot of postion residules
plots.pos_diff_quiver( starlist_match, label_trans_match)
-
+
return
-
+
diff --git a/flystar/tests/test_align.ipynb b/flystar/tests/test_align.ipynb
deleted file mode 100644
index 02442b9..0000000
--- a/flystar/tests/test_align.ipynb
+++ /dev/null
@@ -1,366 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# Notebook for Running Align Tests"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 6,
- "metadata": {},
- "outputs": [],
- "source": [
- "from flystar.tests import test_align\n",
- "from flystar import starlists\n",
- "from astropy.table import Table"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Test: make_fake_starlists_poly1_vel\n",
- "\n",
- "Just make sure the tables look sensible and are in the right units."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 7,
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- " name m0 m0e ... vye t0 \n",
- "-------- ----------------- -------------------- ... ------------------- ------\n",
- "star_155 9.106905292995506 0.054167528156861204 ... 0.1564397531527286 2019.5\n",
- "star_113 9.153031462110043 0.0421090989942197 ... 0.08128628950126615 2019.5\n",
- "star_077 9.16547870263162 0.02021147759307802 ... 0.05907352582911862 2019.5\n",
- "star_069 9.169817788300977 0.027788213230369625 ... 0.04965351499764548 2019.5\n",
- "star_037 9.173200786855755 0.007665400875860144 ... 0.22723357600795704 2019.5\n",
- " name m me ... ye t \n",
- "-------- ----------------- -------------------- ... -------------------- ------\n",
- "star_155 9.198437965086988 0.054167528156861204 ... 0.02649499466969545 2018.5\n",
- "star_113 9.257333243243941 0.0421090989942197 ... 0.02606700846524875 2018.5\n",
- "star_077 9.252158908537464 0.02021147759307802 ... 0.04250920654497108 2018.5\n",
- "star_069 9.267901667333167 0.027788213230369625 ... 0.042689240225924296 2018.5\n",
- "star_037 9.276780126418494 0.007665400875860144 ... 0.03592203011554212 2018.5\n",
- " name m me ... ye t \n",
- "-------- ----------------- -------------------- ... -------------------- ------\n",
- "star_155 9.478887659623185 0.054167528156861204 ... 0.02649499466969545 2019.5\n",
- "star_113 9.569878576042546 0.0421090989942197 ... 0.02606700846524875 2019.5\n",
- "star_077 9.575998150724095 0.02021147759307802 ... 0.04250920654497108 2019.5\n",
- "star_069 9.593581807234129 0.027788213230369625 ... 0.042689240225924296 2019.5\n",
- "star_037 9.553127108740597 0.007665400875860144 ... 0.03592203011554212 2019.5\n",
- "['name', 'm0', 'm0e', 'x0', 'x0e', 'y0', 'y0e', 'vx', 'vxe', 'vy', 'vye', 't0']\n",
- "['name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't']\n"
- ]
- },
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "/Users/jlu/code/python/flystar/flystar/starlists.py:386: UserWarning: The StarList class requires a arguments('name', 'x', 'y', 'm')\n",
- " warnings.warn(err_msg, UserWarning)\n"
- ]
- }
- ],
- "source": [
- "test_align.make_fake_starlists_poly1_vel()\n",
- "\n",
- "ref = Table.read('random_vel_ref.fits')\n",
- "lis0 = Table.read('random_vel_0.fits')\n",
- "lis1 = Table.read('random_vel_1.fits')\n",
- "\n",
- "print(ref[0:5])\n",
- "print(lis0[0:5])\n",
- "print(lis1[0:5])\n",
- "\n",
- "print(ref.colnames)\n",
- "print(lis0.colnames)\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## test_align_vel\n",
- "\n",
- "Make sure it runs, make some plots along the way, etc."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 12,
- "metadata": {},
- "outputs": [
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "/Users/jlu/code/python/flystar/flystar/starlists.py:386: UserWarning: The StarList class requires a arguments('name', 'x', 'y', 'm')\n",
- " warnings.warn(err_msg, UserWarning)\n",
- "/Users/jlu/code/python/flystar/flystar/starlists.py:386: UserWarning: The StarList class requires a arguments('name', 'x', 'y', 'm')\n",
- " warnings.warn(err_msg, UserWarning)\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- " \n",
- "**********\n",
- "**********\n",
- "Starting iter 0 with ref_table shape: (200, 1)\n",
- "**********\n",
- "**********\n",
- " \n",
- " **********\n",
- " Matching catalog 1 / 4 in iteration 0 with 200 stars\n",
- " **********\n",
- "initial_guess: 50 stars matched between starlist and reference list\n",
- "initial_guess: [-6.05144456e+00 1.01098279e+00 -2.50608887e-04] [-1.07161761e+01 4.89226304e-05 1.01096529e+00]\n",
- " Found 0 duplicates out of 196 matches\n",
- "In Loop 0 found 196 matches\n",
- " Found 0 duplicates out of 196 matches\n",
- " \n",
- " **********\n",
- " Matching catalog 2 / 4 in iteration 0 with 200 stars\n",
- " **********\n",
- "initial_guess: 49 stars matched between starlist and reference list\n",
- "initial_guess: [-1.02158015e+02 1.02080743e+00 -1.45081519e-04] [-5.07779471e+01 -2.60729494e-05 9.99423500e-01]\n",
- " Found 0 duplicates out of 200 matches\n",
- "In Loop 0 found 200 matches\n",
- " Found 0 duplicates out of 200 matches\n",
- " \n",
- " **********\n",
- " Matching catalog 3 / 4 in iteration 0 with 200 stars\n",
- " **********\n",
- "initial_guess: 50 stars matched between starlist and reference list\n",
- "initial_guess: [-2.14220566e-10 1.00000000e+00 -2.24089697e-16] [2.50622339e-10 0.00000000e+00 1.00000000e+00]\n",
- " Found 0 duplicates out of 200 matches\n",
- "In Loop 0 found 200 matches\n",
- " Found 0 duplicates out of 200 matches\n",
- " \n",
- " **********\n",
- " Matching catalog 4 / 4 in iteration 0 with 200 stars\n",
- " **********\n",
- "initial_guess: 50 stars matched between starlist and reference list\n",
- "initial_guess: [-2.57803428e+02 1.03052409e+00 -5.28390832e-05] [ 2.49886631e+02 -6.00884405e-05 9.98642952e-01]\n",
- " Found 0 duplicates out of 200 matches\n",
- "In Loop 0 found 200 matches\n",
- " Found 0 duplicates out of 200 matches\n",
- " \n",
- "**********\n",
- "**********\n",
- "Starting iter 1 with ref_table shape: (204, 4)\n",
- "**********\n",
- "**********\n",
- " \n",
- " **********\n",
- " Matching catalog 1 / 4 in iteration 1 with 200 stars\n",
- " **********\n",
- " Found 0 duplicates out of 199 matches\n",
- "In Loop 1 found 199 matches\n",
- " Found 0 duplicates out of 199 matches\n",
- " \n",
- " **********\n",
- " Matching catalog 2 / 4 in iteration 1 with 200 stars\n",
- " **********\n",
- " Found 0 duplicates out of 198 matches\n",
- "In Loop 1 found 198 matches\n",
- " Found 0 duplicates out of 199 matches\n",
- " \n",
- " **********\n",
- " Matching catalog 3 / 4 in iteration 1 with 200 stars\n",
- " **********\n"
- ]
- },
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "/Users/jlu/code/python/flystar/flystar/starlists.py:386: UserWarning: The StarList class requires a arguments('name', 'x', 'y', 'm')\n",
- " warnings.warn(err_msg, UserWarning)\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- " Found 0 duplicates out of 200 matches\n",
- "In Loop 1 found 200 matches\n",
- " Found 0 duplicates out of 200 matches\n",
- " \n",
- " **********\n",
- " Matching catalog 4 / 4 in iteration 1 with 200 stars\n",
- " **********\n",
- " Found 0 duplicates out of 200 matches\n",
- "In Loop 1 found 200 matches\n",
- " Found 0 duplicates out of 200 matches\n",
- "**********\n",
- "Final Matching\n",
- "**********\n",
- " Found 0 duplicates out of 199 matches\n",
- "Matched 199 out of 200 stars in list 0\n",
- " Found 0 duplicates out of 199 matches\n",
- "Matched 199 out of 200 stars in list 1\n",
- " Found 0 duplicates out of 200 matches\n",
- "Matched 200 out of 200 stars in list 2\n",
- " Found 0 duplicates out of 199 matches\n",
- "Matched 199 out of 200 stars in list 3\n",
- "\n",
- " Preparing the reference table...\n"
- ]
- }
- ],
- "source": [
- "test_align.test_mosaic_lists_vel()"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 11,
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "> /Users/jlu/code/python/flystar/flystar/align.py(3244)apply_mag_lim()\n",
- "-> star_list_T.restrict_by_value(**conditions)\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) conditions\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "{'m0_min': None, 'm0_max': None}\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) type(star_list_T)\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) type(ref_list)\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "*** NameError: name 'ref_list' is not defined\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) ref_list\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "*** NameError: name 'ref_list' is not defined\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) u\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "> /Users/jlu/code/python/flystar/flystar/align.py(991)mosaic_lists()\n",
- "-> ref_list_T = apply_mag_lim(ref_list, mag_lim[ref_index])\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) type(ref_list)\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "\n"
- ]
- },
- {
- "name": "stdin",
- "output_type": "stream",
- "text": [
- "(Pdb) q\n"
- ]
- }
- ],
- "source": [
- "import pdb\n",
- "pdb.pm()"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": []
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.6.7"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 2
-}
diff --git a/flystar/tests/test_align.py b/flystar/tests/test_align.py
index 2d6b0dc..5b9494b 100644
--- a/flystar/tests/test_align.py
+++ b/flystar/tests/test_align.py
@@ -1,21 +1,18 @@
-from flystar import align
-from flystar import starlists
-from flystar import startables
-from flystar import transforms
-from flystar import analysis
-from flystar import motion_model
-from astropy.table import Table
-import numpy as np
-import pylab as plt
import pdb
-import datetime
-import pytest
+import flystar
+import numpy as np
+import matplotlib.pyplot as plt
+from astropy.table import Table
+from flystar.plots import plot_stars
+from flystar import align, starlists, transforms, analysis, motion_model
+
+test_data_path = f'{flystar.__path__[0]}/tests/test_data'
def test_MosaicSelfRef():
"""
Cross-match and align 4 starlists using the OO version of mosaic lists.
"""
- list_files = ['A.lis', 'B.lis', 'C.lis', 'D.lis']
+ list_files = [f'{test_data_path}/{f}' for f in ['A.lis', 'B.lis', 'C.lis', 'D.lis']]
lists = [starlists.StarList.from_lis_file(lf) for lf in list_files]
##########
@@ -28,7 +25,7 @@ def test_MosaicSelfRef():
trans_args={'order': 2})
msc.fit()
-
+
# Check some of the output quantities on the final table.
assert 'x0' in msc.ref_table.colnames
assert 'x0_err' in msc.ref_table.colnames
@@ -42,7 +39,6 @@ def test_MosaicSelfRef():
assert msc.ref_table['use_in_trans'].shape == msc.ref_table['x0'].shape
assert msc.ref_table['used_in_trans'].shape == msc.ref_table['x'].shape
-
# Check that we have some matched stars... should be at least 35 stars
# that are detected in all 4 starlists.
@@ -50,11 +46,11 @@ def test_MosaicSelfRef():
assert len(idx) > 35
# Check that the transformation error isn't too big
- assert (msc.ref_table['x0_err'] < 3.0).all() # less than 1 pix
- assert (msc.ref_table['y0_err'] < 3.0).all()
- #assert (msc.ref_table['m0_err'] < 1.0).all() # less than 0.5 mag
- assert (msc.ref_table['m0_err'] < 1.5).all() # less than 0.5 mag
-
+ valid_err = np.isfinite(msc.ref_table['x0_err']) & np.isfinite(msc.ref_table['y0_err']) & np.isfinite(msc.ref_table['m0_err'])
+ assert (msc.ref_table['x0_err'][valid_err] < 3.0).all() # less than 1 pix
+ assert (msc.ref_table['y0_err'][valid_err] < 3.0).all()
+ #assert (msc.ref_table['m0_err'][valid_err] < 1.0).all() # less than 0.5 mag
+ assert (msc.ref_table['m0_err'][valid_err] < 1.5).all() # less than 0.5 mag
# Check that the transformation lists aren't too wacky
for ii in range(4):
np.testing.assert_allclose(msc.trans_list[ii].px.c1_0, 1.0, rtol=1e-2)
@@ -81,17 +77,15 @@ def test_MosaicSelfRef():
plt.plot(msc.ref_table['x0'],
msc.ref_table['y0'],
'.', color='black', alpha=0.2)
-
-
return
def test_MosaicSelfRef_vel_tconst():
"""
Cross-match and align 4 starlists using the OO version of mosaic lists.
The 4 lists are all taken at the same time (so 0 velocities should result).
-
+
"""
- list_files = ['A.lis', 'B.lis', 'C.lis', 'D.lis']
+ list_files = [f'{test_data_path}/{f}' for f in ['A.lis', 'B.lis', 'C.lis', 'D.lis']]
lists = [starlists.StarList.from_lis_file(lf) for lf in list_files]
##########
@@ -102,11 +96,11 @@ def test_MosaicSelfRef_vel_tconst():
dr_tol=[3, 3], dm_tol=[1, 1],
trans_class=transforms.PolyTransform,
trans_args={'order': 2},
- default_motion_model='Linear',
+ motion_models=['Empty', 'Fixed', 'Linear'],
verbose=False)
msc.fit()
-
+
# Check some of the output quantities on the final table.
assert 'x0' in msc.ref_table.colnames
assert 'x0_err' in msc.ref_table.colnames
@@ -114,55 +108,48 @@ def test_MosaicSelfRef_vel_tconst():
assert 'y0_err' in msc.ref_table.colnames
assert 'm0' in msc.ref_table.colnames
assert 'm0_err' in msc.ref_table.colnames
- assert 'vx' in msc.ref_table.colnames
- assert 'vx_err' in msc.ref_table.colnames
- assert 'vy' in msc.ref_table.colnames
- assert 'vy_err' in msc.ref_table.colnames
+ # Since they are in the same epoch, no velocity information can be inferred
+ # assert 'vx' in msc.ref_table.colnames
+ # assert 'vx_err' in msc.ref_table.colnames
+ # assert 'vy' in msc.ref_table.colnames
+ # assert 'vy_err' in msc.ref_table.colnames
assert 't0' in msc.ref_table.colnames
# Check that we have some matched stars... should be at least 35 stars
# that are detected in all 4 starlists.
idx = np.where(msc.ref_table['n_detect'] == 4)[0]
- assert len(idx) > 35
+ assert len(idx) > 35
# Check that the transformation error isn't too big
- assert (msc.ref_table['x0_err'] < 3.0).all() # less than 1 pix
- assert (msc.ref_table['y0_err'] < 3.0).all()
- assert (msc.ref_table['m0_err'] < 1.0).all() # less than 0.5 mag
-
+ valid_err = np.isfinite(msc.ref_table['x0_err']) & np.isfinite(msc.ref_table['y0_err']) & np.isfinite(msc.ref_table['m0_err'])
+ assert (msc.ref_table['x0_err'][valid_err] < 3.0).all() # less than 1 pix
+ assert (msc.ref_table['y0_err'][valid_err] < 3.0).all()
+ assert (msc.ref_table['m0_err'][valid_err] < 1.0).all() # less than 0.5 mag
+
# Check that the transformation lists aren't too wacky
for ii in range(4):
np.testing.assert_allclose(msc.trans_list[ii].px.c1_0, 1.0, rtol=1e-2)
np.testing.assert_allclose(msc.trans_list[ii].py.c0_1, 1.0, rtol=1e-2)
-
- # Check that the velocities aren't crazy...
- # they should be non-existent (since there is no time difference)
- assert np.isnan(msc.ref_table['vx']).all()
- assert np.isnan(msc.ref_table['vy']).all()
- assert np.isnan(msc.ref_table['vx_err']).all()
- assert np.isnan(msc.ref_table['vy_err']).all()
-
return
def test_MosaicSelfRef_vel():
"""
Cross-match and align 4 starlists using the OO version of mosaic lists.
-
"""
- list_files = ['A.lis', 'B.lis', 'C.lis', 'D.lis']
+ list_files = [f'{test_data_path}/{f}' for f in ['A.lis', 'B.lis', 'C.lis', 'D.lis']]
lists = [starlists.StarList.from_lis_file(lf) for lf in list_files]
# Modify the times so that we get velocities out.
- lists[0].meta['list_time'] = 2001.4
+ lists[0].meta['list_times'] = 2001.4
lists[0]['t'] = 2001.4
-
- lists[1].meta['list_time'] = 2002.4
+
+ lists[1].meta['list_times'] = 2002.4
lists[1]['t'] = 2002.4
-
- lists[2].meta['list_time'] = 2003.4
+
+ lists[2].meta['list_times'] = 2003.4
lists[2]['t'] = 2003.4
-
- lists[3].meta['list_time'] = 2004.4
+
+ lists[3].meta['list_times'] = 2004.4
lists[3]['t'] = 2004.4
@@ -170,13 +157,13 @@ def test_MosaicSelfRef_vel():
# Test instantiation and basic fitting.
##########
msc = align.MosaicSelfRef(lists, ref_index=0, iters=3,
- dr_tol=[5, 3, 3], dm_tol=[1, 1, 0.5], outlier_tol=None,
+ dr_tol=[5, 3, 3], dm_tol=[1, 1, 0.5], outlier_tol=None, briteN=30,
trans_class=transforms.PolyTransform,
- trans_args={'order': 2}, default_motion_model='Linear',
+ trans_args={'order': 2}, motion_models=['Empty', 'Fixed', 'Linear'],
verbose=False)
msc.fit()
-
+
# Check some of the output quantities on the final table.
assert 'x0' in msc.ref_table.colnames
assert 'x0_err' in msc.ref_table.colnames
@@ -193,49 +180,44 @@ def test_MosaicSelfRef_vel():
# Check that we have some matched stars... should be at least 35 stars
# that are detected in all 4 starlists.
idx = np.where(msc.ref_table['n_detect'] == 4)[0]
- assert len(idx) > 35
+ assert len(idx) >= 35, f"Expected at least 35 stars detected in all 4 starlists, but only found {len(idx)}"
# Check that the transformation error isn't too big
- assert (msc.ref_table['x0_err'] < 3.0).all() # less than 1 pix
- assert (msc.ref_table['y0_err'] < 3.0).all()
- assert (msc.ref_table['m0_err'] < 1.0).all() # less than 0.5 mag
-
+ valid_err = np.isfinite(msc.ref_table['x0_err']) & np.isfinite(msc.ref_table['y0_err']) & np.isfinite(msc.ref_table['m0_err'])
+ assert (msc.ref_table['x0_err'][valid_err] < 3.0).all() # less than 1 pix
+ assert (msc.ref_table['y0_err'][valid_err] < 3.0).all()
+ assert (msc.ref_table['m0_err'][valid_err] < 1.0).all() # less than 0.5 mag
+
# Check that the transformation lists aren't too wacky
for ii in range(4):
- np.testing.assert_allclose(msc.trans_list[ii].px.c1_0, 1.0, rtol=1e-2)
- np.testing.assert_allclose(msc.trans_list[ii].py.c0_1, 1.0, rtol=1e-2)
-
+ np.testing.assert_allclose(msc.trans_list[ii].px.c1_0, 1.0, rtol=2e-2)
+ np.testing.assert_allclose(msc.trans_list[ii].py.c0_1, 1.0, rtol=2e-2)
+
plt.clf()
plt.plot(msc.ref_table['vx'],
msc.ref_table['vy'],
'k.', color='black', alpha=0.2)
+
return
def test_MosaicToRef():
make_fake_starlists_poly1(seed=42)
-
- ref_file = 'random_ref.fits'
- list_files = ['random_0.fits',
- 'random_1.fits',
- 'random_2.fits',
- 'random_3.fits',
- 'random_4.fits',
- 'random_5.fits',
- 'random_6.fits',
- 'random_7.fits']
+
+ ref_file = f'{test_data_path}/random_ref.fits'
+ list_files = [f'{test_data_path}/random_{i}.fits' for i in range(8)]
ref_list = Table.read(ref_file)
# Switch our list to a "increasing to the West" list.
ref_list['x0'] *= -1.0
-
+
lists = [starlists.StarList.read(lf) for lf in list_files]
msc = align.MosaicToRef(ref_list, lists, iters=2,
dr_tol=[0.2, 0.1], dm_tol=[1, 0.5],
trans_class=transforms.PolyTransform,
- trans_args={'order': 2}, default_motion_model='Fixed',
+ trans_args={'order': 2}, motion_models=['Empty', 'Fixed'],
update_ref_orig=False, verbose=False)
msc.fit()
@@ -266,21 +248,14 @@ def test_MosaicToRef():
# Also double check that they aren't exactly the same for the reference stars.
assert np.not_equal(msc.ref_table['x0'], ref_list['x0']).all()
assert np.not_equal(msc.ref_table['y0'], ref_list['y0']).all()
-
- return msc
+
+ return
def test_MosaicToRef_p0_vel():
make_fake_starlists_poly0_vel(seed=42)
-
- ref_file = 'random_vel_ref.fits'
- list_files = ['random_vel_p0_0.fits',
- 'random_vel_p0_1.fits',
- 'random_vel_p0_2.fits',
- 'random_vel_p0_3.fits']
- #'random_vel_4.fits',
- #'random_vel_5.fits',
- #'random_vel_6.fits',
- #'random_vel_7.fits']
+
+ ref_file = f'{test_data_path}/random_vel_ref.fits'
+ list_files = [f'{test_data_path}/random_vel_p0_{i}.fits' for i in range(4)]
ref_list = Table.read(ref_file)
@@ -293,14 +268,14 @@ def test_MosaicToRef_p0_vel():
# Switch our list to a "increasing to the West" list.
ref_list['x0'] *= -1.0
ref_list['vx'] *= -1.0
-
+
lists = [starlists.StarList.read(lf) for lf in list_files]
msc = align.MosaicToRef(ref_list, lists, iters=2,
dr_tol=[0.2, 0.1], dm_tol=[1, 0.5],
outlier_tol=[None, None],
trans_class=transforms.PolyTransform,
- trans_args={'order': 1}, default_motion_model='Linear',
+ trans_args={'order': 1}, motion_models=['Empty', 'Fixed', 'Linear'],
update_ref_orig=False, verbose=False)
msc.fit()
@@ -326,27 +301,20 @@ def test_MosaicToRef_p0_vel():
# The velocities should be almost the same (but not as close as before)
# as the input velocities since update_ref == True.
assert (msc.ref_table['name']==ref_list['name']).all()
- assert np.max(np.abs(msc.ref_table['vx']-ref_list['vx']))<3e-4
- assert np.max(np.abs(msc.ref_table['vy']-ref_list['vy']))<3e-4
+ np.testing.assert_allclose(msc.ref_table['vx'], ref_list['vx'], rtol=1e-1, atol=3e-4)
+ np.testing.assert_allclose(msc.ref_table['vy'], ref_list['vy'], rtol=1e-1, atol=3e-4)
# Also double check that they aren't exactly the same for the reference stars.
#assert np.any(np.not_equal(msc.ref_table['vx'], ref_list['vx']))
assert np.not_equal(msc.ref_table['vx'], ref_list['vx']).any()
-
- return msc
+
+ return
def test_MosaicToRef_vel():
make_fake_starlists_poly1_vel(seed=42)
-
- ref_file = 'random_vel_ref.fits'
- list_files = ['random_vel_0.fits',
- 'random_vel_1.fits',
- 'random_vel_2.fits',
- 'random_vel_3.fits']
- #'random_vel_4.fits',
- #'random_vel_5.fits',
- #'random_vel_6.fits',
- #'random_vel_7.fits']
+
+ ref_file = f'{test_data_path}/random_vel_ref.fits'
+ list_files = [f'{test_data_path}/random_vel_{i}.fits' for i in range(4)]
ref_list = Table.read(ref_file)
@@ -359,14 +327,14 @@ def test_MosaicToRef_vel():
# Switch our list to a "increasing to the West" list.
ref_list['x0'] *= -1.0
ref_list['vx'] *= -1.0
-
+
lists = [starlists.StarList.read(lf) for lf in list_files]
msc = align.MosaicToRef(ref_list, lists, iters=2,
dr_tol=[0.2, 0.1], dm_tol=[1, 0.5],
outlier_tol=[None, None],
trans_class=transforms.PolyTransform,
- trans_args={'order': 1}, default_motion_model='Linear',
+ trans_args={'order': 1}, motion_models=['Empty', 'Fixed', 'Linear'],
update_ref_orig=False, verbose=False)
msc.fit()
@@ -377,14 +345,14 @@ def test_MosaicToRef_vel():
assert msc.ref_table['use_in_trans'].shape == msc.ref_table['x0'].shape
assert msc.ref_table['used_in_trans'].shape == msc.ref_table['x'].shape
- # The velocities should be almost the same as the input
+ # The velocities should be almost the same as the input
# velocities since update_ref_orig == False.
assert (msc.ref_table['name']==ref_list['name']).all()
np.testing.assert_allclose(msc.ref_table['vx'], ref_list['vx'], rtol=1e-5)
np.testing.assert_allclose(msc.ref_table['vy'], ref_list['vy'], rtol=1e-5)
##########
- # Align and let velocities be free.
+ # Align and let velocities be free.
##########
msc.update_ref_orig = 'periter'
msc.fit()
@@ -398,21 +366,14 @@ def test_MosaicToRef_vel():
# Also double check that they aren't exactly the same for the reference stars.
#assert np.any(np.not_equal(msc.ref_table['vx'], ref_list['vx']))
assert np.not_equal(msc.ref_table['vx'], ref_list['vx']).any()
-
- return msc
+
+ return
def test_MosaicToRef_acc():
make_fake_starlists_poly1_acc(seed=42)
-
- ref_file = 'random_acc_ref.fits'
- list_files = ['random_acc_0.fits',
- 'random_acc_1.fits',
- 'random_acc_2.fits',
- 'random_acc_3.fits',
- 'random_acc_4.fits',
- 'random_acc_5.fits',
- 'random_acc_6.fits',
- 'random_acc_7.fits']
+
+ ref_file = f'{test_data_path}/random_acc_ref.fits'
+ list_files = [f'{test_data_path}/random_acc_{i}.fits' for i in range(8)]
ref_list = Table.read(ref_file)
@@ -427,19 +388,19 @@ def test_MosaicToRef_acc():
ref_list['ay'] *= 1e-3
ref_list['ax_err'] *= 1e-3
ref_list['ay_err'] *= 1e-3
-
+
# Switch our list to a "increasing to the West" list.
ref_list['x0'] *= -1.0
ref_list['vx0'] *= -1.0
ref_list['ax'] *= -1.0
-
+
lists = [starlists.StarList.read(lf) for lf in list_files]
msc = align.MosaicToRef(ref_list, lists, iters=2,
dr_tol=[0.4, 0.2], dm_tol=[1, 0.5],
trans_class=transforms.PolyTransform,
trans_args={'order': 2},
- default_motion_model='Acceleration',
+ motion_models=['Acceleration'],
update_ref_orig=False, verbose=False)
msc.fit()
@@ -451,7 +412,7 @@ def test_MosaicToRef_acc():
assert msc.ref_table['use_in_trans'].shape == msc.ref_table['x0'].shape
assert msc.ref_table['used_in_trans'].shape == msc.ref_table['x'].shape
- # The velocities should be almost the same as the input
+ # The velocities should be almost the same as the input
# velocities since update_ref_orig == False.
i_orig, i_fit = [],[]
for i,star in enumerate(ref_list["name"]):
@@ -462,7 +423,7 @@ def test_MosaicToRef_acc():
np.testing.assert_allclose(msc.ref_table['ay'][i_fit], ref_list['ay'][i_orig], rtol=1e-5)
##########
- # Align and let velocities be free.
+ # Align and let velocities be free.
##########
msc.update_ref_orig = 'periter'
msc.fit()
@@ -476,257 +437,528 @@ def test_MosaicToRef_acc():
if ~np.isnan(msc.ref_table['ax'][ix_fit]):
i_orig.append(i)
i_fit.append(ix_fit)
- np.testing.assert_allclose(msc.ref_table['ax'][i_fit], ref_list['ax'][i_orig], rtol=1e-1, atol=3e-4)
- np.testing.assert_allclose(msc.ref_table['ay'][i_fit], ref_list['ay'][i_orig], rtol=1e-1, atol=3e-4)
+ # Accelerations all too small, rtol doesn't work well here.
+ atol = 3e-4
+ np.testing.assert_allclose(msc.ref_table['ax'][i_fit], ref_list['ax'][i_orig], atol=atol)
+ np.testing.assert_allclose(msc.ref_table['ay'][i_fit], ref_list['ay'][i_orig], atol=atol)
+
+ ax_min = np.min(ref_list['ax'][i_orig])
+ ax_max = np.max(ref_list['ax'][i_orig])
+ ay_min = np.min(ref_list['ay'][i_orig])
+ ay_max = np.max(ref_list['ay'][i_orig])
+
+ plt.clf()
+ fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))
+ ax1.plot(ref_list['ax'][i_orig], msc.ref_table['ax'][i_fit], '.')
+ ax1.plot([ax_min, ax_max], [ax_min, ax_max], color='C3')
+ ax1.plot([ax_min, ax_max], [ax_min - atol, ax_max - atol], ls='--', color='C3')
+ ax1.plot([ax_min, ax_max], [ax_min + atol, ax_max + atol], ls='--', color='C3')
+ ax1.set_xlabel('Input ax')
+ ax1.set_ylabel('Ref Table ax')
+ ax1.set_title('Acceleration in X')
+
+ ax2.plot(ref_list['ay'][i_orig], msc.ref_table['ay'][i_fit], '.')
+ ax2.plot([ay_min, ay_max], [ay_min, ay_max], color='C3')
+ ax2.plot([ay_min, ay_max], [ay_min - atol, ay_max - atol], ls='--', color='C3')
+ ax2.plot([ay_min, ay_max], [ay_min + atol, ay_max + atol], ls='--', color='C3')
+ ax2.set_xlabel('Input ay')
+ ax2.set_ylabel('Ref Table ay')
+ ax2.set_title('Acceleration in Y')
+ plt.tight_layout()
# Also double check that they aren't exactly the same for the reference stars.
- assert np.any(np.not_equal(msc.ref_table['ax'][:200], ref_list['ax'][:200]))
-
- return msc
+ assert np.any(np.not_equal(msc.ref_table['ax'][i_fit], ref_list['ax'][i_orig]))
+ return
+def test_MosaicToRef_hst_me():
+ """
+ Test Casey's issue with 'me' not getting propogated
+ from the input starlists to the output table.
-def make_fake_starlists_shifts():
- N_stars = 200
- x = np.random.rand(N_stars) * 1000
- y = np.random.rand(N_stars) * 1000
- m = (np.random.rand(N_stars) * 8) + 9
-
- sdx = np.argsort(m)
- x = x[sdx]
- y = y[sdx]
- m = m[sdx]
-
- name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
+ Use data from MB10-364 microlensing target for the test.
+ """
+ # Target RA and Dec (MOA data download)
+ # ra = '17:57:05.401'
+ # dec = '-34:27:05.01'
- # Save original positions as reference (1st) list.
- fmt = '{0:10s} {1:5.2f} 2015.0 {2:9.4f} {3:9.4f} 0 0 0 0\n'
- _out = open('random_0.lis', 'w')
- for ii in range(N_stars):
- _out.write(fmt.format(name[ii], m[ii], x[ii], y[ii]))
- _out.close()
+ # Load up a Gaia catalog (queried around the RA/Dec above)
+ my_gaia = Table.read(f'{test_data_path}/mb10364_data/my_gaia.fits')
+ my_gaia['me'] = 0.01
+ my_gaia.rename_columns(
+ ['x0e', 'y0e', 'vxe', 'vye'],
+ ['x0_err', 'y0_err', 'vx_err', 'vy_err']
+ )
+ # Gather the list of starlists. For first pass, don't modify the starlists.
+ # Loop through the observations and read them in, in prep for alignment with Gaia
+ epochs = [2011.83, 2012.73, 2013.81]
+ starlist_names = [f'{test_data_path}/mb10364_data/2011_10_31_F606W_MATCHUP_XYMEEE_final.calib',
+ f'{test_data_path}/mb10364_data/2012_09_25_F606W_MATCHUP_XYMEEE_final.calib',
+ f'{test_data_path}/mb10364_data/2013_10_24_F606W_MATCHUP_XYMEEE_final.calib']
- ##########
- # Shifts
- ##########
- # Make 4 new starlists with different shifts.
- shifts = [[ 6.5, 10.1],
- [100.3, 50.5],
- [-30.0,-100.7],
- [250.0,-250.0]]
+ list_of_starlists = []
- for ss in range(len(shifts)):
- xnew = x - shifts[ss][0]
- ynew = y - shifts[ss][1]
+ # Just using the F606W filters first.
+ for ee in range(len(starlist_names)):
+ lis = starlists.StarList.from_lis_file(starlist_names[ee])
- # Perturb with small errors (0.1 pix)
- xnew += np.random.randn(N_stars) * 0.1
- ynew += np.random.randn(N_stars) * 0.1
+ # # Add additive error term. MAYBE YOU DON'T NEED THIS
+ # lis['xe'] = np.hypot(lis['xe'], 0.01) # Adding 0.01 pix (0.1 mas) in quadrature.
+ # lis['ye'] = np.hypot(lis['ye'], 0.01)
- mnew = m + np.random.randn(N_stars) * 0.05
+ lis['t'] = epochs[ee]
- _out = open('random_shift_{0:d}.lis'.format(ss+1), 'w')
- for ii in range(N_stars):
- _out.write(fmt.format(name[ii], mnew[ii], xnew[ii], ynew[ii]))
- _out.close()
+ # Lets dump the faint stars.
+ idx = np.where(lis['m'] < 20.0)[0]
+ lis = lis[idx]
- return shifts
+ list_of_starlists.append(lis)
-def make_fake_starlists_poly1(seed=-1):
- # If seed >=0, then set random seed to that value
- if seed >= 0:
- np.random.seed(seed=seed)
-
- N_stars = 200
+ msc = align.MosaicToRef(
+ my_gaia, list_of_starlists, iters=1,
+ dr_tol=[0.1], dm_tol=[5],
+ outlier_tol=[None], mag_lim=[13, 21],
+ trans_class=transforms.PolyTransform,
+ trans_args=[{'order': 1}],
+ motion_models=['Empty', 'Fixed'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ mag_trans=False,
+ trans_weighting='both,std',
+ init_guess_mode='miracle',
+ # save_path=f'{test_data_path}/mb10364_data/test_MosaicToRef_hst_me.pkl',
+ verbose=False
+ )
+ msc.fit()
- x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
- y0 = np.random.rand(N_stars) * 10.0 # arcsec
- x0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
- y0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
- m0 = (np.random.rand(N_stars) * 8) + 9 # mag
- m0e = np.random.randn(N_stars) * 0.05 # mag
- t0 = np.ones(N_stars) * 2019.5
+ assert 'me' in msc.ref_table.colnames
+ return
- # Make all the errors positive
- x0e = np.abs(x0e)
- y0e = np.abs(y0e)
- m0e = np.abs(m0e)
-
- name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
+def test_bootstrap():
+ """
+ Test to make sure calc_bootstrap_error() call is working
+ properly (e.g., only called when user calls calc_bootstrap_error,
+ n_boot param for calc_bootstrap_error only, boot_epochs_min working,
+ etc.)
+ """
+ # Read in starlists for MosaicToRef
+ ref = Table.read(f'{test_data_path}/ref_vel.lis', format='ascii')
+ list1 = Table.read(f'{test_data_path}/E.lis', format='ascii')
+ list2 = Table.read(f'{test_data_path}/F.lis', format='ascii')
- # Make an StarList
- lis = starlists.StarList([name, m0, m0e, x0, x0e, y0, y0e, t0],
- names = ('name', 'm0', 'm0_err', 'x0', 'x0_err', 'y0', 'y0_err', 't0'))
-
- sdx = np.argsort(m0)
- lis = lis[sdx]
+ list1 = starlists.StarList.from_table(list1)
+ list2 = starlists.StarList.from_table(list2)
- # Save original positions as reference (1st) list
- # in a StarList format (with velocities).
- lis.write('random_ref.fits', overwrite=True)
+ # Set parameters for alignment
+ transModel = transforms.PolyTransform
+ trans_args = {'order':2}
+ N_loop = 1
+ dr_tol = 0.08
+ dm_tol = 99
+ outlier_tol = None
+ mag_lim = None
+ ref_mag_lim = None
+ trans_weighting = 'both,var'
+ mag_trans = False
- ##########
- # Shifts
- ##########
- # Make 4 new starlists with different shifts.
- times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
- xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
- [[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
- [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.0]],
- [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]],
- [[ 50.0, 1.01, 1e-5], [ -31.0, 1e-5, 1.000]],
- [[ 78.0, 0.98, 0.0 ], [ 45.0, 9e-6, 1.001]],
- [[-13.0, 0.99, 1e-5], [ 150, 2e-5, 1.002]],
- [[ 94.0, 1.00, 9e-6], [-182.0, 0.0, 0.99]]]
- mag_trans = [0.1, 0.4, 0.0, -0.3, 0.2, 0.0, -0.1, -0.3]
-
- # Convert into pixels (undistorted) with the following info.
- scale = 0.01 # arcsec / pix
- shift = [1.0, 1.0] # pix
+ n_boot = 15
+ boot_epochs_min=-1
- for ss in range(len(times)):
- dt = times[ss] - lis['t0']
-
- x = lis['x0']
- y = lis['y0']
- t = np.ones(N_stars) * times[ss]
+ # Run FLYSTAR, no bootstraps yet!
+ match1 = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
+ dm_tol=dm_tol, outlier_tol=outlier_tol,
+ trans_class=transModel,
+ trans_args=trans_args,
+ mag_trans=mag_trans,
+ mag_lim=mag_lim,
+ ref_mag_lim=ref_mag_lim,
+ trans_weighting=trans_weighting,
+ motion_models=['Linear'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ init_guess_mode='name',
+ verbose=False)
+ match1.fit()
- # Convert into pixels
- xp = (x / -scale) + shift[0] # -1 from switching to increasing to West (right)
- yp = (y / scale) + shift[1]
- xpe = lis['x0_err'] / scale
- ype = lis['y0_err'] / scale
+ # Make sure no bootstrap columns exist
+ assert 'xe_boot' not in match1.ref_table.keys()
+ assert 'ye_boot' not in match1.ref_table.keys()
+ assert 'vxe_boot' not in match1.ref_table.keys()
+ assert 'vye_boot' not in match1.ref_table.keys()
- # Distort the positions
- trans = transforms.PolyTransform(1, xy_trans[ss][0], xy_trans[ss][1], mag_offset=mag_trans[ss])
- xd, yd = trans.evaluate(xp, yp)
- md = trans.evaluate_mag(lis['m0'])
+ # Run bootstrap: no boot_epochs_min
+ match1.calc_bootstrap_errors(n_boot=n_boot, boot_epochs_min=boot_epochs_min, seed=42)
+ # Make sure columns exist, and none of them are nan values
+ assert np.sum(np.isnan(match1.ref_table['xe_boot'])) == 0
+ assert np.sum(np.isnan(match1.ref_table['ye_boot'])) == 0
+ assert np.sum(np.isnan(match1.ref_table['vx_err_boot'])) == 0
+ assert np.sum(np.isnan(match1.ref_table['vy_err_boot'])) == 0
- # Perturb with small errors (0.1 pix)
- xd += np.random.randn(N_stars) * 0.1
- yd += np.random.randn(N_stars) * 0.1
- md += np.random.randn(N_stars) * 0.02
- xde = xpe
- yde = ype
- mde = lis['m0_err']
+ # Test 2: make sure boot_epochs_min is working
+ # Eliminate some rows to list2, so some stars are only in 1 epoch.
+ # Rerun align. Some stars should only be detected in 1 epoch
+ list3 = list2[0:60]
- # Save the new list as a starlist.
- new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
- names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
+ match2 = align.MosaicToRef(ref, [list1, list3], iters=N_loop, dr_tol=dr_tol,
+ dm_tol=dm_tol, outlier_tol=outlier_tol,
+ trans_class=transModel,
+ trans_args=trans_args,
+ mag_trans=mag_trans,
+ mag_lim=mag_lim,
+ ref_mag_lim=ref_mag_lim,
+ trans_weighting=trans_weighting,
+ motion_models=['Linear'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ init_guess_mode='name',
+ verbose=False)
+ match2.fit()
- new_lis.write('random_{0:d}.fits'.format(ss), overwrite=True)
+ # Now run_calc_bootstrap_error, with boot_epochs_min engaged
+ boot_epochs_min2 = 2
+ match2.calc_bootstrap_errors(n_boot=n_boot, boot_epochs_min=boot_epochs_min2, seed=42)
- return (xy_trans,mag_trans)
+ # Make sure boot_epochs_min cut worked as intended
+ out = match2.ref_table
+ bad = np.where( (out['n_detect'] == 1) & (out['use_in_trans'] == False) )
+ good = np.where(out['n_detect'] == 2)
-def make_fake_starlists_poly0_vel(seed=-1):
- # If seed >=0, then set random seed to that value
- if seed >= 0:
- np.random.seed(seed=seed)
-
- N_stars = 200
+ # Some stars must exist in both "good" and "bad" criteria,
+ # otherwise this test isn't as useful as intended.
+ assert len(bad[0]) > 0
+ assert len(good[0]) > 0
- x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
- y0 = np.random.rand(N_stars) * 10.0 # arcsec
- x0e = np.ones(N_stars) * 1.0e-4 # arcsec
- y0e = np.ones(N_stars) * 1.0e-4 # arcsec
- vx = np.random.randn(N_stars) * 5.0 # mas / yr
- vy = np.random.randn(N_stars) * 5.0 # mas / yr
- vxe = np.ones(N_stars) * 0.05 # mas / yr
- vye = np.ones(N_stars) * 0.05 # mas / yr
- m0 = (np.random.rand(N_stars) * 8) + 9 # mag
- m0e = np.random.randn(N_stars) * 0.05 # mag
- t0 = np.ones(N_stars) * 2019.5
+ # For "good" stars: all bootstrap vals should be present
+ assert np.sum(~np.isfinite(out['xe_boot'][good])) == 0
+ assert np.sum(~np.isfinite(out['ye_boot'][good])) == 0
+ assert np.sum(~np.isfinite(out['vx_err_boot'][good])) == 0
+ assert np.sum(~np.isfinite(out['vy_err_boot'][good])) == 0
+
+ # For "bad" stars, all bootstrap vals should be nans
+ assert np.sum(np.isfinite(out['xe_boot'][bad])) == 0
+ assert np.sum(np.isfinite(out['ye_boot'][bad])) == 0
+ assert np.sum(np.isfinite(out['vx_err_boot'][bad])) == 0
+ assert np.sum(np.isfinite(out['vy_err_boot'][bad])) == 0
+
+ return
+
+def test_calc_vel_in_bootstrap():
+ """
+ Check calc_vel_in_bootstrap performance in calc_bootstrap_errors()
+
+ Only calculate velocity bootstrap (e.g., bootstrap over epochs and
+ calculating proper motions) if calc_vel_in_bootstrap=True.
+
+ """
+ import copy
+
+ # Define match parameters
+ ref = Table.read(f'{test_data_path}/ref_vel.lis', format='ascii')
+ list1 = Table.read(f'{test_data_path}/E.lis', format='ascii')
+ list2 = Table.read(f'{test_data_path}/F.lis', format='ascii')
+
+ list1 = starlists.StarList.from_table(list1)
+ list2 = starlists.StarList.from_table(list2)
+
+ # Set parameters for alignment
+ transModel = transforms.PolyTransform
+ trans_args = {'order':2}
+ N_loop = 1
+ dr_tol = 0.08
+ dm_tol = 99
+ outlier_tol = None
+ mag_lim = None
+ ref_mag_lim = None
+ trans_weighting = 'both,var'
+ mag_trans = False
+
+ n_boot = 15
+ boot_epochs_min=-1
+
+ # Run match
+ match = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
+ dm_tol=dm_tol, outlier_tol=outlier_tol,
+ trans_class=transModel,
+ trans_args=trans_args,
+ mag_trans=mag_trans,
+ mag_lim=mag_lim,
+ ref_mag_lim=ref_mag_lim,
+ trans_weighting=trans_weighting,
+ motion_models=['Linear'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ init_guess_mode='name',
+ verbose=False)
+ match.fit()
+
+ # Make 2 copies of match object: one to test
+ # each case of calc_vel_in_bootstrap
+ match_vel = copy.deepcopy(match)
+
+ # Run calc_bootstrap_error function with calc_vel_in_bootstrap=True.
+ # Make sure bootstrap velocity errors are calculated and valid
+ n_boot = 50
+ match_vel.calc_bootstrap_errors(n_boot=n_boot, calc_vel_in_bootstrap=True, seed=42)
+
+ assert 'xe_boot' in match_vel.ref_table.keys()
+ assert np.sum(np.isnan(match_vel.ref_table['xe_boot'])) == 0
+ assert 'vx_err_boot' in match_vel.ref_table.keys()
+ assert np.sum(np.isnan(match_vel.ref_table['vx_err_boot'])) == 0
+
+ # Run without calc_vel_in_bootstrap, make sure velocities are NOT calculated
+ match.calc_bootstrap_errors(n_boot=n_boot, calc_vel_in_bootstrap=False, seed=42)
+
+ assert 'xe_boot' in match.ref_table.keys()
+ assert np.sum(np.isnan(match.ref_table['xe_boot'])) == 0
+ assert 'vx_err_boot' not in match.ref_table.keys()
+
+ return
+
+def test_transform_xym():
+ """
+ Test to make sure transforms are being done to mags only
+ if mag_trans = True. This can cause subtle bugs
+ otherwise
+ """
+ #---Align 1: self.mag_Trans = False---#
+ ref = Table.read(f'{test_data_path}/ref_vel.lis', format='ascii')
+ list1 = Table.read(f'{test_data_path}/E.lis', format='ascii')
+ list2 = Table.read(f'{test_data_path}/F.lis', format='ascii')
+
+ list1 = starlists.StarList.from_table(list1)
+ list2 = starlists.StarList.from_table(list2)
+
+ # Set parameters for alignment
+ transModel = transforms.PolyTransform
+ trans_args = {'order':2}
+ N_loop = 1
+ dr_tol = 0.08
+ dm_tol = 99
+ outlier_tol = None
+ mag_lim = None
+ ref_mag_lim = None
+ trans_weighting = 'both,var'
+ n_boot = 15
+
+ mag_trans = False
+
+ # Run FLYSTAR, with bootstraps
+ match1 = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
+ dm_tol=dm_tol, outlier_tol=outlier_tol,
+ trans_class=transModel,
+ trans_args=trans_args,
+ mag_trans=mag_trans,
+ mag_lim=mag_lim,
+ ref_mag_lim=ref_mag_lim,
+ trans_weighting=trans_weighting,
+ motion_models=['Fixed'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ init_guess_mode='name',
+ verbose=False)
+
+ match1.fit()
+ match1.calc_bootstrap_errors(n_boot=n_boot, seed=42)
+
+ # Make sure all transformations have mag_offset = 0
+ trans_list = match1.trans_list
+
+ for ii in trans_list:
+ assert ii.mag_offset == 0
+
+ # Check that no mag transformation has been applied to m col in ref_table
+ tab1 = match1.ref_table
+ assert np.all(tab1['m'] == tab1['m_orig'])
+
+ # Check me_boost == 0 or really small (should be the case
+ # since we don't transform mags)
+ assert np.isclose(np.max(tab1['me_boot']), 0, rtol=10**-5)
+ print('Done mag_trans = False case')
+
+ #---Align 2: self.mag_Trans = True---#
+ # Repeat, this time with mag_trans = False
+ mag_trans = True
+ match2 = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
+ dm_tol=dm_tol, outlier_tol=outlier_tol,
+ trans_class=transModel,
+ trans_args=trans_args,
+ mag_trans=mag_trans,
+ mag_lim=mag_lim,
+ ref_mag_lim=ref_mag_lim,
+ trans_weighting=trans_weighting,
+ motion_models=['Fixed'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ init_guess_mode='name',
+ verbose=False)
+
+ match2.fit()
+ match2.calc_bootstrap_errors(n_boot=n_boot, seed=42)
+
+
+ # Make sure all transformations have correct mag offset
+ trans_list2 = match2.trans_list
+
+ for ii in trans_list2:
+ assert ii.mag_offset > 20
+
+ # Make sure final table mags have transform applied (i.e,
+ tab2 = match2.ref_table
+ assert np.all(tab2['m'] != tab2['m_orig'])
+
+ # Check me_boost > 0
+ assert np.min(tab2['me_boot']) > 10**-3
+
+ print('Done mag_trans = True case')
+
+ return
+
+def test_MosaicToRef_mag_bug():
+ """
+ Bug found by Tuan Do on 2020-04-12.
+ """
+ make_fake_starlists_poly1_vel(seed=42)
+
+ ref_list = starlists.StarList.read(f'{test_data_path}/random_vel_0.fits')
+ lists = [ref_list]
+
+ msc = align.MosaicToRef(ref_list, lists,
+ mag_trans=True,
+ iters=1,
+ dr_tol=[0.2], dm_tol=[1],
+ outlier_tol=None,
+ trans_class=transforms.PolyTransform,
+ trans_args=[{'order': 1}],
+ motion_models=['Fixed'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ verbose=True)
+
+ msc.fit()
+
+ out_tab = msc.ref_table
+
+ # The issue is that in the initial guess with
+ # mag_trans = True
+ # somehow the transformed magnitudes are nan.
+ # This causes zero matches to occur.
+ assert len(out_tab) == len(ref_list)
+
+ return
+
+def test_masked_cols():
+ """
+ Test to make sure analysis.prepare_gaia_for_flystar
+ produces an astropy.table.Table, NOT a masked column
+ table. MosaicToRef cannot handle masked column tables.
+
+ Also make sure this example works, since we use it for the examples
+ jupyter notebook.
+ """
+ # Get gaia reference stars using analysis.py
+ # around a test location.
+ # target = 'ob150029'
+ ra = '17:59:46.60'
+ dec = '-28:38:41.8'
+
+ # Coordinates are arcsecs offset +x to the East.
+ targets_dict = {
+ 'ob150029': [0.0, 0.0],
+ 'S005': [1.1416, 3.7405],
+ 'S002': [-4.421, 0.027]
+ }
+
+ # Get gaia catalog stars. Note that this produces a masked column table
+ search_rad = 10.0 # arcsec
+ gaia = analysis.query_gaia(ra, dec, search_radius=search_rad)
+ my_gaia = analysis.prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=targets_dict)
+
+ assert isinstance(my_gaia, Table)
+
+ # Let's make sure the entire align runs, just to be safe
+
+ # Get starlists to align to gaia
+ epochs = ['15jun07','16jul14', '17may21']
+
+ list_of_starlists = []
+
+ for ee in range(len(epochs)):
+ lis_file = 'mag' + epochs[ee] + '_ob150029_kp_rms_named.lis'
+ lis = starlists.StarList.from_lis_file(f'{test_data_path}/{lis_file}')
+ list_of_starlists.append(lis)
+
+ # Run the align
+ msc = align.MosaicToRef(my_gaia, list_of_starlists, iters=2,
+ dr_tol=[0.2, 0.1], dm_tol=[1, 1],
+ trans_class=transforms.PolyTransform,
+ trans_args=[{'order': 1}, {'order': 1}],
+ motion_models=['Linear'],
+ use_ref_new=False,
+ update_ref_orig=False,
+ mag_trans=True,
+ init_guess_mode='name', verbose=True)
+
+ msc.fit()
+ return
+
+def make_fake_starlists_shifts():
+ N_stars = 200
+ x = np.random.rand(N_stars) * 1000
+ y = np.random.rand(N_stars) * 1000
+ m = (np.random.rand(N_stars) * 8) + 9
+
+ sdx = np.argsort(m)
+ x = x[sdx]
+ y = y[sdx]
+ m = m[sdx]
- # Make all the errors positive
- x0e = np.abs(x0e)
- y0e = np.abs(y0e)
- m0e = np.abs(m0e)
- vxe = np.abs(vxe)
- vye = np.abs(vye)
-
name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
- # Make an StarList
- lis = starlists.StarList([name, m0, m0e, x0, x0e, y0, y0e, vx, vxe, vy, vye, t0],
- names = ('name', 'm0', 'm0_err', 'x0', 'x0_err', 'y0', 'y0_err',
- 'vx', 'vx_err', 'vy', 'vy_err', 't0'))
-
- sdx = np.argsort(m0)
- lis = lis[sdx]
+ # Save original positions as reference (1st) list.
+ fmt = '{0:10s} {1:5.2f} 2015.0 {2:9.4f} {3:9.4f} 0 0 0 0\n'
+ _out = open(f'{test_data_path}/random_0.lis', 'w')
+ for ii in range(N_stars):
+ _out.write(fmt.format(name[ii], m[ii], x[ii], y[ii]))
+ _out.close()
+
- # Save original positions as reference (1st) list
- # in a StarList format (with velocities).
- lis.write('random_vel_ref.fits', overwrite=True)
-
##########
- # Propogate to new times and distort.
+ # Shifts
##########
- # Make 4 new starlists with different epochs and transformations.
- times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
- xy_trans = [[[ 6.5], [ 10.1]],
- [[100.3], [ 50.5]],
- [[ 0.0], [ 0.0]],
- [[250.0], [-250.0]],
- [[ 50.0], [ -31.0]],
- [[ 78.0], [ 45.0]],
- [[-13.0], [ 150]],
- [[ 94.0], [-182.0]]]
- mag_trans = [0.1, 0.4, 0.0, -0.3, 0.2, 0.0, -0.1, -0.3]
-
- # Convert into pixels (undistorted) with the following info.
- scale = 0.01 # arcsec / pix
- shift = [1.0, 1.0] # pix
-
- for ss in range(len(times)):
- dt = times[ss] - lis['t0']
-
- x = lis['x0'] + (lis['vx']/1e3) * dt
- y = lis['y0'] + (lis['vy']/1e3) * dt
- t = np.ones(N_stars) * times[ss]
-
- # Convert into pixels
- xp = (x / -scale) + shift[0] # -1 from switching to increasing to West (right)
- yp = (y / scale) + shift[1]
- xpe = lis['x0_err'] / scale
- ype = lis['y0_err'] / scale
+ # Make 4 new starlists with different shifts.
+ shifts = [[ 6.5, 10.1],
+ [100.3, 50.5],
+ [-30.0,-100.7],
+ [250.0,-250.0]]
- # Distort the positions
- trans = transforms.PolyTransform(0, xy_trans[ss][0], xy_trans[ss][1], mag_offset=mag_trans[ss])
- xd, yd = trans.evaluate(xp, yp)
- md = trans.evaluate_mag(lis['m0'])
+ for ss in range(len(shifts)):
+ xnew = x - shifts[ss][0]
+ ynew = y - shifts[ss][1]
# Perturb with small errors (0.1 pix)
- xd += np.random.randn(N_stars) * xpe
- yd += np.random.randn(N_stars) * ype
- md += np.random.randn(N_stars) * 0.02
- xde = xpe
- yde = ype
- mde = lis['m0_err']
-
- # Save the new list as a starlist.
- new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
- names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
+ xnew += np.random.randn(N_stars) * 0.1
+ ynew += np.random.randn(N_stars) * 0.1
- new_lis.write('random_vel_p0_{0:d}.fits'.format(ss), overwrite=True)
+ mnew = m + np.random.randn(N_stars) * 0.05
- return (xy_trans, mag_trans)
+ _out = open(f'{test_data_path}/random_shift_{ss+1}.lis', 'w')
+ for ii in range(N_stars):
+ _out.write(fmt.format(name[ii], mnew[ii], xnew[ii], ynew[ii]))
+ _out.close()
+ return shifts
-def make_fake_starlists_poly1_vel(seed=-1):
+def make_fake_starlists_poly1(seed=-1):
# If seed >=0, then set random seed to that value
if seed >= 0:
np.random.seed(seed=seed)
-
+
N_stars = 200
x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
y0 = np.random.rand(N_stars) * 10.0 # arcsec
- x0e = np.ones(N_stars) * 1.0e-4 # arcsec
- y0e = np.ones(N_stars) * 1.0e-4 # arcsec
- vx = np.random.randn(N_stars) * 5.0 # mas / yr
- vy = np.random.randn(N_stars) * 5.0 # mas / yr
- vxe = np.ones(N_stars) * 0.05 # mas / yr
- vye = np.ones(N_stars) * 0.05 # mas / yr
+ x0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
+ y0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
m0 = (np.random.rand(N_stars) * 8) + 9 # mag
m0e = np.random.randn(N_stars) * 0.05 # mag
t0 = np.ones(N_stars) * 2019.5
@@ -735,32 +967,29 @@ def make_fake_starlists_poly1_vel(seed=-1):
x0e = np.abs(x0e)
y0e = np.abs(y0e)
m0e = np.abs(m0e)
- vxe = np.abs(vxe)
- vye = np.abs(vye)
-
+
name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
# Make an StarList
- lis = starlists.StarList([name, m0, m0e, x0, x0e, y0, y0e, vx, vxe, vy, vye, t0],
- names = ('name', 'm0', 'm0_err', 'x0', 'x0_err', 'y0', 'y0_err',
- 'vx', 'vx_err', 'vy', 'vy_err', 't0'))
-
+ lis = starlists.StarList([name, m0, m0e, x0, x0e, y0, y0e, t0],
+ names = ('name', 'm0', 'm0_err', 'x0', 'x0_err', 'y0', 'y0_err', 't0'))
+
sdx = np.argsort(m0)
lis = lis[sdx]
# Save original positions as reference (1st) list
# in a StarList format (with velocities).
- lis.write('random_vel_ref.fits', overwrite=True)
-
+ lis.write(f'{test_data_path}/random_ref.fits', overwrite=True)
+
##########
- # Propogate to new times and distort.
+ # Shifts
##########
- # Make 4 new starlists with different epochs and transformations.
+ # Make 4 new starlists with different shifts.
times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
[[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
- [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.000]],
- [[250.0, 1.01, 2e-5], [-250.0, 1e-5, 0.98]],
+ [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.0]],
+ [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]],
[[ 50.0, 1.01, 1e-5], [ -31.0, 1e-5, 1.000]],
[[ 78.0, 0.98, 0.0 ], [ 45.0, 9e-6, 1.001]],
[[-13.0, 0.99, 1e-5], [ 150, 2e-5, 1.002]],
@@ -770,12 +999,12 @@ def make_fake_starlists_poly1_vel(seed=-1):
# Convert into pixels (undistorted) with the following info.
scale = 0.01 # arcsec / pix
shift = [1.0, 1.0] # pix
-
+
for ss in range(len(times)):
dt = times[ss] - lis['t0']
-
- x = lis['x0'] + (lis['vx']/1e3) * dt
- y = lis['y0'] + (lis['vy']/1e3) * dt
+
+ x = lis['x0']
+ y = lis['y0']
t = np.ones(N_stars) * times[ss]
# Convert into pixels
@@ -789,27 +1018,35 @@ def make_fake_starlists_poly1_vel(seed=-1):
xd, yd = trans.evaluate(xp, yp)
md = trans.evaluate_mag(lis['m0'])
- # Perturb with small errors (0.1 mas)
- xd += np.random.randn(N_stars) * xpe
- yd += np.random.randn(N_stars) * ype
+ # Perturb with small errors (0.1 pix)
+ xd += np.random.randn(N_stars) * 0.1
+ yd += np.random.randn(N_stars) * 0.1
md += np.random.randn(N_stars) * 0.02
xde = xpe
yde = ype
mde = lis['m0_err']
+ # fig, ax = plt.subplots()
+ # ax.scatter(x0, y0, s=2, label='Reference')
+ # ax.scatter(xd, yd, s=2, label='Starlist')
+ # ax.set_xlabel('X (pix)')
+ # ax.set_ylabel('Y (pix)')
+ # ax.legend()
+ # plt.show()
+
# Save the new list as a starlist.
new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
- new_lis.write('random_vel_{0:d}.fits'.format(ss), overwrite=True)
+ new_lis.write(f'{test_data_path}/random_{ss}.fits', overwrite=True)
- return (xy_trans, mag_trans)
+ return (xy_trans,mag_trans)
-def make_fake_starlists_poly1_acc(seed=-1):
+def make_fake_starlists_poly0_vel(seed=-1):
# If seed >=0, then set random seed to that value
if seed >= 0:
np.random.seed(seed=seed)
-
+
N_stars = 200
x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
@@ -818,12 +1055,8 @@ def make_fake_starlists_poly1_acc(seed=-1):
y0e = np.ones(N_stars) * 1.0e-4 # arcsec
vx = np.random.randn(N_stars) * 5.0 # mas / yr
vy = np.random.randn(N_stars) * 5.0 # mas / yr
- vxe = np.ones(N_stars) * 0.1 # mas / yr
- vye = np.ones(N_stars) * 0.1 # mas / yr
- ax = np.random.randn(N_stars) * 0.5 # mas / yr^2
- ay = np.random.randn(N_stars) * 0.5 # mas / yr^2
- axe = np.ones(N_stars) * 0.01 # mas / yr^2
- aye = np.ones(N_stars) * 0.01 # mas / yr^2
+ vxe = np.ones(N_stars) * 0.05 # mas / yr
+ vye = np.ones(N_stars) * 0.05 # mas / yr
m0 = (np.random.rand(N_stars) * 8) + 9 # mag
m0e = np.random.randn(N_stars) * 0.05 # mag
t0 = np.ones(N_stars) * 2019.5
@@ -834,54 +1067,45 @@ def make_fake_starlists_poly1_acc(seed=-1):
m0e = np.abs(m0e)
vxe = np.abs(vxe)
vye = np.abs(vye)
- axe = np.abs(axe)
- aye = np.abs(aye)
-
- name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
+
+ name = [f'star_{ii:03d}' for ii in range(N_stars)]
# Make an StarList
- lis = starlists.StarList([name, m0, m0e,
- x0, x0e, y0, y0e,
- vx, vxe, vy, vye,
- ax, axe, ay, aye,
- t0],
- names = ('name', 'm0', 'm0_err',
- 'x0', 'x0_err', 'y0', 'y0_err',
- 'vx0', 'vx0_err', 'vy0', 'vy0_err',
- 'ax', 'ax_err', 'ay', 'ay_err',
- 't0'))
-
+ lis = starlists.StarList([name, m0, m0e, x0, x0e, y0, y0e, vx, vxe, vy, vye, t0],
+ names = ('name', 'm0', 'm0_err', 'x0', 'x0_err', 'y0', 'y0_err',
+ 'vx', 'vx_err', 'vy', 'vy_err', 't0'))
+
sdx = np.argsort(m0)
lis = lis[sdx]
# Save original positions as reference (1st) list
# in a StarList format (with velocities).
- lis.write('random_acc_ref.fits', overwrite=True)
-
+ lis.write(f'{test_data_path}/random_vel_ref.fits', overwrite=True)
+
##########
# Propogate to new times and distort.
##########
# Make 4 new starlists with different epochs and transformations.
times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
- xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
- [[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
- [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.000]],
- [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]],
- [[ 50.0, 1.01, 1e-5], [ -31.0, 1e-5, 1.000]],
- [[ 78.0, 0.98, 0.0 ], [ 45.0, 9e-6, 1.001]],
- [[-13.0, 0.99, 1e-5], [ 150, 2e-5, 1.002]],
- [[ 94.0, 1.00, 9e-6], [-182.0, 0.0, 0.99]]]
+ xy_trans = [[[ 6.5], [ 10.1]],
+ [[100.3], [ 50.5]],
+ [[ 0.0], [ 0.0]],
+ [[250.0], [-250.0]],
+ [[ 50.0], [ -31.0]],
+ [[ 78.0], [ 45.0]],
+ [[-13.0], [ 150]],
+ [[ 94.0], [-182.0]]]
mag_trans = [0.1, 0.4, 0.0, -0.3, 0.2, 0.0, -0.1, -0.3]
# Convert into pixels (undistorted) with the following info.
scale = 0.01 # arcsec / pix
shift = [1.0, 1.0] # pix
-
+
for ss in range(len(times)):
dt = times[ss] - lis['t0']
-
- x = lis['x0'] + (lis['vx0']/1e3) * dt + 0.5*(lis['ax']/1e3) * dt**2
- y = lis['y0'] + (lis['vy0']/1e3) * dt + 0.5*(lis['ay']/1e3) * dt**2
+
+ x = lis['x0'] + (lis['vx']/1e3) * dt
+ y = lis['y0'] + (lis['vy']/1e3) * dt
t = np.ones(N_stars) * times[ss]
# Convert into pixels
@@ -891,7 +1115,7 @@ def make_fake_starlists_poly1_acc(seed=-1):
ype = lis['y0_err'] / scale
# Distort the positions
- trans = transforms.PolyTransform(1, xy_trans[ss][0], xy_trans[ss][1], mag_offset=mag_trans[ss])
+ trans = transforms.PolyTransform(0, xy_trans[ss][0], xy_trans[ss][1], mag_offset=mag_trans[ss])
xd, yd = trans.evaluate(xp, yp)
md = trans.evaluate_mag(lis['m0'])
@@ -907,27 +1131,26 @@ def make_fake_starlists_poly1_acc(seed=-1):
new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
- new_lis.write('random_acc_{0:d}.fits'.format(ss), overwrite=True)
+ new_lis.write(f'{test_data_path}/random_vel_p0_{ss}.fits', overwrite=True)
return (xy_trans, mag_trans)
-
-def make_fake_starlists_poly1_par(seed=-1):
+
+
+def make_fake_starlists_poly1_vel(seed=-1):
# If seed >=0, then set random seed to that value
if seed >= 0:
np.random.seed(seed=seed)
-
+
N_stars = 200
x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
y0 = np.random.rand(N_stars) * 10.0 # arcsec
- x0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
- y0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
+ x0e = np.ones(N_stars) * 1.0e-4 # arcsec
+ y0e = np.ones(N_stars) * 1.0e-4 # arcsec
vx = np.random.randn(N_stars) * 5.0 # mas / yr
vy = np.random.randn(N_stars) * 5.0 # mas / yr
- vxe = np.random.randn(N_stars) * 0.1 # mas / yr
- vye = np.random.randn(N_stars) * 0.1 # mas / yr
- pi = np.random.randn(N_stars) * 0.5 # mas
- pie = np.random.randn(N_stars) * 0.01 # mas
+ vxe = np.ones(N_stars) * 0.05 # mas / yr
+ vye = np.ones(N_stars) * 0.05 # mas / yr
m0 = (np.random.rand(N_stars) * 8) + 9 # mag
m0e = np.random.randn(N_stars) * 0.05 # mag
t0 = np.ones(N_stars) * 2019.5
@@ -938,62 +1161,45 @@ def make_fake_starlists_poly1_par(seed=-1):
m0e = np.abs(m0e)
vxe = np.abs(vxe)
vye = np.abs(vye)
- pie = np.abs(pie)
-
- name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
+
+ name = [f'star_{ii:03d}' for ii in range(N_stars)]
# Make an StarList
- lis = starlists.StarList([name, m0, m0e,
- x0, x0e, y0, y0e,
- vx, vxe, vy, vye,
- pi, pie,
- t0],
- names = ('name', 'm0', 'm0_err',
- 'x0', 'x0_err', 'y0', 'y0_err',
- 'vx', 'vx_err', 'vy', 'vy_err',
- 'pi', 'pi_err',
- 't0'))
-
+ lis = starlists.StarList([name, m0, m0e, x0, x0e, y0, y0e, vx, vxe, vy, vye, t0],
+ names = ('name', 'm0', 'm0_err', 'x0', 'x0_err', 'y0', 'y0_err',
+ 'vx', 'vx_err', 'vy', 'vy_err', 't0'))
+
sdx = np.argsort(m0)
lis = lis[sdx]
# Save original positions as reference (1st) list
# in a StarList format (with velocities).
- lis.write('random_par_ref.fits', overwrite=True)
-
+ lis.write(f'{test_data_path}/random_vel_ref.fits', overwrite=True)
+
##########
# Propogate to new times and distort.
##########
# Make 4 new starlists with different epochs and transformations.
- '''times = [2018.5, 2019.5, 2020.5, 2021.5]
- xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
- [[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
- [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.0]],
- [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]]]
- mag_trans = [0.1, 0.4, 0.0, -0.3]'''
-
times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
[[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
- [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.0]],
- [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]],
- [[ 50.0, 1.00, 0.0], [ -31.0, 0.0, 1.000]],
- [[ 78.0, 1.00, 0.0 ], [ 45.0, 0.0, 1.00]],
- [[-13.0, 1.00, 0.0], [ 150, 0.0, 1.00]],
- [[ 94.0, 1.00, 0.0], [-182.0, 0.0, 1.00]]]
- mag_trans = [0.1, 0.4, 0.0, -0.3, 0.0, 0.0, 0.0, 0.0]
+ [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.000]],
+ [[250.0, 1.01, 2e-5], [-250.0, 1e-5, 0.98]],
+ [[ 50.0, 1.01, 1e-5], [ -31.0, 1e-5, 1.000]],
+ [[ 78.0, 0.98, 0.0 ], [ 45.0, 9e-6, 1.001]],
+ [[-13.0, 0.99, 1e-5], [ 150, 2e-5, 1.002]],
+ [[ 94.0, 1.00, 9e-6], [-182.0, 0.0, 0.99]]]
+ mag_trans = [0.1, 0.4, 0.0, -0.3, 0.2, 0.0, -0.1, -0.3]
# Convert into pixels (undistorted) with the following info.
scale = 0.01 # arcsec / pix
shift = [1.0, 1.0] # pix
-
+
for ss in range(len(times)):
dt = times[ss] - lis['t0']
-
- par_mod = motion_model.Parallax(PA=0,RA=18.0, Dec=-30.0)
- par_mod_dat = par_mod.get_batch_pos_at_time(dt+lis['t0'], x0=lis['x0'],vx=lis['vx']/1e3, pi=lis['pi'],
- y0=lis['y0'], vy=lis['vy']/1e3, t0=lis['t0'])
- x,y = par_mod_dat[0], par_mod_dat[1]
+
+ x = lis['x0'] + (lis['vx']/1e3) * dt
+ y = lis['y0'] + (lis['vy']/1e3) * dt
t = np.ones(N_stars) * times[ss]
# Convert into pixels
@@ -1007,9 +1213,9 @@ def make_fake_starlists_poly1_par(seed=-1):
xd, yd = trans.evaluate(xp, yp)
md = trans.evaluate_mag(lis['m0'])
- # Perturb with small errors (0.1 pix)
- xd += np.random.randn(N_stars) * 0.1
- yd += np.random.randn(N_stars) * 0.1
+ # Perturb with small errors (0.1 mas)
+ xd += np.random.randn(N_stars) * xpe
+ yd += np.random.randn(N_stars) * ype
md += np.random.randn(N_stars) * 0.02
xde = xpe
yde = ype
@@ -1019,435 +1225,250 @@ def make_fake_starlists_poly1_par(seed=-1):
new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
- new_lis.write('random_par_{0:d}.fits'.format(ss), overwrite=True)
+ new_lis.write(f'{test_data_path}/random_vel_{ss}.fits', overwrite=True)
return (xy_trans, mag_trans)
-
-def test_MosaicToRef_hst_me():
- """
- Test Casey's issue with 'me' not getting propogated
- from the input starlists to the output table.
-
- Use data from MB10-364 microlensing target for the test.
- """
- # Target RA and Dec (MOA data download)
- ra = '17:57:05.401'
- dec = '-34:27:05.01'
-
- # Load up a Gaia catalog (queried around the RA/Dec above)
- my_gaia = Table.read('mb10364_data/my_gaia.fits')
- my_gaia['me'] = 0.01
-
- # Gather the list of starlists. For first pass, don't modify the starlists.
- # Loop through the observations and read them in, in prep for alignment with Gaia
- epochs = [2011.83, 2012.73, 2013.81]
- starlist_names = ['mb10364_data/2011_10_31_F606W_MATCHUP_XYMEEE_final.calib',
- 'mb10364_data/2012_09_25_F606W_MATCHUP_XYMEEE_final.calib',
- 'mb10364_data/2013_10_24_F606W_MATCHUP_XYMEEE_final.calib']
-
- list_of_starlists = []
-
- # Just using the F606W filters first.
- for ee in range(len(starlist_names)):
- lis = starlists.StarList.from_lis_file(starlist_names[ee])
-
- # # Add additive error term. MAYBE YOU DON'T NEED THIS
- # lis['xe'] = np.hypot(lis['xe'], 0.01) # Adding 0.01 pix (0.1 mas) in quadrature.
- # lis['ye'] = np.hypot(lis['ye'], 0.01)
-
- lis['t'] = epochs[ee]
-
- # Lets dump the faint stars.
- idx = np.where(lis['m'] < 20.0)[0]
- lis = lis[idx]
-
- list_of_starlists.append(lis)
-
- msc = align.MosaicToRef(my_gaia, list_of_starlists, iters=1,
- dr_tol=[0.1], dm_tol=[5],
- outlier_tol=[None], mag_lim=[13, 21],
- trans_class=transforms.PolyTransform,
- trans_args=[{'order': 1}],
- default_motion_model='Fixed',
- use_ref_new=False,
- update_ref_orig=False,
- mag_trans=False,
- trans_weights='both,std',
- init_guess_mode='miracle', verbose=False)
- msc.fit()
- tab = msc.ref_table
-
- assert 'me' in tab.colnames
-
- return
-
-def test_bootstrap():
- """
- Test to make sure calc_bootstrap_error() call is working
- properly (e.g., only called when user calls calc_bootstrap_error,
- n_boot param for calc_bootstrap_error only, boot_epochs_min working,
- etc.)
- """
- # Read in starlists for MosaicToRef
- ref = Table.read('ref_vel.lis', format='ascii')
- list1 = Table.read('E.lis', format='ascii')
- list2 = Table.read('F.lis', format='ascii')
-
- list1 = starlists.StarList.from_table(list1)
- list2 = starlists.StarList.from_table(list2)
-
- # Set parameters for alignment
- transModel = transforms.PolyTransform
- trans_args = {'order':2}
- N_loop = 1
- dr_tol = 0.08
- dm_tol = 99
- outlier_tol = None
- mag_lim = None
- ref_mag_lim = None
- trans_weights = 'both,var'
- mag_trans = False
-
- n_boot = 15
- boot_epochs_min=-1
-
- # Run FLYSTAR, no bootstraps yet!
- match1 = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
- dm_tol=dm_tol, outlier_tol=outlier_tol,
- trans_class=transModel,
- trans_args=trans_args,
- mag_trans=mag_trans,
- mag_lim=mag_lim,
- ref_mag_lim=ref_mag_lim,
- trans_weights=trans_weights,
- default_motion_model='Linear',
- use_ref_new=False,
- update_ref_orig=False,
- init_guess_mode='name',
- verbose=False)
- match1.fit()
-
- # Make sure no bootstrap columns exist
- assert 'xe_boot' not in match1.ref_table.keys()
- assert 'ye_boot' not in match1.ref_table.keys()
- assert 'vxe_boot' not in match1.ref_table.keys()
- assert 'vye_boot' not in match1.ref_table.keys()
-
- # Run bootstrap: no boot_epochs_min
- match1.calc_bootstrap_errors(n_boot=n_boot, boot_epochs_min=boot_epochs_min)
- # Make sure columns exist, and none of them are nan values
- assert np.sum(np.isnan(match1.ref_table['xe_boot'])) == 0
- assert np.sum(np.isnan(match1.ref_table['ye_boot'])) == 0
- assert np.sum(np.isnan(match1.ref_table['vx_err_boot'])) == 0
- assert np.sum(np.isnan(match1.ref_table['vy_err_boot'])) == 0
- #pdb.set_trace()
-
- # Test 2: make sure boot_epochs_min is working
- # Eliminate some rows to list2, so some stars are only in 1 epoch.
- # Rerun align. Some stars should only be detected in 1 epoch
- list3 = list2[0:60]
-
- match2 = align.MosaicToRef(ref, [list1, list3], iters=N_loop, dr_tol=dr_tol,
- dm_tol=dm_tol, outlier_tol=outlier_tol,
- trans_class=transModel,
- trans_args=trans_args,
- mag_trans=mag_trans,
- mag_lim=mag_lim,
- ref_mag_lim=ref_mag_lim,
- trans_weights=trans_weights,
- default_motion_model='Linear',
- use_ref_new=False,
- update_ref_orig=False,
- init_guess_mode='name',
- verbose=False)
- match2.fit()
-
- # Now run_calc_bootstrap_error, with boot_epochs_min engaged
- boot_epochs_min2 = 2
- match2.calc_bootstrap_errors(n_boot=n_boot, boot_epochs_min=boot_epochs_min2)
-
- # Make sure boot_epochs_min cut worked as intended
- out = match2.ref_table
- bad = np.where( (out['n_detect'] == 1) & (out['use_in_trans'] == False) )
- good = np.where(out['n_detect'] == 2)
-
- # Some stars must exist in both "good" and "bad" criteria,
- # otherwise this test isn't as useful as intended.
- assert len(bad[0]) > 0
- assert len(good[0]) > 0
-
- # For "good" stars: all bootstrap vals should be present
- assert np.sum(np.isnan(out['xe_boot'][good])) == 0
- assert np.sum(np.isnan(out['ye_boot'][good])) == 0
- assert np.sum(np.isnan(out['vx_err_boot'][good])) == 0
- assert np.sum(np.isnan(out['vy_err_boot'][good])) == 0
-
- # For "bad" stars, all bootstrap vals should be nans
- assert np.sum(np.isfinite(out['xe_boot'][bad])) == 0
- assert np.sum(np.isfinite(out['ye_boot'][bad])) == 0
- assert np.sum(np.isfinite(out['vx_err_boot'][bad])) == 0
- assert np.sum(np.isfinite(out['vy_err_boot'][bad])) == 0
-
- return
-
-def test_calc_vel_in_bootstrap():
- """
- Check calc_vel_in_bootstrap performance in calc_bootstrap_errors()
-
- Only calculate velocity bootstrap (e.g., bootstrap over epochs and
- calculating proper motions) if calc_vel_in_bootstrap=True.
-
- """
- import copy
-
- # Define match parameters
- ref = Table.read('ref_vel.lis', format='ascii')
-
- list1 = Table.read('E.lis', format='ascii')
- list2 = Table.read('F.lis', format='ascii')
-
- list1 = starlists.StarList.from_table(list1)
- list2 = starlists.StarList.from_table(list2)
-
- # Set parameters for alignment
- transModel = transforms.PolyTransform
- trans_args = {'order':2}
- N_loop = 1
- dr_tol = 0.08
- dm_tol = 99
- outlier_tol = None
- mag_lim = None
- ref_mag_lim = None
- trans_weights = 'both,var'
- mag_trans = False
-
- n_boot = 15
- boot_epochs_min=-1
+def make_fake_starlists_poly1_acc(seed=-1):
+ # If seed >=0, then set random seed to that value
+ if seed >= 0:
+ np.random.seed(seed=seed)
- # Run match
- match = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
- dm_tol=dm_tol, outlier_tol=outlier_tol,
- trans_class=transModel,
- trans_args=trans_args,
- mag_trans=mag_trans,
- mag_lim=mag_lim,
- ref_mag_lim=ref_mag_lim,
- trans_weights=trans_weights,
- default_motion_model='Linear',
- use_ref_new=False,
- update_ref_orig=False,
- init_guess_mode='name',
- verbose=False)
- match.fit()
+ N_stars = 200
- # Make 2 copies of match object: one to test
- # each case of calc_vel_in_bootstrap
- match_vel = copy.deepcopy(match)
+ x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
+ y0 = np.random.rand(N_stars) * 10.0 # arcsec
+ x0e = np.ones(N_stars) * 1.0e-4 # arcsec
+ y0e = np.ones(N_stars) * 1.0e-4 # arcsec
+ vx = np.random.randn(N_stars) * 5.0 # mas / yr
+ vy = np.random.randn(N_stars) * 5.0 # mas / yr
+ vxe = np.ones(N_stars) * 0.1 # mas / yr
+ vye = np.ones(N_stars) * 0.1 # mas / yr
+ ax = np.random.randn(N_stars) * 0.5 # mas / yr^2
+ ay = np.random.randn(N_stars) * 0.5 # mas / yr^2
+ axe = np.ones(N_stars) * 0.01 # mas / yr^2
+ aye = np.ones(N_stars) * 0.01 # mas / yr^2
+ m0 = (np.random.rand(N_stars) * 8) + 9 # mag
+ m0e = np.random.randn(N_stars) * 0.05 # mag
+ t0 = np.ones(N_stars) * 2019.5
- # Run calc_bootstrap_error function with calc_vel_in_bootstrap=True.
- # Make sure bootstrap velocity errors are calculated and valid
- n_boot = 50
- match_vel.calc_bootstrap_errors(n_boot=n_boot, calc_vel_in_bootstrap=True)
+ # Make all the errors positive
+ x0e = np.abs(x0e)
+ y0e = np.abs(y0e)
+ m0e = np.abs(m0e)
+ vxe = np.abs(vxe)
+ vye = np.abs(vye)
+ axe = np.abs(axe)
+ aye = np.abs(aye)
- assert 'xe_boot' in match_vel.ref_table.keys()
- assert np.sum(np.isnan(match_vel.ref_table['xe_boot'])) == 0
- assert 'vx_err_boot' in match_vel.ref_table.keys()
- assert np.sum(np.isnan(match_vel.ref_table['vx_err_boot'])) == 0
+ name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
- # Run without calc_vel_in_bootstrap, make sure velocities are NOT calculated
- match.calc_bootstrap_errors(n_boot=n_boot, calc_vel_in_bootstrap=False)
+ # Make an StarList
+ lis = starlists.StarList([name, m0, m0e,
+ x0, x0e, y0, y0e,
+ vx, vxe, vy, vye,
+ ax, axe, ay, aye,
+ t0],
+ names = ('name', 'm0', 'm0_err',
+ 'x0', 'x0_err', 'y0', 'y0_err',
+ 'vx0', 'vx0_err', 'vy0', 'vy0_err',
+ 'ax', 'ax_err', 'ay', 'ay_err',
+ 't0'))
- assert 'xe_boot' in match.ref_table.keys()
- assert np.sum(np.isnan(match.ref_table['xe_boot'])) == 0
- assert 'vx_err_boot' not in match.ref_table.keys()
-
- return
+ sdx = np.argsort(m0)
+ lis = lis[sdx]
-def test_transform_xym():
- """
- Test to make sure transforms are being done to mags only
- if mag_trans = True. This can cause subtle bugs
- otherwise
- """
- #---Align 1: self.mag_Trans = False---#
- ref = Table.read('ref_vel.lis', format='ascii')
- list1 = Table.read('E.lis', format='ascii')
- list2 = Table.read('F.lis', format='ascii')
+ # Save original positions as reference (1st) list
+ # in a StarList format (with velocities).
+ lis.write(f'{test_data_path}/random_acc_ref.fits', overwrite=True)
- list1 = starlists.StarList.from_table(list1)
- list2 = starlists.StarList.from_table(list2)
-
- # Set parameters for alignment
- transModel = transforms.PolyTransform
- trans_args = {'order':2}
- N_loop = 1
- dr_tol = 0.08
- dm_tol = 99
- outlier_tol = None
- mag_lim = None
- ref_mag_lim = None
- trans_weights = 'both,var'
- n_boot = 15
+ ##########
+ # Propogate to new times and distort.
+ ##########
+ # Make 4 new starlists with different epochs and transformations.
+ times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
+ xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
+ [[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
+ [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.000]],
+ [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]],
+ [[ 50.0, 1.01, 1e-5], [ -31.0, 1e-5, 1.000]],
+ [[ 78.0, 0.98, 0.0 ], [ 45.0, 9e-6, 1.001]],
+ [[-13.0, 0.99, 1e-5], [ 150, 2e-5, 1.002]],
+ [[ 94.0, 1.00, 9e-6], [-182.0, 0.0, 0.99]]]
+ mag_trans = [0.1, 0.4, 0.0, -0.3, 0.2, 0.0, -0.1, -0.3]
- mag_trans = False
+ # Convert into pixels (undistorted) with the following info.
+ scale = 0.01 # arcsec / pix
+ shift = [1.0, 1.0] # pix
- # Run FLYSTAR, with bootstraps
- match1 = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
- dm_tol=dm_tol, outlier_tol=outlier_tol,
- trans_class=transModel,
- trans_args=trans_args,
- mag_trans=mag_trans,
- mag_lim=mag_lim,
- ref_mag_lim=ref_mag_lim,
- trans_weights=trans_weights,
- default_motion_model='Fixed',
- use_ref_new=False,
- update_ref_orig=False,
- init_guess_mode='name',
- verbose=False)
+ for ss in range(len(times)):
+ dt = times[ss] - lis['t0']
- match1.fit()
- match1.calc_bootstrap_errors(n_boot=n_boot)
+ x = lis['x0'] + (lis['vx0']/1e3) * dt + 0.5*(lis['ax']/1e3) * dt**2
+ y = lis['y0'] + (lis['vy0']/1e3) * dt + 0.5*(lis['ay']/1e3) * dt**2
+ t = np.ones(N_stars) * times[ss]
- # Make sure all transformations have mag_offset = 0
- trans_list = match1.trans_list
+ # Convert into pixels
+ xp = (x / -scale) + shift[0] # -1 from switching to increasing to West (right)
+ yp = (y / scale) + shift[1]
+ xpe = lis['x0_err'] / scale
+ ype = lis['y0_err'] / scale
- for ii in trans_list:
- assert ii.mag_offset == 0
+ # Distort the positions
+ trans = transforms.PolyTransform(1, xy_trans[ss][0], xy_trans[ss][1], mag_offset=mag_trans[ss])
+ xd, yd = trans.evaluate(xp, yp)
+ md = trans.evaluate_mag(lis['m0'])
- # Check that no mag transformation has been applied to m col in ref_table
- tab1 = match1.ref_table
- assert np.all(tab1['m'] == tab1['m_orig'])
-
- # Check me_boost == 0 or really small (should be the case
- # since we don't transform mags)
- assert np.isclose(np.max(tab1['me_boot']), 0, rtol=10**-5)
- print('Done mag_trans = False case')
+ # Perturb with small errors (0.1 pix)
+ xd += np.random.randn(N_stars) * xpe
+ yd += np.random.randn(N_stars) * ype
+ md += np.random.randn(N_stars) * 0.02
+ xde = xpe
+ yde = ype
+ mde = lis['m0_err']
- #---Align 2: self.mag_Trans = True---#
- # Repeat, this time with mag_trans = False
- mag_trans = True
- match2 = align.MosaicToRef(ref, [list1, list2], iters=N_loop, dr_tol=dr_tol,
- dm_tol=dm_tol, outlier_tol=outlier_tol,
- trans_class=transModel,
- trans_args=trans_args,
- mag_trans=mag_trans,
- mag_lim=mag_lim,
- ref_mag_lim=ref_mag_lim,
- trans_weights=trans_weights,
- default_motion_model='Fixed',
- use_ref_new=False,
- update_ref_orig=False,
- init_guess_mode='name',
- verbose=False)
+ # Save the new list as a starlist.
+ new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
+ names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
- match2.fit()
- match2.calc_bootstrap_errors(n_boot=n_boot)
+ new_lis.write(f'{test_data_path}/random_acc_{ss}.fits', overwrite=True)
+ return (xy_trans, mag_trans)
- # Make sure all transformations have correct mag offset
- trans_list2 = match2.trans_list
+def make_fake_starlists_poly1_par(seed=-1):
+ # If seed >=0, then set random seed to that value
+ if seed >= 0:
+ np.random.seed(seed=seed)
- for ii in trans_list2:
- assert ii.mag_offset > 20
+ N_stars = 200
- # Make sure final table mags have transform applied (i.e,
- tab2 = match2.ref_table
- assert np.all(tab2['m'] != tab2['m_orig'])
-
- # Check me_boost > 0
- assert np.min(tab2['me_boot']) > 10**-3
+ x0 = np.random.rand(N_stars) * 10.0 # arcsec (increasing to East)
+ y0 = np.random.rand(N_stars) * 10.0 # arcsec
+ x0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
+ y0e = np.random.randn(N_stars) * 5.0e-4 # arcsec
+ vx = np.random.randn(N_stars) * 5.0 # mas / yr
+ vy = np.random.randn(N_stars) * 5.0 # mas / yr
+ vxe = np.random.randn(N_stars) * 0.1 # mas / yr
+ vye = np.random.randn(N_stars) * 0.1 # mas / yr
+ pi = np.random.randn(N_stars) * 0.5 # mas
+ pie = np.random.randn(N_stars) * 0.01 # mas
+ m0 = (np.random.rand(N_stars) * 8) + 9 # mag
+ m0e = np.random.randn(N_stars) * 0.05 # mag
+ t0 = np.ones(N_stars) * 2019.5
- print('Done mag_trans = True case')
-
- return
+ # Make all the errors positive
+ x0e = np.abs(x0e)
+ y0e = np.abs(y0e)
+ m0e = np.abs(m0e)
+ vxe = np.abs(vxe)
+ vye = np.abs(vye)
+ pie = np.abs(pie)
-def test_MosaicToRef_mag_bug():
- """
- Bug found by Tuan Do on 2020-04-12.
- """
- make_fake_starlists_poly1_vel()
+ name = ['star_{0:03d}'.format(ii) for ii in range(N_stars)]
- ref_list = starlists.StarList.read('random_vel_0.fits')
- lists = [ref_list]
+ # Make an StarList
+ lis = starlists.StarList([name, m0, m0e,
+ x0, x0e, y0, y0e,
+ vx, vxe, vy, vye,
+ pi, pie,
+ t0],
+ names = ('name', 'm0', 'm0_err',
+ 'x0', 'x0_err', 'y0', 'y0_err',
+ 'vx', 'vx_err', 'vy', 'vy_err',
+ 'pi', 'pi_err',
+ 't0'))
- msc = align.MosaicToRef(ref_list, lists,
- mag_trans=True,
- iters=1,
- dr_tol=[0.2], dm_tol=[1],
- outlier_tol=None,
- trans_class=transforms.PolyTransform,
- trans_args=[{'order': 1}],
- default_motion_model='Fixed',
- use_ref_new=False,
- update_ref_orig=False,
- verbose=True)
+ sdx = np.argsort(m0)
+ lis = lis[sdx]
- msc.fit()
+ # Save original positions as reference (1st) list
+ # in a StarList format (with velocities).
+ lis.write(f'{test_data_path}/random_par_ref.fits', overwrite=True)
- out_tab = msc.ref_table
+ ##########
+ # Propogate to new times and distort.
+ ##########
+ # Make 4 new starlists with different epochs and transformations.
+ '''times = [2018.5, 2019.5, 2020.5, 2021.5]
+ xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
+ [[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
+ [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.0]],
+ [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]]]
+ mag_trans = [0.1, 0.4, 0.0, -0.3]'''
- # The issue is that in the initial guess with
- # mag_trans = True
- # somehow the transformed magnitudes are nan.
- # This causes zero matches to occur.
- assert len(out_tab) == len(ref_list)
+ times = [2018.5, 2019.0, 2019.5, 2020.0, 2020.5, 2021.0, 2021.5, 2022.0]
+ xy_trans = [[[ 6.5, 0.99, 1e-5], [ 10.1, 1e-5, 0.99]],
+ [[100.3, 0.98, 1e-5], [ 50.5, 9e-6, 1.001]],
+ [[ 0.0, 1.00, 0.0], [ 0.0, 0.0, 1.0]],
+ [[250.0, 0.97, 2e-5], [-250.0, 1e-5, 1.001]],
+ [[ 50.0, 1.00, 0.0], [ -31.0, 0.0, 1.000]],
+ [[ 78.0, 1.00, 0.0 ], [ 45.0, 0.0, 1.00]],
+ [[-13.0, 1.00, 0.0], [ 150, 0.0, 1.00]],
+ [[ 94.0, 1.00, 0.0], [-182.0, 0.0, 1.00]]]
+ mag_trans = [0.1, 0.4, 0.0, -0.3, 0.0, 0.0, 0.0, 0.0]
- return
+ # Convert into pixels (undistorted) with the following info.
+ scale = 0.01 # arcsec / pix
+ shift = [1.0, 1.0] # pix
-def test_masked_cols():
- """
- Test to make sure analysis.prepare_gaia_for_flystar
- produces an astropy.table.Table, NOT a masked column
- table. MosaicToRef cannot handle masked column tables.
+ for ss in range(len(times)):
+ dt = times[ss] - lis['t0']
- Also make sure this example works, since we use it for the examples
- jupyter notebook.
- """
- # Get gaia reference stars using analysis.py
- # around a test location.
- target = 'ob150029'
- ra = '17:59:46.60'
- dec = '-28:38:41.8'
+ par_mod = motion_model.Parallax(pa=0,ra=18.0, dec=-30.0)
+ par_mod_dat = par_mod.get_batch_pos_at_time(dt+lis['t0'], x0=lis['x0'],vx=lis['vx']/1e3, pi=lis['pi'],
+ y0=lis['y0'], vy=lis['vy']/1e3, t0=lis['t0'])
+ x,y = par_mod_dat[0], par_mod_dat[1]
+ t = np.ones(N_stars) * times[ss]
- # Coordinates are arcsecs offset +x to the East.
- targets_dict = {'ob150029': [0.0, 0.0],
- 'S005': [1.1416, 3.7405],
- 'S002': [-4.421, 0.027]
- }
+ # Convert into pixels
+ xp = (x / -scale) + shift[0] # -1 from switching to increasing to West (right)
+ yp = (y / scale) + shift[1]
+ xpe = lis['x0_err'] / scale
+ ype = lis['y0_err'] / scale
- # Get gaia catalog stars. Note that this produces a masked column table
- search_rad = 10.0 # arcsec
- gaia = analysis.query_gaia(ra, dec, search_radius=search_rad)
- my_gaia = analysis.prepare_gaia_for_flystar(gaia, ra, dec, targets_dict=targets_dict)
+ # Distort the positions
+ trans = transforms.PolyTransform(1, xy_trans[ss][0], xy_trans[ss][1], mag_offset=mag_trans[ss])
+ xd, yd = trans.evaluate(xp, yp)
+ md = trans.evaluate_mag(lis['m0'])
- assert isinstance(my_gaia, Table)
+ # Perturb with small errors (0.1 pix)
+ xd += np.random.randn(N_stars) * 0.1
+ yd += np.random.randn(N_stars) * 0.1
+ md += np.random.randn(N_stars) * 0.02
+ xde = xpe
+ yde = ype
+ mde = lis['m0_err']
- # Let's make sure the entire align runs, just to be safe
-
- # Get starlists to align to gaia
- epochs = ['15jun07','16jul14', '17may21']
+ # Save the new list as a starlist.
+ new_lis = starlists.StarList([lis['name'], md, mde, xd, xde, yd, yde, t],
+ names=('name', 'm', 'me', 'x', 'xe', 'y', 'ye', 't'))
- list_of_starlists = []
+ new_lis.write(f'{test_data_path}/random_par_{ss}.fits', overwrite=True)
- for ee in range(len(epochs)):
- lis_file = 'mag' + epochs[ee] + '_ob150029_kp_rms_named.lis'
- lis = starlists.StarList.from_lis_file(lis_file)
-
- list_of_starlists.append(lis)
+ return (xy_trans, mag_trans)
- # Run the align
- msc = align.MosaicToRef(my_gaia, list_of_starlists, iters=2,
- dr_tol=[0.2, 0.1], dm_tol=[1, 1],
+if __name__ == '__main__':
+ import pickle
+ with open(f'{test_data_path}/my_gaia.pkl', 'rb') as f:
+ my_gaia = pickle.load(f)
+ with open(f'{test_data_path}/list_of_starlists.pkl', 'rb') as f:
+ list_of_starlists = pickle.load(f)
+ ra_deg, dec_deg = 18.0, -30.0
+ my_gaia.remove_column('motion_model_used')
+ msc = align.MosaicToRef(my_gaia, list_of_starlists, iters=3,
+ dr_tol=[0.2, 0.1, 0.08], dm_tol=[5,5,5],
+ outlier_tol=[None, None, 3], mag_lim=[6, 20],
trans_class=transforms.PolyTransform,
- trans_args=[{'order': 1}, {'order': 1}],
- default_motion_model='Linear',
- use_ref_new=False,
+ trans_args=[{'order': 1}, {'order': 1}, {'order': 1}],
+ motion_models=['Linear','Parallax'],
+ fixed_params_dict = {'ra':ra_deg, 'dec':dec_deg, 'pa':0.0, 'obsLocation':'earth'},
+ use_ref_new=True,
update_ref_orig=False,
mag_trans=True,
- init_guess_mode='name', verbose=True)
-
+ trans_weighting='both,std',
+ init_guess_mode='name', verbose=3)
msc.fit()
-
- return
+ for i in range(msc.ref_table['x'].shape[1]):
+ plt.scatter(msc.ref_table['x'][:, i], msc.ref_table['y'][:, i])
+ plt.show()
+ plot_stars(msc.ref_table, msc.ref_table['name'][:3])
\ No newline at end of file
diff --git a/flystar/tests/test_all_detected.fits b/flystar/tests/test_all_detected.fits
deleted file mode 100644
index ae56198..0000000
--- a/flystar/tests/test_all_detected.fits
+++ /dev/null
@@ -1,2911 +0,0 @@
-SIMPLE = T / conforms to FITS standard BITPIX = 8 / array data type NAXIS = 0 / number of array dimensions EXTEND = T END XTENSION= 'BINTABLE' / binary table extension BITPIX = 8 / array data type NAXIS = 2 / number of array dimensions NAXIS1 = 632 / length of dimension 1 NAXIS2 = 2000 / length of dimension 2 PCOUNT = 0 / number of group parameters GCOUNT = 1 / number of groups TFIELDS = 21 / number of table fields TTYPE1 = 'name ' TFORM1 = 'K ' TTYPE2 = 'x ' TFORM2 = '12D ' TDIM2 = '(2,6) ' TTYPE3 = 'y ' TFORM3 = '12D ' TDIM3 = '(2,6) ' TTYPE4 = 'm ' TFORM4 = '12D ' TDIM4 = '(2,6) ' TTYPE5 = 'xe ' TFORM5 = '6D ' TDIM5 = '(6) ' TTYPE6 = 'ye ' TFORM6 = '6D ' TDIM6 = '(6) ' TTYPE7 = 'me ' TFORM7 = '6D ' TDIM7 = '(6) ' TTYPE8 = 'n ' TFORM8 = '6D ' TDIM8 = '(6) ' TTYPE9 = 'det ' TFORM9 = '6D ' TDIM9 = '(6) ' TTYPE10 = 'vx ' TFORM10 = 'D ' TTYPE11 = 'vy ' TFORM11 = 'D ' TTYPE12 = 'vxe ' TFORM12 = 'D ' TTYPE13 = 'vye ' TFORM13 = 'D ' TTYPE14 = 'x0 ' TFORM14 = 'D ' TTYPE15 = 'y0 ' TFORM15 = 'D ' TTYPE16 = 'x0e ' TFORM16 = 'D ' TTYPE17 = 'y0e ' TFORM17 = 'D ' TTYPE18 = 'chi2_vx ' TFORM18 = 'D ' TTYPE19 = 'chi2_vy ' TFORM19 = 'D ' TTYPE20 = 't0 ' TFORM20 = 'D ' TTYPE21 = 'n_vfit ' TFORM21 = 'D ' EPNAMES = '2005_F814W_F1' EPNAMES = '2010_F125W_F3' EPNAMES = '2010_F139M_F2' EPNAMES = '2010_F160W_F1' EPNAMES = '2013_F160W_F1' EPNAMES = '2015_F160W_F1' ZPOINTS = 32.6783 ZPOINTS = 25.2305 ZPOINTS = 23.2835 ZPOINTS = 24.5698 ZPOINTS = 24.5698 ZPOINTS = 24.5698 YEARS = 2005.485 YEARS = 2010.652 YEARS = 2010.652 YEARS = 2010.652 YEARS = 2013.199 YEARS = 2015.148 HIERARCH DATE PRODUCED = '2025-06-30' HIERARCH INSTRUMENT = 'ACSWFC ' HIERARCH INSTRUMENT = 'WFC3IR ' HIERARCH INSTRUMENT = 'WFC3IR ' HIERARCH INSTRUMENT = 'WFC3IR ' HIERARCH INSTRUMENT = 'WFC3IR ' HIERARCH INSTRUMENT = 'WFC3IR ' END @
1&y@
c+(@
1&y@4U*@
1&y@OS@
1&y@ŕ@
1&y@
!@
1&y@]H/@nzG@ns2ph@nzG@n:t@nzG@mI@nzG@mm@nzG@nb3@nzG@ns@8䎊@8m1@4S@3!d@3~"@3Q@䩤@2@2h4Z@2@2ĊRd@2@2&EK?hjaQ?*?iy?Û?
-Ld?OU=6i?/nI|??`l??!g?'?χ1?# ?jo?/O?ޥe?.Eôv?[\@ @" @ @" @4 @. ? ? ? ? ? ? ?Ek ?mo ?zS ?T8O@@n?/??Cs?9wZe`?3#@溦z@k%>@ @`ě@\1'@`ě@Q4K@`ě@Mw1@`ě@G@`ě@:6@`ě@4j~@ۊ=p@ێV@ۊ=p@{lD@ۊ=p@۞Q@ۊ=p@ہTɅ@ۊ=p@ۙb@ۊ=p@cA@6=:@6:)^@4hr@4SMj@3`A@3\(@3._o @3:L/|@3._o @3BC,@3._o @3G?Ol?.5?{?d`Xp?͵?>;?
?>%?:?Җhn?|9.)?@~?
-B?7ly\?J鞤?Jf?8? J6Л@ @ @ @ @, @( ? ? ? ? ? ? C &Ԡ ?*2iۂA?Y領~@OûZ@یc?D?tN'p?{Q(?@bn{@ @+. @+. @+. @+. @+@٦@+@ k@(6E. @(6E. @(6E. @(6E. @(6E@)Q@(6E@!p<@8s.>@4S.Mm@3`A7.Qn@2YJ.NC,@2YJ@2>@2YJ@1E2a|@8 J@8 #@8 :@8 >+?BxT?g{=@8 J@8 @8 i@8 ?VYk?Պu@8 p@8
*@8 p@8 ?Z?\ @ @ ? ? @zG@w@zG@rGF@zG@s@zG@=b@zG@*0@zG@X@շKƧ@ռ(@շKƧ@7@շKƧ@շX@շKƧ@շ@շKƧ@նz@շKƧ@ո}H@8g l@8\N@4hr @4&@4"-V@4*͞&@3B@5@3GKƧ@3B@5@3G@3B@5@3H9Xb?q!U?+W?](s?A2x?wX?>V$?TU?[G,?ҌI?,#t?s?|[z?ӖO_?[
S? e?Za7?Us?DΊ@ @ @ @ @* @( ? ? ? ? ? ? ?VM Bx ?QԬy!?Bex.@W.V@ոAA?nɢf?[~?u?+\t@oF5i@ @EQ@9R4@EQ@G2@EQ@?'-9@EQ@DqN@EQ@D@EQ@FW@/j~#@/,l@/j~#@/i3ߢ@/j~#@/qjK>h@/j~#@/fX@/j~#@/m*@/j~#@/uA@8g l@8u@2r Ĝ@2QU|@2gKƧ@2l76@1&@1"@1&@1[@1&@1} t?ڢ??b r}?N[x?},A? J?P*i?6 k?ZU?1O}?=е?zpY?i?V0qRi?@&pp??~?zA?Ad`@ @ @&